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