Whamcloud - gitweb
LU-14487 lustre: remove references to Sun Trademark.
[fs/lustre-release.git] / lustre / include / lu_target.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.gnu.org/licenses/gpl-2.0.html
19  *
20  * GPL HEADER END
21  */
22 /*
23  * Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2011, 2017, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  */
31
32 #ifndef _LUSTRE_LU_TARGET_H
33 #define _LUSTRE_LU_TARGET_H
34
35 #include <dt_object.h>
36 #include <lustre_export.h>
37 #include <lustre_update.h>
38 #include <lustre_disk.h>
39 #include <lustre_lfsck.h>
40
41 /* Each one represents a distribute transaction replay
42  * operation, and updates on each MDTs are linked to
43  * dtr_sub_list */
44 struct distribute_txn_replay_req {
45         /* update record, may be vmalloc'd */
46         struct llog_update_record *dtrq_lur;
47         int                     dtrq_lur_size;
48
49         /* linked to the distribute transaction replay
50          * list (tdtd_replay_list) */
51         struct list_head        dtrq_list;
52         __u64                   dtrq_master_transno;
53         __u64                   dtrq_batchid;
54         __u64                   dtrq_xid;
55
56         /* all of sub updates are linked here */
57         struct list_head        dtrq_sub_list;
58         spinlock_t              dtrq_sub_list_lock;
59
60         /* If the local update has been executed during replay */
61         __u32                   dtrq_local_update_executed:1;
62 };
63
64 /* Each one represents a sub replay item under a distribute
65  * transaction. A distribute transaction will be operated in
66  * two or more MDTs, and updates on each MDT will be represented
67  * by this structure */
68 struct distribute_txn_replay_req_sub {
69         __u32                   dtrqs_mdt_index;
70
71         /* All of cookies for the update will be linked here */
72         spinlock_t              dtrqs_cookie_list_lock;
73         struct list_head        dtrqs_cookie_list;
74         struct list_head        dtrqs_list;
75 };
76
77 struct target_distribute_txn_data;
78 typedef int (*distribute_txn_replay_handler_t)(struct lu_env *env,
79                                        struct target_distribute_txn_data *tdtd,
80                                        struct distribute_txn_replay_req *dtrq);
81 typedef char *(*target_show_update_logs_retrievers_t)(void *data, int *size,
82                                                       int *count);
83 struct target_distribute_txn_data {
84         /* Distribution ID is used to identify updates log on different
85          * MDTs for one operation */
86         spinlock_t              tdtd_batchid_lock;
87         __u64                   tdtd_batchid;
88         struct lu_target        *tdtd_lut;
89         struct dt_object        *tdtd_batchid_obj;
90         struct dt_device        *tdtd_dt;
91
92         /* Committed batchid for distribute transaction */
93         __u64                   tdtd_committed_batchid;
94
95         /* List for distribute transaction */
96         struct list_head        tdtd_list;
97
98         /* Threads to manage distribute transaction */
99         struct task_struct      *tdtd_commit_task;
100         atomic_t                tdtd_refcount;
101         struct lu_env           tdtd_env;
102
103         /* recovery update */
104         distribute_txn_replay_handler_t tdtd_replay_handler;
105         struct list_head                tdtd_replay_list;
106         struct list_head                tdtd_replay_finish_list;
107         spinlock_t                      tdtd_replay_list_lock;
108         /* last replay update transno */
109         __u32                           tdtd_replay_ready:1;
110
111         /* Manage the llog recovery threads */
112         atomic_t                tdtd_recovery_threads_count;
113         wait_queue_head_t       tdtd_recovery_threads_waitq;
114         target_show_update_logs_retrievers_t
115                                 tdtd_show_update_logs_retrievers;
116         void                    *tdtd_show_retrievers_cbdata;
117 };
118
119 struct tg_grants_data {
120         /* grants: all values in bytes */
121         /* grant lock to protect all grant counters */
122         spinlock_t               tgd_grant_lock;
123         /* total amount of dirty data reported by clients in incoming obdo */
124         u64                      tgd_tot_dirty;
125         /* sum of filesystem space granted to clients for async writes */
126         u64                      tgd_tot_granted;
127         /* grant used by I/Os in progress (between prepare and commit) */
128         u64                      tgd_tot_pending;
129         /* amount of available space in percentage that is never used for
130          * grants, used on MDT to always keep space for metadata. */
131         u64                      tgd_reserved_pcnt;
132         /* number of clients using grants */
133         int                      tgd_tot_granted_clients;
134         /* shall we grant space to clients not
135          * supporting OBD_CONNECT_GRANT_PARAM? */
136         int                      tgd_grant_compat_disable;
137         /* protect all statfs-related counters */
138         spinlock_t               tgd_osfs_lock;
139         time64_t                 tgd_osfs_age;
140         int                      tgd_blockbits;
141         /* counters used during statfs update, protected by ofd_osfs_lock.
142          * record when some statfs refresh are in progress */
143         int                      tgd_statfs_inflight;
144         /* writes between prep & commit which might be accounted twice in
145          * ofd_osfs.os_bavail */
146         u64                      tgd_osfs_unstable;
147         /* track writes completed while statfs refresh is underway.
148          * tracking is only effective when ofd_statfs_inflight > 1 */
149         u64                      tgd_osfs_inflight;
150         /* statfs optimization: we cache a bit  */
151         struct obd_statfs        tgd_osfs;
152 };
153
154 struct lu_target {
155         struct obd_device       *lut_obd;
156         struct dt_device        *lut_bottom;
157         struct dt_device_param   lut_dt_conf;
158
159         struct target_distribute_txn_data *lut_tdtd;
160
161         /* supported opcodes and handlers for this target */
162         struct tgt_opc_slice    *lut_slice;
163         __u32                    lut_reply_fail_id;
164         __u32                    lut_request_fail_id;
165
166         /* sptlrpc rules */
167         rwlock_t                 lut_sptlrpc_lock;
168         struct sptlrpc_rule_set  lut_sptlrpc_rset;
169         spinlock_t               lut_flags_lock;
170         unsigned int             lut_syncjournal:1,
171                                  lut_sync_lock_cancel:2,
172                                  /* e.g. OST node */
173                                  lut_no_reconstruct:1,
174                                  /* enforce recovery for local clients */
175                                  lut_local_recovery:1,
176                                  lut_cksum_t10pi_enforce:1;
177         /* checksum types supported on this node */
178         enum cksum_types         lut_cksum_types_supported;
179         /** last_rcvd file */
180         struct dt_object        *lut_last_rcvd;
181         /* transaction callbacks */
182         struct dt_txn_callback   lut_txn_cb;
183         /** server data in last_rcvd file */
184         struct lr_server_data    lut_lsd;
185         /** Server last transaction number */
186         __u64                    lut_last_transno;
187         /** Lock protecting last transaction number */
188         spinlock_t               lut_translock;
189         /** Lock protecting client bitmap */
190         spinlock_t               lut_client_bitmap_lock;
191         /** Bitmap of known clients */
192         unsigned long           *lut_client_bitmap;
193         /* Number of clients supporting multiple modify RPCs
194          * recorded in the bitmap */
195         atomic_t                 lut_num_clients;
196         /* Client generation to identify client slot reuse */
197         atomic_t                 lut_client_generation;
198         /** reply_data file */
199         struct dt_object        *lut_reply_data;
200         /** Bitmap of used slots in the reply data file */
201         unsigned long           **lut_reply_bitmap;
202         /** target sync count, used for debug & test */
203         atomic_t                 lut_sync_count;
204
205         /** cross MDT locks which should trigger Sync-on-Lock-Cancel */
206         spinlock_t               lut_slc_locks_guard;
207         struct list_head         lut_slc_locks;
208
209         /* target grants fields */
210         struct tg_grants_data    lut_tgd;
211
212         /* target tunables */
213         const struct attribute  **lut_attrs;
214
215         /* FMD (file modification data) values */
216         int                      lut_fmd_max_num;
217         time64_t                 lut_fmd_max_age;
218 };
219
220 #define LUT_FMD_MAX_NUM_DEFAULT 128
221 #define LUT_FMD_MAX_AGE_DEFAULT (obd_timeout + 10)
222
223 /* number of slots in reply bitmap */
224 #define LUT_REPLY_SLOTS_PER_CHUNK (1<<20)
225 #define LUT_REPLY_SLOTS_MAX_CHUNKS 16
226
227 #define TRD_INDEX_MEMORY -1
228
229 /**
230  * Target reply data
231  */
232 struct tg_reply_data {
233         /** chain of reply data anchored in tg_export_data */
234         struct list_head        trd_list;
235         /** copy of on-disk reply data */
236         struct lsd_reply_data   trd_reply;
237         /** versions for Version Based Recovery */
238         __u64                   trd_pre_versions[4];
239         /** slot index in reply_data file */
240         int                     trd_index;
241         /** tag the client used */
242         __u16                   trd_tag;
243 };
244
245 extern struct lu_context_key tgt_session_key;
246
247 struct tgt_session_info {
248         /*
249          * The following members will be filled explicitly
250          * with specific data in tgt_ses_init().
251          */
252         struct req_capsule      *tsi_pill;
253
254         /*
255          * Lock request for "habeo clavis" operations.
256          */
257         struct ldlm_request     *tsi_dlm_req;
258
259         /* although we have export in req, there are cases when it is not
260          * available, e.g. closing files upon export destroy */
261         struct obd_export       *tsi_exp;
262         const struct lu_env     *tsi_env;
263         struct lu_target        *tsi_tgt;
264
265         const struct mdt_body   *tsi_mdt_body;
266         struct ost_body         *tsi_ost_body;
267         struct lu_object        *tsi_corpus;
268
269         struct lu_fid            tsi_fid;
270         struct ldlm_res_id       tsi_resid;
271
272         /* object affected by VBR, for last_rcvd_update */
273         struct dt_object        *tsi_vbr_obj;
274         /* opdata for mdt_reint_open(), has the same value as
275          * ldlm_reply:lock_policy_res1.  The tgt_update_last_rcvd() stores
276          * this value onto disk for recovery when tgt_txn_stop_cb() is called.
277          */
278         __u64                    tsi_opdata;
279
280         /*
281          * Additional fail id that can be set by handler.
282          */
283         int                      tsi_reply_fail_id;
284         bool                     tsi_preprocessed;
285         /* request JobID */
286         char                    *tsi_jobid;
287
288         /* update replay */
289         __u64                   tsi_xid;
290         __u32                   tsi_result;
291         __u32                   tsi_client_gen;
292 };
293
294 static inline struct tgt_session_info *tgt_ses_info(const struct lu_env *env)
295 {
296         struct tgt_session_info *tsi;
297
298         LASSERT(env->le_ses != NULL);
299         tsi = lu_context_key_get(env->le_ses, &tgt_session_key);
300         LASSERT(tsi);
301         return tsi;
302 }
303
304 static inline void tgt_vbr_obj_set(const struct lu_env *env,
305                                    struct dt_object *obj)
306 {
307         struct tgt_session_info *tsi;
308
309         if (env->le_ses != NULL) {
310                 tsi = tgt_ses_info(env);
311                 tsi->tsi_vbr_obj = obj;
312         }
313 }
314
315 static inline void tgt_opdata_set(const struct lu_env *env, __u64 flags)
316 {
317         struct tgt_session_info *tsi;
318
319         if (env->le_ses != NULL) {
320                 tsi = tgt_ses_info(env);
321                 tsi->tsi_opdata |= flags;
322         }
323 }
324
325 static inline void tgt_opdata_clear(const struct lu_env *env, __u64 flags)
326 {
327         struct tgt_session_info *tsi;
328
329         if (env->le_ses != NULL) {
330                 tsi = tgt_ses_info(env);
331                 tsi->tsi_opdata &= ~flags;
332         }
333 }
334
335 /*
336  * Generic unified target support.
337  */
338 enum tgt_handler_flags {
339         /*
340          * struct *_body is passed in the incoming message, and object
341          * identified by this fid exists on disk.
342          */
343         HAS_BODY        = BIT(0),
344         /*
345          * struct ldlm_request is passed in the incoming message.
346          */
347         HAS_KEY         = BIT(1),
348         /*
349          * this request has fixed reply format, so that reply message can be
350          * packed by generic code.
351          */
352         HAS_REPLY       = BIT(2),
353         /*
354          * this request will modify something, so check whether the file system
355          * is readonly or not, then return -EROFS to client asap if necessary.
356          */
357         IS_MUTABLE      = BIT(3)
358 };
359
360 struct tgt_handler {
361         /* The name of this handler. */
362         const char              *th_name;
363         /* Fail id, check at the beginning */
364         int                      th_fail_id;
365         /* Operation code */
366         __u32                    th_opc;
367         /* Flags in enum tgt_handler_flags */
368         __u32                    th_flags;
369         /* Request version for this opcode */
370         enum lustre_msg_version  th_version;
371         /* Handler function */
372         int                     (*th_act)(struct tgt_session_info *tsi);
373         /* Handler function for high priority requests */
374         void                    (*th_hp)(struct tgt_session_info *tsi);
375         /* Request format for this request */
376         const struct req_format *th_fmt;
377 };
378
379 struct tgt_opc_slice {
380         __u32                    tos_opc_start; /* First op code */
381         __u32                    tos_opc_end; /* Last op code */
382         struct tgt_handler      *tos_hs; /* Registered handler */
383 };
384
385 static inline struct ptlrpc_request *tgt_ses_req(struct tgt_session_info *tsi)
386 {
387         return tsi->tsi_pill ? tsi->tsi_pill->rc_req : NULL;
388 }
389
390 static inline __u64 tgt_conn_flags(struct tgt_session_info *tsi)
391 {
392         LASSERT(tsi->tsi_exp);
393         return exp_connect_flags(tsi->tsi_exp);
394 }
395
396 static inline int req_is_replay(struct ptlrpc_request *req)
397 {
398         LASSERT(req->rq_reqmsg);
399         return !!(lustre_msg_get_flags(req->rq_reqmsg) & MSG_REPLAY);
400 }
401
402 static inline bool tgt_is_multimodrpcs_client(struct obd_export *exp)
403 {
404         return exp_connect_flags(exp) & OBD_CONNECT_MULTIMODRPCS;
405 }
406
407 static inline bool tgt_is_increasing_xid_client(struct obd_export *exp)
408 {
409         return exp_connect_flags2(exp) & OBD_CONNECT2_INC_XID;
410 }
411
412 /* target/tgt_handler.c */
413 int tgt_request_handle(struct ptlrpc_request *req);
414 char *tgt_name(struct lu_target *tgt);
415 void tgt_counter_incr(struct obd_export *exp, int opcode);
416 int tgt_connect_check_sptlrpc(struct ptlrpc_request *req,
417                               struct obd_export *exp);
418 int tgt_adapt_sptlrpc_conf(struct lu_target *tgt);
419 int tgt_connect(struct tgt_session_info *tsi);
420 int tgt_disconnect(struct tgt_session_info *uti);
421 int tgt_obd_ping(struct tgt_session_info *tsi);
422 int tgt_enqueue(struct tgt_session_info *tsi);
423 int tgt_convert(struct tgt_session_info *tsi);
424 int tgt_bl_callback(struct tgt_session_info *tsi);
425 int tgt_cp_callback(struct tgt_session_info *tsi);
426 int tgt_llog_open(struct tgt_session_info *tsi);
427 int tgt_llog_read_header(struct tgt_session_info *tsi);
428 int tgt_llog_next_block(struct tgt_session_info *tsi);
429 int tgt_llog_prev_block(struct tgt_session_info *tsi);
430 int tgt_sec_ctx_init(struct tgt_session_info *tsi);
431 int tgt_sec_ctx_init_cont(struct tgt_session_info *tsi);
432 int tgt_sec_ctx_fini(struct tgt_session_info *tsi);
433 int tgt_sendpage(struct tgt_session_info *tsi, struct lu_rdpg *rdpg, int nob);
434 int tgt_send_buffer(struct tgt_session_info *tsi, struct lu_rdbuf *rdbuf);
435 int tgt_validate_obdo(struct tgt_session_info *tsi, struct obdo *oa);
436 int tgt_sync(const struct lu_env *env, struct lu_target *tgt,
437              struct dt_object *obj, __u64 start, __u64 end);
438
439 int tgt_io_thread_init(struct ptlrpc_thread *thread);
440 void tgt_io_thread_done(struct ptlrpc_thread *thread);
441
442 int tgt_mdt_data_lock(struct ldlm_namespace *ns, struct ldlm_res_id *res_id,
443                       struct lustre_handle *lh, int mode, __u64 *flags);
444 int tgt_extent_lock(const struct lu_env *env, struct ldlm_namespace *ns,
445                     struct ldlm_res_id *res_id, __u64 start, __u64 end,
446                     struct lustre_handle *lh, int mode, __u64 *flags);
447 void tgt_data_unlock(struct lustre_handle *lh, enum ldlm_mode mode);
448 int tgt_brw_read(struct tgt_session_info *tsi);
449 int tgt_brw_write(struct tgt_session_info *tsi);
450 int tgt_lseek(struct tgt_session_info *tsi);
451 int tgt_hpreq_handler(struct ptlrpc_request *req);
452 void tgt_register_lfsck_in_notify_local(int (*notify)(const struct lu_env *,
453                                                       struct dt_device *,
454                                                       struct lfsck_req_local *,
455                                                       struct thandle *));
456 void tgt_register_lfsck_in_notify(int (*notify)(const struct lu_env *,
457                                                 struct dt_device *,
458                                                 struct lfsck_request *));
459 void tgt_register_lfsck_query(int (*query)(const struct lu_env *,
460                                            struct dt_device *,
461                                            struct lfsck_request *,
462                                            struct lfsck_reply *,
463                                            struct lfsck_query *));
464 int req_can_reconstruct(struct ptlrpc_request *req, struct tg_reply_data *trd);
465
466 extern struct tgt_handler tgt_sec_ctx_handlers[];
467 extern struct tgt_handler tgt_lfsck_handlers[];
468 extern struct tgt_handler tgt_obd_handlers[];
469 extern struct tgt_handler tgt_dlm_handlers[];
470 extern struct tgt_handler tgt_llog_handlers[];
471 extern struct tgt_handler tgt_out_handlers[];
472 extern struct tgt_handler fld_handlers[];
473 extern struct tgt_handler seq_handlers[];
474
475 typedef void (*tgt_cb_t)(struct lu_target *lut, __u64 transno,
476                          void *data, int err);
477 struct tgt_commit_cb {
478         tgt_cb_t  tgt_cb_func;
479         void     *tgt_cb_data;
480 };
481
482 int tgt_hpreq_handler(struct ptlrpc_request *req);
483
484 /* target/tgt_main.c */
485 void tgt_boot_epoch_update(struct lu_target *lut);
486 void tgt_save_slc_lock(struct lu_target *lut, struct ldlm_lock *lock,
487                        __u64 transno);
488 void tgt_discard_slc_lock(struct lu_target *lut, struct ldlm_lock *lock);
489 int tgt_init(const struct lu_env *env, struct lu_target *lut,
490              struct obd_device *obd, struct dt_device *dt,
491              struct tgt_opc_slice *slice,
492              int request_fail_id, int reply_fail_id);
493 void tgt_fini(const struct lu_env *env, struct lu_target *lut);
494 int tgt_client_alloc(struct obd_export *exp);
495 void tgt_client_free(struct obd_export *exp);
496 int tgt_client_del(const struct lu_env *env, struct obd_export *exp);
497 int tgt_client_add(const struct lu_env *env, struct obd_export *exp, int);
498 int tgt_client_new(const struct lu_env *env, struct obd_export *exp);
499 int tgt_server_data_update(const struct lu_env *env, struct lu_target *tg,
500                            int sync);
501 int tgt_reply_data_init(const struct lu_env *env, struct lu_target *tgt);
502 int tgt_lookup_reply(struct ptlrpc_request *req, struct tg_reply_data *trd);
503 int tgt_mk_reply_data(const struct lu_env *env, struct lu_target *tgt,
504                       struct tg_export_data *ted, struct ptlrpc_request *req,
505                       __u64 opdata, struct thandle *th, bool write_update,
506                       __u64 transno);
507 struct tg_reply_data *tgt_lookup_reply_by_xid(struct tg_export_data *ted,
508                                                __u64 xid);
509 int tgt_tunables_init(struct lu_target *lut);
510 void tgt_tunables_fini(struct lu_target *lut);
511 void tgt_mask_cksum_types(struct lu_target *lut, enum cksum_types *cksum_types);
512
513 /* target/tgt_grant.c */
514 static inline int exp_grant_param_supp(struct obd_export *exp)
515 {
516         return !!(exp_connect_flags(exp) & OBD_CONNECT_GRANT_PARAM);
517 }
518
519 /* Blocksize used for client not supporting OBD_CONNECT_GRANT_PARAM.
520  * That's 4KB=2^12 which is the biggest block size known to work whatever
521  * the client's page size is. */
522 #define COMPAT_BSIZE_SHIFT 12
523
524 void tgt_grant_sanity_check(struct obd_device *obd, const char *func);
525 void tgt_grant_connect(const struct lu_env *env, struct obd_export *exp,
526                        struct obd_connect_data *data, bool new_conn);
527 void tgt_grant_discard(struct obd_export *exp);
528 void tgt_grant_prepare_read(const struct lu_env *env, struct obd_export *exp,
529                             struct obdo *oa);
530 void tgt_grant_prepare_write(const struct lu_env *env, struct obd_export *exp,
531                              struct obdo *oa, struct niobuf_remote *rnb,
532                              int niocount);
533 void tgt_grant_commit(struct obd_export *exp, unsigned long grant_used, int rc);
534 int tgt_grant_commit_cb_add(struct thandle *th, struct obd_export *exp,
535                             unsigned long grant);
536 long tgt_grant_create(const struct lu_env *env, struct obd_export *exp,
537                       s64 *nr);
538 int tgt_statfs_internal(const struct lu_env *env, struct lu_target *lut,
539                         struct obd_statfs *osfs, time64_t max_age,
540                         int *from_cache);
541 ssize_t tot_dirty_show(struct kobject *kobj, struct attribute *attr,
542                        char *buf);
543 ssize_t tot_granted_show(struct kobject *kobj, struct attribute *attr,
544                          char *buf);
545 ssize_t tot_pending_show(struct kobject *kobj, struct attribute *attr,
546                          char *buf);
547 ssize_t grant_compat_disable_show(struct kobject *kobj, struct attribute *attr,
548                                   char *buf);
549 ssize_t grant_compat_disable_store(struct kobject *kobj,
550                                    struct attribute *attr,
551                                    const char *buffer, size_t count);
552 #if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 16, 53, 0)
553 ssize_t sync_lock_cancel_show(struct kobject *kobj,
554                               struct attribute *attr, char *buf);
555 ssize_t sync_lock_cancel_store(struct kobject *kobj, struct attribute *attr,
556                                const char *buffer, size_t count);
557 #endif
558
559 /* FMD */
560 void tgt_fmd_update(struct obd_export *exp, const struct lu_fid *fid,
561                     __u64 xid);
562 bool tgt_fmd_check(struct obd_export *exp, const struct lu_fid *fid,
563                    __u64 xid);
564 #ifdef DO_FMD_DROP
565 void tgt_fmd_drop(struct obd_export *exp, const struct lu_fid *fid);
566 #else
567 #define tgt_fmd_drop(exp, fid) do {} while (0)
568 #endif
569
570 /* target/update_trans.c */
571 int distribute_txn_init(const struct lu_env *env,
572                         struct lu_target *lut,
573                         struct target_distribute_txn_data *tdtd,
574                         __u32 index);
575 void distribute_txn_fini(const struct lu_env *env,
576                          struct target_distribute_txn_data *tdtd);
577
578 /* target/update_recovery.c */
579 int insert_update_records_to_replay_list(struct target_distribute_txn_data *,
580                                          struct llog_update_record *,
581                                          struct llog_cookie *, __u32);
582 void dtrq_list_dump(struct target_distribute_txn_data *tdtd,
583                     unsigned int mask);
584 void dtrq_list_destroy(struct target_distribute_txn_data *tdtd);
585 int distribute_txn_replay_handle(struct lu_env *env,
586                            struct target_distribute_txn_data *tdtd,
587                            struct distribute_txn_replay_req *dtrq);
588 __u64 distribute_txn_get_next_transno(struct target_distribute_txn_data *tdtd);
589 struct distribute_txn_replay_req *
590 distribute_txn_get_next_req(struct target_distribute_txn_data *tdtd);
591 void dtrq_destroy(struct distribute_txn_replay_req *dtrq);
592 struct distribute_txn_replay_req_sub *
593 dtrq_sub_lookup(struct distribute_txn_replay_req *dtrq, __u32 mdt_index);
594 struct distribute_txn_replay_req *
595 distribute_txn_lookup_finish_list(struct target_distribute_txn_data *tdtd,
596                                   __u64 transno);
597 bool is_req_replayed_by_update(struct ptlrpc_request *req);
598 enum {
599         ESERIOUS = 0x0001000
600 };
601
602 static inline int err_serious(int rc)
603 {
604         LASSERT(rc < 0);
605         return -(-rc | ESERIOUS);
606 }
607
608 static inline int clear_serious(int rc)
609 {
610         if (rc < 0)
611                 rc = -(-rc & ~ESERIOUS);
612         return rc;
613 }
614
615 static inline int is_serious(int rc)
616 {
617         return (rc < 0 && -rc & ESERIOUS);
618 }
619
620 /*
621  * Unified target generic handers macros and generic functions.
622  */
623 #define TGT_RPC_HANDLER_HP(base, flags, opc, fn, hp, fmt, version)      \
624 [opc - base] = {                                                        \
625         .th_name        = #opc,                                         \
626         .th_fail_id     = OBD_FAIL_ ## opc ## _NET,                     \
627         .th_opc         = opc,                                          \
628         .th_flags       = flags,                                        \
629         .th_act         = fn,                                           \
630         .th_fmt         = fmt,                                          \
631         .th_version     = version,                                      \
632         .th_hp          = hp,                                           \
633 }
634 #define TGT_RPC_HANDLER(base, flags, opc, fn, fmt, version)             \
635         TGT_RPC_HANDLER_HP(base, flags, opc, fn, NULL, fmt, version)
636
637 /* MDT Request with a format known in advance */
638 #define TGT_MDT_HDL(flags, name, fn)                                    \
639         TGT_RPC_HANDLER(MDS_FIRST_OPC, flags, name, fn, &RQF_ ## name,  \
640                         LUSTRE_MDS_VERSION)
641 /* Request with a format we do not yet know */
642 #define TGT_MDT_HDL_VAR(flags, name, fn)                                \
643         TGT_RPC_HANDLER(MDS_FIRST_OPC, flags, name, fn, NULL,           \
644                         LUSTRE_MDS_VERSION)
645
646 /* OST Request with a format known in advance */
647 #define TGT_OST_HDL(flags, name, fn)                                    \
648         TGT_RPC_HANDLER(OST_FIRST_OPC, flags, name, fn, &RQF_ ## name,  \
649                         LUSTRE_OST_VERSION)
650 #define TGT_OST_HDL_HP(flags, name, fn, hp)                             \
651         TGT_RPC_HANDLER_HP(OST_FIRST_OPC, flags, name, fn, hp,          \
652                            &RQF_ ## name, LUSTRE_OST_VERSION)
653
654 /* MGS request with a format known in advance */
655 #define TGT_MGS_HDL(flags, name, fn)                                    \
656         TGT_RPC_HANDLER(MGS_FIRST_OPC, flags, name, fn, &RQF_ ## name,  \
657                         LUSTRE_MGS_VERSION)
658 #define TGT_MGS_HDL_VAR(flags, name, fn)                                \
659         TGT_RPC_HANDLER(MGS_FIRST_OPC, flags, name, fn, NULL,           \
660                         LUSTRE_MGS_VERSION)
661
662 /*
663  * OBD handler macros and generic functions.
664  */
665 #define TGT_OBD_HDL(flags, name, fn)                                    \
666         TGT_RPC_HANDLER(OBD_FIRST_OPC, flags, name, fn, &RQF_ ## name,  \
667                         LUSTRE_OBD_VERSION)
668 #define TGT_OBD_HDL_VAR(flags, name, fn)                                \
669         TGT_RPC_HANDLER(OBD_FIRST_OPC, flags, name, fn, NULL,           \
670                         LUSTRE_OBD_VERSION)
671
672 /*
673  * DLM handler macros and generic functions.
674  */
675 #define TGT_DLM_HDL_VAR(flags, name, fn)                                \
676         TGT_RPC_HANDLER(LDLM_FIRST_OPC, flags, name, fn, NULL,          \
677                         LUSTRE_DLM_VERSION)
678 #define TGT_DLM_HDL(flags, name, fn)                                    \
679         TGT_RPC_HANDLER(LDLM_FIRST_OPC, flags, name, fn, &RQF_ ## name, \
680                         LUSTRE_DLM_VERSION)
681
682 /*
683  * LLOG handler macros and generic functions.
684  */
685 #define TGT_LLOG_HDL_VAR(flags, name, fn)                               \
686         TGT_RPC_HANDLER(LLOG_FIRST_OPC, flags, name, fn, NULL,          \
687                         LUSTRE_LOG_VERSION)
688 #define TGT_LLOG_HDL(flags, name, fn)                                   \
689         TGT_RPC_HANDLER(LLOG_FIRST_OPC, flags, name, fn, &RQF_ ## name, \
690                         LUSTRE_LOG_VERSION)
691
692 /*
693  * Sec context handler macros and generic functions.
694  */
695 #define TGT_SEC_HDL_VAR(flags, name, fn)                                \
696         TGT_RPC_HANDLER(SEC_FIRST_OPC, flags, name, fn, NULL,           \
697                         LUSTRE_OBD_VERSION)
698
699 #define TGT_QUOTA_HDL(flags, name, fn)                                  \
700         TGT_RPC_HANDLER(QUOTA_DQACQ, flags, name, fn, &RQF_ ## name,    \
701                         LUSTRE_MDS_VERSION)
702
703 /* Sequence service handlers */
704 #define TGT_SEQ_HDL(flags, name, fn)                                    \
705         TGT_RPC_HANDLER(SEQ_QUERY, flags, name, fn, &RQF_ ## name,      \
706                         LUSTRE_MDS_VERSION)
707
708 /* FID Location Database handlers */
709 #define TGT_FLD_HDL_VAR(flags, name, fn)                                \
710         TGT_RPC_HANDLER(FLD_QUERY, flags, name, fn, NULL,               \
711                         LUSTRE_MDS_VERSION)
712
713 /* LFSCK handlers */
714 #define TGT_LFSCK_HDL(flags, name, fn)                                  \
715         TGT_RPC_HANDLER(LFSCK_FIRST_OPC, flags, name, fn,               \
716                         &RQF_ ## name, LUSTRE_OBD_VERSION)
717
718 /* Request with a format known in advance */
719 #define TGT_UPDATE_HDL(flags, name, fn)                                 \
720         TGT_RPC_HANDLER(OUT_UPDATE, flags, name, fn, &RQF_ ## name,     \
721                         LUSTRE_MDS_VERSION)
722
723 #endif /* __LUSTRE_LU_TARGET_H */