* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 only,
* as published by the Free Software Foundation.
-
+ *
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License version 2 for more details. A copy is
* included in the COPYING file that accompanied this code.
-
+ *
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
* Copyright 2009 Sun Microsystems, Inc. All rights reserved
* Use is subject to license terms.
*
- * Copyright (c) 2012, 2013, Intel Corporation.
+ * Copyright (c) 2012, 2014, Intel Corporation.
*/
/*
* lustre/lod/lod_object.c
*
+ * This file contains implementations of methods for the OSD API
+ * for the Logical Object Device (LOD) layer, which provides a virtual
+ * local OSD object interface to the MDD layer, and abstracts the
+ * addressing of local (OSD) and remote (OSP) objects. The API is
+ * described in the file lustre/include/dt_object.h and in
+ * lustre/doc/osd-api.txt.
+ *
* Author: Alex Zhuravlev <alexey.zhuravlev@intel.com>
*/
#include <lustre_fid.h>
#include <lustre_lmv.h>
#include <md_object.h>
+#include <lustre_linkea.h>
#include "lod_internal.h"
static const char dot[] = ".";
static const char dotdot[] = "..";
-extern struct kmem_cache *lod_object_kmem;
static const struct dt_body_operations lod_body_lnk_ops;
+/**
+ * Implementation of dt_index_operations::dio_lookup
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_index_operations::dio_lookup() in the API description for details.
+ */
static int lod_index_lookup(const struct lu_env *env, struct dt_object *dt,
struct dt_rec *rec, const struct dt_key *key,
struct lustre_capa *capa)
return next->do_index_ops->dio_lookup(env, next, rec, key, capa);
}
+/**
+ * Implementation of dt_index_operations::dio_declare_insert.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_index_operations::dio_declare_insert() in the API description
+ * for details.
+ */
static int lod_declare_index_insert(const struct lu_env *env,
struct dt_object *dt,
const struct dt_rec *rec,
return dt_declare_insert(env, dt_object_child(dt), rec, key, handle);
}
+/**
+ * Implementation of dt_index_operations::dio_insert.
+ *
+ * Used with regular (non-striped) objects
+ *
+ * \see dt_index_operations::dio_insert() in the API description for details.
+ */
static int lod_index_insert(const struct lu_env *env,
struct dt_object *dt,
const struct dt_rec *rec,
return dt_insert(env, dt_object_child(dt), rec, key, th, capa, ign);
}
+/**
+ * Implementation of dt_index_operations::dio_declare_delete.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_index_operations::dio_declare_delete() in the API description
+ * for details.
+ */
static int lod_declare_index_delete(const struct lu_env *env,
struct dt_object *dt,
const struct dt_key *key,
return dt_declare_delete(env, dt_object_child(dt), key, th);
}
+/**
+ * Implementation of dt_index_operations::dio_delete.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_index_operations::dio_delete() in the API description for details.
+ */
static int lod_index_delete(const struct lu_env *env,
struct dt_object *dt,
const struct dt_key *key,
return dt_delete(env, dt_object_child(dt), key, th, capa);
}
+/**
+ * Implementation of dt_it_ops::init.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::init() in the API description for details.
+ */
static struct dt_it *lod_it_init(const struct lu_env *env,
struct dt_object *dt, __u32 attr,
struct lustre_capa *capa)
LASSERT((it)->lit_it != NULL); \
} while (0)
-void lod_it_fini(const struct lu_env *env, struct dt_it *di)
+/**
+ * Implementation of dt_index_operations::dio_it.fini.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_index_operations::dio_it.fini() in the API description for details.
+ */
+static void lod_it_fini(const struct lu_env *env, struct dt_it *di)
{
struct lod_it *it = (struct lod_it *)di;
it->lit_it = NULL;
}
-int lod_it_get(const struct lu_env *env, struct dt_it *di,
- const struct dt_key *key)
+/**
+ * Implementation of dt_it_ops::get.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::get() in the API description for details.
+ */
+static int lod_it_get(const struct lu_env *env, struct dt_it *di,
+ const struct dt_key *key)
{
const struct lod_it *it = (const struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.get(env, it->lit_it, key);
}
-void lod_it_put(const struct lu_env *env, struct dt_it *di)
+/**
+ * Implementation of dt_it_ops::put.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::put() in the API description for details.
+ */
+static void lod_it_put(const struct lu_env *env, struct dt_it *di)
{
struct lod_it *it = (struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.put(env, it->lit_it);
}
-int lod_it_next(const struct lu_env *env, struct dt_it *di)
+/**
+ * Implementation of dt_it_ops::next.
+ *
+ * Used with regular (non-striped) objects
+ *
+ * \see dt_it_ops::next() in the API description for details.
+ */
+static int lod_it_next(const struct lu_env *env, struct dt_it *di)
{
struct lod_it *it = (struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.next(env, it->lit_it);
}
-struct dt_key *lod_it_key(const struct lu_env *env, const struct dt_it *di)
+/**
+ * Implementation of dt_it_ops::key.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::key() in the API description for details.
+ */
+static struct dt_key *lod_it_key(const struct lu_env *env,
+ const struct dt_it *di)
{
const struct lod_it *it = (const struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.key(env, it->lit_it);
}
-int lod_it_key_size(const struct lu_env *env, const struct dt_it *di)
+/**
+ * Implementation of dt_it_ops::key_size.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::key_size() in the API description for details.
+ */
+static int lod_it_key_size(const struct lu_env *env, const struct dt_it *di)
{
struct lod_it *it = (struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.key_size(env, it->lit_it);
}
-int lod_it_rec(const struct lu_env *env, const struct dt_it *di,
- struct dt_rec *rec, __u32 attr)
+/**
+ * Implementation of dt_it_ops::rec.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::rec() in the API description for details.
+ */
+static int lod_it_rec(const struct lu_env *env, const struct dt_it *di,
+ struct dt_rec *rec, __u32 attr)
{
const struct lod_it *it = (const struct lod_it *)di;
attr);
}
-int lod_it_rec_size(const struct lu_env *env, const struct dt_it *di,
- __u32 attr)
+/**
+ * Implementation of dt_it_ops::rec_size.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::rec_size() in the API description for details.
+ */
+static int lod_it_rec_size(const struct lu_env *env, const struct dt_it *di,
+ __u32 attr)
{
const struct lod_it *it = (const struct lod_it *)di;
attr);
}
-__u64 lod_it_store(const struct lu_env *env, const struct dt_it *di)
+/**
+ * Implementation of dt_it_ops::store.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::store() in the API description for details.
+ */
+static __u64 lod_it_store(const struct lu_env *env, const struct dt_it *di)
{
const struct lod_it *it = (const struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.store(env, it->lit_it);
}
-int lod_it_load(const struct lu_env *env, const struct dt_it *di, __u64 hash)
+/**
+ * Implementation of dt_it_ops::load.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::load() in the API description for details.
+ */
+static int lod_it_load(const struct lu_env *env, const struct dt_it *di,
+ __u64 hash)
{
const struct lod_it *it = (const struct lod_it *)di;
return it->lit_obj->do_index_ops->dio_it.load(env, it->lit_it, hash);
}
-int lod_it_key_rec(const struct lu_env *env, const struct dt_it *di,
- void *key_rec)
+/**
+ * Implementation of dt_it_ops::key_rec.
+ *
+ * Used with regular (non-striped) objects.
+ *
+ * \see dt_it_ops::rec() in the API description for details.
+ */
+static int lod_it_key_rec(const struct lu_env *env, const struct dt_it *di,
+ void *key_rec)
{
const struct lod_it *it = (const struct lod_it *)di;
};
/**
- * Implementation of dt_index_operations:: dio_it.init
- *
- * This function is to initialize the iterator for striped directory,
- * basically these lod_striped_it_xxx will just locate the stripe
- * and call the correspondent api of its next lower layer.
+ * Implementation of dt_it_ops::init.
*
- * \param[in] env execution environment.
- * \param[in] dt the striped directory object to be iterated.
- * \param[in] attr the attribute of iterator, mostly used to indicate
- * the entry attribute in the object to be iterated.
- * \param[in] capa capability(useless in current implementation)
+ * Used with striped objects. Internally just initializes the iterator
+ * on the first stripe.
*
- * \retval initialized iterator(dt_it) if successful initialize the
- * iteration. lit_stripe_index will be used to indicate the
- * current iterate position among stripes.
- * \retval ERR pointer if initialization is failed.
+ * \see dt_it_ops::init() in the API description for details.
*/
static struct dt_it *lod_striped_it_init(const struct lu_env *env,
struct dt_object *dt, __u32 attr,
} while (0)
/**
- * Implementation of dt_index_operations:: dio_it.fini
- *
- * This function is to finish the iterator for striped directory.
+ * Implementation of dt_it_ops::fini.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for the striped directory
+ * Used with striped objects.
*
+ * \see dt_it_ops::fini() in the API description for details.
*/
static void lod_striped_it_fini(const struct lu_env *env, struct dt_it *di)
{
}
/**
- * Implementation of dt_index_operations:: dio_it.get
+ * Implementation of dt_it_ops::get.
*
- * This function is to position the iterator with given key
+ * Right now it's not used widely, only to reset the iterator to the
+ * initial position. It should be possible to implement a full version
+ * which chooses a correct stripe to be able to position with any key.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- * \param[in] key the key the iterator will be positioned.
- *
- * \retval 0 if successfully position iterator by the key.
- * \retval negative error if position is failed.
+ * \see dt_it_ops::get() in the API description for details.
*/
static int lod_striped_it_get(const struct lu_env *env, struct dt_it *di,
const struct dt_key *key)
}
/**
- * Implementation of dt_index_operations:: dio_it.put
+ * Implementation of dt_it_ops::put.
+ *
+ * Used with striped objects.
*
- * This function is supposed to be the pair of it_get, but currently do
- * nothing. see (osd_it_ea_put or osd_index_it_put)
+ * \see dt_it_ops::put() in the API description for details.
*/
static void lod_striped_it_put(const struct lu_env *env, struct dt_it *di)
{
}
/**
- * Implementation of dt_index_operations:: dio_it.next
+ * Implementation of dt_it_ops::next.
*
- * This function is to position the iterator to the next entry, if current
- * stripe is finished by checking the return value of next() in current
- * stripe. it will go to next stripe. In the mean time, the sub-iterator
- * for next stripe needs to be initialized.
+ * Used with striped objects. When the end of the current stripe is
+ * reached, the method takes the next stripe's iterator.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- *
- * \retval 0 if successfully position iterator to the next entry.
- * \retval negative error if position is failed.
+ * \see dt_it_ops::next() in the API description for details.
*/
static int lod_striped_it_next(const struct lu_env *env, struct dt_it *di)
{
}
/**
- * Implementation of dt_index_operations:: dio_it.key
- *
- * This function is to get the key of the iterator at current position.
+ * Implementation of dt_it_ops::key.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
+ * Used with striped objects.
*
- * \retval key(dt_key) if successfully get the key.
- * \retval negative error if can not get the key.
+ * \see dt_it_ops::key() in the API description for details.
*/
static struct dt_key *lod_striped_it_key(const struct lu_env *env,
const struct dt_it *di)
}
/**
- * Implementation of dt_index_operations:: dio_it.key_size
+ * Implementation of dt_it_ops::key_size.
*
- * This function is to get the key_size of current key.
+ * Used with striped objects.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- *
- * \retval key_size if successfully get the key_size.
- * \retval negative error if can not get the key_size.
+ * \see dt_it_ops::size() in the API description for details.
*/
static int lod_striped_it_key_size(const struct lu_env *env,
const struct dt_it *di)
}
/**
- * Implementation of dt_index_operations:: dio_it.rec
- *
- * This function is to get the record at current position.
+ * Implementation of dt_it_ops::rec.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- * \param[in] attr the attribute of iterator, mostly used to indicate
- * the entry attribute in the object to be iterated.
- * \param[out] rec hold the return record.
+ * Used with striped objects.
*
- * \retval 0 if successfully get the entry.
- * \retval negative error if can not get entry.
+ * \see dt_it_ops::rec() in the API description for details.
*/
static int lod_striped_it_rec(const struct lu_env *env, const struct dt_it *di,
struct dt_rec *rec, __u32 attr)
}
/**
- * Implementation of dt_index_operations:: dio_it.rec_size
+ * Implementation of dt_it_ops::rec_size.
*
- * This function is to get the record_size at current record.
+ * Used with striped objects.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- * \param[in] attr the attribute of iterator, mostly used to indicate
- * the entry attribute in the object to be iterated.
- *
- * \retval rec_size if successfully get the entry size.
- * \retval negative error if can not get entry size.
+ * \see dt_it_ops::rec_size() in the API description for details.
*/
static int lod_striped_it_rec_size(const struct lu_env *env,
const struct dt_it *di, __u32 attr)
}
/**
- * Implementation of dt_index_operations:: dio_it.store
- *
- * This function will a cookie for current position of the iterator head,
- * so that user can use this cookie to load/start the iterator next time.
+ * Implementation of dt_it_ops::store.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
+ * Used with striped objects.
*
- * \retval the cookie.
+ * \see dt_it_ops::store() in the API description for details.
*/
static __u64 lod_striped_it_store(const struct lu_env *env,
const struct dt_it *di)
}
/**
- * Implementation of dt_index_operations:: dio_it.load
+ * Implementation of dt_it_ops::load.
*
- * This function will position the iterator with the given hash(usually
- * get from store),
+ * Used with striped objects.
*
- * \param[in] env execution environment.
- * \param[in] di the iterator for striped directory.
- * \param[in] hash the given hash.
- *
- * \retval >0 if successfuly load the iterator to the given position.
- * \retval <0 if load is failed.
+ * \see dt_it_ops::load() in the API description for details.
*/
static int lod_striped_it_load(const struct lu_env *env,
const struct dt_it *di, __u64 hash)
};
/**
- * Implementation of dt_object_operations:: do_index_try
+ * Append the FID for each shard of the striped directory after the
+ * given LMV EA header.
+ *
+ * To simplify striped directory and the consistency verification,
+ * we only store the LMV EA header on disk, for both master object
+ * and slave objects. When someone wants to know the whole LMV EA,
+ * such as client readdir(), we can build the entrie LMV EA on the
+ * MDT side (in RAM) via iterating the sub-directory entries that
+ * are contained in the master object of the stripe directory.
+ *
+ * For the master object of the striped directroy, the valid name
+ * for each shard is composed of the ${shard_FID}:${shard_idx}.
+ *
+ * There may be holes in the LMV EA if some shards' name entries
+ * are corrupted or lost.
*
- * This function will try to initialize the index api pointer for the
- * given object, usually it the entry point of the index api. i.e.
- * the index object should be initialized in index_try, then start
- * using index api. For striped directory, it will try to initialize
- * all of its sub_stripes.
+ * \param[in] env pointer to the thread context
+ * \param[in] lo pointer to the master object of the striped directory
+ * \param[in] buf pointer to the lu_buf which will hold the LMV EA
+ * \param[in] resize whether re-allocate the buffer if it is not big enough
*
- * \param[in] env execution environment.
- * \param[in] dt the index object to be initialized.
- * \param[in] feat the features of this object, for example fixed or
- * variable key size etc.
+ * \retval positive size of the LMV EA
+ * \retval 0 for nothing to be loaded
+ * \retval negative error number on failure
+ */
+int lod_load_lmv_shards(const struct lu_env *env, struct lod_object *lo,
+ struct lu_buf *buf, bool resize)
+{
+ struct lu_dirent *ent =
+ (struct lu_dirent *)lod_env_info(env)->lti_key;
+ struct lod_device *lod = lu2lod_dev(lo->ldo_obj.do_lu.lo_dev);
+ struct dt_object *obj = dt_object_child(&lo->ldo_obj);
+ struct lmv_mds_md_v1 *lmv1 = buf->lb_buf;
+ struct dt_it *it;
+ const struct dt_it_ops *iops;
+ __u32 stripes;
+ __u32 magic = le32_to_cpu(lmv1->lmv_magic);
+ size_t lmv1_size;
+ int rc;
+ ENTRY;
+
+ /* If it is not a striped directory, then load nothing. */
+ if (magic != LMV_MAGIC_V1)
+ RETURN(0);
+
+ /* If it is in migration (or failure), then load nothing. */
+ if (le32_to_cpu(lmv1->lmv_hash_type) & LMV_HASH_FLAG_MIGRATION)
+ RETURN(0);
+
+ stripes = le32_to_cpu(lmv1->lmv_stripe_count);
+ if (stripes < 1)
+ RETURN(0);
+
+ rc = lmv_mds_md_size(stripes, magic);
+ if (rc < 0)
+ RETURN(rc);
+ lmv1_size = rc;
+ if (buf->lb_len < lmv1_size) {
+ struct lu_buf tbuf;
+
+ if (!resize)
+ RETURN(-ERANGE);
+
+ tbuf = *buf;
+ buf->lb_buf = NULL;
+ buf->lb_len = 0;
+ lu_buf_alloc(buf, lmv1_size);
+ lmv1 = buf->lb_buf;
+ if (lmv1 == NULL)
+ RETURN(-ENOMEM);
+
+ memcpy(buf->lb_buf, tbuf.lb_buf, tbuf.lb_len);
+ }
+
+ if (unlikely(!dt_try_as_dir(env, obj)))
+ RETURN(-ENOTDIR);
+
+ memset(&lmv1->lmv_stripe_fids[0], 0, stripes * sizeof(struct lu_fid));
+ iops = &obj->do_index_ops->dio_it;
+ it = iops->init(env, obj, LUDA_64BITHASH, BYPASS_CAPA);
+ if (IS_ERR(it))
+ RETURN(PTR_ERR(it));
+
+ rc = iops->load(env, it, 0);
+ if (rc == 0)
+ rc = iops->next(env, it);
+ else if (rc > 0)
+ rc = 0;
+
+ while (rc == 0) {
+ char name[FID_LEN + 2] = "";
+ struct lu_fid fid;
+ __u32 index;
+ int len;
+
+ rc = iops->rec(env, it, (struct dt_rec *)ent, LUDA_64BITHASH);
+ if (rc != 0)
+ break;
+
+ rc = -EIO;
+
+ fid_le_to_cpu(&fid, &ent->lde_fid);
+ ent->lde_namelen = le16_to_cpu(ent->lde_namelen);
+ if (ent->lde_name[0] == '.') {
+ if (ent->lde_namelen == 1)
+ goto next;
+
+ if (ent->lde_namelen == 2 && ent->lde_name[1] == '.')
+ goto next;
+ }
+
+ len = snprintf(name, FID_LEN + 1, DFID":", PFID(&ent->lde_fid));
+ /* The ent->lde_name is composed of ${FID}:${index} */
+ if (ent->lde_namelen < len + 1 ||
+ memcmp(ent->lde_name, name, len) != 0) {
+ CDEBUG(lod->lod_lmv_failout ? D_ERROR : D_INFO,
+ "%s: invalid shard name %.*s with the FID "DFID
+ " for the striped directory "DFID", %s\n",
+ lod2obd(lod)->obd_name, ent->lde_namelen,
+ ent->lde_name, PFID(&fid),
+ PFID(lu_object_fid(&obj->do_lu)),
+ lod->lod_lmv_failout ? "failout" : "skip");
+
+ if (lod->lod_lmv_failout)
+ break;
+
+ goto next;
+ }
+
+ index = 0;
+ do {
+ if (ent->lde_name[len] < '0' ||
+ ent->lde_name[len] > '9') {
+ CDEBUG(lod->lod_lmv_failout ? D_ERROR : D_INFO,
+ "%s: invalid shard name %.*s with the "
+ "FID "DFID" for the striped directory "
+ DFID", %s\n",
+ lod2obd(lod)->obd_name, ent->lde_namelen,
+ ent->lde_name, PFID(&fid),
+ PFID(lu_object_fid(&obj->do_lu)),
+ lod->lod_lmv_failout ?
+ "failout" : "skip");
+
+ if (lod->lod_lmv_failout)
+ break;
+
+ goto next;
+ }
+
+ index = index * 10 + ent->lde_name[len++] - '0';
+ } while (len < ent->lde_namelen);
+
+ if (len == ent->lde_namelen) {
+ /* Out of LMV EA range. */
+ if (index >= stripes) {
+ CERROR("%s: the shard %.*s for the striped "
+ "directory "DFID" is out of the known "
+ "LMV EA range [0 - %u], failout\n",
+ lod2obd(lod)->obd_name, ent->lde_namelen,
+ ent->lde_name,
+ PFID(lu_object_fid(&obj->do_lu)),
+ stripes - 1);
+
+ break;
+ }
+
+ /* The slot has been occupied. */
+ if (!fid_is_zero(&lmv1->lmv_stripe_fids[index])) {
+ struct lu_fid fid0;
+
+ fid_le_to_cpu(&fid0,
+ &lmv1->lmv_stripe_fids[index]);
+ CERROR("%s: both the shard "DFID" and "DFID
+ " for the striped directory "DFID
+ " claim the same LMV EA slot at the "
+ "index %d, failout\n",
+ lod2obd(lod)->obd_name,
+ PFID(&fid0), PFID(&fid),
+ PFID(lu_object_fid(&obj->do_lu)), index);
+
+ break;
+ }
+
+ /* stored as LE mode */
+ lmv1->lmv_stripe_fids[index] = ent->lde_fid;
+
+next:
+ rc = iops->next(env, it);
+ }
+ }
+
+ iops->put(env, it);
+ iops->fini(env, it);
+
+ RETURN(rc > 0 ? lmv_mds_md_size(stripes, magic) : rc);
+}
+
+/**
+ * Implementation of dt_object_operations::do_index_try.
*
- * \retval >0 if the initialization is successful.
- * \retval <0 if the initialization is failed.
+ * \see dt_object_operations::do_index_try() in the API description for details.
*/
static int lod_index_try(const struct lu_env *env, struct dt_object *dt,
const struct dt_index_features *feat)
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_read_lock.
+ *
+ * \see dt_object_operations::do_read_lock() in the API description for details.
+ */
static void lod_object_read_lock(const struct lu_env *env,
struct dt_object *dt, unsigned role)
{
dt_read_lock(env, dt_object_child(dt), role);
}
+/**
+ * Implementation of dt_object_operations::do_write_lock.
+ *
+ * \see dt_object_operations::do_write_lock() in the API description for
+ * details.
+ */
static void lod_object_write_lock(const struct lu_env *env,
struct dt_object *dt, unsigned role)
{
dt_write_lock(env, dt_object_child(dt), role);
}
+/**
+ * Implementation of dt_object_operations::do_read_unlock.
+ *
+ * \see dt_object_operations::do_read_unlock() in the API description for
+ * details.
+ */
static void lod_object_read_unlock(const struct lu_env *env,
struct dt_object *dt)
{
dt_read_unlock(env, dt_object_child(dt));
}
+/**
+ * Implementation of dt_object_operations::do_write_unlock.
+ *
+ * \see dt_object_operations::do_write_unlock() in the API description for
+ * details.
+ */
static void lod_object_write_unlock(const struct lu_env *env,
struct dt_object *dt)
{
dt_write_unlock(env, dt_object_child(dt));
}
+/**
+ * Implementation of dt_object_operations::do_write_locked.
+ *
+ * \see dt_object_operations::do_write_locked() in the API description for
+ * details.
+ */
static int lod_object_write_locked(const struct lu_env *env,
struct dt_object *dt)
{
return dt_write_locked(env, dt_object_child(dt));
}
+/**
+ * Implementation of dt_object_operations::do_attr_get.
+ *
+ * \see dt_object_operations::do_attr_get() in the API description for details.
+ */
static int lod_attr_get(const struct lu_env *env,
struct dt_object *dt,
struct lu_attr *attr,
struct lustre_capa *capa)
{
- struct lod_object *lo = lod_dt_obj(dt);
- int i;
- int rc;
- ENTRY;
-
- rc = dt_attr_get(env, dt_object_child(dt), attr, capa);
- if (!S_ISDIR(dt->do_lu.lo_header->loh_attr) || rc != 0)
- RETURN(rc);
-
- rc = lod_load_striping_locked(env, lo);
- if (rc)
- RETURN(rc);
-
- if (lo->ldo_stripenr == 0)
- RETURN(rc);
-
- attr->la_nlink = 2;
- attr->la_size = 0;
- for (i = 0; i < lo->ldo_stripenr; i++) {
- struct lu_attr *sub_attr = &lod_env_info(env)->lti_attr;
-
- LASSERT(lo->ldo_stripe[i]);
- if (dt_object_exists(lo->ldo_stripe[i]))
- continue;
-
- rc = dt_attr_get(env, lo->ldo_stripe[i], sub_attr, capa);
- if (rc != 0)
- break;
-
- /* -2 for . and .. on each stripe */
- if (sub_attr->la_valid & LA_NLINK && attr->la_valid & LA_NLINK)
- attr->la_nlink += sub_attr->la_nlink - 2;
- if (sub_attr->la_valid & LA_SIZE && attr->la_valid & LA_SIZE)
- attr->la_size += sub_attr->la_size;
-
- if (sub_attr->la_valid & LA_ATIME &&
- attr->la_valid & LA_ATIME &&
- attr->la_atime < sub_attr->la_atime)
- attr->la_atime = sub_attr->la_atime;
-
- if (sub_attr->la_valid & LA_CTIME &&
- attr->la_valid & LA_CTIME &&
- attr->la_ctime < sub_attr->la_ctime)
- attr->la_ctime = sub_attr->la_ctime;
-
- if (sub_attr->la_valid & LA_MTIME &&
- attr->la_valid & LA_MTIME &&
- attr->la_mtime < sub_attr->la_mtime)
- attr->la_mtime = sub_attr->la_mtime;
- }
-
- CDEBUG(D_INFO, DFID" stripe_count %d nlink %u size "LPU64"\n",
- PFID(lu_object_fid(&dt->do_lu)), lo->ldo_stripenr,
- attr->la_nlink, attr->la_size);
-
- RETURN(rc);
+ /* Note: for striped directory, client will merge attributes
+ * from all of the sub-stripes see lmv_merge_attr(), and there
+ * no MDD logic depend on directory nlink/size/time, so we can
+ * always use master inode nlink and size for now. */
+ return dt_attr_get(env, dt_object_child(dt), attr, capa);
}
/**
- * Mark all of sub-stripes dead of the striped directory.
+ * Mark all of the striped directory sub-stripes dead.
+ *
+ * When a striped object is a subject to removal, we have
+ * to mark all the stripes to prevent further access to
+ * them (e.g. create a new file in those). So we mark
+ * all the stripes with LMV_HASH_FLAG_DEAD. The function
+ * can be used to declare the changes and to apply them.
+ * If the object isn't striped, then just return success.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt the striped object
+ * \param[in] handle transaction handle
+ * \param[in] declare whether to declare the change or apply
+ *
+ * \retval 0 on success
+ * \retval negative if failed
**/
static int lod_mark_dead_object(const struct lu_env *env,
struct dt_object *dt,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_declare_attr_set.
+ *
+ * If the object is striped, then apply the changes to all the stripes.
+ *
+ * \see dt_object_operations::do_declare_attr_set() in the API description
+ * for details.
+ */
static int lod_declare_attr_set(const struct lu_env *env,
struct dt_object *dt,
const struct lu_attr *attr,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_attr_set.
+ *
+ * If the object is striped, then apply the changes to all or subset of
+ * the stripes depending on the object type and specific attributes.
+ *
+ * \see dt_object_operations::do_attr_set() in the API description for details.
+ */
static int lod_attr_set(const struct lu_env *env,
struct dt_object *dt,
const struct lu_attr *attr,
*/
LASSERT(lo->ldo_stripe);
for (i = 0; i < lo->ldo_stripenr; i++) {
- if (likely(lo->ldo_stripe[i] != NULL)) {
- if (dt_object_exists(lo->ldo_stripe[i]) == 0)
- continue;
+ if (unlikely(lo->ldo_stripe[i] == NULL))
+ continue;
+ if (S_ISDIR(dt->do_lu.lo_header->loh_attr) &&
+ (dt_object_exists(lo->ldo_stripe[i]) == 0))
+ continue;
- rc = dt_attr_set(env, lo->ldo_stripe[i], attr,
- handle, capa);
- if (rc != 0) {
- CERROR("failed declaration: %d\n", rc);
- break;
- }
+ rc = dt_attr_set(env, lo->ldo_stripe[i], attr, handle, capa);
+ if (rc != 0) {
+ CERROR("failed declaration: %d\n", rc);
+ break;
}
}
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_xattr_get.
+ *
+ * If LOV EA is requested from the root object and it's not
+ * found, then return default striping for the filesystem.
+ *
+ * \see dt_object_operations::do_xattr_get() in the API description for details.
+ */
static int lod_xattr_get(const struct lu_env *env, struct dt_object *dt,
struct lu_buf *buf, const char *name,
struct lustre_capa *capa)
ENTRY;
rc = dt_xattr_get(env, dt_object_child(dt), buf, name, capa);
+ if (strcmp(name, XATTR_NAME_LMV) == 0) {
+ struct lmv_mds_md_v1 *lmv1;
+ int rc1 = 0;
+
+ if (rc > (typeof(rc))sizeof(*lmv1))
+ RETURN(rc);
+
+ if (rc < (typeof(rc))sizeof(*lmv1))
+ RETURN(rc = rc > 0 ? -EINVAL : rc);
+
+ if (buf->lb_buf == NULL || buf->lb_len == 0) {
+ CLASSERT(sizeof(*lmv1) <= sizeof(info->lti_key));
+
+ info->lti_buf.lb_buf = info->lti_key;
+ info->lti_buf.lb_len = sizeof(*lmv1);
+ rc = dt_xattr_get(env, dt_object_child(dt),
+ &info->lti_buf, name, capa);
+ if (unlikely(rc != sizeof(*lmv1)))
+ RETURN(rc = rc > 0 ? -EINVAL : rc);
+
+ lmv1 = info->lti_buf.lb_buf;
+ /* The on-disk LMV EA only contains header, but the
+ * returned LMV EA size should contain the space for
+ * the FIDs of all shards of the striped directory. */
+ if (le32_to_cpu(lmv1->lmv_magic) == LMV_MAGIC_V1)
+ rc = lmv_mds_md_size(
+ le32_to_cpu(lmv1->lmv_stripe_count),
+ LMV_MAGIC_V1);
+ } else {
+ rc1 = lod_load_lmv_shards(env, lod_dt_obj(dt),
+ buf, false);
+ }
+
+ RETURN(rc = rc1 != 0 ? rc1 : rc);
+ }
+
if (rc != -ENODATA || !S_ISDIR(dt->do_lu.lo_header->loh_attr & S_IFMT))
RETURN(rc);
RETURN(rc);
}
+/**
+ * Verify LVM EA.
+ *
+ * Checks that the magic and the number of the stripes are sane.
+ *
+ * \param[in] lod lod device
+ * \param[in] lum a buffer storing LMV EA to verify
+ *
+ * \retval 0 if the EA is sane
+ * \retval negative otherwise
+ */
static int lod_verify_md_striping(struct lod_device *lod,
const struct lmv_user_md_v1 *lum)
{
}
/**
- * Master LMVEA will be same as slave LMVEA, except
- * 1. different magic
- * 2. No lmv_stripe_fids on slave
- * 3. lmv_master_mdt_index on slave LMV EA will be stripe_index.
+ * Initialize LMV EA for a slave.
+ *
+ * Initialize slave's LMV EA from the master's LMV EA.
+ *
+ * \param[in] master_lmv a buffer containing master's EA
+ * \param[out] slave_lmv a buffer where slave's EA will be stored
+ *
*/
static void lod_prep_slave_lmv_md(struct lmv_mds_md_v1 *slave_lmv,
const struct lmv_mds_md_v1 *master_lmv)
slave_lmv->lmv_magic = cpu_to_le32(LMV_MAGIC_STRIPE);
}
-int lod_prep_lmv_md(const struct lu_env *env, struct dt_object *dt,
- struct lu_buf *lmv_buf)
+/**
+ * Generate LMV EA.
+ *
+ * Generate LMV EA from the object passed as \a dt. The object must have
+ * the stripes created and initialized.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[out] lmv_buf buffer storing generated LMV EA
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
+static int lod_prep_lmv_md(const struct lu_env *env, struct dt_object *dt,
+ struct lu_buf *lmv_buf)
{
struct lod_thread_info *info = lod_env_info(env);
struct lod_device *lod = lu2lod_dev(dt->do_lu.lo_dev);
struct lod_object *lo = lod_dt_obj(dt);
struct lmv_mds_md_v1 *lmm1;
int stripe_count;
- int lmm_size;
int type = LU_SEQ_RANGE_ANY;
- int i;
int rc;
__u32 mdtidx;
ENTRY;
LASSERT(lo->ldo_dir_striped != 0);
LASSERT(lo->ldo_stripenr > 0);
stripe_count = lo->ldo_stripenr;
- lmm_size = lmv_mds_md_size(stripe_count, LMV_MAGIC);
- if (info->lti_ea_store_size < lmm_size) {
- rc = lod_ea_store_resize(info, lmm_size);
+ /* Only store the LMV EA heahder on the disk. */
+ if (info->lti_ea_store_size < sizeof(*lmm1)) {
+ rc = lod_ea_store_resize(info, sizeof(*lmm1));
if (rc != 0)
RETURN(rc);
+ } else {
+ memset(info->lti_ea_store, 0, sizeof(*lmm1));
}
lmm1 = (struct lmv_mds_md_v1 *)info->lti_ea_store;
RETURN(rc);
lmm1->lmv_master_mdt_index = cpu_to_le32(mdtidx);
- fid_cpu_to_le(&lmm1->lmv_master_fid, lu_object_fid(&dt->do_lu));
- for (i = 0; i < lo->ldo_stripenr; i++) {
- struct dt_object *dto;
-
- dto = lo->ldo_stripe[i];
- LASSERT(dto != NULL);
- fid_cpu_to_le(&lmm1->lmv_stripe_fids[i],
- lu_object_fid(&dto->do_lu));
- }
-
lmv_buf->lb_buf = info->lti_ea_store;
- lmv_buf->lb_len = lmm_size;
+ lmv_buf->lb_len = sizeof(*lmm1);
lo->ldo_dir_striping_cached = 1;
RETURN(rc);
}
+/**
+ * Create in-core represenation for a striped directory.
+ *
+ * Parse the buffer containing LMV EA and instantiate LU objects
+ * representing the stripe objects. The pointers to the objects are
+ * stored in ldo_stripe field of \a lo. This function is used when
+ * we need to access an already created object (i.e. load from a disk).
+ *
+ * \param[in] env execution environment
+ * \param[in] lo lod object
+ * \param[in] buf buffer containing LMV EA
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
int lod_parse_dir_striping(const struct lu_env *env, struct lod_object *lo,
const struct lu_buf *buf)
{
union lmv_mds_md *lmm = buf->lb_buf;
struct lmv_mds_md_v1 *lmv1 = &lmm->lmv_md_v1;
struct lu_fid *fid = &info->lti_fid;
- int i;
+ unsigned int i;
int rc = 0;
ENTRY;
if (le32_to_cpu(lmv1->lmv_magic) != LMV_MAGIC_V1)
RETURN(-EINVAL);
- if (le32_to_cpu(lmv1->lmv_stripe_count) <= 1)
+ if (le32_to_cpu(lmv1->lmv_stripe_count) < 1)
RETURN(0);
LASSERT(lo->ldo_stripe == NULL);
RETURN(rc);
}
+/**
+ * Create a striped directory.
+ *
+ * Create a striped directory with a given stripe pattern on the specified MDTs.
+ * A striped directory is represented as a regular directory - an index listing
+ * all the stripes. The stripes point back to the master object with ".." and
+ * LinkEA. The master object gets LMV EA which identifies it as a striped
+ * directory. The function allocates FIDs for all the stripes.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] attr attributes to initialize the objects with
+ * \param[in] lum a pattern specifying the number of stripes and
+ * MDT to start from
+ * \param[in] dof type of objects to be created
+ * \param[in] th transaction handle
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_prep_md_striped_create(const struct lu_env *env,
struct dt_object *dt,
struct lu_attr *attr,
struct lu_buf slave_lmv_buf;
struct lmv_mds_md_v1 *lmm;
struct lmv_mds_md_v1 *slave_lmm = NULL;
- int stripe_count;
+ struct dt_insert_rec *rec = &info->lti_dt_rec;
+ __u32 stripe_count;
int *idx_array;
int rc = 0;
- int i;
- int j;
+ __u32 i;
+ __u32 j;
ENTRY;
/* The lum has been verifed in lod_verify_md_striping */
for (j = 0; j < lod->lod_remote_mdt_count;
j++, idx = (idx + 1) % (lod->lod_remote_mdt_count + 1)) {
bool already_allocated = false;
- int k;
+ __u32 k;
- CDEBUG(D_INFO, "try idx %d, mdt cnt %d,"
- " allocated %d, last allocated %d\n", idx,
+ CDEBUG(D_INFO, "try idx %d, mdt cnt %u,"
+ " allocated %u, last allocated %d\n", idx,
lod->lod_remote_mdt_count, i, idx_array[i - 1]);
/* Find next available target */
/* Can not allocate more stripes */
if (j == lod->lod_remote_mdt_count) {
- CDEBUG(D_INFO, "%s: require stripes %d only get %d\n",
+ CDEBUG(D_INFO, "%s: require stripes %u only get %d\n",
lod2obd(lod)->obd_name, stripe_count, i - 1);
break;
}
- CDEBUG(D_INFO, "idx %d, mdt cnt %d,"
- " allocated %d, last allocated %d\n", idx,
+ CDEBUG(D_INFO, "idx %d, mdt cnt %u,"
+ " allocated %u, last allocated %d\n", idx,
lod->lod_remote_mdt_count, i, idx_array[i - 1]);
next:
if (!dt_try_as_dir(env, dt_object_child(dt)))
GOTO(out_put, rc = -EINVAL);
+ rec->rec_type = S_IFDIR;
for (i = 0; i < lo->ldo_stripenr; i++) {
- struct dt_object *dto = stripe[i];
- char *stripe_name = info->lti_key;
+ struct dt_object *dto = stripe[i];
+ char *stripe_name = info->lti_key;
+ struct lu_name *sname;
+ struct linkea_data ldata = { 0 };
+ struct lu_buf linkea_buf;
rc = dt_declare_create(env, dto, attr, NULL, dof, th);
if (rc != 0)
if (!dt_try_as_dir(env, dto))
GOTO(out_put, rc = -EINVAL);
- rc = dt_declare_insert(env, dto,
- (const struct dt_rec *)lu_object_fid(&dto->do_lu),
- (const struct dt_key *)dot, th);
+ rec->rec_fid = lu_object_fid(&dto->do_lu);
+ rc = dt_declare_insert(env, dto, (const struct dt_rec *)rec,
+ (const struct dt_key *)dot, th);
if (rc != 0)
GOTO(out_put, rc);
/* master stripe FID will be put to .. */
- rc = dt_declare_insert(env, dto,
- (const struct dt_rec *)lu_object_fid(&dt->do_lu),
- (const struct dt_key *)dotdot, th);
+ rec->rec_fid = lu_object_fid(&dt->do_lu);
+ rc = dt_declare_insert(env, dto, (const struct dt_rec *)rec,
+ (const struct dt_key *)dotdot, th);
if (rc != 0)
GOTO(out_put, rc);
if (lo->ldo_striping_cached &&
!LOVEA_DELETE_VALUES(lo->ldo_def_stripe_size,
lo->ldo_def_stripenr,
- lo->ldo_def_stripe_offset)) {
+ lo->ldo_def_stripe_offset,
+ lo->ldo_pool)) {
struct lov_user_md_v3 *v3;
/* sigh, lti_ea_store has been used for lmv_buf,
cpu_to_le16(lo->ldo_def_stripe_offset);
v3->lmm_stripe_size =
cpu_to_le32(lo->ldo_def_stripe_size);
- if (lo->ldo_pool)
- strncpy(v3->lmm_pool_name, lo->ldo_pool,
- LOV_MAXPOOLNAME);
+ if (lo->ldo_pool != NULL)
+ strlcpy(v3->lmm_pool_name, lo->ldo_pool,
+ sizeof(v3->lmm_pool_name));
info->lti_buf.lb_buf = v3;
info->lti_buf.lb_len = sizeof(*v3);
GOTO(out_put, rc);
}
- slave_lmm->lmv_master_mdt_index = cpu_to_le32(i);
- rc = dt_declare_xattr_set(env, dto, &slave_lmv_buf,
- XATTR_NAME_LMV, 0, th);
+ if (!OBD_FAIL_CHECK(OBD_FAIL_LFSCK_LOST_SLAVE_LMV) ||
+ cfs_fail_val != i) {
+ if (OBD_FAIL_CHECK(OBD_FAIL_LFSCK_BAD_SLAVE_LMV) &&
+ cfs_fail_val == i)
+ slave_lmm->lmv_master_mdt_index =
+ cpu_to_le32(i + 1);
+ else
+ slave_lmm->lmv_master_mdt_index =
+ cpu_to_le32(i);
+ rc = dt_declare_xattr_set(env, dto, &slave_lmv_buf,
+ XATTR_NAME_LMV, 0, th);
+ if (rc != 0)
+ GOTO(out_put, rc);
+ }
+
+ if (OBD_FAIL_CHECK(OBD_FAIL_LFSCK_BAD_SLAVE_NAME) &&
+ cfs_fail_val == i)
+ snprintf(stripe_name, sizeof(info->lti_key), DFID":%u",
+ PFID(lu_object_fid(&dto->do_lu)), i + 1);
+ else
+ snprintf(stripe_name, sizeof(info->lti_key), DFID":%u",
+ PFID(lu_object_fid(&dto->do_lu)), i);
+
+ sname = lod_name_get(env, stripe_name, strlen(stripe_name));
+ rc = linkea_data_new(&ldata, &info->lti_linkea_buf);
+ if (rc != 0)
+ GOTO(out_put, rc);
+
+ rc = linkea_add_buf(&ldata, sname, lu_object_fid(&dt->do_lu));
+ if (rc != 0)
+ GOTO(out_put, rc);
+
+ linkea_buf.lb_buf = ldata.ld_buf->lb_buf;
+ linkea_buf.lb_len = ldata.ld_leh->leh_len;
+ rc = dt_declare_xattr_set(env, dto, &linkea_buf,
+ XATTR_NAME_LINK, 0, th);
if (rc != 0)
GOTO(out_put, rc);
- snprintf(stripe_name, sizeof(info->lti_key), DFID":%d",
- PFID(lu_object_fid(&dto->do_lu)), i);
+ rec->rec_fid = lu_object_fid(&dto->do_lu);
rc = dt_declare_insert(env, dt_object_child(dt),
- (const struct dt_rec *)lu_object_fid(&dto->do_lu),
- (const struct dt_key *)stripe_name, th);
+ (const struct dt_rec *)rec,
+ (const struct dt_key *)stripe_name, th);
if (rc != 0)
GOTO(out_put, rc);
/**
* Declare create striped md object.
+ *
+ * The function declares intention to create a striped directory. This is a
+ * wrapper for lod_prep_md_striped_create(). The only additional functionality
+ * is to verify pattern \a lum_buf is good. Check that function for the details.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] attr attributes to initialize the objects with
+ * \param[in] lum_buf a pattern specifying the number of stripes and
+ * MDT to start from
+ * \param[in] dof type of objects to be created
+ * \param[in] th transaction handle
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ *
*/
static int lod_declare_xattr_set_lmv(const struct lu_env *env,
struct dt_object *dt,
RETURN(rc);
}
+
+/**
+ * Implementation of dt_object_operations::do_declare_xattr_set.
+ *
+ * Used with regular (non-striped) objects. Basically it
+ * initializes the striping information and applies the
+ * change to all the stripes.
+ *
+ * \see dt_object_operations::do_declare_xattr_set() in the API description
+ * for details.
+ */
static int lod_dir_declare_xattr_set(const struct lu_env *env,
struct dt_object *dt,
const struct lu_buf *buf,
if (rc != 0)
RETURN(rc);
- if (lo->ldo_stripenr == 0)
- RETURN(rc);
+ /* Note: Do not set LinkEA on sub-stripes, otherwise
+ * it will confuse the fid2path process(see mdt_path_current()).
+ * The linkEA between master and sub-stripes is set in
+ * lod_xattr_set_lmv(). */
+ if (lo->ldo_stripenr == 0 || strcmp(name, XATTR_NAME_LINK) == 0)
+ RETURN(0);
for (i = 0; i < lo->ldo_stripenr; i++) {
LASSERT(lo->ldo_stripe[i]);
RETURN(rc);
}
-/*
- * LOV xattr is a storage for striping, and LOD owns this xattr.
- * but LOD allows others to control striping to some extent
- * - to reset strping
- * - to set new defined striping
- * - to set new semi-defined striping
- * - number of stripes is defined
- * - number of stripes + osts are defined
- * - ??
+/**
+ * Implementation of dt_object_operations::do_declare_xattr_set.
+ *
+ * \see dt_object_operations::do_declare_xattr_set() in the API description
+ * for details.
+ *
+ * the extension to the API:
+ * - declaring LOVEA requests striping creation
+ * - LU_XATTR_REPLACE means layout swap
*/
static int lod_declare_xattr_set(const struct lu_env *env,
struct dt_object *dt,
RETURN(rc);
}
+/**
+ * Resets cached default striping in the object.
+ *
+ * \param[in] lo object
+ */
static void lod_lov_stripe_cache_clear(struct lod_object *lo)
{
lo->ldo_striping_cached = 0;
lo->ldo_dir_striping_cached = 0;
}
+/**
+ * Apply xattr changes to the object.
+ *
+ * Applies xattr changes to the object and the stripes if the latter exist.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] buf buffer pointing to the new value of xattr
+ * \param[in] name name of xattr
+ * \param[in] fl flags
+ * \param[in] th transaction handle
+ * \param[in] capa not used currently
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_xattr_set_internal(const struct lu_env *env,
struct dt_object *dt,
const struct lu_buf *buf,
if (rc != 0 || !S_ISDIR(dt->do_lu.lo_header->loh_attr))
RETURN(rc);
- if (lo->ldo_stripenr == 0)
- RETURN(rc);
+ /* Note: Do not set LinkEA on sub-stripes, otherwise
+ * it will confuse the fid2path process(see mdt_path_current()).
+ * The linkEA between master and sub-stripes is set in
+ * lod_xattr_set_lmv(). */
+ if (lo->ldo_stripenr == 0 || strcmp(name, XATTR_NAME_LINK) == 0)
+ RETURN(0);
for (i = 0; i < lo->ldo_stripenr; i++) {
LASSERT(lo->ldo_stripe[i]);
RETURN(rc);
}
+/**
+ * Delete an extended attribute.
+ *
+ * Deletes specified xattr from the object and the stripes if the latter exist.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] name name of xattr
+ * \param[in] th transaction handle
+ * \param[in] capa not used currently
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_xattr_del_internal(const struct lu_env *env,
struct dt_object *dt,
const char *name, struct thandle *th,
RETURN(rc);
}
+/**
+ * Set default striping on a directory.
+ *
+ * Sets specified striping on a directory object unless it matches the default
+ * striping (LOVEA_DELETE_VALUES() macro). In the latter case remove existing
+ * EA. This striping will be used when regular file is being created in this
+ * directory.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt the striped object
+ * \param[in] buf buffer with the striping
+ * \param[in] name name of EA
+ * \param[in] fl xattr flag (see OSD API description)
+ * \param[in] th transaction handle
+ * \param[in] capa not used
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_xattr_set_lov_on_dir(const struct lu_env *env,
struct dt_object *dt,
const struct lu_buf *buf,
struct lod_object *l = lod_dt_obj(dt);
struct lov_user_md_v1 *lum;
struct lov_user_md_v3 *v3 = NULL;
+ const char *pool_name = NULL;
int rc;
ENTRY;
LASSERT(buf != NULL && buf->lb_buf != NULL);
lum = buf->lb_buf;
- rc = lod_verify_striping(d, buf, 0);
+ rc = lod_verify_striping(d, buf, false);
if (rc)
RETURN(rc);
- if (lum->lmm_magic == LOV_USER_MAGIC_V3)
+ if (lum->lmm_magic == LOV_USER_MAGIC_V3) {
v3 = buf->lb_buf;
+ if (v3->lmm_pool_name[0] != '\0')
+ pool_name = v3->lmm_pool_name;
+ }
/* if { size, offset, count } = { 0, -1, 0 } and no pool
* (i.e. all default values specified) then delete default
(int)lum->lmm_stripe_offset,
v3 ? "from" : "", v3 ? v3->lmm_pool_name : "");
- if (LOVEA_DELETE_VALUES((lum->lmm_stripe_size),
- (lum->lmm_stripe_count),
- (lum->lmm_stripe_offset)) &&
- lum->lmm_magic == LOV_USER_MAGIC_V1) {
+ if (LOVEA_DELETE_VALUES(lum->lmm_stripe_size, lum->lmm_stripe_count,
+ lum->lmm_stripe_offset, pool_name)) {
rc = lod_xattr_del_internal(env, dt, name, th, capa);
if (rc == -ENODATA)
rc = 0;
RETURN(rc);
}
+/**
+ * Set default striping on a directory object.
+ *
+ * Sets specified striping on a directory object unless it matches the default
+ * striping (LOVEA_DELETE_VALUES() macro). In the latter case remove existing
+ * EA. This striping will be used when a new directory is being created in the
+ * directory.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt the striped object
+ * \param[in] buf buffer with the striping
+ * \param[in] name name of EA
+ * \param[in] fl xattr flag (see OSD API description)
+ * \param[in] th transaction handle
+ * \param[in] capa not used
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_xattr_set_default_lmv_on_dir(const struct lu_env *env,
struct dt_object *dt,
const struct lu_buf *buf,
RETURN(rc);
}
+/**
+ * Turn directory into a striped directory.
+ *
+ * During replay the client sends the striping created before MDT
+ * failure, then the layer above LOD sends this defined striping
+ * using ->do_xattr_set(), so LOD uses this method to replay creation
+ * of the stripes. Notice the original information for the striping
+ * (#stripes, FIDs, etc) was transfered in declare path.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt the striped object
+ * \param[in] buf not used currently
+ * \param[in] name not used currently
+ * \param[in] fl xattr flag (see OSD API description)
+ * \param[in] th transaction handle
+ * \param[in] capa not used
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_xattr_set_lmv(const struct lu_env *env, struct dt_object *dt,
const struct lu_buf *buf, const char *name,
int fl, struct thandle *th,
struct lu_buf slave_lmv_buf;
struct lmv_mds_md_v1 *lmm;
struct lmv_mds_md_v1 *slave_lmm = NULL;
+ struct dt_insert_rec *rec = &info->lti_dt_rec;
int i;
int rc;
ENTRY;
slave_lmv_buf.lb_buf = slave_lmm;
slave_lmv_buf.lb_len = sizeof(*slave_lmm);
+ rec->rec_type = S_IFDIR;
for (i = 0; i < lo->ldo_stripenr; i++) {
- struct dt_object *dto;
- char *stripe_name = info->lti_key;
+ struct dt_object *dto;
+ char *stripe_name = info->lti_key;
+ struct lu_name *sname;
+ struct linkea_data ldata = { 0 };
+ struct lu_buf linkea_buf;
dto = lo->ldo_stripe[i];
dt_write_lock(env, dto, MOR_TGT_CHILD);
if (rc != 0)
RETURN(rc);
- rc = dt_insert(env, dto,
- (const struct dt_rec *)lu_object_fid(&dto->do_lu),
- (const struct dt_key *)dot, th, capa, 0);
+ rec->rec_fid = lu_object_fid(&dto->do_lu);
+ rc = dt_insert(env, dto, (const struct dt_rec *)rec,
+ (const struct dt_key *)dot, th, capa, 0);
if (rc != 0)
RETURN(rc);
- rc = dt_insert(env, dto,
- (struct dt_rec *)lu_object_fid(&dt->do_lu),
- (const struct dt_key *)dotdot, th, capa, 0);
+ rec->rec_fid = lu_object_fid(&dt->do_lu);
+ rc = dt_insert(env, dto, (struct dt_rec *)rec,
+ (const struct dt_key *)dotdot, th, capa, 0);
if (rc != 0)
RETURN(rc);
if (lo->ldo_striping_cached &&
!LOVEA_DELETE_VALUES(lo->ldo_def_stripe_size,
lo->ldo_def_stripenr,
- lo->ldo_def_stripe_offset)) {
+ lo->ldo_def_stripe_offset,
+ lo->ldo_pool)) {
struct lov_user_md_v3 *v3;
/* sigh, lti_ea_store has been used for lmv_buf,
cpu_to_le16(lo->ldo_def_stripe_offset);
v3->lmm_stripe_size =
cpu_to_le32(lo->ldo_def_stripe_size);
- if (lo->ldo_pool)
- strncpy(v3->lmm_pool_name, lo->ldo_pool,
- LOV_MAXPOOLNAME);
+ if (lo->ldo_pool != NULL)
+ strlcpy(v3->lmm_pool_name, lo->ldo_pool,
+ sizeof(v3->lmm_pool_name));
info->lti_buf.lb_buf = v3;
info->lti_buf.lb_len = sizeof(*v3);
GOTO(out, rc);
}
- slave_lmm->lmv_master_mdt_index = cpu_to_le32(i);
- rc = dt_xattr_set(env, dto, &slave_lmv_buf, XATTR_NAME_LMV,
- fl, th, capa);
+ if (!OBD_FAIL_CHECK(OBD_FAIL_LFSCK_LOST_SLAVE_LMV) ||
+ cfs_fail_val != i) {
+ if (OBD_FAIL_CHECK(OBD_FAIL_LFSCK_BAD_SLAVE_LMV) &&
+ cfs_fail_val == i)
+ slave_lmm->lmv_master_mdt_index =
+ cpu_to_le32(i + 1);
+ else
+ slave_lmm->lmv_master_mdt_index =
+ cpu_to_le32(i);
+ rc = dt_xattr_set(env, dto, &slave_lmv_buf,
+ XATTR_NAME_LMV, fl, th, capa);
+ if (rc != 0)
+ GOTO(out, rc);
+ }
+
+ if (OBD_FAIL_CHECK(OBD_FAIL_LFSCK_BAD_SLAVE_NAME) &&
+ cfs_fail_val == i)
+ snprintf(stripe_name, sizeof(info->lti_key), DFID":%d",
+ PFID(lu_object_fid(&dto->do_lu)), i + 1);
+ else
+ snprintf(stripe_name, sizeof(info->lti_key), DFID":%d",
+ PFID(lu_object_fid(&dto->do_lu)), i);
+
+ sname = lod_name_get(env, stripe_name, strlen(stripe_name));
+ rc = linkea_data_new(&ldata, &info->lti_linkea_buf);
if (rc != 0)
GOTO(out, rc);
- snprintf(stripe_name, sizeof(info->lti_key), DFID":%d",
- PFID(lu_object_fid(&dto->do_lu)), i);
+ rc = linkea_add_buf(&ldata, sname, lu_object_fid(&dt->do_lu));
+ if (rc != 0)
+ GOTO(out, rc);
+
+ linkea_buf.lb_buf = ldata.ld_buf->lb_buf;
+ linkea_buf.lb_len = ldata.ld_leh->leh_len;
+ rc = dt_xattr_set(env, dto, &linkea_buf, XATTR_NAME_LINK,
+ 0, th, BYPASS_CAPA);
+ if (rc != 0)
+ GOTO(out, rc);
+
+ rec->rec_fid = lu_object_fid(&dto->do_lu);
rc = dt_insert(env, dt_object_child(dt),
- (const struct dt_rec *)lu_object_fid(&dto->do_lu),
- (const struct dt_key *)stripe_name, th, capa, 0);
+ (const struct dt_rec *)rec,
+ (const struct dt_key *)stripe_name, th, capa, 0);
if (rc != 0)
GOTO(out, rc);
GOTO(out, rc);
}
- rc = dt_xattr_set(env, dt_object_child(dt), &lmv_buf, XATTR_NAME_LMV,
- fl, th, capa);
+ if (!OBD_FAIL_CHECK(OBD_FAIL_LFSCK_LOST_MASTER_LMV))
+ rc = dt_xattr_set(env, dt_object_child(dt), &lmv_buf,
+ XATTR_NAME_LMV, fl, th, capa);
out:
if (slave_lmm != NULL)
RETURN(rc);
}
-int lod_dir_striping_create_internal(const struct lu_env *env,
- struct dt_object *dt,
- struct lu_attr *attr,
- struct dt_object_format *dof,
- struct thandle *th,
- bool declare)
+/**
+ * Helper function to declare/execute creation of a striped directory
+ *
+ * Called in declare/create object path, prepare striping for a directory
+ * and prepare defaults data striping for the objects to be created in
+ * that directory. Notice the function calls "declaration" or "execution"
+ * methods depending on \a declare param. This is a consequence of the
+ * current approach while we don't have natural distributed transactions:
+ * we basically execute non-local updates in the declare phase. So, the
+ * arguments for the both phases are the same and this is the reason for
+ * this function to exist.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] attr attributes the stripes will be created with
+ * \param[in] dof format of stripes (see OSD API description)
+ * \param[in] th transaction handle
+ * \param[in] declare where to call "declare" or "execute" methods
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
+static int lod_dir_striping_create_internal(const struct lu_env *env,
+ struct dt_object *dt,
+ struct lu_attr *attr,
+ struct dt_object_format *dof,
+ struct thandle *th,
+ bool declare)
{
struct lod_thread_info *info = lod_env_info(env);
struct lod_object *lo = lod_dt_obj(dt);
int rc;
ENTRY;
- if (lo->ldo_dir_def_striping_set &&
- !LMVEA_DELETE_VALUES(lo->ldo_stripenr,
+ if (!LMVEA_DELETE_VALUES(lo->ldo_stripenr,
lo->ldo_dir_stripe_offset)) {
struct lmv_user_md_v1 *v1 = info->lti_ea_store;
int stripe_count = lo->ldo_stripenr;
if (lo->ldo_striping_cached &&
!LOVEA_DELETE_VALUES(lo->ldo_def_stripe_size,
lo->ldo_def_stripenr,
- lo->ldo_def_stripe_offset)) {
+ lo->ldo_def_stripe_offset,
+ lo->ldo_pool)) {
struct lov_user_md_v3 *v3 = info->lti_ea_store;
if (info->lti_ea_store_size < sizeof(*v3)) {
v3->lmm_stripe_count = cpu_to_le16(lo->ldo_def_stripenr);
v3->lmm_stripe_offset = cpu_to_le16(lo->ldo_def_stripe_offset);
v3->lmm_stripe_size = cpu_to_le32(lo->ldo_def_stripe_size);
- if (lo->ldo_pool)
- strncpy(v3->lmm_pool_name, lo->ldo_pool,
- LOV_MAXPOOLNAME);
+ if (lo->ldo_pool != NULL)
+ strlcpy(v3->lmm_pool_name, lo->ldo_pool,
+ sizeof(v3->lmm_pool_name));
info->lti_buf.lb_buf = v3;
info->lti_buf.lb_len = sizeof(*v3);
return lod_dir_striping_create_internal(env, dt, attr, dof, th, false);
}
+/**
+ * Implementation of dt_object_operations::do_xattr_set.
+ *
+ * Sets specified extended attribute on the object. Three types of EAs are
+ * special:
+ * LOV EA - stores striping for a regular file or default striping (when set
+ * on a directory)
+ * LMV EA - stores a marker for the striped directories
+ * DMV EA - stores default directory striping
+ *
+ * When striping is applied to a non-striped existing object (this is called
+ * late striping), then LOD notices the caller wants to turn the object into a
+ * striped one. The stripe objects are created and appropriate EA is set:
+ * LOV EA storing all the stripes directly or LMV EA storing just a small header
+ * with striping configuration.
+ *
+ * \see dt_object_operations::do_xattr_set() in the API description for details.
+ */
static int lod_xattr_set(const struct lu_env *env,
struct dt_object *dt, const struct lu_buf *buf,
const char *name, int fl, struct thandle *th,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_declare_xattr_del.
+ *
+ * \see dt_object_operations::do_declare_xattr_del() in the API description
+ * for details.
+ */
static int lod_declare_xattr_del(const struct lu_env *env,
struct dt_object *dt, const char *name,
struct thandle *th)
return dt_declare_xattr_del(env, dt_object_child(dt), name, th);
}
+/**
+ * Implementation of dt_object_operations::do_xattr_del.
+ *
+ * If EA storing a regular striping is being deleted, then release
+ * all the references to the stripe objects in core.
+ *
+ * \see dt_object_operations::do_xattr_del() in the API description for details.
+ */
static int lod_xattr_del(const struct lu_env *env, struct dt_object *dt,
const char *name, struct thandle *th,
struct lustre_capa *capa)
return dt_xattr_del(env, dt_object_child(dt), name, th, capa);
}
+/**
+ * Implementation of dt_object_operations::do_xattr_list.
+ *
+ * \see dt_object_operations::do_xattr_list() in the API description
+ * for details.
+ */
static int lod_xattr_list(const struct lu_env *env,
- struct dt_object *dt, struct lu_buf *buf,
+ struct dt_object *dt, const struct lu_buf *buf,
struct lustre_capa *capa)
{
return dt_xattr_list(env, dt_object_child(dt), buf, capa);
}
+/**
+ * Initialize a pool the object belongs to.
+ *
+ * When a striped object is being created, striping configuration
+ * may demand the stripes are allocated on a limited set of the
+ * targets. These limited sets are known as "pools". So we copy
+ * a pool name into the object and later actual creation methods
+ * (like lod_object_create()) will use this information to allocate
+ * the stripes properly.
+ *
+ * \param[in] o object
+ * \param[in] pool pool name
+ */
int lod_object_set_pool(struct lod_object *o, char *pool)
{
int len;
}
+/**
+ * Cache default regular striping in the object.
+ *
+ * To improve performance of striped regular object creation we cache
+ * default LOV striping (if it exists) in the parent directory object.
+ *
+ * \param[in] env execution environment
+ * \param[in] lp object
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_cache_parent_lov_striping(const struct lu_env *env,
struct lod_object *lp)
{
if (rc < 0)
GOTO(unlock, rc);
- if (rc < sizeof(struct lov_user_md)) {
+ if (rc < (typeof(rc))sizeof(struct lov_user_md)) {
/* don't lookup for non-existing or invalid striping */
lp->ldo_def_striping_set = 0;
lp->ldo_striping_cached = 1;
}
+/**
+ * Cache default directory striping in the object.
+ *
+ * To improve performance of striped directory creation we cache default
+ * directory striping (if it exists) in the parent directory object.
+ *
+ * \param[in] env execution environment
+ * \param[in] lp object
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_cache_parent_lmv_striping(const struct lu_env *env,
struct lod_object *lp)
{
if (rc < 0)
GOTO(unlock, rc);
- if (rc < sizeof(struct lmv_user_md)) {
+ if (rc < (typeof(rc))sizeof(struct lmv_user_md)) {
/* don't lookup for non-existing or invalid striping */
lp->ldo_dir_def_striping_set = 0;
lp->ldo_dir_striping_cached = 1;
return rc;
}
+/**
+ * Cache default striping in the object.
+ *
+ * To improve performance of striped object creation we cache default striping
+ * (if it exists) in the parent directory object. We always cache default
+ * striping for the regular files (stored in LOV EA) and we cache default
+ * striping for the directories if requested by \a child_mode (when a new
+ * directory is being created).
+ *
+ * \param[in] env execution environment
+ * \param[in] lp object
+ * \param[in] child_mode new object's mode
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_cache_parent_striping(const struct lu_env *env,
struct lod_object *lp,
umode_t child_mode)
}
/**
- * used to transfer default striping data to the object being created
+ * Implementation of dt_object_operations::do_ah_init.
+ *
+ * This method is used to make a decision on the striping configuration for the
+ * object being created. It can be taken from the \a parent object if it exists,
+ * or filesystem's default. The resulting configuration (number of stripes,
+ * stripe size/offset, pool name, etc) is stored in the object itself and will
+ * be used by the methods like ->doo_declare_create().
+ *
+ * \see dt_object_operations::do_ah_init() in the API description for details.
*/
static void lod_ah_init(const struct lu_env *env,
struct dt_allocation_hint *ah,
* in case of late striping creation, ->ah_init()
* can be called with local object existing
*/
- if (!dt_object_exists(nextc) || dt_object_remote(nextc))
- nextc->do_ops->do_ah_init(env, ah, dt_object_remote(nextp) ?
- NULL : nextp, nextc, child_mode);
+ if (!dt_object_exists(nextc) || dt_object_remote(nextc)) {
+ struct dt_object *obj;
+
+ obj = (nextp != NULL && dt_object_remote(nextp)) ? NULL : nextp;
+ nextc->do_ops->do_ah_init(env, ah, obj, nextc, child_mode);
+ }
if (S_ISDIR(child_mode)) {
if (lc->ldo_dir_stripe == NULL) {
lc->ldo_dir_def_hash_type);
}
- /* If the directory is specified with certain stripes */
+ /* It should always honour the specified stripes */
if (ah->dah_eadata != NULL && ah->dah_eadata_len != 0) {
const struct lmv_user_md_v1 *lum1 = ah->dah_eadata;
lc->ldo_stripenr,
(int)lc->ldo_dir_stripe_offset);
}
+ /* then check whether there is default stripes from parent */
} else if (lp->ldo_dir_def_striping_set) {
/* If there are default dir stripe from parent */
lc->ldo_stripenr = lp->ldo_dir_def_stripenr;
if (likely(parent)) {
lod_cache_parent_striping(env, lp, child_mode);
- lc->ldo_def_stripe_offset = (__u16) -1;
+ lc->ldo_def_stripe_offset = LOV_OFFSET_DEFAULT;
if (lp->ldo_def_striping_set) {
if (lp->ldo_pool)
}
#define ll_do_div64(aaa,bbb) do_div((aaa), (bbb))
-/*
- * this function handles a special case when truncate was done
- * on a stripeless object and now striping is being created
- * we can't lose that size, so we have to propagate it to newly
- * created object
+/**
+ * Size initialization on late striping.
+ *
+ * Propagate the size of a truncated object to a deferred striping.
+ * This function handles a special case when truncate was done on a
+ * non-striped object and now while the striping is being created
+ * we can't lose that size, so we have to propagate it to the stripes
+ * being created.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] th transaction handle
+ *
+ * \retval 0 on success
+ * \retval negative if failed
*/
static int lod_declare_init_size(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
}
/**
- * Create declaration of striped object
+ * Declare creation of striped object.
+ *
+ * The function declares creation stripes for a regular object. The function
+ * also declares whether the stripes will be created with non-zero size if
+ * previously size was set non-zero on the master object. If object \a dt is
+ * not local, then only fully defined striping can be applied in \a lovea.
+ * Otherwise \a lovea can be in the form of pattern, see lod_qos_parse_config()
+ * for the details.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] attr attributes the stripes will be created with
+ * \param[in] lovea a buffer containing striping description
+ * \param[in] th transaction handle
+ *
+ * \retval 0 on success
+ * \retval negative if failed
*/
int lod_declare_striped_object(const struct lu_env *env, struct dt_object *dt,
struct lu_attr *attr,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_declare_create.
+ *
+ * The method declares creation of a new object. If the object will be striped,
+ * then helper functions are called to find FIDs for the stripes, declare
+ * creation of the stripes and declare initialization of the striping
+ * information to be stored in the master object.
+ *
+ * \see dt_object_operations::do_declare_create() in the API description
+ * for details.
+ */
static int lod_declare_object_create(const struct lu_env *env,
struct dt_object *dt,
struct lu_attr *attr,
RETURN(rc);
}
+/**
+ * Creation of a striped regular object.
+ *
+ * The function is called to create the stripe objects for a regular
+ * striped file. This can happen at the initial object creation or
+ * when the caller asks LOD to do so using ->do_xattr_set() method
+ * (so called late striping). Notice all the information are already
+ * prepared in the form of the list of objects (ldo_stripe field).
+ * This is done during declare phase.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt object
+ * \param[in] attr attributes the stripes will be created with
+ * \param[in] dof format of stripes (see OSD API description)
+ * \param[in] th transaction handle
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
int lod_striping_create(const struct lu_env *env, struct dt_object *dt,
struct lu_attr *attr, struct dt_object_format *dof,
struct thandle *th)
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_create.
+ *
+ * If any of preceeding methods (like ->do_declare_create(),
+ * ->do_ah_init(), etc) chose to create a striped object,
+ * then this method will create the master and the stripes.
+ *
+ * \see dt_object_operations::do_create() in the API description for details.
+ */
static int lod_object_create(const struct lu_env *env, struct dt_object *dt,
struct lu_attr *attr,
struct dt_allocation_hint *hint,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_declare_destroy.
+ *
+ * If the object is a striped directory, then the function declares reference
+ * removal from the master object (this is an index) to the stripes and declares
+ * destroy of all the stripes. In all the cases, it declares an intention to
+ * destroy the object itself.
+ *
+ * \see dt_object_operations::do_declare_destroy() in the API description
+ * for details.
+ */
static int lod_declare_object_destroy(const struct lu_env *env,
struct dt_object *dt,
struct thandle *th)
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_destroy.
+ *
+ * If the object is a striped directory, then the function removes references
+ * from the master object (this is an index) to the stripes and destroys all
+ * the stripes. In all the cases, the function destroys the object itself.
+ *
+ * \see dt_object_operations::do_destroy() in the API description for details.
+ */
static int lod_object_destroy(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
struct lod_object *lo = lod_dt_obj(dt);
struct lod_thread_info *info = lod_env_info(env);
char *stripe_name = info->lti_key;
- int rc, i;
+ unsigned int i;
+ int rc;
ENTRY;
/* destroy sub-stripe of master object */
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_declare_ref_add.
+ *
+ * \see dt_object_operations::do_declare_ref_add() in the API description
+ * for details.
+ */
static int lod_declare_ref_add(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
return dt_declare_ref_add(env, dt_object_child(dt), th);
}
+/**
+ * Implementation of dt_object_operations::do_ref_add.
+ *
+ * \see dt_object_operations::do_ref_add() in the API description for details.
+ */
static int lod_ref_add(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
return dt_ref_add(env, dt_object_child(dt), th);
}
+/**
+ * Implementation of dt_object_operations::do_declare_ref_del.
+ *
+ * \see dt_object_operations::do_declare_ref_del() in the API description
+ * for details.
+ */
static int lod_declare_ref_del(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
return dt_declare_ref_del(env, dt_object_child(dt), th);
}
+/**
+ * Implementation of dt_object_operations::do_ref_del
+ *
+ * \see dt_object_operations::do_ref_del() in the API description for details.
+ */
static int lod_ref_del(const struct lu_env *env,
struct dt_object *dt, struct thandle *th)
{
return dt_ref_del(env, dt_object_child(dt), th);
}
+/**
+ * Implementation of dt_object_operations::do_capa_get.
+ *
+ * \see dt_object_operations::do_capa_get() in the API description for details.
+ */
static struct obd_capa *lod_capa_get(const struct lu_env *env,
struct dt_object *dt,
struct lustre_capa *old, __u64 opc)
return dt_capa_get(env, dt_object_child(dt), old, opc);
}
+/**
+ * Implementation of dt_object_operations::do_object_sync.
+ *
+ * \see dt_object_operations::do_object_sync() in the API description
+ * for details.
+ */
static int lod_object_sync(const struct lu_env *env, struct dt_object *dt,
__u64 start, __u64 end)
{
struct lustre_handle lsl_handle[0];
};
+/**
+ * Release LDLM locks on the stripes of a striped directory.
+ *
+ * Iterates over all the locks taken on the stripe objects and
+ * release them using ->do_object_unlock() method.
+ *
+ * \param[in] env execution environment
+ * \param[in] dt striped object
+ * \param[in] einfo lock description
+ * \param[in] policy data describing requested lock
+ *
+ * \retval 0 on success
+ * \retval negative if failed
+ */
static int lod_object_unlock_internal(const struct lu_env *env,
struct dt_object *dt,
struct ldlm_enqueue_info *einfo,
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_object_unlock.
+ *
+ * Used to release LDLM lock(s).
+ *
+ * \see dt_object_operations::do_object_unlock() in the API description
+ * for details.
+ */
static int lod_object_unlock(const struct lu_env *env, struct dt_object *dt,
struct ldlm_enqueue_info *einfo,
union ldlm_policy_data *policy)
RETURN(rc);
}
+/**
+ * Implementation of dt_object_operations::do_object_lock.
+ *
+ * Used to get LDLM lock on the non-striped and striped objects.
+ *
+ * \see dt_object_operations::do_object_lock() in the API description
+ * for details.
+ */
static int lod_object_lock(const struct lu_env *env,
struct dt_object *dt,
struct lustre_handle *lh,
.do_object_unlock = lod_object_unlock,
};
+/**
+ * Implementation of dt_body_operations::dbo_read.
+ *
+ * \see dt_body_operations::dbo_read() in the API description for details.
+ */
static ssize_t lod_read(const struct lu_env *env, struct dt_object *dt,
struct lu_buf *buf, loff_t *pos,
struct lustre_capa *capa)
return next->do_body_ops->dbo_read(env, next, buf, pos, capa);
}
+/**
+ * Implementation of dt_body_operations::dbo_declare_write.
+ *
+ * \see dt_body_operations::dbo_declare_write() in the API description
+ * for details.
+ */
static ssize_t lod_declare_write(const struct lu_env *env,
struct dt_object *dt,
const struct lu_buf *buf, loff_t pos,
buf, pos, th);
}
+/**
+ * Implementation of dt_body_operations::dbo_write.
+ *
+ * \see dt_body_operations::dbo_write() in the API description for details.
+ */
static ssize_t lod_write(const struct lu_env *env, struct dt_object *dt,
const struct lu_buf *buf, loff_t *pos,
struct thandle *th, struct lustre_capa *capa, int iq)
.dbo_write = lod_write
};
+/**
+ * Implementation of lu_object_operations::loo_object_init.
+ *
+ * The function determines the type and the index of the target device using
+ * sequence of the object's FID. Then passes control down to the
+ * corresponding device:
+ * OSD for the local objects, OSP for remote
+ *
+ * \see lu_object_operations::loo_object_init() in the API description
+ * for details.
+ */
static int lod_object_init(const struct lu_env *env, struct lu_object *lo,
const struct lu_object_conf *conf)
{
struct lu_object *cobj;
struct lod_tgt_descs *ltd = NULL;
struct lod_tgt_desc *tgt;
- mdsno_t idx = 0;
+ u32 idx = 0;
int type = LU_SEQ_RANGE_ANY;
int rc;
ENTRY;
rc = lod_fld_lookup(env, lod, lu_object_fid(lo), &idx, &type);
- if (rc != 0)
+ if (rc != 0) {
+ /* Note: Sometimes, it will Return EAGAIN here, see
+ * ptrlpc_import_delay_req(), which might confuse
+ * lu_object_find_at() and make it wait there incorrectly.
+ * so we convert it to EIO here.*/
+ if (rc == -EAGAIN)
+ rc = -EIO;
+
RETURN(rc);
+ }
if (type == LU_SEQ_RANGE_MDT &&
idx == lu_site2seq(lo->lo_dev->ld_site)->ss_node_id) {
RETURN(0);
}
+/**
+ *
+ * Release resources associated with striping.
+ *
+ * If the object is striped (regular or directory), then release
+ * the stripe objects references and free the ldo_stripe array.
+ *
+ * \param[in] env execution environment
+ * \param[in] lo object
+ */
void lod_object_free_striping(const struct lu_env *env, struct lod_object *lo)
{
int i;
lo->ldo_pattern = 0;
}
-/*
- * ->start is called once all slices are initialized, including header's
- * cache for mode (object type). using the type we can initialize ops
+/**
+ * Implementation of lu_object_operations::loo_object_start.
+ *
+ * \see lu_object_operations::loo_object_start() in the API description
+ * for details.
*/
static int lod_object_start(const struct lu_env *env, struct lu_object *o)
{
return 0;
}
+/**
+ * Implementation of lu_object_operations::loo_object_free.
+ *
+ * \see lu_object_operations::loo_object_free() in the API description
+ * for details.
+ */
static void lod_object_free(const struct lu_env *env, struct lu_object *o)
{
struct lod_object *mo = lu2lod_obj(o);
OBD_SLAB_FREE_PTR(mo, lod_object_kmem);
}
+/**
+ * Implementation of lu_object_operations::loo_object_release.
+ *
+ * \see lu_object_operations::loo_object_release() in the API description
+ * for details.
+ */
static void lod_object_release(const struct lu_env *env, struct lu_object *o)
{
/* XXX: shouldn't we release everything here in case if object
* creation failed before? */
}
+/**
+ * Implementation of lu_object_operations::loo_object_print.
+ *
+ * \see lu_object_operations::loo_object_print() in the API description
+ * for details.
+ */
static int lod_object_print(const struct lu_env *env, void *cookie,
lu_printer_t p, const struct lu_object *l)
{