4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License version 2 for more details (a copy is included
14 * in the LICENSE file that accompanied this code).
16 * You should have received a copy of the GNU General Public License
17 * version 2 along with this program; If not, see
18 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
20 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21 * CA 95054 USA or visit www.sun.com if you need additional information or
27 * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2012, 2013, Intel Corporation.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
37 #ifndef _OFD_INTERNAL_H
38 #define _OFD_INTERNAL_H
41 #include <obd_class.h>
42 #include <dt_object.h>
43 #include <md_object.h>
44 #include <lustre_fid.h>
45 #include <lustre_capa.h>
47 #define OFD_INIT_OBJID 0
48 #define OFD_ROCOMPAT_SUPP (0)
49 #define OFD_INCOMPAT_SUPP (OBD_INCOMPAT_GROUPS | OBD_INCOMPAT_OST | \
50 OBD_INCOMPAT_COMMON_LR)
51 #define OFD_PRECREATE_BATCH_DEFAULT (OBJ_SUBDIR_COUNT * 4)
53 /* on small filesystems we should not precreate too many objects in
54 * a single transaction, otherwise we can overflow transactions */
55 #define OFD_PRECREATE_SMALL_FS (1024ULL * 1024 * 1024)
56 #define OFD_PRECREATE_BATCH_SMALL 8
58 /* Limit the returned fields marked valid to those that we actually might set */
59 #define OFD_VALID_FLAGS (LA_TYPE | LA_MODE | LA_SIZE | LA_BLOCKS | \
60 LA_BLKSIZE | LA_ATIME | LA_MTIME | LA_CTIME)
62 /* per-client-per-object persistent state (LRU) */
64 cfs_list_t fmd_list; /* linked to fed_mod_list */
65 struct lu_fid fmd_fid; /* FID being written to */
66 __u64 fmd_mactime_xid; /* xid highest {m,a,c}time setattr */
67 cfs_time_t fmd_expire; /* time when the fmd should expire */
68 int fmd_refcount; /* reference counter - list holds 1 */
71 #define OFD_FMD_MAX_NUM_DEFAULT 128
72 #define OFD_FMD_MAX_AGE_DEFAULT ((obd_timeout + 10) * HZ)
74 #define OFD_SOFT_SYNC_LIMIT_DEFAULT 16
78 LPROC_OFD_STATS_READ = 0,
79 LPROC_OFD_STATS_WRITE,
80 LPROC_OFD_STATS_GETATTR,
81 LPROC_OFD_STATS_SETATTR,
82 LPROC_OFD_STATS_PUNCH,
84 LPROC_OFD_STATS_DESTROY,
85 LPROC_OFD_STATS_CREATE,
86 LPROC_OFD_STATS_STATFS,
87 LPROC_OFD_STATS_GET_INFO,
88 LPROC_OFD_STATS_SET_INFO,
89 LPROC_OFD_STATS_QUOTACTL,
93 static inline void ofd_counter_incr(struct obd_export *exp, int opcode,
94 char *jobid, long amount)
96 if (exp->exp_obd && exp->exp_obd->obd_stats)
97 lprocfs_counter_add(exp->exp_obd->obd_stats, opcode, amount);
99 if (exp->exp_obd && exp->exp_obd->u.obt.obt_jobstats.ojs_hash &&
100 (exp_connect_flags(exp) & OBD_CONNECT_JOBSTATS))
101 lprocfs_job_stats_log(exp->exp_obd, jobid, opcode, amount);
103 if (exp->exp_nid_stats != NULL &&
104 exp->exp_nid_stats->nid_stats != NULL) {
105 lprocfs_counter_add(exp->exp_nid_stats->nid_stats, opcode,
113 spinlock_t os_last_oid_lock;
114 struct mutex os_create_lock;
116 struct dt_object *os_lastid_obj;
117 unsigned long os_destroys_in_progress:1;
121 struct dt_device ofd_dt_dev;
122 struct dt_device *ofd_osd;
123 struct obd_export *ofd_osd_exp;
124 struct dt_device_param ofd_dt_conf;
125 /* DLM name-space for meta-data locks maintained by this server */
126 struct ldlm_namespace *ofd_namespace;
129 struct lu_target ofd_lut;
130 struct dt_object *ofd_health_check_file;
132 int ofd_subdir_count;
133 __u64 ofd_inconsistency_self_detected;
134 __u64 ofd_inconsistency_self_repaired;
136 cfs_list_t ofd_seq_list;
137 rwlock_t ofd_seq_list_lock;
139 int ofd_precreate_batch;
140 spinlock_t ofd_batch_lock;
142 /* protect all statfs-related counters */
143 spinlock_t ofd_osfs_lock;
144 /* statfs optimization: we cache a bit */
145 struct obd_statfs ofd_osfs;
148 /* writes which might be be accounted twice in ofd_osfs.os_bavail */
149 obd_size ofd_osfs_unstable;
151 /* counters used during statfs update, protected by ofd_osfs_lock.
152 * record when some statfs refresh are in progress */
153 int ofd_statfs_inflight;
154 /* track writes completed while statfs refresh is underway.
155 * tracking is only effective when ofd_statfs_inflight > 1 */
156 obd_size ofd_osfs_inflight;
158 /* grants: all values in bytes */
159 /* grant lock to protect all grant counters */
160 spinlock_t ofd_grant_lock;
161 /* total amount of dirty data reported by clients in incoming obdo */
162 obd_size ofd_tot_dirty;
163 /* sum of filesystem space granted to clients for async writes */
164 obd_size ofd_tot_granted;
165 /* grant used by I/Os in progress (between prepare and commit) */
166 obd_size ofd_tot_pending;
167 /* free space threshold over which we stop granting space to clients
168 * ofd_grant_ratio is stored as a fixed-point fraction using
169 * OFD_GRANT_RATIO_SHIFT of the remaining free space, not in percentage
172 /* number of clients using grants */
173 int ofd_tot_granted_clients;
175 /* ofd mod data: ofd_device wide values */
176 int ofd_fmd_max_num; /* per ofd ofd_mod_data */
177 cfs_duration_t ofd_fmd_max_age; /* time to fmd expiry */
179 spinlock_t ofd_flags_lock;
180 unsigned long ofd_raid_degraded:1,
181 /* sync journal on writes */
183 /* shall we grant space to clients not
184 * supporting OBD_CONNECT_GRANT_PARAM? */
185 ofd_grant_compat_disable:1,
186 /* Protected by ofd_lastid_rwsem. */
187 ofd_lastid_rebuilding:1,
188 ofd_record_fid_accessed:1,
189 ofd_lfsck_verify_pfid:1;
190 struct seq_server_site ofd_seq_site;
191 /* the limit of SOFT_SYNC RPCs that will trigger a soft sync */
192 unsigned int ofd_soft_sync_limit;
193 /* Protect ::ofd_lastid_rebuilding */
194 struct rw_semaphore ofd_lastid_rwsem;
195 __u64 ofd_lastid_gen;
196 struct ptlrpc_thread ofd_inconsistency_thread;
197 struct list_head ofd_inconsistency_list;
198 spinlock_t ofd_inconsistency_lock;
201 static inline struct ofd_device *ofd_dev(struct lu_device *d)
203 return container_of0(d, struct ofd_device, ofd_dt_dev.dd_lu_dev);
206 static inline struct obd_device *ofd_obd(struct ofd_device *ofd)
208 return ofd->ofd_dt_dev.dd_lu_dev.ld_obd;
211 static inline struct ofd_device *ofd_exp(struct obd_export *exp)
213 return ofd_dev(exp->exp_obd->obd_lu_dev);
216 static inline char *ofd_name(struct ofd_device *ofd)
218 return ofd->ofd_dt_dev.dd_lu_dev.ld_obd->obd_name;
222 struct lu_object_header ofo_header;
223 struct dt_object ofo_obj;
224 struct lu_fid ofo_pfid;
225 unsigned int ofo_pfid_checking:1,
229 static inline struct ofd_object *ofd_obj(struct lu_object *o)
231 return container_of0(o, struct ofd_object, ofo_obj.do_lu);
234 static inline int ofd_object_exists(struct ofd_object *obj)
236 LASSERT(obj != NULL);
237 if (lu_object_is_dying(obj->ofo_obj.do_lu.lo_header))
239 return lu_object_exists(&obj->ofo_obj.do_lu);
242 static inline struct dt_object *fo2dt(struct ofd_object *obj)
244 return &obj->ofo_obj;
247 static inline struct dt_object *ofd_object_child(struct ofd_object *_obj)
249 struct lu_object *lu = &(_obj)->ofo_obj.do_lu;
251 return container_of0(lu_object_next(lu), struct dt_object, do_lu);
254 static inline struct ofd_device *ofd_obj2dev(const struct ofd_object *fo)
256 return ofd_dev(fo->ofo_obj.do_lu.lo_dev);
259 static inline struct lustre_capa *ofd_object_capa(const struct lu_env *env,
260 const struct ofd_object *obj)
262 /* TODO: see mdd_object_capa() */
266 static inline void ofd_read_lock(const struct lu_env *env,
267 struct ofd_object *fo)
269 struct dt_object *next = ofd_object_child(fo);
271 next->do_ops->do_read_lock(env, next, 0);
274 static inline void ofd_read_unlock(const struct lu_env *env,
275 struct ofd_object *fo)
277 struct dt_object *next = ofd_object_child(fo);
279 next->do_ops->do_read_unlock(env, next);
282 static inline void ofd_write_lock(const struct lu_env *env,
283 struct ofd_object *fo)
285 struct dt_object *next = ofd_object_child(fo);
287 next->do_ops->do_write_lock(env, next, 0);
290 static inline void ofd_write_unlock(const struct lu_env *env,
291 struct ofd_object *fo)
293 struct dt_object *next = ofd_object_child(fo);
295 next->do_ops->do_write_unlock(env, next);
299 * Common data shared by obdofd-level handlers. This is allocated per-thread
300 * to reduce stack consumption.
302 struct ofd_thread_info {
303 const struct lu_env *fti_env;
305 struct obd_export *fti_exp;
307 __u64 fti_pre_version;
309 struct lu_fid fti_fid;
310 struct lu_attr fti_attr;
311 struct lu_attr fti_attr2;
312 struct ldlm_res_id fti_resid;
314 struct filter_fid fti_mds_fid;
315 struct filter_fid_old fti_mds_fid_old;
317 struct ost_id fti_ostid;
318 struct ofd_object *fti_obj;
320 char name[64]; /* for ofd_init0() */
321 struct obd_statfs osfs; /* for obdofd_statfs() */
324 /* Ops object filename */
325 struct lu_name fti_name;
326 struct dt_object_format fti_dof;
327 struct lu_buf fti_buf;
330 /* Space used by the I/O, used by grant code */
331 unsigned long fti_used;
332 struct ost_lvb fti_lvb;
333 struct lfsck_request fti_lr;
336 extern void target_recovery_fini(struct obd_device *obd);
337 extern void target_recovery_init(struct lu_target *lut, svc_handler_t handler);
340 int ofd_update_capa_key(struct ofd_device *ofd, struct lustre_capa_key *key);
341 int ofd_auth_capa(struct obd_export *exp, const struct lu_fid *fid,
342 obd_seq seq, struct lustre_capa *capa, __u64 opc);
343 void ofd_free_capa_keys(struct ofd_device *ofd);
346 extern struct lu_context_key ofd_thread_key;
347 int ofd_postrecov(const struct lu_env *env, struct ofd_device *ofd);
348 int ofd_fiemap_get(const struct lu_env *env, struct ofd_device *ofd,
349 struct lu_fid *fid, struct ll_user_fiemap *fiemap);
352 extern struct obd_ops ofd_obd_ops;
353 int ofd_statfs_internal(const struct lu_env *env, struct ofd_device *ofd,
354 struct obd_statfs *osfs, __u64 max_age,
356 int ofd_destroy_by_fid(const struct lu_env *env, struct ofd_device *ofd,
357 const struct lu_fid *fid, int orphan);
358 int ofd_statfs(const struct lu_env *env, struct obd_export *exp,
359 struct obd_statfs *osfs, __u64 max_age, __u32 flags);
360 int ofd_obd_disconnect(struct obd_export *exp);
363 obd_id ofd_seq_last_oid(struct ofd_seq *oseq);
364 void ofd_seq_last_oid_set(struct ofd_seq *oseq, obd_id id);
365 int ofd_seq_last_oid_write(const struct lu_env *env, struct ofd_device *ofd,
366 struct ofd_seq *oseq);
367 int ofd_seqs_init(const struct lu_env *env, struct ofd_device *ofd);
368 struct ofd_seq *ofd_seq_get(struct ofd_device *ofd, obd_seq seq);
369 void ofd_seq_put(const struct lu_env *env, struct ofd_seq *oseq);
371 int ofd_fs_setup(const struct lu_env *env, struct ofd_device *ofd,
372 struct obd_device *obd);
373 void ofd_fs_cleanup(const struct lu_env *env, struct ofd_device *ofd);
374 int ofd_precreate_batch(struct ofd_device *ofd, int batch);
375 struct ofd_seq *ofd_seq_load(const struct lu_env *env, struct ofd_device *ofd,
377 void ofd_seqs_fini(const struct lu_env *env, struct ofd_device *ofd);
378 void ofd_seqs_free(const struct lu_env *env, struct ofd_device *ofd);
381 int ofd_start_inconsistency_verification_thread(struct ofd_device *ofd);
382 int ofd_stop_inconsistency_verification_thread(struct ofd_device *ofd);
383 int ofd_verify_ff(const struct lu_env *env, struct ofd_object *fo,
385 int ofd_preprw(const struct lu_env *env,int cmd, struct obd_export *exp,
386 struct obdo *oa, int objcount, struct obd_ioobj *obj,
387 struct niobuf_remote *rnb, int *nr_local,
388 struct niobuf_local *lnb, struct obd_trans_info *oti,
389 struct lustre_capa *capa);
390 int ofd_commitrw(const struct lu_env *env, int cmd, struct obd_export *exp,
391 struct obdo *oa, int objcount, struct obd_ioobj *obj,
392 struct niobuf_remote *rnb, int npages,
393 struct niobuf_local *lnb, struct obd_trans_info *oti,
397 struct thandle *ofd_trans_create(const struct lu_env *env,
398 struct ofd_device *ofd);
399 int ofd_trans_start(const struct lu_env *env,
400 struct ofd_device *ofd, struct ofd_object *fo,
402 void ofd_trans_stop(const struct lu_env *env, struct ofd_device *ofd,
403 struct thandle *th, int rc);
404 int ofd_txn_stop_cb(const struct lu_env *env, struct thandle *txn,
409 void lprocfs_ofd_init_vars(struct lprocfs_static_vars *lvars);
410 void ofd_stats_counter_init(struct lprocfs_stats *stats);
412 static void lprocfs_ofd_init_vars(struct lprocfs_static_vars *lvars)
414 memset(lvars, 0, sizeof(*lvars));
416 static inline void ofd_stats_counter_init(struct lprocfs_stats *stats) {}
420 struct ofd_object *ofd_object_find(const struct lu_env *env,
421 struct ofd_device *ofd,
422 const struct lu_fid *fid);
423 struct ofd_object *ofd_object_find_or_create(const struct lu_env *env,
424 struct ofd_device *ofd,
425 const struct lu_fid *fid,
426 struct lu_attr *attr);
427 int ofd_object_ff_load(const struct lu_env *env, struct ofd_object *fo);
428 int ofd_precreate_objects(const struct lu_env *env, struct ofd_device *ofd,
429 obd_id id, struct ofd_seq *oseq, int nr, int sync);
431 void ofd_object_put(const struct lu_env *env, struct ofd_object *fo);
432 int ofd_attr_set(const struct lu_env *env, struct ofd_object *fo,
433 struct lu_attr *la, struct filter_fid *ff);
434 int ofd_object_punch(const struct lu_env *env, struct ofd_object *fo,
435 __u64 start, __u64 end, struct lu_attr *la,
436 struct filter_fid *ff, struct obdo *oa);
437 int ofd_object_destroy(const struct lu_env *, struct ofd_object *, int);
438 int ofd_attr_get(const struct lu_env *env, struct ofd_object *fo,
440 int ofd_attr_handle_ugid(const struct lu_env *env, struct ofd_object *fo,
441 struct lu_attr *la, int is_setattr);
444 struct ofd_object *ofd_object_find_exists(const struct lu_env *env,
445 struct ofd_device *ofd,
446 const struct lu_fid *fid)
448 struct ofd_object *fo;
450 fo = ofd_object_find(env, ofd, fid);
451 if (!IS_ERR(fo) && !ofd_object_exists(fo)) {
452 ofd_object_put(env, fo);
453 fo = ERR_PTR(-ENOENT);
459 #define OFD_GRANT_RATIO_SHIFT 8
460 static inline __u64 ofd_grant_reserved(struct ofd_device *ofd, obd_size bavail)
462 return (bavail * ofd->ofd_grant_ratio) >> OFD_GRANT_RATIO_SHIFT;
465 static inline int ofd_grant_ratio_conv(int percentage)
467 return (percentage << OFD_GRANT_RATIO_SHIFT) / 100;
470 static inline int ofd_grant_param_supp(struct obd_export *exp)
472 return !!(exp_connect_flags(exp) & OBD_CONNECT_GRANT_PARAM);
475 /* Blocksize used for client not supporting OBD_CONNECT_GRANT_PARAM.
476 * That's 4KB=2^12 which is the biggest block size known to work whatever
477 * the client's page size is. */
478 #define COMPAT_BSIZE_SHIFT 12
479 static inline int ofd_grant_compat(struct obd_export *exp,
480 struct ofd_device *ofd)
482 /* Clients which don't support OBD_CONNECT_GRANT_PARAM cannot handle
483 * a block size > page size and consume PAGE_CACHE_SIZE of grant when
484 * dirtying a page regardless of the block size */
485 return !!(ofd_obd(ofd)->obd_self_export != exp &&
486 ofd->ofd_blockbits > COMPAT_BSIZE_SHIFT &&
487 !ofd_grant_param_supp(exp));
490 static inline int ofd_grant_prohibit(struct obd_export *exp,
491 struct ofd_device *ofd)
493 /* When ofd_grant_compat_disable is set, we don't grant any space to
494 * clients not supporting OBD_CONNECT_GRANT_PARAM.
495 * Otherwise, space granted to such a client is inflated since it
496 * consumes PAGE_CACHE_SIZE of grant space per block */
497 return !!(ofd_grant_compat(exp, ofd) && ofd->ofd_grant_compat_disable);
500 void ofd_grant_sanity_check(struct obd_device *obd, const char *func);
501 long ofd_grant_connect(const struct lu_env *env, struct obd_export *exp,
502 obd_size want, bool conservative);
503 void ofd_grant_discard(struct obd_export *exp);
504 void ofd_grant_prepare_read(const struct lu_env *env, struct obd_export *exp,
506 void ofd_grant_prepare_write(const struct lu_env *env, struct obd_export *exp,
507 struct obdo *oa, struct niobuf_remote *rnb,
509 void ofd_grant_commit(const struct lu_env *env, struct obd_export *exp, int rc);
510 int ofd_grant_create(const struct lu_env *env, struct obd_export *exp, int *nr);
513 int ofd_fmd_init(void);
514 void ofd_fmd_exit(void);
515 struct ofd_mod_data *ofd_fmd_find(struct obd_export *exp,
516 const struct lu_fid *fid);
517 struct ofd_mod_data *ofd_fmd_get(struct obd_export *exp,
518 const struct lu_fid *fid);
519 void ofd_fmd_put(struct obd_export *exp, struct ofd_mod_data *fmd);
520 void ofd_fmd_expire(struct obd_export *exp);
521 void ofd_fmd_cleanup(struct obd_export *exp);
523 void ofd_fmd_drop(struct obd_export *exp, const struct lu_fid *fid);
525 #define ofd_fmd_drop(exp, fid) do {} while (0)
529 int ofd_fid_set_index(const struct lu_env *env, struct ofd_device *ofd,
531 int ofd_fid_init(const struct lu_env *env, struct ofd_device *ofd);
532 int ofd_fid_fini(const struct lu_env *env, struct ofd_device *ofd);
535 extern struct ldlm_valblock_ops ofd_lvbo;
538 int ofd_intent_policy(struct ldlm_namespace *ns, struct ldlm_lock **lockp,
539 void *req_cookie, ldlm_mode_t mode, __u64 flags,
542 static inline struct ofd_thread_info *ofd_info(const struct lu_env *env)
544 struct ofd_thread_info *info;
546 lu_env_refill((void *)env);
547 info = lu_context_key_get(&env->le_ctx, &ofd_thread_key);
552 static inline struct ofd_thread_info *ofd_info_init(const struct lu_env *env,
553 struct obd_export *exp)
555 struct ofd_thread_info *info;
557 info = ofd_info(env);
558 LASSERT(info->fti_exp == NULL);
559 LASSERT(info->fti_env == NULL);
560 LASSERT(info->fti_attr.la_valid == 0);
564 info->fti_pre_version = 0;
568 static inline struct ofd_thread_info *tsi2ofd_info(struct tgt_session_info *tsi)
570 struct ptlrpc_request *req = tgt_ses_req(tsi);
571 struct ofd_thread_info *info;
573 info = ofd_info(tsi->tsi_env);
574 LASSERT(info->fti_exp == NULL);
575 LASSERT(info->fti_env == NULL);
576 LASSERT(info->fti_attr.la_valid == 0);
578 info->fti_env = tsi->tsi_env;
579 info->fti_exp = tsi->tsi_exp;
581 info->fti_xid = req->rq_xid;
582 /** VBR: take versions from request */
583 if (req->rq_reqmsg != NULL &&
584 lustre_msg_get_flags(req->rq_reqmsg) & MSG_REPLAY) {
585 __u64 *pre_version = lustre_msg_get_versions(req->rq_reqmsg);
587 info->fti_pre_version = pre_version ? pre_version[0] : 0;
592 static inline void ofd_oti2info(struct ofd_thread_info *info,
593 struct obd_trans_info *oti)
595 info->fti_xid = oti->oti_xid;
596 info->fti_pre_version = oti->oti_pre_version;
599 static inline void ofd_info2oti(struct ofd_thread_info *info,
600 struct obd_trans_info *oti)
602 oti->oti_xid = info->fti_xid;
603 oti->oti_pre_version = info->fti_pre_version;
606 /* sync on lock cancel is useless when we force a journal flush,
607 * and if we enable async journal commit, we should also turn on
608 * sync on lock cancel if it is not enabled already. */
609 static inline void ofd_slc_set(struct ofd_device *ofd)
611 if (ofd->ofd_syncjournal == 1)
612 ofd->ofd_lut.lut_sync_lock_cancel = NEVER_SYNC_ON_CANCEL;
613 else if (ofd->ofd_lut.lut_sync_lock_cancel == NEVER_SYNC_ON_CANCEL)
614 ofd->ofd_lut.lut_sync_lock_cancel = ALWAYS_SYNC_ON_CANCEL;
617 static inline void ofd_prepare_fidea(struct filter_fid *ff,
618 const struct obdo *oa)
620 /* packing fid and converting it to LE for storing into EA.
621 * Here ->o_stripe_idx should be filled by LOV and rest of
622 * fields - by client. */
623 ff->ff_parent.f_seq = cpu_to_le64(oa->o_parent_seq);
624 ff->ff_parent.f_oid = cpu_to_le32(oa->o_parent_oid);
625 /* XXX: we are ignoring o_parent_ver here, since this should
626 * be the same for all objects in this fileset. */
627 ff->ff_parent.f_ver = cpu_to_le32(oa->o_stripe_idx);
630 /* niobuf_remote has no rnb_ prefix in master */
631 #define rnb_offset offset
632 #define rnb_flags flags
634 /* the same for niobuf_local */
635 #define lnb_flags flags
638 #endif /* _OFD_INTERNAL_H */