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.gnu.org/licenses/gpl-2.0.html
23 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Use is subject to license terms.
26 * Copyright (c) 2011, 2017, Intel Corporation.
29 * This file is part of Lustre, http://www.lustre.org/
30 * Lustre is a trademark of Sun Microsystems, Inc.
32 * lustre/mdt/mdt_internal.h
34 * Lustre Metadata Target (mdt) request handler
36 * Author: Peter Braam <braam@clusterfs.com>
37 * Author: Andreas Dilger <adilger@clusterfs.com>
38 * Author: Phil Schwan <phil@clusterfs.com>
39 * Author: Mike Shaver <shaver@clusterfs.com>
40 * Author: Nikita Danilov <nikita@clusterfs.com>
41 * Author: Huang Hua <huanghua@clusterfs.com>
44 #ifndef _MDT_INTERNAL_H
45 #define _MDT_INTERNAL_H
47 #include <libcfs/libcfs.h>
48 #include <libcfs/libcfs_hash.h>
49 #include <upcall_cache.h>
50 #include <obd_class.h>
51 #include <lustre_disk.h>
52 #include <lu_target.h>
53 #include <md_object.h>
54 #include <lustre_fid.h>
55 #include <lustre_fld.h>
56 #include <lustre_req_layout.h>
57 #include <lustre_sec.h>
58 #include <lustre_idmap.h>
59 #include <lustre_eacl.h>
60 #include <lustre_quota.h>
61 #include <lustre_linkea.h>
65 /* file data for open files on MDS */
66 struct mdt_file_data {
67 /** portals handle must be first */
68 struct portals_handle mfd_open_handle;
69 /** open mode provided by client */
71 /** protected by med_open_lock */
72 struct list_head mfd_list;
73 /** xid of the open request */
75 /** old handle in replay case */
76 struct lustre_handle mfd_open_handle_old;
77 /** point to opened object */
78 struct mdt_object *mfd_object;
81 #define CDT_NONBLOCKING_RESTORE (1ULL << 0)
82 #define CDT_NORETRY_ACTION (1ULL << 1)
83 #define CDT_POLICY_LAST CDT_NORETRY_ACTION
84 #define CDT_POLICY_SHIFT_COUNT 2
85 #define CDT_POLICY_ALL (CDT_NONBLOCKING_RESTORE | \
88 /* when adding a new policy, do not forget to update
89 * lustre/mdt/mdt_coordinator.c::hsm_policy_names[]
91 #define CDT_DEFAULT_POLICY CDT_NORETRY_ACTION
93 /* Coordinator states. Keep the cdt_transition table in sync. */
94 enum cdt_states { CDT_STOPPED = 0,
103 static inline char *cdt_mdt_state2str(int state)
121 /* when multiple lock are needed, the lock order is
129 wait_queue_head_t cdt_waitq; /**< cdt wait queue */
130 bool cdt_event; /**< coordinator event */
131 struct task_struct *cdt_task; /**< cdt thread handle */
132 struct lu_env cdt_env; /**< coordinator lustre
134 struct lu_context cdt_session; /** session for lu_ucred */
135 struct proc_dir_entry *cdt_proc_dir; /**< cdt /proc directory */
136 __u64 cdt_policy; /**< policy flags */
137 enum cdt_states cdt_state; /**< state */
138 struct mutex cdt_state_lock; /**< cdt_state lock */
139 __u64 cdt_last_cookie; /**< last cookie
141 struct rw_semaphore cdt_llog_lock; /**< protect llog
143 struct rw_semaphore cdt_agent_lock; /**< protect agent list */
144 struct rw_semaphore cdt_request_lock; /**< protect request
146 struct mutex cdt_restore_lock; /**< protect restore
148 time64_t cdt_loop_period; /**< llog scan period */
149 time64_t cdt_grace_delay; /**< request grace
151 time64_t cdt_active_req_timeout; /**< request timeout */
152 __u32 cdt_default_archive_id; /**< archive id used
155 __u64 cdt_max_requests; /**< max count of started
157 /** Current count of active requests */
158 atomic_t cdt_request_count; /** total */
159 atomic_t cdt_archive_count;
160 atomic_t cdt_restore_count;
161 atomic_t cdt_remove_count;
163 /* started requests (struct cdt_agent_req:car_cookie_hash)
164 * indexed by cookie */
165 struct cfs_hash *cdt_request_cookie_hash;
166 /* started requests (struct cdt_agent_req:car_request_list) */
167 struct list_head cdt_request_list;
168 struct list_head cdt_agents; /**< list of register
170 struct list_head cdt_restore_handle_list;
172 /* Hash of cookies to locations of record locations in agent
174 struct cfs_hash *cdt_agent_record_hash;
176 /* Bitmasks indexed by the HSMA_XXX constants. */
177 __u64 cdt_user_request_mask;
178 __u64 cdt_group_request_mask;
179 __u64 cdt_other_request_mask;
181 /* Remove archive on last unlink policy */
182 bool cdt_remove_archive_on_last_unlink;
184 bool cdt_wakeup_coordinator;
187 /* mdt state flag bits */
188 #define MDT_FL_CFGLOG 0
189 #define MDT_FL_SYNCED 1
191 /* possible values for mo_dom_lock */
193 NO_DOM_LOCK_ON_OPEN = 0,
194 TRYLOCK_DOM_ON_OPEN = 1,
195 ALWAYS_DOM_LOCK_ON_OPEN = 2,
196 NUM_DOM_LOCK_ON_OPEN_MODES
199 struct mdt_statfs_cache {
200 struct obd_statfs msf_osfs;
206 struct lu_device mdt_lu_dev;
207 struct seq_server_site mdt_seq_site;
208 /* DLM name-space for meta-data locks maintained by this server */
209 struct ldlm_namespace *mdt_namespace;
210 /* ptlrpc handle for MDS->client connections (for lock ASTs). */
211 struct ptlrpc_client *mdt_ldlm_client;
212 /* underlying device */
213 struct obd_export *mdt_child_exp;
214 struct md_device *mdt_child;
215 struct dt_device *mdt_bottom;
216 struct obd_export *mdt_bottom_exp;
217 struct local_oid_storage *mdt_los;
219 struct lu_target mdt_lut;
221 * Options bit-fields.
224 unsigned int mo_user_xattr:1,
229 mo_migrate_hsm_allowed:1;
230 unsigned int mo_dom_lock;
232 /* mdt state flags */
233 unsigned long mdt_state;
235 /* transaction callbacks */
236 struct dt_txn_callback mdt_txn_cb;
238 /* these values should be updated from lov if necessary.
239 * or should be placed somewhere else. */
244 /* preferred BRW size, decided by storage type and capability */
247 struct upcall_cache *mdt_identity_cache;
249 unsigned int mdt_capa_conf:1,
250 /* Enable remote dir on non-MDT0 */
251 mdt_enable_remote_dir:1,
252 mdt_enable_striped_dir:1,
253 mdt_enable_dir_migration:1,
254 mdt_enable_remote_rename:1,
256 /* subdirectory mount of remote dir */
257 mdt_enable_remote_subdir_mount:1;
259 /* user with gid can create remote/striped
260 * dir, and set default dir stripe */
261 gid_t mdt_enable_remote_dir_gid;
262 /* user with this gid can change projid */
263 gid_t mdt_enable_chprojid_gid;
265 /* lock for osfs and md_root */
268 /* statfs optimization: we cache a bit */
269 struct mdt_statfs_cache mdt_sum_osfs;
270 struct mdt_statfs_cache mdt_osfs;
273 struct root_squash_info mdt_squash;
275 struct rename_stats mdt_rename_stats;
276 struct lu_fid mdt_md_root_fid;
278 /* connection to quota master */
279 struct obd_export *mdt_qmt_exp;
280 /* quota master device associated with this MDT */
281 struct lu_device *mdt_qmt_dev;
283 struct coordinator mdt_coordinator;
285 /* inter-MDT connection count */
286 atomic_t mdt_mds_mds_conns;
288 /* MDT device async commit count, used for debug and sanity test */
289 atomic_t mdt_async_commit_count;
291 struct mdt_object *mdt_md_root;
294 #define MDT_SERVICE_WATCHDOG_FACTOR (2)
295 #define MDT_COS_DEFAULT (0)
297 #define ENOENT_VERSION 1 /** 'virtual' version of non-existent object */
300 struct lu_object_header mot_header;
301 struct lu_object mot_obj;
302 unsigned int mot_lov_created:1, /* lov object created */
303 mot_cache_attr:1; /* enable remote object
306 spinlock_t mot_write_lock;
307 /* Lock to protect object's SOM update. */
308 struct mutex mot_som_mutex;
309 /* Lock to protect create_data */
310 struct mutex mot_lov_mutex;
311 /* lock to protect read/write stages for Data-on-MDT files */
312 struct rw_semaphore mot_dom_sem;
313 /* Lock to protect lease open.
314 * Lease open acquires write lock; normal open acquires read lock */
315 struct rw_semaphore mot_open_sem;
316 atomic_t mot_lease_count;
317 atomic_t mot_open_count;
320 struct mdt_lock_handle {
321 /* Lock type, reg for cross-ref use or pdo lock. */
325 struct lustre_handle mlh_reg_lh;
326 enum ldlm_mode mlh_reg_mode;
329 struct lustre_handle mlh_pdo_lh;
330 enum ldlm_mode mlh_pdo_mode;
331 unsigned int mlh_pdo_hash;
333 /* Remote regular lock */
334 struct lustre_handle mlh_rreg_lh;
335 enum ldlm_mode mlh_rreg_mode;
339 MDT_LH_PARENT, /* parent lockh */
340 MDT_LH_CHILD, /* child lockh */
341 MDT_LH_OLD, /* old lockh for rename */
342 MDT_LH_LAYOUT = MDT_LH_OLD, /* layout lock */
343 MDT_LH_NEW, /* new lockh for rename */
344 MDT_LH_RMT, /* used for return lh to caller */
345 MDT_LH_LOCAL, /* local lock never return to client */
354 /* Special magical errno for communicaiton between mdt_reint_open()
355 * and mdt_intent_reint() which means return the lock to the client
356 * for subsequent cross ref open. Previously we used plain -EREMOTE
357 * but other functions called in that path might return it too and
358 * confuse us. This is not returned to the client. See LU-5370. */
359 #define MDT_EREMOTE_OPEN (EREMOTE + 1024)
361 struct mdt_reint_record {
362 enum mds_reint_op rr_opcode;
363 const struct lustre_handle *rr_open_handle;
364 const struct lustre_handle *rr_lease_handle;
365 const struct lu_fid *rr_fid1;
366 const struct lu_fid *rr_fid2;
367 struct lu_name rr_name;
368 struct lu_name rr_tgt_name;
375 enum mdt_reint_flag {
376 MRF_OPEN_TRUNC = 1 << 0,
380 * Common data shared by mdt-level handlers. This is allocated per-thread to
381 * reduce stack consumption.
383 struct mdt_thread_info {
386 * The following members will be filled explicitly
387 * with specific data in mdt_thread_info_init().
389 /* TODO: move this into mdt_session_key(with LCT_SESSION), because
390 * request handling may migrate from one server thread to another.
392 struct req_capsule *mti_pill;
394 /* although we have export in req, there are cases when it is not
395 * available, e.g. closing files upon export destroy */
396 struct obd_export *mti_exp;
398 * A couple of lock handles.
400 struct mdt_lock_handle mti_lh[MDT_LH_NR];
402 struct mdt_device *mti_mdt;
403 const struct lu_env *mti_env;
405 /* transaction number of current request */
411 * The following members will be filled expilictly
412 * with zero in mdt_thread_info_init(). These members may be used
419 struct md_attr mti_attr;
420 struct md_attr mti_attr2; /* mdt_lvb.c */
422 * Body for "habeo corpus" operations.
424 const struct mdt_body *mti_body;
426 * Host object. This is released at the end of mdt_handler().
428 struct mdt_object *mti_object;
430 * Lock request for "habeo clavis" operations.
432 const struct ldlm_request *mti_dlm_req;
434 __u32 mti_has_trans:1, /* has txn already? */
436 /* big_lmm buffer was used and must be used in reply */
441 /* opdata for mdt_reint_open(), has the same as
442 * ldlm_reply:lock_policy_res1. mdt_update_last_rcvd() stores this
443 * value onto disk for recovery when mdt_trans_stop_cb() is called.
449 * The following members will be filled explicitly
450 * with zero in mdt_reint_unpack(), because they are only used
451 * by reint requests (including mdt_reint_open()).
455 * reint record. contains information for reint operations.
457 struct mdt_reint_record mti_rr;
459 __u64 mti_ver[PTLRPC_NUM_VERSIONS];
461 * Operation specification (currently create and lookup)
463 struct md_op_spec mti_spec;
467 * The following members will _NOT_ be initialized at all.
468 * DO NOT expect them to contain any valid value.
469 * They should be initialized explicitly by the user themselves.
472 /* XXX: If something is in a union, make sure they do not conflict */
473 struct lu_fid mti_tmp_fid1;
474 struct lu_fid mti_tmp_fid2;
475 union ldlm_policy_data mti_policy; /* for mdt_object_lock() */
476 struct ldlm_res_id mti_res_id; /* and mdt_rename_lock() */
478 struct obd_uuid uuid[2]; /* for mdt_seq_init_cli() */
479 char ns_name[48];/* for mdt_init0() */
480 struct lustre_cfg_bufs bufs; /* for mdt_stack_fini() */
481 struct obd_statfs osfs; /* for mdt_statfs() */
483 /* for mdt_readpage() */
484 struct lu_rdpg mti_rdpg;
485 /* for mdt_sendpage() */
486 struct l_wait_info mti_wait_info;
496 struct lustre_handle mti_open_handle;
498 struct lu_buf mti_buf;
499 struct lu_buf mti_big_buf;
501 /* Ops object filename */
502 struct lu_name mti_name;
503 char mti_filename[NAME_MAX + 1];
504 /* per-thread values, can be re-used, may be vmalloc'd */
509 /* should be enough to fit lustre_mdt_attrs */
510 char mti_xattr_buf[128];
511 struct ldlm_enqueue_info mti_einfo[2];
512 /* einfo used by mdt_remote_object_lock_try() */
513 struct ldlm_enqueue_info mti_remote_einfo;
514 struct tg_reply_data *mti_reply_data;
516 /* FLR: layout change API */
517 struct md_layout_change mti_layout;
518 struct lu_seq_range mti_range;
521 extern struct lu_context_key mdt_thread_key;
523 static inline struct mdt_thread_info *mdt_th_info(const struct lu_env *env)
525 return lu_env_info(env, &mdt_thread_key);
528 struct cdt_req_progress {
529 struct mutex crp_lock; /**< protect tree */
530 struct interval_node *crp_root; /**< tree to track extent
532 struct interval_node **crp_node; /**< buffer for tree nodes
533 * vector of fixed size
535 int crp_cnt; /**< # of used nodes */
536 int crp_max; /**< # of allocated nodes */
539 struct cdt_agent_req {
540 struct hlist_node car_cookie_hash; /**< find req by cookie */
541 struct list_head car_request_list; /**< to chain all the req. */
542 atomic_t car_refcount; /**< reference counter */
543 __u64 car_flags; /**< request original flags */
544 struct obd_uuid car_uuid; /**< agent doing the req. */
545 __u32 car_archive_id; /**< archive id */
546 int car_canceled; /**< request was canceled */
547 time64_t car_req_start; /**< start time */
548 time64_t car_req_update; /**< last update time */
549 struct hsm_action_item *car_hai; /**< req. to the agent */
550 struct cdt_req_progress car_progress; /**< track data mvt
553 extern struct kmem_cache *mdt_hsm_car_kmem;
556 struct list_head ha_list; /**< to chain the agents */
557 struct obd_uuid ha_uuid; /**< agent uuid */
558 __u32 *ha_archive_id; /**< archive id */
559 int ha_archive_cnt; /**< number of archive entries
560 * 0 means any archive */
561 atomic_t ha_requests; /**< current request count */
562 atomic_t ha_success; /**< number of successful
564 atomic_t ha_failure; /**< number of failed actions */
567 struct cdt_restore_handle {
568 struct list_head crh_list; /**< to chain the handle */
569 struct lu_fid crh_fid; /**< fid of the object */
570 struct ldlm_extent crh_extent; /**< extent of the restore */
571 struct mdt_lock_handle crh_lh; /**< lock handle */
573 extern struct kmem_cache *mdt_hsm_cdt_kmem; /** restore handle slab cache */
575 struct hsm_record_update {
577 enum agent_req_status status;
580 static inline const struct md_device_operations *
581 mdt_child_ops(struct mdt_device * m)
583 LASSERT(m->mdt_child);
584 return m->mdt_child->md_ops;
587 static inline struct md_object *mdt_object_child(struct mdt_object *o)
590 return lu2md(lu_object_next(&o->mot_obj));
593 static inline struct ptlrpc_request *mdt_info_req(struct mdt_thread_info *info)
595 return info->mti_pill ? info->mti_pill->rc_req : NULL;
598 static inline __u64 mdt_conn_flags(struct mdt_thread_info *info)
600 LASSERT(info->mti_exp);
601 return exp_connect_flags(info->mti_exp);
604 static inline void mdt_object_get(const struct lu_env *env,
605 struct mdt_object *o)
608 lu_object_get(&o->mot_obj);
612 static inline void mdt_object_put(const struct lu_env *env,
613 struct mdt_object *o)
616 lu_object_put(env, &o->mot_obj);
620 static inline int mdt_object_exists(const struct mdt_object *o)
622 return lu_object_exists(&o->mot_obj);
625 static inline int mdt_object_remote(const struct mdt_object *o)
627 return lu_object_remote(&o->mot_obj);
630 static inline const struct lu_fid *mdt_object_fid(const struct mdt_object *o)
632 return lu_object_fid(&o->mot_obj);
635 static inline struct lu_site *mdt_lu_site(const struct mdt_device *mdt)
637 return mdt->mdt_lu_dev.ld_site;
640 static inline struct seq_server_site *mdt_seq_site(struct mdt_device *mdt)
642 return &mdt->mdt_seq_site;
645 static inline void mdt_export_evict(struct obd_export *exp)
647 class_fail_export(exp);
650 /* Here we use LVB_TYPE to check dne client, because it is
651 * also landed on 2.4. */
652 static inline bool mdt_is_dne_client(struct obd_export *exp)
654 return !!(exp_connect_flags(exp) & OBD_CONNECT_LVB_TYPE);
657 static inline bool mdt_is_striped_client(struct obd_export *exp)
659 return exp_connect_flags(exp) & OBD_CONNECT_DIR_STRIPE;
668 /* XXX Look into layout in MDT layer. This must be done in LOD. */
669 static inline int mdt_lmm_dom_entry(struct lov_mds_md *lmm)
671 struct lov_comp_md_v1 *comp_v1;
672 struct lov_mds_md *v1;
676 if (le32_to_cpu(lmm->lmm_magic) != LOV_MAGIC_COMP_V1)
679 comp_v1 = (struct lov_comp_md_v1 *)lmm;
680 off = le32_to_cpu(comp_v1->lcm_entries[0].lcme_offset);
681 v1 = (struct lov_mds_md *)((char *)comp_v1 + off);
683 /* DoM entry is the first entry always */
684 if (lov_pattern(le32_to_cpu(v1->lmm_pattern)) != LOV_PATTERN_MDT)
687 for (i = 1; i < le16_to_cpu(comp_v1->lcm_entry_count); i++) {
690 off = le32_to_cpu(comp_v1->lcm_entries[i].lcme_offset);
691 v1 = (struct lov_mds_md *)((char *)comp_v1 + off);
693 for (j = 0; j < le16_to_cpu(v1->lmm_stripe_count); j++) {
694 /* if there is any object on OST */
695 if (le32_to_cpu(v1->lmm_objects[j].l_ost_idx) !=
703 static inline bool mdt_lmm_is_flr(struct lov_mds_md *lmm)
705 struct lov_comp_md_v1 *lcm = (typeof(lcm))lmm;
707 return le32_to_cpu(lmm->lmm_magic) == LOV_MAGIC_COMP_V1 &&
708 le16_to_cpu(lcm->lcm_mirror_count) > 0;
711 static inline bool mdt_is_sum_statfs_client(struct obd_export *exp)
713 return exp_connect_flags(exp) & OBD_CONNECT_FLAGS2 &&
714 exp_connect_flags2(exp) & OBD_CONNECT2_SUM_STATFS;
717 __u64 mdt_get_disposition(struct ldlm_reply *rep, __u64 op_flag);
718 void mdt_set_disposition(struct mdt_thread_info *info,
719 struct ldlm_reply *rep, __u64 op_flag);
720 void mdt_clear_disposition(struct mdt_thread_info *info,
721 struct ldlm_reply *rep, __u64 op_flag);
723 void mdt_lock_pdo_init(struct mdt_lock_handle *lh, enum ldlm_mode lock_mode,
724 const struct lu_name *lname);
726 void mdt_lock_reg_init(struct mdt_lock_handle *lh, enum ldlm_mode lm);
728 int mdt_lock_setup(struct mdt_thread_info *info, struct mdt_object *mo,
729 struct mdt_lock_handle *lh);
731 int mdt_check_resent_lock(struct mdt_thread_info *info, struct mdt_object *mo,
732 struct mdt_lock_handle *lhc);
734 int mdt_object_lock(struct mdt_thread_info *info, struct mdt_object *mo,
735 struct mdt_lock_handle *lh, __u64 ibits);
737 int mdt_reint_object_lock(struct mdt_thread_info *info, struct mdt_object *o,
738 struct mdt_lock_handle *lh, __u64 ibits,
741 int mdt_object_lock_try(struct mdt_thread_info *info, struct mdt_object *mo,
742 struct mdt_lock_handle *lh, __u64 *ibits,
743 __u64 trybits, bool cos_incompat);
745 void mdt_object_unlock(struct mdt_thread_info *info, struct mdt_object *mo,
746 struct mdt_lock_handle *lh, int decref);
747 void mdt_save_lock(struct mdt_thread_info *info, struct lustre_handle *h,
748 enum ldlm_mode mode, int decref);
750 struct mdt_object *mdt_object_new(const struct lu_env *env,
752 const struct lu_fid *);
753 struct mdt_object *mdt_object_find(const struct lu_env *,
755 const struct lu_fid *);
756 struct mdt_object *mdt_object_find_lock(struct mdt_thread_info *,
757 const struct lu_fid *,
758 struct mdt_lock_handle *,
760 void mdt_object_unlock_put(struct mdt_thread_info *,
762 struct mdt_lock_handle *,
765 void mdt_client_compatibility(struct mdt_thread_info *info);
767 int mdt_remote_object_lock(struct mdt_thread_info *mti,
768 struct mdt_object *o, const struct lu_fid *fid,
769 struct lustre_handle *lh,
770 enum ldlm_mode mode, __u64 ibits, bool cache);
771 int mdt_object_local_lock(struct mdt_thread_info *info, struct mdt_object *o,
772 struct mdt_lock_handle *lh, __u64 *ibits,
773 __u64 trybits, bool cos_incompat);
774 int mdt_reint_striped_lock(struct mdt_thread_info *info,
775 struct mdt_object *o,
776 struct mdt_lock_handle *lh,
778 struct ldlm_enqueue_info *einfo,
780 void mdt_reint_striped_unlock(struct mdt_thread_info *info,
781 struct mdt_object *o,
782 struct mdt_lock_handle *lh,
783 struct ldlm_enqueue_info *einfo, int decref);
785 enum mdt_name_flags {
789 int mdt_name_unpack(struct req_capsule *pill,
790 const struct req_msg_field *field,
792 enum mdt_name_flags flags);
793 int mdt_close_unpack(struct mdt_thread_info *info);
794 int mdt_reint_unpack(struct mdt_thread_info *info, __u32 op);
795 void mdt_fix_lov_magic(struct mdt_thread_info *info, void *eadata);
796 int mdt_reint_rec(struct mdt_thread_info *, struct mdt_lock_handle *);
797 #ifdef CONFIG_FS_POSIX_ACL
798 int mdt_pack_acl2body(struct mdt_thread_info *info, struct mdt_body *repbody,
799 struct mdt_object *o, struct lu_nodemap *nodemap);
801 void mdt_pack_attr2body(struct mdt_thread_info *info, struct mdt_body *b,
802 const struct lu_attr *attr, const struct lu_fid *fid);
803 int mdt_pack_size2body(struct mdt_thread_info *info,
804 const struct lu_fid *fid, struct lustre_handle *lh);
805 int mdt_getxattr(struct mdt_thread_info *info);
806 int mdt_reint_setxattr(struct mdt_thread_info *info,
807 struct mdt_lock_handle *lh);
809 void mdt_lock_handle_init(struct mdt_lock_handle *lh);
810 void mdt_lock_handle_fini(struct mdt_lock_handle *lh);
812 void mdt_reconstruct(struct mdt_thread_info *, struct mdt_lock_handle *);
813 void mdt_reconstruct_generic(struct mdt_thread_info *mti,
814 struct mdt_lock_handle *lhc);
816 extern void target_recovery_fini(struct obd_device *obd);
817 extern void target_recovery_init(struct lu_target *lut,
818 svc_handler_t handler);
819 int mdt_fs_setup(const struct lu_env *, struct mdt_device *,
820 struct obd_device *, struct lustre_sb_info *lsi);
821 void mdt_fs_cleanup(const struct lu_env *, struct mdt_device *);
823 int mdt_export_stats_init(struct obd_device *obd,
824 struct obd_export *exp,
827 int mdt_lock_new_child(struct mdt_thread_info *info,
828 struct mdt_object *o,
829 struct mdt_lock_handle *child_lockh);
830 void mdt_mfd_set_mode(struct mdt_file_data *mfd, u64 open_flags);
831 int mdt_reint_open(struct mdt_thread_info *info, struct mdt_lock_handle *lhc);
832 struct mdt_file_data *mdt_open_handle2mfd(struct mdt_export_data *med,
833 const struct lustre_handle *open_handle,
835 int mdt_revoke_remote_lookup_lock(struct mdt_thread_info *info,
836 struct mdt_object *pobj,
837 struct mdt_object *obj);
839 int mdt_get_info(struct tgt_session_info *tsi);
840 int mdt_attr_get_complex(struct mdt_thread_info *info,
841 struct mdt_object *o, struct md_attr *ma);
842 int mdt_big_xattr_get(struct mdt_thread_info *info, struct mdt_object *o,
844 int __mdt_stripe_get(struct mdt_thread_info *info, struct mdt_object *o,
845 struct md_attr *ma, const char *name);
846 int mdt_stripe_get(struct mdt_thread_info *info, struct mdt_object *o,
847 struct md_attr *ma, const char *name);
848 int mdt_attr_get_pfid(struct mdt_thread_info *info, struct mdt_object *o,
849 struct lu_fid *pfid);
850 int mdt_write_get(struct mdt_object *o);
851 void mdt_write_put(struct mdt_object *o);
852 int mdt_write_read(struct mdt_object *o);
853 struct mdt_file_data *mdt_mfd_new(const struct mdt_export_data *med);
854 int mdt_mfd_close(struct mdt_thread_info *info, struct mdt_file_data *mfd);
855 void mdt_mfd_free(struct mdt_file_data *mfd);
856 int mdt_close(struct tgt_session_info *tsi);
857 int mdt_add_dirty_flag(struct mdt_thread_info *info, struct mdt_object *mo,
859 int mdt_fix_reply(struct mdt_thread_info *info);
860 int mdt_handle_last_unlink(struct mdt_thread_info *, struct mdt_object *,
862 void mdt_reconstruct_open(struct mdt_thread_info *, struct mdt_lock_handle *);
863 int mdt_layout_change(struct mdt_thread_info *info, struct mdt_object *obj,
864 struct mdt_lock_handle *lhc,
865 struct md_layout_change *spec);
866 int mdt_device_sync(const struct lu_env *env, struct mdt_device *mdt);
868 struct lu_buf *mdt_buf(const struct lu_env *env, void *area, ssize_t len);
869 const struct lu_buf *mdt_buf_const(const struct lu_env *env,
870 const void *area, ssize_t len);
872 void mdt_dump_lmm(int level, const struct lov_mds_md *lmm, __u64 valid);
873 void mdt_dump_lmv(unsigned int level, const union lmv_mds_md *lmv);
875 bool allow_client_chgrp(struct mdt_thread_info *info, struct lu_ucred *uc);
876 int mdt_check_ucred(struct mdt_thread_info *);
877 int mdt_init_ucred(struct mdt_thread_info *, struct mdt_body *);
878 int mdt_init_ucred_intent_getattr(struct mdt_thread_info *, struct mdt_body *);
879 int mdt_init_ucred_reint(struct mdt_thread_info *);
880 void mdt_exit_ucred(struct mdt_thread_info *);
881 int mdt_version_get_check(struct mdt_thread_info *, struct mdt_object *, int);
882 void mdt_version_get_save(struct mdt_thread_info *, struct mdt_object *, int);
883 int mdt_version_get_check_save(struct mdt_thread_info *, struct mdt_object *,
885 void mdt_thread_info_init(struct ptlrpc_request *req,
886 struct mdt_thread_info *mti);
887 void mdt_thread_info_fini(struct mdt_thread_info *mti);
888 struct mdt_thread_info *tsi2mdt_info(struct tgt_session_info *tsi);
889 void mdt_intent_fixup_resent(struct mdt_thread_info *info,
890 struct ldlm_lock *new_lock,
891 struct mdt_lock_handle *lh, __u64 flags);
892 int mdt_intent_lock_replace(struct mdt_thread_info *info,
893 struct ldlm_lock **lockp,
894 struct mdt_lock_handle *lh,
895 __u64 flags, int result);
897 int hsm_init_ucred(struct lu_ucred *uc);
898 int mdt_hsm_attr_set(struct mdt_thread_info *info, struct mdt_object *obj,
899 const struct md_hsm *mh);
901 int mdt_remote_blocking_ast(struct ldlm_lock *lock, struct ldlm_lock_desc *desc,
902 void *data, int flag);
903 int mdt_links_read(struct mdt_thread_info *info,
904 struct mdt_object *mdt_obj,
905 struct linkea_data *ldata);
906 int mdt_close_internal(struct mdt_thread_info *info, struct ptlrpc_request *req,
907 struct mdt_body *repbody);
908 void mdt_pack_secctx_in_reply(struct mdt_thread_info *info,
909 struct mdt_object *child);
911 static inline struct mdt_device *mdt_dev(struct lu_device *d)
913 return container_of0(d, struct mdt_device, mdt_lu_dev);
916 static inline struct mdt_object *mdt_obj(struct lu_object *o)
918 return container_of0(o, struct mdt_object, mot_obj);
921 static inline struct dt_object *mdt_obj2dt(struct mdt_object *mo)
923 struct lu_object *lo;
924 struct mdt_device *mdt = mdt_dev(mo->mot_obj.lo_dev);
926 lo = lu_object_locate(mo->mot_obj.lo_header,
927 mdt->mdt_bottom->dd_lu_dev.ld_type);
932 static inline bool agent_req_in_final_state(enum agent_req_status ars)
934 return ((ars == ARS_SUCCEED) || (ars == ARS_FAILED) ||
935 (ars == ARS_CANCELED));
938 /* mdt/mdt_identity.c */
939 #define MDT_IDENTITY_UPCALL_PATH "/usr/sbin/l_getidentity"
941 extern struct upcall_cache_ops mdt_identity_upcall_cache_ops;
943 struct md_identity *mdt_identity_get(struct upcall_cache *, __u32);
945 void mdt_identity_put(struct upcall_cache *, struct md_identity *);
947 void mdt_flush_identity(struct upcall_cache *, int);
949 __u32 mdt_identity_get_perm(struct md_identity *, lnet_nid_t);
951 /* mdt/mdt_recovery.c */
952 __u64 mdt_req_from_lrd(struct ptlrpc_request *req, struct tg_reply_data *trd);
955 int mdt_hsm_state_get(struct tgt_session_info *tsi);
956 int mdt_hsm_state_set(struct tgt_session_info *tsi);
957 int mdt_hsm_action(struct tgt_session_info *tsi);
958 int mdt_hsm_progress(struct tgt_session_info *tsi);
959 int mdt_hsm_ct_register(struct tgt_session_info *tsi);
960 int mdt_hsm_ct_unregister(struct tgt_session_info *tsi);
961 int mdt_hsm_request(struct tgt_session_info *tsi);
963 /* mdt/mdt_hsm_cdt_actions.c */
964 extern const struct file_operations mdt_hsm_actions_fops;
965 void dump_llog_agent_req_rec(const char *prefix,
966 const struct llog_agent_req_rec *larr);
967 int cdt_llog_process(const struct lu_env *env, struct mdt_device *mdt,
968 llog_cb_t cb, void *data, u32 start_cat_idx,
969 u32 start_rec_idx, int rw);
970 int mdt_agent_record_add(const struct lu_env *env, struct mdt_device *mdt,
971 __u32 archive_id, __u64 flags,
972 struct hsm_action_item *hai);
973 int mdt_agent_record_update(const struct lu_env *env, struct mdt_device *mdt,
974 struct hsm_record_update *updates,
975 unsigned int updates_count);
976 void cdt_agent_record_hash_add(struct coordinator *cdt, u64 cookie, u32 cat_idt,
978 void cdt_agent_record_hash_lookup(struct coordinator *cdt, u64 cookie,
979 u32 *cat_idt, u32 *rec_idx);
980 void cdt_agent_record_hash_del(struct coordinator *cdt, u64 cookie);
982 /* mdt/mdt_hsm_cdt_agent.c */
983 extern const struct file_operations mdt_hsm_agent_fops;
984 int mdt_hsm_agent_register(struct mdt_thread_info *info,
985 const struct obd_uuid *uuid,
986 int nr_archives, __u32 *archive_num);
987 int mdt_hsm_agent_register_mask(struct mdt_thread_info *info,
988 const struct obd_uuid *uuid,
990 int mdt_hsm_agent_unregister(struct mdt_thread_info *info,
991 const struct obd_uuid *uuid);
992 int mdt_hsm_agent_update_statistics(struct coordinator *cdt,
993 int succ_rq, int fail_rq, int new_rq,
994 const struct obd_uuid *uuid);
995 int mdt_hsm_find_best_agent(struct coordinator *cdt, __u32 archive,
996 struct obd_uuid *uuid);
997 int mdt_hsm_agent_send(struct mdt_thread_info *mti, struct hsm_action_list *hal,
999 /* mdt/mdt_hsm_cdt_client.c */
1000 int mdt_hsm_add_actions(struct mdt_thread_info *info,
1001 struct hsm_action_list *hal);
1002 int mdt_hsm_get_action(struct mdt_thread_info *mti,
1003 const struct lu_fid *fid,
1004 enum hsm_copytool_action *action,
1005 enum agent_req_status *status,
1006 struct hsm_extent *extent);
1007 bool mdt_hsm_restore_is_running(struct mdt_thread_info *mti,
1008 const struct lu_fid *fid);
1009 /* mdt/mdt_hsm_cdt_requests.c */
1010 extern struct cfs_hash_ops cdt_request_cookie_hash_ops;
1011 extern struct cfs_hash_ops cdt_agent_record_hash_ops;
1012 extern const struct file_operations mdt_hsm_active_requests_fops;
1013 void dump_requests(char *prefix, struct coordinator *cdt);
1014 struct cdt_agent_req *mdt_cdt_alloc_request(__u32 archive_id, __u64 flags,
1015 struct obd_uuid *uuid,
1016 struct hsm_action_item *hai);
1017 void mdt_cdt_free_request(struct cdt_agent_req *car);
1018 int mdt_cdt_add_request(struct coordinator *cdt, struct cdt_agent_req *new_car);
1019 struct cdt_agent_req *mdt_cdt_find_request(struct coordinator *cdt, u64 cookie);
1020 void mdt_cdt_get_work_done(struct cdt_agent_req *car, __u64 *done_sz);
1021 void mdt_cdt_get_request(struct cdt_agent_req *car);
1022 void mdt_cdt_put_request(struct cdt_agent_req *car);
1023 struct cdt_agent_req *mdt_cdt_update_request(struct coordinator *cdt,
1024 const struct hsm_progress_kernel *pgs);
1025 int mdt_cdt_remove_request(struct coordinator *cdt, __u64 cookie);
1026 /* mdt/mdt_coordinator.c */
1027 void mdt_hsm_dump_hal(int level, const char *prefix,
1028 struct hsm_action_list *hal);
1029 int cdt_restore_handle_add(struct mdt_thread_info *mti, struct coordinator *cdt,
1030 const struct lu_fid *fid,
1031 const struct hsm_extent *he);
1032 struct cdt_restore_handle *cdt_restore_handle_find(struct coordinator *cdt,
1033 const struct lu_fid *fid);
1034 void cdt_restore_handle_del(struct mdt_thread_info *mti,
1035 struct coordinator *cdt, const struct lu_fid *fid);
1036 /* coordinator management */
1037 int mdt_hsm_cdt_init(struct mdt_device *mdt);
1038 int mdt_hsm_cdt_stop(struct mdt_device *mdt);
1039 int mdt_hsm_cdt_fini(struct mdt_device *mdt);
1042 * Signal the coordinator has work to do
1043 * \param cdt [IN] coordinator
1045 static inline void mdt_hsm_cdt_event(struct coordinator *cdt)
1047 cdt->cdt_event = true;
1050 /* coordinator control /proc interface */
1051 ssize_t mdt_hsm_cdt_control_seq_write(struct file *file,
1052 const char __user *buffer,
1053 size_t count, loff_t *off);
1054 int mdt_hsm_cdt_control_seq_show(struct seq_file *m, void *data);
1055 int hsm_cdt_procfs_init(struct mdt_device *mdt);
1056 void hsm_cdt_procfs_fini(struct mdt_device *mdt);
1057 struct lprocfs_vars *hsm_cdt_get_proc_vars(void);
1058 /* md_hsm helpers */
1059 struct mdt_object *mdt_hsm_get_md_hsm(struct mdt_thread_info *mti,
1060 const struct lu_fid *fid,
1061 struct md_hsm *hsm);
1062 /* actions/request helpers */
1063 int mdt_hsm_add_hal(struct mdt_thread_info *mti,
1064 struct hsm_action_list *hal, struct obd_uuid *uuid);
1065 bool mdt_hsm_is_action_compat(const struct hsm_action_item *hai,
1066 u32 archive_id, u64 rq_flags,
1067 const struct md_hsm *hsm);
1068 int mdt_hsm_update_request_state(struct mdt_thread_info *mti,
1069 struct hsm_progress_kernel *pgs);
1071 int mdt_close_swap_layouts(struct mdt_thread_info *info,
1072 struct mdt_object *o, struct md_attr *ma);
1074 extern struct lu_context_key mdt_thread_key;
1076 /* debug issues helper starts here*/
1077 static inline int mdt_fail_write(const struct lu_env *env,
1078 struct dt_device *dd, int id)
1080 if (OBD_FAIL_CHECK_ORSET(id, OBD_FAIL_ONCE)) {
1081 CERROR(LUSTRE_MDT_NAME": cfs_fail_loc=%x, fail write ops\n",
1083 return dt_ro(env, dd);
1084 /* We set FAIL_ONCE because we never "un-fail" a device */
1090 static inline struct mdt_export_data *mdt_req2med(struct ptlrpc_request *req)
1092 return &req->rq_export->exp_mdt_data;
1095 static inline struct mdt_device *mdt_exp2dev(struct obd_export *exp)
1097 return mdt_dev(exp->exp_obd->obd_lu_dev);
1100 static inline bool mdt_rdonly(struct obd_export *exp)
1102 if (exp_connect_flags(exp) & OBD_CONNECT_RDONLY ||
1103 mdt_exp2dev(exp)->mdt_bottom->dd_rdonly)
1108 typedef void (*mdt_reconstruct_t)(struct mdt_thread_info *mti,
1109 struct mdt_lock_handle *lhc);
1110 static inline int mdt_check_resent(struct mdt_thread_info *info,
1111 mdt_reconstruct_t reconstruct,
1112 struct mdt_lock_handle *lhc)
1114 struct ptlrpc_request *req = mdt_info_req(info);
1118 if (lustre_msg_get_flags(req->rq_reqmsg) & MSG_RESENT) {
1119 OBD_ALLOC_PTR(info->mti_reply_data);
1120 if (info->mti_reply_data == NULL)
1123 if (req_can_reconstruct(req, info->mti_reply_data)) {
1124 reconstruct(info, lhc);
1127 DEBUG_REQ(D_HA, req,
1128 "no reply data found for RESENT req");
1131 OBD_FREE_PTR(info->mti_reply_data);
1132 info->mti_reply_data = NULL;
1137 struct lu_ucred *mdt_ucred(const struct mdt_thread_info *info);
1138 struct lu_ucred *mdt_ucred_check(const struct mdt_thread_info *info);
1140 static inline int is_identity_get_disabled(struct upcall_cache *cache)
1142 return cache ? (strcmp(cache->uc_upcall, "NONE") == 0) : 1;
1145 int mdt_blocking_ast(struct ldlm_lock*, struct ldlm_lock_desc*, void*, int);
1147 static int mdt_dom_glimpse_ast(struct ldlm_lock *lock, void *reqp)
1149 return -ELDLM_NO_LOCK_DATA;
1152 /* Issues dlm lock on passed @ns, @f stores it lock handle into @lh. */
1153 static inline int mdt_fid_lock(const struct lu_env *env,
1154 struct ldlm_namespace *ns,
1155 struct lustre_handle *lh, enum ldlm_mode mode,
1156 union ldlm_policy_data *policy,
1157 const struct ldlm_res_id *res_id,
1158 __u64 flags, const __u64 *client_cookie)
1161 bool glimpse = policy->l_inodebits.bits & MDS_INODELOCK_DOM;
1163 LASSERT(ns != NULL);
1164 LASSERT(lh != NULL);
1166 rc = ldlm_cli_enqueue_local(env, ns, res_id, LDLM_IBITS, policy,
1167 mode, &flags, mdt_blocking_ast,
1168 ldlm_completion_ast,
1169 glimpse ? mdt_dom_glimpse_ast : NULL,
1170 NULL, 0, LVB_T_NONE, client_cookie, lh);
1171 return rc == ELDLM_OK ? 0 : -EIO;
1174 static inline void mdt_fid_unlock(struct lustre_handle *lh, enum ldlm_mode mode)
1176 ldlm_lock_decref(lh, mode);
1179 static inline bool mdt_slc_is_enabled(struct mdt_device *mdt)
1181 return mdt->mdt_lut.lut_sync_lock_cancel == SYNC_LOCK_CANCEL_BLOCKING;
1184 extern mdl_mode_t mdt_mdl_lock_modes[];
1185 extern enum ldlm_mode mdt_dlm_lock_modes[];
1187 /* LCK_MINMODE which is zero returns false for is_power_of_2 */
1189 static inline mdl_mode_t mdt_dlm_mode2mdl_mode(enum ldlm_mode mode)
1191 LASSERT(mode == LCK_MINMODE || is_power_of_2(mode));
1192 return mdt_mdl_lock_modes[mode];
1195 static inline enum ldlm_mode mdt_mdl_mode2dlm_mode(mdl_mode_t mode)
1197 LASSERT(mode == MDL_MINMODE || is_power_of_2(mode));
1198 return mdt_dlm_lock_modes[mode];
1202 int mdt_set_som(struct mdt_thread_info *info, struct mdt_object *obj,
1203 enum lustre_som_flags flag, __u64 size, __u64 blocks);
1204 int mdt_get_som(struct mdt_thread_info *info, struct mdt_object *obj,
1205 struct md_attr *ma);
1206 int mdt_lsom_downgrade(struct mdt_thread_info *info, struct mdt_object *obj);
1207 int mdt_lsom_update(struct mdt_thread_info *info, struct mdt_object *obj,
1211 extern struct ldlm_valblock_ops mdt_lvbo;
1212 int mdt_dom_lvb_is_valid(struct ldlm_resource *res);
1213 int mdt_dom_lvbo_update(struct ldlm_resource *res, struct ldlm_lock *lock,
1214 struct ptlrpc_request *req, bool increase_only);
1216 void mdt_enable_cos(struct mdt_device *dev, bool enable);
1217 int mdt_cos_is_enabled(struct mdt_device *);
1235 LPROC_MDT_SAMEDIR_RENAME,
1236 LPROC_MDT_CROSSDIR_RENAME,
1243 void mdt_counter_incr(struct ptlrpc_request *req, int opcode);
1244 void mdt_stats_counter_init(struct lprocfs_stats *stats);
1245 int mdt_procfs_init(struct mdt_device *mdt, const char *name);
1246 void mdt_procfs_fini(struct mdt_device *mdt);
1248 /* lustre/mdt_mdt_lproc.c */
1249 int lprocfs_mdt_open_files_seq_open(struct inode *inode,
1251 void mdt_rename_counter_tally(struct mdt_thread_info *info,
1252 struct mdt_device *mdt,
1253 struct ptlrpc_request *req,
1254 struct mdt_object *src, struct mdt_object *tgt);
1256 static inline struct obd_device *mdt2obd_dev(const struct mdt_device *mdt)
1258 return mdt->mdt_lu_dev.ld_obd;
1261 extern const struct lu_device_operations mdt_lu_ops;
1263 static inline char *mdt_obd_name(struct mdt_device *mdt)
1265 return mdt->mdt_lu_dev.ld_obd->obd_name;
1268 int mds_mod_init(void);
1269 void mds_mod_exit(void);
1271 static inline char *mdt_req_get_jobid(struct ptlrpc_request *req)
1273 struct obd_export *exp = req->rq_export;
1276 if (exp_connect_flags(exp) & OBD_CONNECT_JOBSTATS)
1277 jobid = lustre_msg_get_jobid(req->rq_reqmsg);
1284 #define VALID_FLAGS (LA_TYPE | LA_MODE | LA_SIZE | LA_BLOCKS | \
1285 LA_BLKSIZE | LA_ATIME | LA_MTIME | LA_CTIME)
1287 int mdt_obd_preprw(const struct lu_env *env, int cmd, struct obd_export *exp,
1288 struct obdo *oa, int objcount, struct obd_ioobj *obj,
1289 struct niobuf_remote *rnb, int *nr_local,
1290 struct niobuf_local *lnb);
1292 int mdt_obd_commitrw(const struct lu_env *env, int cmd, struct obd_export *exp,
1293 struct obdo *oa, int objcount, struct obd_ioobj *obj,
1294 struct niobuf_remote *rnb, int npages,
1295 struct niobuf_local *lnb, int old_rc);
1296 int mdt_punch_hdl(struct tgt_session_info *tsi);
1297 int mdt_glimpse_enqueue(struct mdt_thread_info *mti, struct ldlm_namespace *ns,
1298 struct ldlm_lock **lockp, __u64 flags);
1299 int mdt_brw_enqueue(struct mdt_thread_info *info, struct ldlm_namespace *ns,
1300 struct ldlm_lock **lockp, __u64 flags);
1301 int mdt_dom_read_on_open(struct mdt_thread_info *mti, struct mdt_device *mdt,
1302 struct lustre_handle *lh);
1303 void mdt_dom_discard_data(struct mdt_thread_info *info, struct mdt_object *mo);
1304 int mdt_dom_disk_lvbo_update(const struct lu_env *env, struct mdt_object *mo,
1305 struct ldlm_resource *res, bool increase_only);
1306 void mdt_dom_obj_lvb_update(const struct lu_env *env, struct mdt_object *mo,
1307 bool increase_only);
1308 int mdt_dom_lvb_alloc(struct ldlm_resource *res);
1310 static inline bool mdt_dom_check_for_discard(struct mdt_thread_info *mti,
1311 struct mdt_object *mo)
1313 return lu_object_is_dying(&mo->mot_header) &&
1314 S_ISREG(lu_object_attr(&mo->mot_obj));
1317 int mdt_dom_object_size(const struct lu_env *env, struct mdt_device *mdt,
1318 const struct lu_fid *fid, struct mdt_body *mb,
1320 bool mdt_dom_client_has_lock(struct mdt_thread_info *info,
1321 const struct lu_fid *fid);
1322 void mdt_hp_brw(struct tgt_session_info *tsi);
1323 void mdt_hp_punch(struct tgt_session_info *tsi);
1324 int mdt_data_version_get(struct tgt_session_info *tsi);
1327 long mdt_grant_connect(const struct lu_env *env, struct obd_export *exp,
1328 u64 want, bool conservative);
1329 extern struct kmem_cache *ldlm_glimpse_work_kmem;
1331 int mdt_is_remote_object(struct mdt_thread_info *info,
1332 struct mdt_object *parent,
1333 struct mdt_object *child);
1335 #endif /* _MDT_INTERNAL_H */