Last Updated: October 9, 2012
-Copyright © 2012 Intel, Corp.
+ Copyright (c) 2012, 2013, Intel Corporation.
This file is released under the GPLv2.
objects.
- ACCT_USER_OID/ACCT_GROUP_OID are used for accessing space accounting
information for respectively users and groups.
-- MDT_LAST_RECV_OID/OFD_LAST_RECV_OID is the last_rcvd file for respectively
+- LAST_RECV_OID is the last_rcvd file for respectively
the MDT and OST.
iv. Object Operations
int (*dt_sync)(const struct lu_env *, struct dt_device *);
int (*dt_ro)(const struct lu_env *, struct dt_device *);
int (*dt_commit_async)(const struct lu_env *, struct dt_device *);
-int (*dt_init_capa_ctxt)(const struct lu_env *, struct dt_device *, int,
- unsigned long, __u32, struct lustre_capa_key *);
dt_trans_create
dt_trans_start
called to notify OSD/backend that higher level need transaction to be
flushed as soon as possible. Used by Commit-on-Share feature.
Should return immediately and not block for long.
-dt_init_capa_ctxt
- called to initialize context for capabilities. not in use currently.
2. Data Objects
===============
void (*do_write_unlock)(const struct lu_env *, struct dt_object *);
int (*do_write_locked)(const struct lu_env *, struct dt_object *);
int (*do_attr_get)(const struct lu_env *, struct dt_object *,
- struct lu_attr *, struct lustre_capa *);
+ struct lu_attr *);
int (*do_declare_attr_set)(const struct lu_env *, struct dt_object *,
const struct lu_attr *, struct thandle *);
int (*do_attr_set)(const struct lu_env *, struct dt_object *,
- const struct lu_attr *, struct thandle *,
- struct lustre_capa *);
+ const struct lu_attr *, struct thandle *);
int (*do_xattr_get)(const struct lu_env *, struct dt_object *,
- struct lu_buf *, const char *, struct lustre_capa *);
+ struct lu_buf *, const char *);
int (*do_declare_xattr_set)(const struct lu_env *, struct dt_object *,
const struct lu_buf *, const char *, int,
struct thandle *);
int (*do_xattr_set)(const struct lu_env *, struct dt_object *,
const struct lu_buf *, const char *, int,
- struct thandle *, struct lustre_capa *);
+ struct thandle *);
int (*do_declare_xattr_del)(const struct lu_env *, struct dt_object *,
const char *, struct thandle *);
int (*do_xattr_del)(const struct lu_env *, struct dt_object *, const char *,
- struct thandle *, struct lustre_capa *);
+ struct thandle *);
int (*do_xattr_list)(const struct lu_env *, struct dt_object *,
- struct lu_buf *, struct lustre_capa *);
+ struct lu_buf *);
void (*do_ah_init)(const struct lu_env *, struct dt_allocation_hint *,
struct dt_object *, struct dt_object *, cfs_umode_t);
int (*do_declare_create)(const struct lu_env *, struct dt_object *,
int (*do_declare_ref_del)(const struct lu_env *, struct dt_object *,
struct thandle *);
int (*do_ref_del)(const struct lu_env *, struct dt_object *, struct thandle *);
-struct obd_capa *(*do_capa_get)(const struct lu_env *, struct dt_object *,
- struct lustre_capa *, __u64);
int (*do_object_sync)(const struct lu_env *, struct dt_object *);
do_read_lock
called to decrement nlink attribute in a specified transaction.
This is typically done on an object when a record referring to it is
deleted from an index object. The object must exist.
-do_capa_get
- called to get a capability for a specified object. not used currently.
do_object_sync
called to flush a given object on-disk. It’s a fine grained version of
->do_sync() method which should make sure an object is stored on-disk.
regular objects storing unstructured data:
ssize_t (*dbo_read)(const struct lu_env *, struct dt_object *, struct lu_buf *,
- loff_t *pos, struct lustre_capa *);
+ loff_t *pos);
ssize_t (*dbo_declare_write)(const struct lu_env *, struct dt_object *,
const loff_t, loff_t, struct thandle *);
ssize_t (*dbo_write)(const struct lu_env , struct dt_object *,
- const struct lu_buf *, loff_t *, struct thandle *,
- struct lustre_capa *, int);
+ const struct lu_buf *, loff_t *, struct thandle *, int);
int (*dbo_bufs_get)(const struct lu_env *, struct dt_object *, loff_t,
- ssize_t, struct niobuf_local *, int, struct lustre_capa *);
+ ssize_t, struct niobuf_local *, int);
int (*dbo_bufs_put)(const struct lu_env *, struct dt_object *,
struct niobuf_local *, int);
int (*dbo_write_prep)(const struct lu_env *, struct dt_object *,
struct niobuf_local *, int);
int (*dbo_fiemap_get)(const struct lu_env *, struct dt_object *,
struct ll_user_fiemap *);
-int (*do_declare_punch)(const struct lu_env*, struct dt_object *, __u64,
+int (*dbo_declare_punch)(const struct lu_env*, struct dt_object *, __u64,
__u64,struct thandle *);
-int (*do_punch)(const struct lu_env *, struct dt_object *, __u64, __u64,
- struct thandle *, struct lustre_capa *);
+int (*dbo_punch)(const struct lu_env *, struct dt_object *, __u64, __u64,
+ struct thandle *);
dbo_read
is called to read raw unstructured data from a specified range of an
The method prototypes are defined in dt_index_operations as follows:
int (*dio_lookup)(const struct lu_env *, struct dt_object *, struct dt_rec *,
- const struct dt_key *, struct lustre_capa *);
+ const struct dt_key *);
int (*dio_declare_insert)(const struct lu_env *, struct dt_object *,
const struct dt_rec *, const struct dt_key *,
struct thandle *);
int (*dio_insert)(const struct lu_env *, struct dt_object *,
const struct dt_rec *, const struct dt_key *,
- struct thandle *, struct lustre_capa *, int);
+ struct thandle *, int);
int (*dio_declare_delete)(const struct lu_env *, struct dt_object *,
const struct dt_key *, struct thandle *);
int (*dio_delete)(const struct lu_env *, struct dt_object *,
- const struct dt_key *, struct thandle *,
- struct lustre_capa *);
+ const struct dt_key *, struct thandle *);
dio_lookup
is called to lookup exact key=value pair. A value is copied into a
To iterate over all key=value pair stored in an index, OSD should provide the
following set of methods:
-struct dt_it *(*init)(const struct lu_env *, struct dt_object *, __u32,
- struct lustre_capa *);
+struct dt_it *(*init)(const struct lu_env *, struct dt_object *, __u32);
void (*fini)(const struct lu_env *, struct dt_it *);
int (*get)(const struct lu_env *, struct dt_it *, const struct dt_key *);
void (*put)(const struct lu_env *, struct dt_it *);
The QSD API is defined in lustre/include/lustre_quota.h as follows:
struct qsd_instance *qsd_init(const struct lu_env *, char *, struct dt_device *,
- cfs_proc_dir_entry_t *);
+ struct proc_dir_entry *);
int qsd_prepare(const struct lu_env *, struct qsd_instance *);
int qsd_start(const struct lu_env *, struct qsd_instance *);
void qsd_fini(const struct lu_env *, struct qsd_instance *);
struct lquota_trans *, struct lquota_id_info *, int *);
void qsd_op_end(const struct lu_env *, struct qsd_instance *,
struct lquota_trans *);
-void qsd_adjust_quota(const struct lu_env *, struct qsd_instance *,
- union lquota_id *, int);
+void qsd_op_adjust(const struct lu_env *, struct qsd_instance *,
+ union lquota_id *, int);
qsd_init
The OSD module should first allocate a qsd instance via qsd_init.
each time a new operation is declared, qsd_op_end should be called only
once for the whole transaction.
-qsd_adjust_quota
+qsd_op_adjust
Trigger pre-acquire/release if necessary, it's only used for ldiskfs osd
so far. When unlink a file in ldiskfs, the quota accounting isn't
updated when the transaction stopped. Instead, it'll be updated on the
- final iput, so qsd_adjust_quota() will be called then (in
+ final iput, so qsd_op_adjust() will be called then (in
osd_object_delete()) to trigger quota release if necessary.
Appendix 1. A brief note on Lustre configuration.
Lustre currently has 2 different OSD implementations:
- ldiskfs OSD under lustre/osd-ldiskfs
- http://git.whamcloud.com/?p=fs/lustre-release.git;a=tree;f=lustre/osd-ldiskfs;hb=HEAD
+ http://git.hpdd.intel.com/?p=fs/lustre-release.git;a=tree;f=lustre/osd-ldiskfs;hb=HEAD
- ZFS OSD under lustre/zfs-osd
- http://git.whamcloud.com/?p=fs/lustre-release.git;a=tree;f=lustre/osd-zfs;hb=HEAD
+ http://git.hpdd.intel.com/?p=fs/lustre-release.git;a=tree;f=lustre/osd-zfs;hb=HEAD
git://git.whamcloud.com / fs / lustre-release.git / blobdiff