* Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
* Use is subject to license terms.
*
- * Copyright (c) 2012, 2013, Intel Corporation.
+ * Copyright (c) 2014, Intel Corporation.
*/
/*
- * This file is part of Lustre, http://www.lustre.org/
- * Lustre is a trademark of Sun Microsystems, Inc.
- *
* lustre/osp/osp_object.c
*
- * Lustre OST Proxy Device
+ * Lustre OST Proxy Device (OSP) is the agent on the local MDT for the OST
+ * or remote MDT.
+ *
+ * OSP object attributes cache
+ * ---------------------------
+ * OSP object is the stub of the remote OST-object or MDT-object. Both the
+ * attribute and the extended attributes are stored on the peer side remotely.
+ * It is inefficient to send RPC to peer to fetch those attributes when every
+ * get_attr()/get_xattr() called. For a large system, the LFSCK synchronous
+ * mode scanning is prohibitively inefficient.
+ *
+ * So the OSP maintains the OSP object attributes cache to cache some
+ * attributes on the local MDT. The cache is organized against the OSP
+ * object as follows:
+ *
+ * struct osp_xattr_entry {
+ * struct list_head oxe_list;
+ * atomic_t oxe_ref;
+ * void *oxe_value;
+ * int oxe_buflen;
+ * int oxe_namelen;
+ * int oxe_vallen;
+ * unsigned int oxe_exist:1,
+ * oxe_ready:1;
+ * char oxe_buf[0];
+ * };
+ *
+ * struct osp_object_attr {
+ * struct lu_attr ooa_attr;
+ * struct list_head ooa_xattr_list;
+ * };
+ *
+ * struct osp_object {
+ * ...
+ * struct osp_object_attr *opo_ooa;
+ * spinlock_t opo_lock;
+ * ...
+ * };
+ *
+ * The basic attributes, such as owner/mode/flags, are stored in the
+ * osp_object_attr::ooa_attr. The extended attributes will be stored
+ * as osp_xattr_entry. Every extended attribute has an independent
+ * osp_xattr_entry, and all the osp_xattr_entry are linked into the
+ * osp_object_attr::ooa_xattr_list. The OSP object attributes cache
+ * is protected by the osp_object::opo_lock.
+ *
+ * Not all OSP objects have an attributes cache because maintaining
+ * the cache requires some resources. Currently, the OSP object
+ * attributes cache will be initialized when the attributes or the
+ * extended attributes are pre-fetched via osp_declare_attr_get()
+ * or osp_declare_xattr_get(). That is usually for LFSCK purpose,
+ * but it also can be shared by others.
*
* Author: Alex Zhuravlev <alexey.zhuravlev@intel.com>
* Author: Mikhail Pershin <mike.tappro@intel.com>
#include "osp_internal.h"
+static inline __u32 osp_dev2node(struct osp_device *osp)
+{
+ return osp->opd_storage->dd_lu_dev.ld_site->ld_seq_site->ss_node_id;
+}
+
static inline bool is_ost_obj(struct lu_object *lo)
{
return !lu2osp_dev(lo->lo_dev)->opd_connect_mdt;
}
+/**
+ * Assign FID to the OST object.
+ *
+ * This function will assign the FID to the OST object of a striped file.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] d pointer to the OSP device
+ * \param[in] o pointer to the OSP object that the FID will be
+ * assigned to
+ */
static void osp_object_assign_fid(const struct lu_env *env,
- struct osp_device *d, struct osp_object *o)
+ struct osp_device *d, struct osp_object *o)
{
struct osp_thread_info *osi = osp_env_info(env);
lu_object_assign_fid(env, &o->opo_obj.do_lu, &osi->osi_fid);
}
+/**
+ * Initialize the OSP object attributes cache.
+ *
+ * \param[in] obj pointer to the OSP object
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_oac_init(struct osp_object *obj)
{
struct osp_object_attr *ooa;
return 0;
}
+/**
+ * Find the named extended attribute in the OSP object attributes cache.
+ *
+ * The caller should take the osp_object::opo_lock before calling
+ * this function.
+ *
+ * \param[in] ooa pointer to the OSP object attributes cache
+ * \param[in] name the name of the extended attribute
+ * \param[in] namelen the name length of the extended attribute
+ *
+ * \retval pointer to the found extended attribute entry
+ * \retval NULL if the specified extended attribute is not
+ * in the cache
+ */
static struct osp_xattr_entry *
osp_oac_xattr_find_locked(struct osp_object_attr *ooa,
- const char *name, size_t namelen, bool unlink)
+ const char *name, size_t namelen)
{
struct osp_xattr_entry *oxe;
list_for_each_entry(oxe, &ooa->ooa_xattr_list, oxe_list) {
if (namelen == oxe->oxe_namelen &&
- strncmp(name, oxe->oxe_buf, namelen) == 0) {
- if (unlink)
- list_del_init(&oxe->oxe_list);
- else
- atomic_inc(&oxe->oxe_ref);
-
+ strncmp(name, oxe->oxe_buf, namelen) == 0)
return oxe;
- }
}
return NULL;
}
+/**
+ * Find the named extended attribute in the OSP object attributes cache.
+ *
+ * Call osp_oac_xattr_find_locked() with the osp_object::opo_lock held.
+ *
+ * \param[in] obj pointer to the OSP object
+ * \param[in] name the name of the extended attribute
+ * \param[in] unlink true if the extended attribute entry is to be removed
+ * from the cache
+ *
+ * \retval pointer to the found extended attribute entry
+ * \retval NULL if the specified extended attribute is not
+ * in the cache
+ */
static struct osp_xattr_entry *osp_oac_xattr_find(struct osp_object *obj,
- const char *name)
+ const char *name, bool unlink)
{
struct osp_xattr_entry *oxe = NULL;
spin_lock(&obj->opo_lock);
- if (obj->opo_ooa != NULL)
+ if (obj->opo_ooa != NULL) {
oxe = osp_oac_xattr_find_locked(obj->opo_ooa, name,
- strlen(name), false);
+ strlen(name));
+ if (oxe != NULL) {
+ if (unlink)
+ list_del_init(&oxe->oxe_list);
+ else
+ atomic_inc(&oxe->oxe_ref);
+ }
+ }
spin_unlock(&obj->opo_lock);
return oxe;
}
+/**
+ * Find the named extended attribute in the OSP object attributes cache.
+ *
+ * If it is not in the cache, then add an empty entry (that will be
+ * filled later) to cache with the given name.
+ *
+ * \param[in] obj pointer to the OSP object
+ * \param[in] name the name of the extended attribute
+ * \param[in] len the length of the extended attribute value
+ *
+ * \retval pointer to the found or new-created extended
+ * attribute entry
+ * \retval NULL if the specified extended attribute is not in the
+ * cache or fail to add new empty entry to the cache.
+ */
static struct osp_xattr_entry *
osp_oac_xattr_find_or_add(struct osp_object *obj, const char *name, size_t len)
{
LASSERT(ooa != NULL);
- oxe = osp_oac_xattr_find(obj, name);
+ oxe = osp_oac_xattr_find(obj, name, false);
if (oxe != NULL)
return oxe;
atomic_set(&oxe->oxe_ref, 2);
spin_lock(&obj->opo_lock);
- tmp = osp_oac_xattr_find_locked(ooa, name, namelen, false);
+ tmp = osp_oac_xattr_find_locked(ooa, name, namelen);
if (tmp == NULL)
list_add_tail(&oxe->oxe_list, &ooa->ooa_xattr_list);
+ else
+ atomic_inc(&tmp->oxe_ref);
spin_unlock(&obj->opo_lock);
if (tmp != NULL) {
return oxe;
}
+/**
+ * Add the given extended attribute to the OSP object attributes cache.
+ *
+ * If there is an old extended attributed entry with the same name,
+ * remove it from the cache and return it via the parameter \a poxe.
+ *
+ * \param[in] obj pointer to the OSP object
+ * \param[in,out] poxe double pointer to the OSP object extended attribute
+ * entry: the new extended attribute entry is transfered
+ * via such pointer target, and if old the extended
+ * attribute entry exists, then it will be returned back
+ * via such pointer target.
+ * \param[in] len the length of the (new) extended attribute value
+ *
+ * \retval pointer to the new extended attribute entry
+ * \retval NULL for failure cases.
+ */
static struct osp_xattr_entry *
osp_oac_xattr_replace(struct osp_object *obj,
struct osp_xattr_entry **poxe, size_t len)
{
struct osp_object_attr *ooa = obj->opo_ooa;
- struct osp_xattr_entry *old = *poxe;
struct osp_xattr_entry *oxe;
- struct osp_xattr_entry *tmp = NULL;
- size_t namelen = old->oxe_namelen;
+ size_t namelen = (*poxe)->oxe_namelen;
size_t size = sizeof(*oxe) + namelen + 1 + len;
LASSERT(ooa != NULL);
INIT_LIST_HEAD(&oxe->oxe_list);
oxe->oxe_buflen = size;
oxe->oxe_namelen = namelen;
- memcpy(oxe->oxe_buf, old->oxe_buf, namelen);
+ memcpy(oxe->oxe_buf, (*poxe)->oxe_buf, namelen);
oxe->oxe_value = oxe->oxe_buf + namelen + 1;
/* One ref is for the caller, the other is for the entry on the list. */
atomic_set(&oxe->oxe_ref, 2);
spin_lock(&obj->opo_lock);
- tmp = osp_oac_xattr_find_locked(ooa, oxe->oxe_buf, namelen, true);
+ *poxe = osp_oac_xattr_find_locked(ooa, oxe->oxe_buf, namelen);
+ LASSERT(*poxe != NULL);
+
+ list_del_init(&(*poxe)->oxe_list);
list_add_tail(&oxe->oxe_list, &ooa->ooa_xattr_list);
spin_unlock(&obj->opo_lock);
- *poxe = tmp;
- LASSERT(tmp != NULL);
-
return oxe;
}
+/**
+ * Release reference from the OSP object extended attribute entry.
+ *
+ * If it is the last reference, then free the entry.
+ *
+ * \param[in] oxe pointer to the OSP object extended attribute entry.
+ */
static inline void osp_oac_xattr_put(struct osp_xattr_entry *oxe)
{
if (atomic_dec_and_test(&oxe->oxe_ref)) {
}
}
+/**
+ * Parse the OSP object attribute from the RPC reply.
+ *
+ * If the attribute is valid, then it will be added to the OSP object
+ * attributes cache.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] reply pointer to the RPC reply
+ * \param[in] req pointer to the RPC request
+ * \param[out] attr pointer to buffer to hold the output attribute
+ * \param[in] obj pointer to the OSP object
+ * \param[in] index the index of the attribute buffer in the reply
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_get_attr_from_reply(const struct lu_env *env,
struct object_update_reply *reply,
struct ptlrpc_request *req,
return 0;
}
+/**
+ * Interpreter function for getting OSP object attribute asynchronously.
+ *
+ * Called to interpret the result of an async mode RPC for getting the
+ * OSP object attribute.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] reply pointer to the RPC reply
+ * \param[in] req pointer to the RPC request
+ * \param[in] obj pointer to the OSP object
+ * \param[out] data pointer to buffer to hold the output attribute
+ * \param[in] index the index of the attribute buffer in the reply
+ * \param[in] rc the result for handling the RPC
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_attr_get_interpterer(const struct lu_env *env,
struct object_update_reply *reply,
struct ptlrpc_request *req,
return 0;
}
+/**
+ * Implement OSP layer dt_object_operations::do_declare_attr_get() interface.
+ *
+ * Declare that the caller will get attribute from the specified OST object.
+ *
+ * This function adds an Object Unified Target (OUT) sub-request to the per-OSP
+ * based shared asynchronous request queue. The osp_attr_get_interpterer()
+ * is registered as the interpreter function to handle the result of this
+ * sub-request.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_declare_attr_get(const struct lu_env *env, struct dt_object *dt,
struct lustre_capa *capa)
{
return rc;
}
+/**
+ * Implement OSP layer dt_object_operations::do_attr_get() interface.
+ *
+ * Get attribute from the specified MDT/OST object.
+ *
+ * If the attribute is in the OSP object attributes cache, then return
+ * the cached attribute directly. Otherwise it will trigger an OUT RPC
+ * to the peer to get the attribute synchronously, if successful, add it
+ * to the OSP attributes cache. (\see lustre/osp/osp_trans.c for OUT RPC.)
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[out] attr pointer to the buffer to hold the output attribute
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_attr_get(const struct lu_env *env, struct dt_object *dt,
struct lu_attr *attr, struct lustre_capa *capa)
{
spin_unlock(&obj->opo_lock);
}
- update = out_create_update_req(dev);
+ update = dt_update_request_create(dev);
if (IS_ERR(update))
RETURN(PTR_ERR(update));
- rc = out_insert_update(env, update, OUT_ATTR_GET,
- lu_object_fid(&dt->do_lu), 0, NULL, NULL);
+ rc = out_attr_get_pack(env, &update->dur_buf,
+ lu_object_fid(&dt->do_lu));
if (rc != 0) {
CERROR("%s: Insert update error "DFID": rc = %d\n",
dev->dd_lu_dev.ld_obd->obd_name,
if (req != NULL)
ptlrpc_req_finished(req);
- out_destroy_update_req(update);
+ dt_update_request_destroy(update);
return rc;
}
-static int osp_declare_attr_set(const struct lu_env *env, struct dt_object *dt,
- const struct lu_attr *attr, struct thandle *th)
+static int __osp_attr_set(const struct lu_env *env, struct dt_object *dt,
+ const struct lu_attr *attr, struct thandle *th)
{
struct osp_device *d = lu2osp_dev(dt->do_lu.lo_dev);
struct osp_object *o = dt2osp_obj(dt);
struct lu_attr *la;
int rc = 0;
-
ENTRY;
/*
* Usually we don't allow server stack to manipulate size
* but there is a special case when striping is created
- * late, after stripless file got truncated to non-zero.
+ * late, after stripeless file got truncated to non-zero.
*
* In this case we do the following:
*
RETURN(rc);
}
- if (o->opo_new) {
+ if (o->opo_new)
/* no need in logging for new objects being created */
RETURN(0);
- }
if (!(attr->la_valid & (LA_UID | LA_GID)))
RETURN(0);
if (rc != 0 || o->opo_ooa == NULL)
RETURN(rc);
+ /* Update the OSP object attributes cache. */
la = &o->opo_ooa->ooa_attr;
spin_lock(&o->opo_lock);
if (attr->la_valid & LA_UID) {
RETURN(0);
}
+/**
+ * Implement OSP layer dt_object_operations::do_declare_attr_set() interface.
+ * XXX: NOT prepare set_{attr,xattr} RPC for remote transaction.
+ *
+ * According to our current transaction/dt_object_lock framework (to make
+ * the cross-MDTs modification for DNE1 to be workable), the transaction
+ * sponsor will start the transaction firstly, then try to acquire related
+ * dt_object_lock if needed. Under such rules, if we want to prepare the
+ * set_{attr,xattr} RPC in the RPC declare phase, then related attr/xattr
+ * should be known without dt_object_lock. But such condition maybe not
+ * true for some remote transaction case. For example:
+ *
+ * For linkEA repairing (by LFSCK) case, before the LFSCK thread obtained
+ * the dt_object_lock on the target MDT-object, it cannot know whether
+ * the MDT-object has linkEA or not, neither invalid or not.
+ *
+ * Since the LFSCK thread cannot hold dt_object_lock before the (remote)
+ * transaction start (otherwise there will be some potential deadlock),
+ * it cannot prepare related RPC for repairing during the declare phase
+ * as other normal transactions do.
+ *
+ * To resolve the trouble, we will make OSP to prepare related RPC
+ * (set_attr/set_xattr/del_xattr) after remote transaction started,
+ * and trigger the remote updating (RPC sending) when trans_stop.
+ * Then the up layer users, such as LFSCK, can follow the general
+ * rule to handle trans_start/dt_object_lock for repairing linkEA
+ * inconsistency without distinguishing remote MDT-object.
+ *
+ * In fact, above solution for remote transaction should be the normal
+ * model without considering DNE1. The trouble brought by DNE1 will be
+ * resolved in DNE2. At that time, this patch can be removed.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] attr pointer to the attribute to be set
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
+static int osp_declare_attr_set(const struct lu_env *env, struct dt_object *dt,
+ const struct lu_attr *attr, struct thandle *th)
+{
+ int rc = 0;
+
+ if (!is_only_remote_trans(th))
+ rc = __osp_attr_set(env, dt, attr, th);
+
+ return rc;
+}
+
+/**
+ * Implement OSP layer dt_object_operations::do_attr_set() interface.
+ *
+ * Set attribute to the specified OST object.
+ *
+ * If the transaction is a remote transaction, then related modification
+ * sub-request has been added in the declare phase and related OUT RPC
+ * has been triggered at transaction start. Otherwise it will generate
+ * a MDS_SETATTR64_REC record in the llog. There is a dedicated thread
+ * to handle the llog asynchronously.
+ *
+ * If the attribute entry exists in the OSP object attributes cache,
+ * then update the cached attribute according to given attribute.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] attr pointer to the attribute to be set
+ * \param[in] th pointer to the transaction handler
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_attr_set(const struct lu_env *env, struct dt_object *dt,
const struct lu_attr *attr, struct thandle *th,
struct lustre_capa *capa)
{
struct osp_object *o = dt2osp_obj(dt);
int rc = 0;
-
ENTRY;
+ if (is_only_remote_trans(th)) {
+ rc = __osp_attr_set(env, dt, attr, th);
+ if (rc != 0)
+ RETURN(rc);
+ }
+
/* we're interested in uid/gid changes only */
if (!(attr->la_valid & (LA_UID | LA_GID)))
RETURN(0);
RETURN(rc);
}
+/**
+ * Interpreter function for getting OSP object extended attribute asynchronously
+ *
+ * Called to interpret the result of an async mode RPC for getting the
+ * OSP object extended attribute.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] reply pointer to the RPC reply
+ * \param[in] req pointer to the RPC request
+ * \param[in] obj pointer to the OSP object
+ * \param[out] data pointer to OSP object attributes cache
+ * \param[in] index the index of the attribute buffer in the reply
+ * \param[in] rc the result for handling the RPC
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_xattr_get_interpterer(const struct lu_env *env,
struct object_update_reply *reply,
struct ptlrpc_request *req,
return 0;
}
+/**
+ * Implement OSP dt_object_operations::do_declare_xattr_get() interface.
+ *
+ * Declare that the caller will get extended attribute from the specified
+ * OST object.
+ *
+ * This function will add an OUT_XATTR_GET sub-request to the per OSP
+ * based shared asynchronous request queue with the interpreter function:
+ * osp_xattr_get_interpterer().
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[out] buf pointer to the lu_buf to hold the extended attribute
+ * \param[in] name the name for the expected extended attribute
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_declare_xattr_get(const struct lu_env *env, struct dt_object *dt,
struct lu_buf *buf, const char *name,
struct lustre_capa *capa)
struct osp_object *obj = dt2osp_obj(dt);
struct osp_device *osp = lu2osp_dev(dt->do_lu.lo_dev);
struct osp_xattr_entry *oxe;
- int namelen = strlen(name);
+ __u16 namelen = strlen(name);
int rc = 0;
LASSERT(buf != NULL);
mutex_lock(&osp->opd_async_requests_mutex);
rc = osp_insert_async_request(env, OUT_XATTR_GET, obj, 1,
- &namelen, &name, oxe,
+ &namelen, (const void **)&name, oxe,
osp_xattr_get_interpterer);
if (rc != 0) {
mutex_unlock(&osp->opd_async_requests_mutex);
*
* We will improve it in the future. */
update = osp->opd_async_requests;
- if (update != NULL && update->dur_req != NULL &&
- update->dur_req->ourq_count > 0) {
+ if (update != NULL && update->dur_buf.ub_req != NULL &&
+ update->dur_buf.ub_req->ourq_count > 0) {
osp->opd_async_requests = NULL;
mutex_unlock(&osp->opd_async_requests_mutex);
rc = osp_unplug_async_request(env, osp, update);
return rc;
}
+/**
+ * Implement OSP layer dt_object_operations::do_xattr_get() interface.
+ *
+ * Get extended attribute from the specified MDT/OST object.
+ *
+ * If the extended attribute is in the OSP object attributes cache, then
+ * return the cached extended attribute directly. Otherwise it will get
+ * the extended attribute synchronously, if successful, add it to the OSP
+ * attributes cache. (\see lustre/osp/osp_trans.c for OUT RPC.)
+ *
+ * There is a race condition: some other thread has added the named extended
+ * attributed entry to the OSP object attributes cache during the current
+ * OUT_XATTR_GET handling. If such case happens, the OSP will replace the
+ * (just) existing extended attribute entry with the new replied one.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[out] buf pointer to the lu_buf to hold the extended attribute
+ * \param[in] name the name for the expected extended attribute
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_xattr_get(const struct lu_env *env, struct dt_object *dt,
struct lu_buf *buf, const char *name,
struct lustre_capa *capa)
struct object_update_reply *reply;
struct osp_xattr_entry *oxe = NULL;
const char *dname = dt->do_lu.lo_dev->ld_obd->obd_name;
- int namelen;
int rc = 0;
ENTRY;
LASSERT(buf != NULL);
LASSERT(name != NULL);
+ if (OBD_FAIL_CHECK(OBD_FAIL_LFSCK_BAD_NETWORK) &&
+ osp->opd_index == cfs_fail_val) {
+ if (is_ost_obj(&dt->do_lu)) {
+ if (osp_dev2node(osp) == cfs_fail_val)
+ RETURN(-ENOTCONN);
+ } else {
+ if (strcmp(name, XATTR_NAME_LINK) == 0)
+ RETURN(-ENOTCONN);
+ }
+ }
+
if (unlikely(obj->opo_non_exist))
RETURN(-ENOENT);
- oxe = osp_oac_xattr_find(obj, name);
+ oxe = osp_oac_xattr_find(obj, name, false);
if (oxe != NULL) {
spin_lock(&obj->opo_lock);
if (oxe->oxe_ready) {
spin_unlock(&obj->opo_lock);
}
- update = out_create_update_req(dev);
+ update = dt_update_request_create(dev);
if (IS_ERR(update))
GOTO(out, rc = PTR_ERR(update));
- namelen = strlen(name) + 1;
- rc = out_insert_update(env, update, OUT_XATTR_GET,
- lu_object_fid(&dt->do_lu), 1, &namelen, &name);
+ rc = out_xattr_get_pack(env, &update->dur_buf,
+ lu_object_fid(&dt->do_lu), name);
if (rc != 0) {
CERROR("%s: Insert update error "DFID": rc = %d\n",
dname, PFID(lu_object_fid(&dt->do_lu)), rc);
-
GOTO(out, rc);
}
rc = out_remote_sync(env, osp->opd_obd->u.cli.cl_import, update, &req);
if (rc != 0) {
+ if (rc == -ENOENT) {
+ dt->do_lu.lo_header->loh_attr &= ~LOHA_EXISTS;
+ obj->opo_non_exist = 1;
+ }
+
if (obj->opo_ooa == NULL)
GOTO(out, rc);
ptlrpc_req_finished(req);
if (update != NULL && !IS_ERR(update))
- out_destroy_update_req(update);
+ dt_update_request_destroy(update);
if (oxe != NULL)
osp_oac_xattr_put(oxe);
return rc;
}
-int osp_declare_xattr_set(const struct lu_env *env, struct dt_object *dt,
- const struct lu_buf *buf, const char *name,
- int flag, struct thandle *th)
+static int __osp_xattr_set(const struct lu_env *env, struct dt_object *dt,
+ const struct lu_buf *buf, const char *name,
+ int flag, struct thandle *th)
{
- struct osp_object *o = dt2osp_obj(dt);
+ struct osp_object *o = dt2osp_obj(dt);
struct dt_update_request *update;
- struct lu_fid *fid;
struct osp_xattr_entry *oxe;
- int sizes[3] = {strlen(name), buf->lb_len,
- sizeof(int)};
- char *bufs[3] = {(char *)name, (char *)buf->lb_buf };
int rc;
+ ENTRY;
LASSERT(buf->lb_len > 0 && buf->lb_buf != NULL);
- update = out_find_create_update_loc(th, dt);
+ update = dt_update_request_find_or_create(th, dt);
if (IS_ERR(update)) {
CERROR("%s: Get OSP update buf failed "DFID": rc = %d\n",
dt->do_lu.lo_dev->ld_obd->obd_name,
PFID(lu_object_fid(&dt->do_lu)),
(int)PTR_ERR(update));
- return PTR_ERR(update);
+ RETURN(PTR_ERR(update));
}
- flag = cpu_to_le32(flag);
- bufs[2] = (char *)&flag;
-
- fid = (struct lu_fid *)lu_object_fid(&dt->do_lu);
- rc = out_insert_update(env, update, OUT_XATTR_SET, fid,
- ARRAY_SIZE(sizes), sizes, (const char **)bufs);
+ rc = out_xattr_set_pack(env, &update->dur_buf,
+ lu_object_fid(&dt->do_lu),
+ buf, name, flag, update->dur_batchid);
if (rc != 0 || o->opo_ooa == NULL)
- return rc;
+ RETURN(rc);
oxe = osp_oac_xattr_find_or_add(o, name, buf->lb_len);
if (oxe == NULL) {
- CWARN("%s: Fail to add xattr (%s) to cache for "DFID
- ": rc = %d\n", dt->do_lu.lo_dev->ld_obd->obd_name,
- name, PFID(lu_object_fid(&dt->do_lu)), rc);
+ CWARN("%s: Fail to add xattr (%s) to cache for "DFID,
+ dt->do_lu.lo_dev->ld_obd->obd_name,
+ name, PFID(lu_object_fid(&dt->do_lu)));
- return 0;
+ RETURN(0);
}
if (oxe->oxe_buflen - oxe->oxe_namelen - 1 < buf->lb_len) {
osp_oac_xattr_put(oxe);
oxe = tmp;
if (tmp == NULL) {
- CWARN("%s: Fail to update xattr (%s) to cache for "DFID
- ": rc = %d\n", dt->do_lu.lo_dev->ld_obd->obd_name,
- name, PFID(lu_object_fid(&dt->do_lu)), rc);
+ CWARN("%s: Fail to update xattr (%s) to cache for "DFID,
+ dt->do_lu.lo_dev->ld_obd->obd_name,
+ name, PFID(lu_object_fid(&dt->do_lu)));
spin_lock(&o->opo_lock);
old->oxe_ready = 0;
spin_unlock(&o->opo_lock);
- return 0;
+ RETURN(0);
}
/* Drop the ref for entry on list. */
spin_unlock(&o->opo_lock);
osp_oac_xattr_put(oxe);
- return 0;
+ RETURN(0);
}
+/**
+ * Implement OSP layer dt_object_operations::do_declare_xattr_set() interface.
+ *
+ * Declare that the caller will set extended attribute to the specified
+ * MDT/OST object.
+ *
+ * This function will add an OUT_XATTR_SET sub-request to the per
+ * OSP-transaction based request queue which will be flushed when
+ * the transaction starts.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] buf pointer to the lu_buf to hold the extended attribute
+ * \param[in] name the name of the extended attribute to be set
+ * \param[in] flag to indicate the detailed set operation: LU_XATTR_CREATE
+ * or LU_XATTR_REPLACE or others
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
+int osp_declare_xattr_set(const struct lu_env *env, struct dt_object *dt,
+ const struct lu_buf *buf, const char *name,
+ int flag, struct thandle *th)
+{
+ int rc = 0;
+
+ /* Please check the comment in osp_attr_set() for handling
+ * remote transaction. */
+ if (!is_only_remote_trans(th))
+ rc = __osp_xattr_set(env, dt, buf, name, flag, th);
+
+ return rc;
+}
+
+/**
+ * Implement OSP layer dt_object_operations::do_xattr_set() interface.
+ *
+ * Set extended attribute to the specified MDT/OST object.
+ *
+ * The real modification sub-request has been added in the declare phase
+ * and related (OUT) RPC has been triggered when transaction start.
+ *
+ * If the OSP attributes cache is initialized, then check whether the name
+ * extended attribute entry exists in the cache or not. If yes, replace it;
+ * otherwise, add the extended attribute to the cache.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] buf pointer to the lu_buf to hold the extended attribute
+ * \param[in] name the name of the extended attribute to be set
+ * \param[in] fl to indicate the detailed set operation: LU_XATTR_CREATE
+ * or LU_XATTR_REPLACE or others
+ * \param[in] th pointer to the transaction handler
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_xattr_set(const struct lu_env *env, struct dt_object *dt,
const struct lu_buf *buf, const char *name, int fl,
struct thandle *th, struct lustre_capa *capa)
{
+ int rc = 0;
+
CDEBUG(D_INFO, "xattr %s set object "DFID"\n", name,
PFID(&dt->do_lu.lo_header->loh_fid));
- return 0;
+ /* Please check the comment in osp_attr_set() for handling
+ * remote transaction. */
+ if (is_only_remote_trans(th))
+ rc = __osp_xattr_set(env, dt, buf, name, fl, th);
+
+ return rc;
}
-int osp_declare_xattr_del(const struct lu_env *env, struct dt_object *dt,
- const char *name, struct thandle *th)
+static int __osp_xattr_del(const struct lu_env *env, struct dt_object *dt,
+ const char *name, struct thandle *th)
{
struct dt_update_request *update;
const struct lu_fid *fid;
- int size = strlen(name);
- int rc;
+ struct osp_object *o = dt2osp_obj(dt);
+ struct osp_xattr_entry *oxe;
+ int rc;
- update = out_find_create_update_loc(th, dt);
+ update = dt_update_request_find_or_create(th, dt);
if (IS_ERR(update))
return PTR_ERR(update);
fid = lu_object_fid(&dt->do_lu);
- rc = out_insert_update(env, update, OUT_XATTR_DEL, fid, 1, &size,
- (const char **)&name);
+ rc = out_xattr_del_pack(env, &update->dur_buf, fid, name,
+ update->dur_batchid);
+
+ if (rc != 0 || o->opo_ooa == NULL)
+ return rc;
+
+ oxe = osp_oac_xattr_find(o, name, true);
+ if (oxe != NULL)
+ /* Drop the ref for entry on list. */
+ osp_oac_xattr_put(oxe);
+
+ return 0;
+}
+
+/**
+ * Implement OSP layer dt_object_operations::do_declare_xattr_del() interface.
+ *
+ * Declare that the caller will delete extended attribute on the specified
+ * MDT/OST object.
+ *
+ * This function will add an OUT_XATTR_DEL sub-request to the per
+ * OSP-transaction based request queue which will be flushed when
+ * transaction start.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] name the name of the extended attribute to be set
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
+int osp_declare_xattr_del(const struct lu_env *env, struct dt_object *dt,
+ const char *name, struct thandle *th)
+{
+ int rc = 0;
+
+ /* Please check the comment in osp_attr_set() for handling
+ * remote transaction. */
+ if (!is_only_remote_trans(th))
+ rc = __osp_xattr_del(env, dt, name, th);
return rc;
}
+/**
+ * Implement OSP layer dt_object_operations::do_xattr_del() interface.
+ *
+ * Delete extended attribute on the specified MDT/OST object.
+ *
+ * The real modification sub-request has been added in the declare phase
+ * and related (OUT) RPC has been triggered when transaction start.
+ *
+ * If the name extended attribute entry exists in the OSP attributes
+ * cache, then remove it from the cache.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] name the name of the extended attribute to be set
+ * \param[in] th pointer to the transaction handler
+ * \param[in] capa the capability for this operation
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_xattr_del(const struct lu_env *env, struct dt_object *dt,
const char *name, struct thandle *th,
struct lustre_capa *capa)
{
+ int rc = 0;
+
CDEBUG(D_INFO, "xattr %s del object "DFID"\n", name,
PFID(&dt->do_lu.lo_header->loh_fid));
- return 0;
+ /* Please check the comment in osp_attr_set() for handling
+ * remote transaction. */
+ if (is_only_remote_trans(th))
+ rc = __osp_xattr_del(env, dt, name, th);
+
+ return rc;
}
+/**
+ * Implement OSP layer dt_object_operations::do_declare_create() interface.
+ *
+ * Declare that the caller will create the OST object.
+ *
+ * If the transaction is a remote transaction (please refer to the
+ * comment of osp_trans_create() for remote transaction), then the FID
+ * for the OST object has been assigned already, and will be handled
+ * as create (remote) MDT object via osp_md_declare_object_create().
+ * This function is usually used for LFSCK to re-create the lost OST
+ * object. Otherwise, if it is not replay case, the OSP will reserve
+ * pre-created object for the subsequent create operation; if the MDT
+ * side cached pre-created objects are less than some threshold, then
+ * it will wakeup the pre-create thread.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] attr the attribute for the object to be created
+ * \param[in] hint pointer to the hint for creating the object, such as
+ * the parent object
+ * \param[in] dof pointer to the dt_object_format for help the creation
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_declare_object_create(const struct lu_env *env,
struct dt_object *dt,
struct lu_attr *attr,
RETURN(rc);
}
+/**
+ * Implement OSP layer dt_object_operations::do_create() interface.
+ *
+ * Create the OST object.
+ *
+ * For remote transaction case, the real create sub-request has been
+ * added in the declare phase and related (OUT) RPC has been triggered
+ * at transaction start. Here, like creating (remote) MDT object, the
+ * OSP will mark the object existence via osp_md_object_create().
+ *
+ * For non-remote transaction case, the OSP will assign FID to the
+ * object to be created, and update last_used Object ID (OID) file.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] attr the attribute for the object to be created
+ * \param[in] hint pointer to the hint for creating the object, such as
+ * the parent object
+ * \param[in] dof pointer to the dt_object_format for help the creation
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_object_create(const struct lu_env *env, struct dt_object *dt,
struct lu_attr *attr,
struct dt_allocation_hint *hint,
o->opo_non_exist = 0;
if (o->opo_reserved) {
- /* regular case, fid is assigned holding trunsaction open */
+ /* regular case, fid is assigned holding transaction open */
osp_object_assign_fid(env, d, o);
}
d->opd_gap_count = 0;
spin_unlock(&d->opd_pre_lock);
- CDEBUG(D_HA, "Writting gap "DFID"+%d in llog\n",
+ CDEBUG(D_HA, "Writing gap "DFID"+%d in llog\n",
PFID(&d->opd_gap_start_fid), count);
/* real gap handling is disabled intil ORI-692 will be
* fixed, now we only report gaps */
RETURN(rc);
}
+/**
+ * Implement OSP layer dt_object_operations::do_declare_destroy() interface.
+ *
+ * Declare that the caller will destroy the specified OST object.
+ *
+ * The OST object destroy will be handled via llog asynchronously. This
+ * function will declare the credits for generating MDS_UNLINK64_REC llog.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object to be destroyed
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_declare_object_destroy(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
RETURN(rc);
}
+/**
+ * Implement OSP layer dt_object_operations::do_destroy() interface.
+ *
+ * Destroy the specified OST object.
+ *
+ * The OSP generates a MDS_UNLINK64_REC record in the llog. There
+ * will be some dedicated thread to handle the llog asynchronously.
+ *
+ * It also marks the object as non-cached.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object to be destroyed
+ * \param[in] th pointer to the transaction handler
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_object_destroy(const struct lu_env *env, struct dt_object *dt,
struct thandle *th)
{
return -EOPNOTSUPP;
}
+/**
+ * Initialize the OSP layer index iteration.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the index object to be iterated
+ * \param[in] attr unused
+ * \param[in] capa the capability for this operation
+ *
+ * \retval pointer to the iteration structure
+ * \retval negative error number on failure
+ */
struct dt_it *osp_it_init(const struct lu_env *env, struct dt_object *dt,
__u32 attr, struct lustre_capa *capa)
{
return (struct dt_it *)it;
}
+/**
+ * Finalize the OSP layer index iteration.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] di pointer to the iteration structure
+ */
void osp_it_fini(const struct lu_env *env, struct dt_it *di)
{
struct osp_it *it = (struct osp_it *)di;
OBD_FREE_PTR(it);
}
+/**
+ * Get more records for the iteration from peer.
+ *
+ * The new records will be filled in an array of pages. The OSP side
+ * allows 1MB bulk data to be transfered.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] it pointer to the iteration structure
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_it_fetch(const struct lu_env *env, struct osp_it *it)
{
struct lu_device *dev = it->ooi_obj->do_lu.lo_dev;
ii->ii_magic = IDX_INFO_MAGIC;
ii->ii_count = npages * LU_PAGE_COUNT;
ii->ii_hash_start = it->ooi_next;
- ii->ii_attrs =
- osp->opd_storage->dd_lu_dev.ld_site->ld_seq_site->ss_node_id;
+ ii->ii_attrs = osp_dev2node(osp);
ptlrpc_at_set_req_timeout(req);
return rc;
}
+/**
+ * Move the iteration cursor to the next lu_page.
+ *
+ * One system page (PAGE_SIZE) may contain multiple lu_page (4KB),
+ * that depends on the LU_PAGE_COUNT. If it is not the last lu_page
+ * in current system page, then move the iteration cursor to the next
+ * lu_page in current system page. Otherwise, if there are more system
+ * pages in the cache, then move the iteration cursor to the next system
+ * page. If all the cached records (pages) have been iterated, then fetch
+ * more records via osp_it_fetch().
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] di pointer to the iteration structure
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_it_next_page(const struct lu_env *env, struct dt_it *di)
{
struct osp_it *it = (struct osp_it *)di;
RETURN(rc);
}
+/**
+ * Move the iteration cursor to the next record.
+ *
+ * If there are more records in the lu_page, then move the iteration
+ * cursor to the next record directly. Otherwise, move the iteration
+ * cursor to the record in the next lu_page via osp_it_next_page()
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] di pointer to the iteration structure
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
int osp_orphan_it_next(const struct lu_env *env, struct dt_it *di)
{
struct osp_it *it = (struct osp_it *)di;
}
/**
- * \retval +1: locate to the exactly position
- * \retval 0: cannot locate to the exactly position,
- * call next() to move to a valid position.
- * \retval -ve: on error
+ * Locate the iteration cursor to the specified position (cookie).
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] di pointer to the iteration structure
+ * \param[in] hash the specified position
+ *
+ * \retval positive number for locating to the exactly position
+ * or the next
+ * \retval 0 for arriving at the end of the iteration
+ * \retval negative error number on failure
*/
int osp_orphan_it_load(const struct lu_env *env, const struct dt_it *di,
- __u64 hash)
+ __u64 hash)
{
struct osp_it *it = (struct osp_it *)di;
- int rc;
+ int rc;
it->ooi_next = hash;
rc = osp_orphan_it_next(env, (struct dt_it *)di);
}
};
+/**
+ * Implement OSP layer dt_object_operations::do_index_try() interface.
+ *
+ * Negotiate the index type.
+ *
+ * If the target index is an IDIF object, then use osp_orphan_index_ops.
+ * Otherwise, assign osp_md_index_ops to the dt_object::do_index_ops.
+ * (\see lustre/include/lustre_fid.h for IDIF.)
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] dt pointer to the OSP layer dt_object
+ * \param[in] feat unused
+ *
+ * \retval 0 for success
+ */
static int osp_index_try(const struct lu_env *env,
struct dt_object *dt,
const struct dt_index_features *feat)
.do_index_try = osp_index_try,
};
+/**
+ * Implement OSP layer lu_object_operations::loo_object_init() interface.
+ *
+ * Initialize the object.
+ *
+ * If it is a remote MDT object, then call do_attr_get() to fetch
+ * the attribute from the peer.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] o pointer to the OSP layer lu_object
+ * \param[in] conf unused
+ *
+ * \retval 0 for success
+ * \retval negative error number on failure
+ */
static int osp_object_init(const struct lu_env *env, struct lu_object *o,
const struct lu_object_conf *conf)
{
RETURN(rc);
}
+/**
+ * Implement OSP layer lu_object_operations::loo_object_free() interface.
+ *
+ * Finalize the object.
+ *
+ * If the OSP object has attributes cache, then destroy the cache.
+ * Free the object finally.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] o pointer to the OSP layer lu_object
+ */
static void osp_object_free(const struct lu_env *env, struct lu_object *o)
{
struct osp_object *obj = lu2osp_obj(o);
OBD_SLAB_FREE_PTR(obj, osp_object_kmem);
}
+/**
+ * Implement OSP layer lu_object_operations::loo_object_release() interface.
+ *
+ * Cleanup (not free) the object.
+ *
+ * If it is a reserved object but failed to be created, or it is an OST
+ * object, then mark the object as non-cached.
+ *
+ * \param[in] env pointer to the thread context
+ * \param[in] o pointer to the OSP layer lu_object
+ */
static void osp_object_release(const struct lu_env *env, struct lu_object *o)
{
struct osp_object *po = lu2osp_obj(o);
git://git.whamcloud.com / fs / lustre-release.git / blobdiff