Whamcloud - gitweb
LU-3467 target: unified transaction callbacks
[fs/lustre-release.git] / lustre / mdt / mdt_internal.h
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
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.
9  *
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).
15  *
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
19  *
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
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2011, 2013, Intel Corporation.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  *
36  * lustre/mdt/mdt_internal.h
37  *
38  * Lustre Metadata Target (mdt) request handler
39  *
40  * Author: Peter Braam <braam@clusterfs.com>
41  * Author: Andreas Dilger <adilger@clusterfs.com>
42  * Author: Phil Schwan <phil@clusterfs.com>
43  * Author: Mike Shaver <shaver@clusterfs.com>
44  * Author: Nikita Danilov <nikita@clusterfs.com>
45  * Author: Huang Hua <huanghua@clusterfs.com>
46  */
47
48 #ifndef _MDT_INTERNAL_H
49 #define _MDT_INTERNAL_H
50
51 #if defined(__KERNEL__)
52
53 #include <lustre_net.h>
54 #include <lustre/lustre_idl.h>
55 #include <obd_class.h>
56 #include <lustre_disk.h>
57 #include <lu_target.h>
58 #include <md_object.h>
59 #include <lustre_fid.h>
60 #include <lustre_fld.h>
61 #include <lustre_req_layout.h>
62 #include <lustre_sec.h>
63 #include <lustre_idmap.h>
64 #include <lustre_eacl.h>
65 #include <lustre_quota.h>
66
67 /* check if request's xid is equal to last one or not*/
68 static inline int req_xid_is_last(struct ptlrpc_request *req)
69 {
70         struct lsd_client_data *lcd = req->rq_export->exp_target_data.ted_lcd;
71         return (req->rq_xid == lcd->lcd_last_xid ||
72                 req->rq_xid == lcd->lcd_last_close_xid);
73 }
74
75 struct mdt_object;
76
77 /* file data for open files on MDS */
78 struct mdt_file_data {
79         struct portals_handle mfd_handle; /* must be first */
80         __u64                 mfd_mode;   /* open mode provided by client */
81         cfs_list_t            mfd_list;   /* protected by med_open_lock */
82         __u64                 mfd_xid;    /* xid of the open request */
83         struct lustre_handle  mfd_old_handle; /* old handle in replay case */
84         struct mdt_object    *mfd_object; /* point to opened object */
85 };
86
87 #define CDT_NONBLOCKING_RESTORE         (1ULL << 0)
88 #define CDT_NORETRY_ACTION              (1ULL << 1)
89 #define CDT_POLICY_LAST                 CDT_NORETRY_ACTION
90 #define CDT_POLICY_SHIFT_COUNT          2
91 #define CDT_POLICY_ALL                  (CDT_NONBLOCKING_RESTORE | \
92                                         CDT_NORETRY_ACTION)
93
94 /* when adding a new policy, do not forget to update
95  * lustre/mdt/mdt_coordinator.c::hsm_policy_names[]
96  */
97 #define CDT_DEFAULT_POLICY              CDT_NORETRY_ACTION
98
99 enum cdt_states { CDT_STOPPED = 0,
100                   CDT_INIT,
101                   CDT_RUNNING,
102                   CDT_DISABLE,
103                   CDT_STOPPING };
104
105 /* when multiple lock are needed, the lock order is
106  * cdt_llog_lock
107  * cdt_agent_lock
108  * cdt_counter_lock
109  * cdt_restore_lock
110  * cdt_request_lock
111  */
112 struct coordinator {
113         struct ptlrpc_thread     cdt_thread;         /**< coordinator thread */
114         struct lu_env            cdt_env;            /**< coordinator lustre
115                                                       * env */
116         struct lu_context        cdt_session;        /** session for lu_ucred */
117         struct proc_dir_entry   *cdt_proc_dir;       /**< cdt /proc directory */
118         __u64                    cdt_policy;         /**< policy flags */
119         enum cdt_states          cdt_state;           /**< state */
120         atomic_t                 cdt_compound_id;     /**< compound id
121                                                        * counter */
122         __u64                    cdt_last_cookie;     /**< last cookie
123                                                        * allocated */
124         struct mutex             cdt_llog_lock;       /**< protect llog
125                                                        * access */
126         struct rw_semaphore      cdt_agent_lock;      /**< protect agent list */
127         struct rw_semaphore      cdt_request_lock;    /**< protect request
128                                                        * list */
129         struct mutex             cdt_restore_lock;    /**< protect restore
130                                                        * list */
131         cfs_time_t               cdt_loop_period;     /**< llog scan period */
132         cfs_time_t               cdt_grace_delay;     /**< request grace
133                                                        * delay */
134         cfs_time_t               cdt_active_req_timeout; /**< request timeout */
135         __u32                    cdt_default_archive_id; /**< archive id used
136                                                        * when none are
137                                                        * specified */
138         __u64                    cdt_max_requests;    /**< max count of started
139                                                        * requests */
140         atomic_t                 cdt_request_count;   /**< current count of
141                                                        * started requests */
142         struct list_head         cdt_requests;        /**< list of started
143                                                        * requests */
144         struct list_head         cdt_agents;          /**< list of register
145                                                        * agents */
146         struct list_head         cdt_restore_hdl;     /**< list of restore lock
147                                                        * handles */
148         /* Bitmasks indexed by the HSMA_XXX constants. */
149         __u64                    cdt_user_request_mask;
150         __u64                    cdt_group_request_mask;
151         __u64                    cdt_other_request_mask;
152 };
153
154 /* mdt state flag bits */
155 #define MDT_FL_CFGLOG 0
156 #define MDT_FL_SYNCED 1
157
158 struct mdt_device {
159         /* super-class */
160         struct lu_device           mdt_lu_dev;
161         struct seq_server_site     mdt_seq_site;
162         /* DLM name-space for meta-data locks maintained by this server */
163         struct ldlm_namespace     *mdt_namespace;
164         /* ptlrpc handle for MDS->client connections (for lock ASTs). */
165         struct ptlrpc_client      *mdt_ldlm_client;
166         /* underlying device */
167         struct obd_export         *mdt_child_exp;
168         struct md_device          *mdt_child;
169         struct dt_device          *mdt_bottom;
170         struct obd_export         *mdt_bottom_exp;
171         /** target device */
172         struct lu_target           mdt_lut;
173         /*
174          * Options bit-fields.
175          */
176         struct {
177                 unsigned int       mo_user_xattr:1,
178                                    mo_acl:1,
179                                    mo_cos:1,
180                                    mo_coordinator:1;
181         } mdt_opts;
182         /* mdt state flags */
183         unsigned long              mdt_state;
184         /* lock to protect IOepoch */
185         spinlock_t                 mdt_ioepoch_lock;
186         __u64                      mdt_ioepoch;
187
188         /* transaction callbacks */
189         struct dt_txn_callback     mdt_txn_cb;
190
191         /* these values should be updated from lov if necessary.
192          * or should be placed somewhere else. */
193         int                        mdt_max_mdsize;
194         int                        mdt_max_cookiesize;
195
196         int                        mdt_max_ea_size;
197
198         struct upcall_cache        *mdt_identity_cache;
199
200         /* capability keys */
201         unsigned long              mdt_capa_timeout;
202         __u32                      mdt_capa_alg;
203         struct dt_object          *mdt_ck_obj;
204         unsigned long              mdt_ck_timeout;
205         unsigned long              mdt_ck_expiry;
206         struct timer_list          mdt_ck_timer;
207         struct ptlrpc_thread       mdt_ck_thread;
208         struct lustre_capa_key     mdt_capa_keys[2];
209         unsigned int               mdt_capa_conf:1,
210                                    mdt_som_conf:1,
211                                    /* Enable remote dir on non-MDT0 */
212                                    mdt_enable_remote_dir:1;
213
214         gid_t                      mdt_enable_remote_dir_gid;
215         /* statfs optimization: we cache a bit  */
216         struct obd_statfs          mdt_osfs;
217         __u64                      mdt_osfs_age;
218         spinlock_t                 mdt_osfs_lock;
219
220         /* root squash */
221         uid_t                      mdt_squash_uid;
222         gid_t                      mdt_squash_gid;
223         cfs_list_t                 mdt_nosquash_nids;
224         char                      *mdt_nosquash_str;
225         int                        mdt_nosquash_strlen;
226         struct rw_semaphore        mdt_squash_sem;
227
228         struct rename_stats        mdt_rename_stats;
229         struct lu_fid              mdt_md_root_fid;
230
231         /* connection to quota master */
232         struct obd_export         *mdt_qmt_exp;
233         /* quota master device associated with this MDT */
234         struct lu_device          *mdt_qmt_dev;
235
236         struct coordinator         mdt_coordinator;
237 };
238
239 #define MDT_SERVICE_WATCHDOG_FACTOR     (2)
240 #define MDT_ROCOMPAT_SUPP       (OBD_ROCOMPAT_LOVOBJID)
241 #define MDT_INCOMPAT_SUPP       (OBD_INCOMPAT_MDT | OBD_INCOMPAT_COMMON_LR | \
242                                 OBD_INCOMPAT_FID | OBD_INCOMPAT_IAM_DIR | \
243                                 OBD_INCOMPAT_LMM_VER | OBD_INCOMPAT_MULTI_OI)
244 #define MDT_COS_DEFAULT         (0)
245
246 struct mdt_object {
247         struct lu_object_header mot_header;
248         struct lu_object        mot_obj;
249         __u64                   mot_ioepoch;
250         __u64                   mot_flags;
251         int                     mot_ioepoch_count;
252         int                     mot_writecount;
253         /* Lock to protect object's IO epoch. */
254         struct mutex            mot_ioepoch_mutex;
255         /* Lock to protect create_data */
256         struct mutex            mot_lov_mutex;
257         /* Lock to protect lease open.
258          * Lease open acquires write lock; normal open acquires read lock */
259         struct rw_semaphore     mot_open_sem;
260         atomic_t                mot_lease_count;
261         atomic_t                mot_open_count;
262 };
263
264 enum mdt_object_flags {
265         /** SOM attributes are changed. */
266         MOF_SOM_CHANGE  = (1 << 0),
267         /**
268          * The SOM recovery state for mdt object.
269          * This state is an in-memory equivalent of an absent SOM EA, used
270          * instead of invalidating SOM EA while IOEpoch is still opened when
271          * a client eviction occurs or a client fails to obtain SOM attributes.
272          * It indicates that the last IOEpoch holder will need to obtain SOM
273          * attributes under [0;EOF] extent lock to flush all the client's
274          * cached of evicted from MDS clients (but not necessary evicted from
275          * OST) before taking ost attributes.
276          */
277         MOF_SOM_RECOV   = (1 << 1),
278         /** File has been just created. */
279         MOF_SOM_CREATED = (1 << 2),
280         /** lov object has been created. */
281         MOF_LOV_CREATED = (1 << 3),
282 };
283
284 struct mdt_lock_handle {
285         /* Lock type, reg for cross-ref use or pdo lock. */
286         mdl_type_t              mlh_type;
287
288         /* Regular lock */
289         struct lustre_handle    mlh_reg_lh;
290         ldlm_mode_t             mlh_reg_mode;
291
292         /* Pdirops lock */
293         struct lustre_handle    mlh_pdo_lh;
294         ldlm_mode_t             mlh_pdo_mode;
295         unsigned int            mlh_pdo_hash;
296
297         /* Remote regular lock */
298         struct lustre_handle    mlh_rreg_lh;
299         ldlm_mode_t          mlh_rreg_mode;
300 };
301
302 enum {
303         MDT_LH_PARENT,  /* parent lockh */
304         MDT_LH_CHILD,   /* child lockh */
305         MDT_LH_OLD,     /* old lockh for rename */
306         MDT_LH_LAYOUT = MDT_LH_OLD, /* layout lock */
307         MDT_LH_NEW,     /* new lockh for rename */
308         MDT_LH_RMT,     /* used for return lh to caller */
309         MDT_LH_LOCAL,   /* local lock never return to client */
310         MDT_LH_NR
311 };
312
313 enum {
314         MDT_LOCAL_LOCK,
315         MDT_CROSS_LOCK
316 };
317
318 struct mdt_reint_record {
319         mdt_reint_t             rr_opcode;
320         const struct lustre_handle *rr_handle;
321         const struct lu_fid    *rr_fid1;
322         const struct lu_fid    *rr_fid2;
323         const char             *rr_name;
324         int                     rr_namelen;
325         const char             *rr_tgt;
326         int                     rr_tgtlen;
327         const void             *rr_eadata;
328         int                     rr_eadatalen;
329         int                     rr_logcookielen;
330         const struct llog_cookie  *rr_logcookies;
331         __u32                   rr_flags;
332 };
333
334 enum mdt_reint_flag {
335         MRF_OPEN_TRUNC = 1 << 0,
336 };
337
338 /*
339  * Common data shared by mdt-level handlers. This is allocated per-thread to
340  * reduce stack consumption.
341  */
342 struct mdt_thread_info {
343         /*
344          * XXX: Part One:
345          * The following members will be filled explicitly
346          * with specific data in mdt_thread_info_init().
347          */
348         /* TODO: move this into mdt_session_key(with LCT_SESSION), because
349          * request handling may migrate from one server thread to another.
350          */
351         struct req_capsule        *mti_pill;
352
353         /* although we have export in req, there are cases when it is not
354          * available, e.g. closing files upon export destroy */
355         struct obd_export          *mti_exp;
356         /*
357          * A couple of lock handles.
358          */
359         struct mdt_lock_handle     mti_lh[MDT_LH_NR];
360
361         struct mdt_device         *mti_mdt;
362         const struct lu_env       *mti_env;
363
364         /* transaction number of current request */
365         __u64                      mti_transno;
366
367
368         /*
369          * XXX: Part Two:
370          * The following members will be filled expilictly
371          * with zero in mdt_thread_info_init(). These members may be used
372          * by all requests.
373          */
374
375         /*
376          * Object attributes.
377          */
378         struct md_attr             mti_attr;
379         /*
380          * Body for "habeo corpus" operations.
381          */
382         const struct mdt_body     *mti_body;
383         /*
384          * Host object. This is released at the end of mdt_handler().
385          */
386         struct mdt_object         *mti_object;
387         /*
388          * Lock request for "habeo clavis" operations.
389          */
390         const struct ldlm_request *mti_dlm_req;
391
392         __u32                      mti_has_trans:1, /* has txn already? */
393                                    mti_cross_ref:1;
394
395         /* opdata for mdt_reint_open(), has the same as
396          * ldlm_reply:lock_policy_res1.  mdt_update_last_rcvd() stores this
397          * value onto disk for recovery when mdt_trans_stop_cb() is called.
398          */
399         __u64                      mti_opdata;
400
401         /*
402          * XXX: Part Three:
403          * The following members will be filled explicitly
404          * with zero in mdt_reint_unpack(), because they are only used
405          * by reint requests (including mdt_reint_open()).
406          */
407
408         /*
409          * reint record. contains information for reint operations.
410          */
411         struct mdt_reint_record    mti_rr;
412
413         __u64                      mti_ver[PTLRPC_NUM_VERSIONS];
414         /*
415          * Operation specification (currently create and lookup)
416          */
417         struct md_op_spec          mti_spec;
418
419         /*
420          * XXX: Part Four:
421          * The following members will _NOT_ be initialized at all.
422          * DO NOT expect them to contain any valid value.
423          * They should be initialized explicitly by the user themselves.
424          */
425
426          /* XXX: If something is in a union, make sure they do not conflict */
427
428         struct lu_fid              mti_tmp_fid1;
429         struct lu_fid              mti_tmp_fid2;
430         ldlm_policy_data_t         mti_policy;    /* for mdt_object_lock() and
431                                                    * mdt_rename_lock() */
432         struct ldlm_res_id         mti_res_id;    /* for mdt_object_lock() and
433                                                      mdt_rename_lock()   */
434         union {
435                 struct obd_uuid    uuid[2];       /* for mdt_seq_init_cli()  */
436                 char               ns_name[48];   /* for mdt_init0()         */
437                 struct lustre_cfg_bufs bufs;      /* for mdt_stack_fini()    */
438                 struct obd_statfs  osfs;          /* for mdt_statfs()        */
439                 struct {
440                         /* for mdt_readpage()      */
441                         struct lu_rdpg     mti_rdpg;
442                         /* for mdt_sendpage()      */
443                         struct l_wait_info mti_wait_info;
444                 } rdpg;
445                 struct {
446                         struct md_attr attr;
447                         struct md_som_data data;
448                 } som;
449         } mti_u;
450
451         /* IO epoch related stuff. */
452         struct mdt_ioepoch        *mti_ioepoch;
453         __u64                      mti_replayepoch;
454
455         loff_t                     mti_off;
456         struct lu_buf              mti_buf;
457         struct lu_buf              mti_big_buf;
458         struct lustre_capa_key     mti_capa_key;
459
460         /* Ops object filename */
461         struct lu_name             mti_name;
462         /* per-thread values, can be re-used */
463         void                      *mti_big_lmm;
464         int                        mti_big_lmmsize;
465         /* big_lmm buffer was used and must be used in reply */
466         int                        mti_big_lmm_used;
467         /* should be enough to fit lustre_mdt_attrs */
468         char                       mti_xattr_buf[128];
469         struct ldlm_enqueue_info   mti_einfo;
470 };
471
472 extern struct lu_context_key mdt_thread_key;
473
474 static inline struct mdt_thread_info *mdt_th_info(const struct lu_env *env)
475 {
476         struct mdt_thread_info *mti;
477
478         lu_env_refill((void *)env);
479         mti = lu_context_key_get(&env->le_ctx, &mdt_thread_key);
480         LASSERT(mti);
481         return mti;
482 }
483
484 /* ptlrpc request handler for MDT. All handlers are
485  * grouped into several slices - struct mdt_opc_slice,
486  * and stored in an array - mdt_handlers[].
487  */
488 struct mdt_handler {
489         /* The name of this handler. */
490         const char *mh_name;
491         /* Fail id for this handler, checked at the beginning of this handler*/
492         int      mh_fail_id;
493         /* Operation code for this handler */
494         __u32       mh_opc;
495         /* flags are listed in enum mdt_handler_flags below. */
496         __u32       mh_flags;
497         /* The actual handler function to execute. */
498         int (*mh_act)(struct mdt_thread_info *info);
499         /* Request format for this request. */
500         const struct req_format *mh_fmt;
501 };
502
503 struct mdt_opc_slice {
504         __u32                   mos_opc_start;
505         int                     mos_opc_end;
506         struct mdt_handler      *mos_hs;
507 };
508
509 struct cdt_req_progress {
510         struct mutex             crp_lock;      /**< protect tree */
511         struct interval_node    *crp_root;      /**< tree to track extent
512                                                  *   moved */
513         struct interval_node    **crp_node;     /**< buffer for tree nodes
514                                                  *   vector of fixed size
515                                                  *   vectors */
516         int                      crp_cnt;       /**< # of used nodes */
517         int                      crp_max;       /**< # of allocated nodes */
518 };
519
520 struct cdt_agent_req {
521         cfs_list_t               car_request_list; /**< to chain all the req. */
522         atomic_t                 car_refcount;     /**< reference counter */
523         __u64                    car_compound_id;  /**< compound id */
524         __u64                    car_flags;        /**< request original flags */
525         struct obd_uuid          car_uuid;         /**< agent doing the req. */
526         __u32                    car_archive_id;   /**< archive id */
527         int                      car_canceled;     /**< request was canceled */
528         cfs_time_t               car_req_start;    /**< start time */
529         cfs_time_t               car_req_update;   /**< last update time */
530         struct hsm_action_item  *car_hai;          /**< req. to the agent */
531         struct cdt_req_progress  car_progress;     /**< track data mvt
532                                                     *   progress */
533 };
534 extern struct kmem_cache *mdt_hsm_car_kmem;
535
536 struct hsm_agent {
537         cfs_list_t       ha_list;               /**< to chain the agents */
538         struct obd_uuid  ha_uuid;               /**< agent uuid */
539         __u32           *ha_archive_id;         /**< archive id */
540         int              ha_archive_cnt;        /**< number of archive entries
541                                                  *   0 means any archive */
542         atomic_t         ha_requests;           /**< current request count */
543         atomic_t         ha_success;            /**< number of successful
544                                                  * actions */
545         atomic_t         ha_failure;            /**< number of failed actions */
546 };
547
548 struct cdt_restore_handle {
549         cfs_list_t               crh_list;      /**< to chain the handle */
550         struct lu_fid            crh_fid;       /**< fid of the object */
551         struct ldlm_extent       crh_extent;    /**< extent of the restore */
552         struct mdt_lock_handle   crh_lh;        /**< lock handle */
553 };
554 extern struct kmem_cache *mdt_hsm_cdt_kmem;     /** restore handle slab cache */
555
556 static inline const struct md_device_operations *
557 mdt_child_ops(struct mdt_device * m)
558 {
559         LASSERT(m->mdt_child);
560         return m->mdt_child->md_ops;
561 }
562
563 static inline struct md_object *mdt_object_child(struct mdt_object *o)
564 {
565         LASSERT(o);
566         return lu2md(lu_object_next(&o->mot_obj));
567 }
568
569 static inline struct ptlrpc_request *mdt_info_req(struct mdt_thread_info *info)
570 {
571          return info->mti_pill ? info->mti_pill->rc_req : NULL;
572 }
573
574 static inline __u64 mdt_conn_flags(struct mdt_thread_info *info)
575 {
576         LASSERT(info->mti_exp);
577         return exp_connect_flags(info->mti_exp);
578 }
579
580 static inline void mdt_object_get(const struct lu_env *env,
581                                   struct mdt_object *o)
582 {
583         ENTRY;
584         lu_object_get(&o->mot_obj);
585         EXIT;
586 }
587
588 static inline void mdt_object_put(const struct lu_env *env,
589                                   struct mdt_object *o)
590 {
591         ENTRY;
592         lu_object_put(env, &o->mot_obj);
593         EXIT;
594 }
595
596 static inline int mdt_object_exists(const struct mdt_object *o)
597 {
598         return lu_object_exists(&o->mot_obj);
599 }
600
601 static inline int mdt_object_remote(const struct mdt_object *o)
602 {
603         return lu_object_remote(&o->mot_obj);
604 }
605
606 static inline const struct lu_fid *mdt_object_fid(const struct mdt_object *o)
607 {
608         return lu_object_fid(&o->mot_obj);
609 }
610
611 static inline struct lu_site *mdt_lu_site(const struct mdt_device *mdt)
612 {
613         return mdt->mdt_lu_dev.ld_site;
614 }
615
616 static inline struct seq_server_site *mdt_seq_site(struct mdt_device *mdt)
617 {
618         return &mdt->mdt_seq_site;
619 }
620
621 static inline void mdt_export_evict(struct obd_export *exp)
622 {
623         class_fail_export(exp);
624         class_export_put(exp);
625 }
626
627 /* Here we use LVB_TYPE to check dne client, because it is
628  * also landed on 2.4. */
629 static inline int mdt_is_dne_client(struct obd_export *exp)
630 {
631         return !!(exp_connect_flags(exp) & OBD_CONNECT_LVB_TYPE);
632 }
633
634 int mdt_get_disposition(struct ldlm_reply *rep, int flag);
635 void mdt_set_disposition(struct mdt_thread_info *info,
636                         struct ldlm_reply *rep, int flag);
637 void mdt_clear_disposition(struct mdt_thread_info *info,
638                         struct ldlm_reply *rep, int flag);
639
640 void mdt_lock_pdo_init(struct mdt_lock_handle *lh,
641                        ldlm_mode_t lm, const char *name,
642                        int namelen);
643
644 void mdt_lock_reg_init(struct mdt_lock_handle *lh,
645                        ldlm_mode_t lm);
646
647 int mdt_lock_setup(struct mdt_thread_info *info,
648                    struct mdt_object *o,
649                    struct mdt_lock_handle *lh);
650
651 int mdt_object_lock(struct mdt_thread_info *,
652                     struct mdt_object *,
653                     struct mdt_lock_handle *,
654                     __u64, int);
655
656 int mdt_object_lock_try(struct mdt_thread_info *,
657                         struct mdt_object *,
658                         struct mdt_lock_handle *,
659                         __u64, int);
660
661 void mdt_object_unlock(struct mdt_thread_info *,
662                        struct mdt_object *,
663                        struct mdt_lock_handle *,
664                        int decref);
665
666 struct mdt_object *mdt_object_new(const struct lu_env *,
667                                   struct mdt_device *,
668                                   const struct lu_fid *);
669 struct mdt_object *mdt_object_find(const struct lu_env *,
670                                    struct mdt_device *,
671                                    const struct lu_fid *);
672 struct mdt_object *mdt_object_find_lock(struct mdt_thread_info *,
673                                         const struct lu_fid *,
674                                         struct mdt_lock_handle *,
675                                         __u64);
676 void mdt_object_unlock_put(struct mdt_thread_info *,
677                            struct mdt_object *,
678                            struct mdt_lock_handle *,
679                            int decref);
680
681 void mdt_client_compatibility(struct mdt_thread_info *info);
682
683 int mdt_remote_object_lock(struct mdt_thread_info *mti,
684                            struct mdt_object *o, struct lustre_handle *lh,
685                            ldlm_mode_t mode, __u64 ibits);
686 int mdt_close_unpack(struct mdt_thread_info *info);
687 int mdt_reint_unpack(struct mdt_thread_info *info, __u32 op);
688 int mdt_reint_rec(struct mdt_thread_info *, struct mdt_lock_handle *);
689 void mdt_pack_attr2body(struct mdt_thread_info *info, struct mdt_body *b,
690                         const struct lu_attr *attr, const struct lu_fid *fid);
691
692 int mdt_getxattr(struct mdt_thread_info *info);
693 int mdt_reint_setxattr(struct mdt_thread_info *info,
694                        struct mdt_lock_handle *lh);
695
696 void mdt_lock_handle_init(struct mdt_lock_handle *lh);
697 void mdt_lock_handle_fini(struct mdt_lock_handle *lh);
698
699 void mdt_reconstruct(struct mdt_thread_info *, struct mdt_lock_handle *);
700 void mdt_reconstruct_generic(struct mdt_thread_info *mti,
701                              struct mdt_lock_handle *lhc);
702
703 extern void target_recovery_fini(struct obd_device *obd);
704 extern void target_recovery_init(struct lu_target *lut,
705                                  svc_handler_t handler);
706 int mdt_fs_setup(const struct lu_env *, struct mdt_device *,
707                  struct obd_device *, struct lustre_sb_info *lsi);
708 void mdt_fs_cleanup(const struct lu_env *, struct mdt_device *);
709
710 int mdt_export_stats_init(struct obd_device *obd,
711                           struct obd_export *exp,
712                           void *client_nid);
713
714 int mdt_lock_new_child(struct mdt_thread_info *info,
715                        struct mdt_object *o,
716                        struct mdt_lock_handle *child_lockh);
717
718 void mdt_mfd_set_mode(struct mdt_file_data *mfd,
719                       __u64 mode);
720
721 int mdt_reint_open(struct mdt_thread_info *info,
722                    struct mdt_lock_handle *lhc);
723
724 struct mdt_file_data *mdt_handle2mfd(struct mdt_export_data *med,
725                                      const struct lustre_handle *handle,
726                                      bool is_replay);
727
728 enum {
729         MDT_IOEPOCH_CLOSED  = 0,
730         MDT_IOEPOCH_OPENED  = 1,
731         MDT_IOEPOCH_GETATTR = 2,
732 };
733
734 enum {
735         MDT_SOM_DISABLE = 0,
736         MDT_SOM_ENABLE  = 1,
737 };
738
739 int mdt_get_info(struct tgt_session_info *tsi);
740 int mdt_attr_get_complex(struct mdt_thread_info *info,
741                          struct mdt_object *o, struct md_attr *ma);
742 int mdt_ioepoch_open(struct mdt_thread_info *info, struct mdt_object *o,
743                      int created);
744 int mdt_object_is_som_enabled(struct mdt_object *mo);
745 int mdt_write_get(struct mdt_object *o);
746 void mdt_write_put(struct mdt_object *o);
747 int mdt_write_read(struct mdt_object *o);
748 struct mdt_file_data *mdt_mfd_new(const struct mdt_export_data *med);
749 int mdt_mfd_close(struct mdt_thread_info *info, struct mdt_file_data *mfd);
750 void mdt_mfd_free(struct mdt_file_data *mfd);
751 int mdt_close(struct tgt_session_info *tsi);
752 int mdt_attr_set(struct mdt_thread_info *info, struct mdt_object *mo,
753                  struct md_attr *ma, int flags);
754 int mdt_add_dirty_flag(struct mdt_thread_info *info, struct mdt_object *mo,
755                         struct md_attr *ma);
756 int mdt_done_writing(struct tgt_session_info *tsi);
757 int mdt_fix_reply(struct mdt_thread_info *info);
758 int mdt_handle_last_unlink(struct mdt_thread_info *, struct mdt_object *,
759                            const struct md_attr *);
760 void mdt_reconstruct_open(struct mdt_thread_info *, struct mdt_lock_handle *);
761
762 struct lu_buf *mdt_buf(const struct lu_env *env, void *area, ssize_t len);
763 const struct lu_buf *mdt_buf_const(const struct lu_env *env,
764                                    const void *area, ssize_t len);
765
766 void mdt_dump_lmm(int level, const struct lov_mds_md *lmm);
767
768 int mdt_check_ucred(struct mdt_thread_info *);
769 int mdt_init_ucred(struct mdt_thread_info *, struct mdt_body *);
770 int mdt_init_ucred_reint(struct mdt_thread_info *);
771 void mdt_exit_ucred(struct mdt_thread_info *);
772 int mdt_version_get_check(struct mdt_thread_info *, struct mdt_object *, int);
773 void mdt_version_get_save(struct mdt_thread_info *, struct mdt_object *, int);
774 int mdt_version_get_check_save(struct mdt_thread_info *, struct mdt_object *,
775                                int);
776 void mdt_thread_info_init(struct ptlrpc_request *req,
777                           struct mdt_thread_info *mti);
778 void mdt_thread_info_fini(struct mdt_thread_info *mti);
779 struct mdt_thread_info *tsi2mdt_info(struct tgt_session_info *tsi);
780
781 extern struct lprocfs_vars lprocfs_mds_module_vars[];
782 extern struct lprocfs_vars lprocfs_mds_obd_vars[];
783
784 int mdt_hsm_attr_set(struct mdt_thread_info *info, struct mdt_object *obj,
785                      const struct md_hsm *mh);
786
787 /* mdt_idmap.c */
788 int mdt_init_idmap(struct tgt_session_info *tsi);
789 void mdt_cleanup_idmap(struct mdt_export_data *);
790 int mdt_handle_idmap(struct tgt_session_info *tsi);
791 int ptlrpc_user_desc_do_idmap(struct ptlrpc_request *,
792                               struct ptlrpc_user_desc *);
793 void mdt_body_reverse_idmap(struct mdt_thread_info *,
794                             struct mdt_body *);
795 int mdt_remote_perm_reverse_idmap(struct ptlrpc_request *,
796                                   struct mdt_remote_perm *);
797 int mdt_fix_attr_ucred(struct mdt_thread_info *, __u32);
798
799 static inline struct mdt_device *mdt_dev(struct lu_device *d)
800 {
801         return container_of0(d, struct mdt_device, mdt_lu_dev);
802 }
803
804 static inline struct mdt_object *mdt_obj(struct lu_object *o)
805 {
806         return container_of0(o, struct mdt_object, mot_obj);
807 }
808
809 static inline struct dt_object *mdt_obj2dt(struct mdt_object *mo)
810 {
811         struct lu_object        *lo;
812         struct mdt_device       *mdt = mdt_dev(mo->mot_obj.lo_dev);
813
814         lo = lu_object_locate(mo->mot_obj.lo_header,
815                               mdt->mdt_bottom->dd_lu_dev.ld_type);
816
817         return lu2dt(lo);
818 }
819
820 /* mdt/mdt_identity.c */
821 #define MDT_IDENTITY_UPCALL_PATH        "/usr/sbin/l_getidentity"
822
823 extern struct upcall_cache_ops mdt_identity_upcall_cache_ops;
824
825 struct md_identity *mdt_identity_get(struct upcall_cache *, __u32);
826
827 void mdt_identity_put(struct upcall_cache *, struct md_identity *);
828
829 void mdt_flush_identity(struct upcall_cache *, int);
830
831 __u32 mdt_identity_get_perm(struct md_identity *, __u32, lnet_nid_t);
832
833 int mdt_pack_remote_perm(struct mdt_thread_info *, struct mdt_object *, void *);
834
835 /* mdt/mdt_hsm.c */
836 int mdt_hsm_state_get(struct tgt_session_info *tsi);
837 int mdt_hsm_state_set(struct tgt_session_info *tsi);
838 int mdt_hsm_action(struct tgt_session_info *tsi);
839 int mdt_hsm_progress(struct tgt_session_info *tsi);
840 int mdt_hsm_ct_register(struct tgt_session_info *tsi);
841 int mdt_hsm_ct_unregister(struct tgt_session_info *tsi);
842 int mdt_hsm_request(struct tgt_session_info *tsi);
843
844 /* mdt/mdt_hsm_cdt_actions.c */
845 extern const struct file_operations mdt_hsm_actions_fops;
846 void dump_llog_agent_req_rec(const char *prefix,
847                              const struct llog_agent_req_rec *larr);
848 int cdt_llog_process(const struct lu_env *env, struct mdt_device *mdt,
849                      llog_cb_t cb, void *data);
850 int mdt_agent_record_add(const struct lu_env *env, struct mdt_device *mdt,
851                          __u64 compound_id, __u32 archive_id,
852                          __u64 flags, struct hsm_action_item *hai);
853 int mdt_agent_record_update(const struct lu_env *env,
854                             struct mdt_device *mdt, __u64 *cookies,
855                             int cookies_count, enum agent_req_status status);
856 int mdt_agent_llog_update_rec(const struct lu_env *env, struct mdt_device *mdt,
857                               struct llog_handle *llh,
858                               struct llog_agent_req_rec *larr);
859
860 /* mdt/mdt_hsm_cdt_agent.c */
861 extern const struct file_operations mdt_hsm_agent_fops;
862 int mdt_hsm_agent_register(struct mdt_thread_info *info,
863                            const struct obd_uuid *uuid,
864                            int nr_archives, __u32 *archive_num);
865 int mdt_hsm_agent_register_mask(struct mdt_thread_info *info,
866                                 const struct obd_uuid *uuid,
867                                 __u32 archive_mask);
868 int mdt_hsm_agent_unregister(struct mdt_thread_info *info,
869                              const struct obd_uuid *uuid);
870 int mdt_hsm_agent_update_statistics(struct coordinator *cdt,
871                                     int succ_rq, int fail_rq, int new_rq,
872                                     const struct obd_uuid *uuid);
873 int mdt_hsm_find_best_agent(struct coordinator *cdt, __u32 archive,
874                             struct obd_uuid *uuid);
875 int mdt_hsm_agent_send(struct mdt_thread_info *mti, struct hsm_action_list *hal,
876                        bool purge);
877 int mdt_hsm_coordinator_update(struct mdt_thread_info *mti,
878                                struct hsm_progress_kernel *pgs);
879 /* mdt/mdt_hsm_cdt_client.c */
880 int mdt_hsm_add_actions(struct mdt_thread_info *info,
881                         struct hsm_action_list *hal, __u64 *compound_id);
882 int mdt_hsm_get_actions(struct mdt_thread_info *mti,
883                         struct hsm_action_list *hal);
884 int mdt_hsm_get_running(struct mdt_thread_info *mti,
885                         struct hsm_action_list *hal);
886 bool mdt_hsm_restore_is_running(struct mdt_thread_info *mti,
887                                 const struct lu_fid *fid);
888 /* mdt/mdt_hsm_cdt_requests.c */
889 extern const struct file_operations mdt_hsm_active_requests_fops;
890 void dump_requests(char *prefix, struct coordinator *cdt);
891 struct cdt_agent_req *mdt_cdt_alloc_request(__u64 compound_id, __u32 archive_id,
892                                             __u64 flags, struct obd_uuid *uuid,
893                                             struct hsm_action_item *hai);
894 void mdt_cdt_free_request(struct cdt_agent_req *car);
895 int mdt_cdt_add_request(struct coordinator *cdt, struct cdt_agent_req *new_car);
896 struct cdt_agent_req *mdt_cdt_find_request(struct coordinator *cdt,
897                                            const __u64 cookie,
898                                            const struct lu_fid *fid);
899 void mdt_cdt_get_work_done(struct cdt_agent_req *car, __u64 *done_sz);
900 void mdt_cdt_get_request(struct cdt_agent_req *car);
901 void mdt_cdt_put_request(struct cdt_agent_req *car);
902 struct cdt_agent_req *mdt_cdt_update_request(struct coordinator *cdt,
903                                          const struct hsm_progress_kernel *pgs);
904 int mdt_cdt_remove_request(struct coordinator *cdt, __u64 cookie);
905 /* mdt/mdt_coordinator.c */
906 void mdt_hsm_dump_hal(int level, const char *prefix,
907                       struct hsm_action_list *hal);
908 /* coordinator management */
909 int mdt_hsm_cdt_init(struct mdt_device *mdt);
910 int mdt_hsm_cdt_start(struct mdt_device *mdt);
911 int mdt_hsm_cdt_stop(struct mdt_device *mdt);
912 int mdt_hsm_cdt_fini(struct mdt_device *mdt);
913 int mdt_hsm_cdt_wakeup(struct mdt_device *mdt);
914
915 /* coordinator control /proc interface */
916 int lprocfs_wr_hsm_cdt_control(struct file *file, const char *buffer,
917                                unsigned long count, void *data);
918 int lprocfs_rd_hsm_cdt_control(char *page, char **start, off_t off,
919                                int count, int *eof, void *data);
920 int hsm_cdt_procfs_init(struct mdt_device *mdt);
921 void hsm_cdt_procfs_fini(struct mdt_device *mdt);
922 struct lprocfs_vars *hsm_cdt_get_proc_vars(void);
923 /* md_hsm helpers */
924 struct mdt_object *mdt_hsm_get_md_hsm(struct mdt_thread_info *mti,
925                                       const struct lu_fid *fid,
926                                       struct md_hsm *hsm);
927 /* actions/request helpers */
928 int mdt_hsm_add_hal(struct mdt_thread_info *mti,
929                     struct hsm_action_list *hal, struct obd_uuid *uuid);
930 bool mdt_hsm_is_action_compat(const struct hsm_action_item *hai,
931                               const int hal_an, const __u64 rq_flags,
932                               const struct md_hsm *hsm);
933 int mdt_hsm_update_request_state(struct mdt_thread_info *mti,
934                                  struct hsm_progress_kernel *pgs,
935                                  const int update_record);
936
937 extern struct lu_context_key       mdt_thread_key;
938
939 /* debug issues helper starts here*/
940 static inline int mdt_fail_write(const struct lu_env *env,
941                                  struct dt_device *dd, int id)
942 {
943         if (OBD_FAIL_CHECK_ORSET(id, OBD_FAIL_ONCE)) {
944                 CERROR(LUSTRE_MDT_NAME": cfs_fail_loc=%x, fail write ops\n",
945                        id);
946                 return dd->dd_ops->dt_ro(env, dd);
947                 /* We set FAIL_ONCE because we never "un-fail" a device */
948         }
949
950         return 0;
951 }
952
953 static inline struct mdt_export_data *mdt_req2med(struct ptlrpc_request *req)
954 {
955         return &req->rq_export->exp_mdt_data;
956 }
957
958 static inline struct mdt_device *mdt_exp2dev(struct obd_export *exp)
959 {
960         return mdt_dev(exp->exp_obd->obd_lu_dev);
961 }
962
963 typedef void (*mdt_reconstruct_t)(struct mdt_thread_info *mti,
964                                   struct mdt_lock_handle *lhc);
965 static inline int mdt_check_resent(struct mdt_thread_info *info,
966                                    mdt_reconstruct_t reconstruct,
967                                    struct mdt_lock_handle *lhc)
968 {
969         struct ptlrpc_request *req = mdt_info_req(info);
970         ENTRY;
971
972         if (lustre_msg_get_flags(req->rq_reqmsg) & MSG_RESENT) {
973                 if (req_xid_is_last(req)) {
974                         reconstruct(info, lhc);
975                         RETURN(1);
976                 }
977                 DEBUG_REQ(D_HA, req, "no reply for RESENT req (have "LPD64")",
978                           req->rq_export->exp_target_data.ted_lcd->lcd_last_xid);
979         }
980         RETURN(0);
981 }
982
983 struct lu_ucred *mdt_ucred(const struct mdt_thread_info *info);
984 struct lu_ucred *mdt_ucred_check(const struct mdt_thread_info *info);
985
986 static inline int is_identity_get_disabled(struct upcall_cache *cache)
987 {
988         return cache ? (strcmp(cache->uc_upcall, "NONE") == 0) : 1;
989 }
990
991 int mdt_blocking_ast(struct ldlm_lock*, struct ldlm_lock_desc*, void*, int);
992
993 /* Issues dlm lock on passed @ns, @f stores it lock handle into @lh. */
994 static inline int mdt_fid_lock(struct ldlm_namespace *ns,
995                                struct lustre_handle *lh,
996                                ldlm_mode_t mode,
997                                ldlm_policy_data_t *policy,
998                                const struct ldlm_res_id *res_id,
999                                __u64 flags, const __u64 *client_cookie)
1000 {
1001         int rc;
1002
1003         LASSERT(ns != NULL);
1004         LASSERT(lh != NULL);
1005
1006         rc = ldlm_cli_enqueue_local(ns, res_id, LDLM_IBITS, policy,
1007                                     mode, &flags, mdt_blocking_ast,
1008                                     ldlm_completion_ast, NULL, NULL, 0,
1009                                     LVB_T_NONE, client_cookie, lh);
1010         return rc == ELDLM_OK ? 0 : -EIO;
1011 }
1012
1013 static inline void mdt_fid_unlock(struct lustre_handle *lh,
1014                                   ldlm_mode_t mode)
1015 {
1016         ldlm_lock_decref(lh, mode);
1017 }
1018
1019 extern mdl_mode_t mdt_mdl_lock_modes[];
1020 extern ldlm_mode_t mdt_dlm_lock_modes[];
1021
1022 static inline mdl_mode_t mdt_dlm_mode2mdl_mode(ldlm_mode_t mode)
1023 {
1024         LASSERT(IS_PO2(mode));
1025         return mdt_mdl_lock_modes[mode];
1026 }
1027
1028 static inline ldlm_mode_t mdt_mdl_mode2dlm_mode(mdl_mode_t mode)
1029 {
1030         LASSERT(IS_PO2(mode));
1031         return mdt_dlm_lock_modes[mode];
1032 }
1033
1034 /* mdt_lvb.c */
1035 extern struct ldlm_valblock_ops mdt_lvbo;
1036
1037 static inline struct lu_name *mdt_name(const struct lu_env *env,
1038                                        char *name, int namelen)
1039 {
1040         struct lu_name *lname;
1041         struct mdt_thread_info *mti;
1042
1043         LASSERT(namelen > 0);
1044         /* trailing '\0' in buffer */
1045         LASSERT(name[namelen] == '\0');
1046
1047         mti = lu_context_key_get(&env->le_ctx, &mdt_thread_key);
1048         lname = &mti->mti_name;
1049         lname->ln_name = name;
1050         lname->ln_namelen = namelen;
1051         return lname;
1052 }
1053
1054 static inline struct lu_name *mdt_name_copy(struct lu_name *tlname,
1055                                             struct lu_name *slname)
1056 {
1057         LASSERT(tlname);
1058         LASSERT(slname);
1059
1060         tlname->ln_name = slname->ln_name;
1061         tlname->ln_namelen = slname->ln_namelen;
1062         return tlname;
1063 }
1064
1065 void mdt_enable_cos(struct mdt_device *, int);
1066 int mdt_cos_is_enabled(struct mdt_device *);
1067
1068 /* lprocfs stuff */
1069 enum {
1070         LPROC_MDT_OPEN = 0,
1071         LPROC_MDT_CLOSE,
1072         LPROC_MDT_MKNOD,
1073         LPROC_MDT_LINK,
1074         LPROC_MDT_UNLINK,
1075         LPROC_MDT_MKDIR,
1076         LPROC_MDT_RMDIR,
1077         LPROC_MDT_RENAME,
1078         LPROC_MDT_GETATTR,
1079         LPROC_MDT_SETATTR,
1080         LPROC_MDT_GETXATTR,
1081         LPROC_MDT_SETXATTR,
1082         LPROC_MDT_STATFS,
1083         LPROC_MDT_SYNC,
1084         LPROC_MDT_SAMEDIR_RENAME,
1085         LPROC_MDT_CROSSDIR_RENAME,
1086         LPROC_MDT_LAST,
1087 };
1088 void mdt_counter_incr(struct ptlrpc_request *req, int opcode);
1089 void mdt_stats_counter_init(struct lprocfs_stats *stats);
1090 void lprocfs_mdt_init_vars(struct lprocfs_static_vars *lvars);
1091 void lprocfs_mds_init_vars(struct lprocfs_static_vars *lvars);
1092 int mdt_procfs_init(struct mdt_device *mdt, const char *name);
1093 void mdt_procfs_fini(struct mdt_device *mdt);
1094 void mdt_rename_counter_tally(struct mdt_thread_info *info,
1095                               struct mdt_device *mdt,
1096                               struct ptlrpc_request *req,
1097                               struct mdt_object *src, struct mdt_object *tgt);
1098
1099 /* Capability */
1100 int mdt_ck_thread_start(struct mdt_device *mdt);
1101 void mdt_ck_thread_stop(struct mdt_device *mdt);
1102 void mdt_ck_timer_callback(unsigned long castmeharder);
1103 int mdt_capa_keys_init(const struct lu_env *env, struct mdt_device *mdt);
1104 void mdt_set_capainfo(struct mdt_thread_info *info, int offset,
1105                       const struct lu_fid *fid, struct lustre_capa *capa);
1106 void mdt_dump_capainfo(struct mdt_thread_info *info);
1107
1108 static inline struct obd_device *mdt2obd_dev(const struct mdt_device *mdt)
1109 {
1110         return mdt->mdt_lu_dev.ld_obd;
1111 }
1112
1113 extern const struct lu_device_operations mdt_lu_ops;
1114
1115 static inline char *mdt_obd_name(struct mdt_device *mdt)
1116 {
1117         return mdt->mdt_lu_dev.ld_obd->obd_name;
1118 }
1119
1120 int mds_mod_init(void);
1121 void mds_mod_exit(void);
1122
1123 #endif /* __KERNEL__ */
1124 #endif /* _MDT_H */