lustre/include/lustre_req_layout.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) 2007, 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  * lustre/include/lustre_req_layout.h
  32  *
  33  * Lustre Metadata Target (mdt) request handler
  34  *
  35  * Author: Nikita Danilov <nikita@clusterfs.com>
  36  */
  37
  38 #ifndef _LUSTRE_REQ_LAYOUT_H__
  39 #define _LUSTRE_REQ_LAYOUT_H__
  40
  41 #include <linux/types.h>
  42
  43 /** \defgroup req_layout req_layout
  44  *
  45  * @{
  46  */
  47
  48 struct req_msg_field;
  49 struct req_format;
  50 struct req_capsule;
  51
  52 struct ptlrpc_request;
  53
  54 enum req_location {
  55         RCL_CLIENT,
  56         RCL_SERVER,
  57         RCL_NR
  58 };
  59
  60 /* Maximal number of fields (buffers) in a request message. */
  61 #define REQ_MAX_FIELD_NR 12
  62
  63 struct req_capsule {
  64         struct ptlrpc_request   *rc_req;
  65         /** Request message - what client sent */
  66         struct lustre_msg       *rc_reqmsg;
  67         /** Reply message - server response */
  68         struct lustre_msg       *rc_repmsg;
  69         /** Fields that help to see if request and reply were swabved or not */
  70         __u32                    rc_req_swab_mask;
  71         __u32                    rc_rep_swab_mask;
  72         const struct req_format *rc_fmt;
  73         enum req_location        rc_loc;
  74         __u32                    rc_area[RCL_NR][REQ_MAX_FIELD_NR];
  75 };
  76
  77 void req_capsule_init(struct req_capsule *pill, struct ptlrpc_request *req,
  78                       enum req_location location);
  79 void req_capsule_fini(struct req_capsule *pill);
  80
  81 void req_capsule_set(struct req_capsule *pill, const struct req_format *fmt);
  82 void req_capsule_subreq_init(struct req_capsule *pill,
  83                              const struct req_format *fmt,
  84                              struct ptlrpc_request *req,
  85                              struct lustre_msg *reqmsg,
  86                              struct lustre_msg *repmsg,
  87                              enum req_location loc);
  88
  89 void req_capsule_client_dump(struct req_capsule *pill);
  90 void req_capsule_server_dump(struct req_capsule *pill);
  91 void req_capsule_init_area(struct req_capsule *pill);
  92 size_t req_capsule_filled_sizes(struct req_capsule *pill,
  93                                 enum req_location loc);
  94 int  req_capsule_server_pack(struct req_capsule *pill);
  95 int  req_capsule_client_pack(struct req_capsule *pill);
  96 void req_capsule_set_replen(struct req_capsule *pill);
  97
  98 void *req_capsule_client_get(struct req_capsule *pill,
  99                              const struct req_msg_field *field);
 100 void *req_capsule_client_swab_get(struct req_capsule *pill,
 101                                   const struct req_msg_field *field,
 102                                   void *swabber);
 103 void *req_capsule_client_sized_get(struct req_capsule *pill,
 104                                    const struct req_msg_field *field,
 105                                    __u32 len);
 106 void *req_capsule_server_get(struct req_capsule *pill,
 107                              const struct req_msg_field *field);
 108 void *req_capsule_server_sized_get(struct req_capsule *pill,
 109                                    const struct req_msg_field *field,
 110                                    __u32 len);
 111 void *req_capsule_server_swab_get(struct req_capsule *pill,
 112                                   const struct req_msg_field *field,
 113                                   void *swabber);
 114 void *req_capsule_server_sized_swab_get(struct req_capsule *pill,
 115                                         const struct req_msg_field *field,
 116                                         __u32 len, void *swabber);
 117 const void *req_capsule_other_get(struct req_capsule *pill,
 118                                   const struct req_msg_field *field);
 119
 120 void req_capsule_set_size(struct req_capsule *pill,
 121                           const struct req_msg_field *field,
 122                           enum req_location loc, __u32 size);
 123 __u32 req_capsule_get_size(const struct req_capsule *pill,
 124                            const struct req_msg_field *field,
 125                            enum req_location loc);
 126 __u32 req_capsule_msg_size(struct req_capsule *pill, enum req_location loc);
 127 __u32 req_capsule_fmt_size(__u32 magic, const struct req_format *fmt,
 128                          enum req_location loc);
 129 void req_capsule_extend(struct req_capsule *pill, const struct req_format *fmt);
 130
 131 int req_capsule_has_field(const struct req_capsule *pill,
 132                           const struct req_msg_field *field,
 133                           enum req_location loc);
 134 int req_capsule_field_present(const struct req_capsule *pill,
 135                               const struct req_msg_field *field,
 136                               enum req_location loc);
 137 void req_capsule_shrink(struct req_capsule *pill,
 138                         const struct req_msg_field *field,
 139                         __u32 newlen,
 140                         enum req_location loc);
 141 int req_capsule_server_grow(struct req_capsule *pill,
 142                             const struct req_msg_field *field,
 143                             __u32 newlen);
 144 bool req_capsule_need_swab(struct req_capsule *pill, enum req_location loc,
 145                            __u32 index);
 146 void req_capsule_set_swabbed(struct req_capsule *pill, enum req_location loc,
 147                              __u32 index);
 148
 149 /**
 150  * Returns true if request buffer at offset \a index was already swabbed
 151  */
 152 static inline bool req_capsule_req_swabbed(struct req_capsule *pill,
 153                                            size_t index)
 154 {
 155         LASSERT(index < sizeof(pill->rc_req_swab_mask) * 8);
 156         return pill->rc_req_swab_mask & BIT(index);
 157 }
 158
 159 /**
 160  * Returns true if request reply buffer at offset \a index was already swabbed
 161  */
 162 static inline bool req_capsule_rep_swabbed(struct req_capsule *pill,
 163                                            size_t index)
 164 {
 165         LASSERT(index < sizeof(pill->rc_rep_swab_mask) * 8);
 166         return pill->rc_rep_swab_mask & BIT(index);
 167 }
 168
 169 /**
 170  * Mark request buffer at offset \a index that it was already swabbed
 171  */
 172 static inline void req_capsule_set_req_swabbed(struct req_capsule *pill,
 173                                                size_t index)
 174 {
 175         LASSERT(index < sizeof(pill->rc_req_swab_mask) * 8);
 176         LASSERT((pill->rc_req_swab_mask & BIT(index)) == 0);
 177         pill->rc_req_swab_mask |= BIT(index);
 178 }
 179
 180 /**
 181  * Mark request reply buffer at offset \a index that it was already swabbed
 182  */
 183 static inline void req_capsule_set_rep_swabbed(struct req_capsule *pill,
 184                                                size_t index)
 185 {
 186         LASSERT(index < sizeof(pill->rc_rep_swab_mask) * 8);
 187         LASSERT((pill->rc_rep_swab_mask & BIT(index)) == 0);
 188         pill->rc_rep_swab_mask |= BIT(index);
 189 }
 190
 191 int  req_layout_init(void);
 192 void req_layout_fini(void);
 193 #ifdef HAVE_SERVER_SUPPORT
 194 int req_check_sepol(struct req_capsule *pill);
 195 #else
 196 static inline int req_check_sepol(struct req_capsule *pill)
 197 {
 198         return 0;
 199 }
 200 #endif
 201
 202 extern struct req_format RQF_OBD_PING;
 203 extern struct req_format RQF_OBD_SET_INFO;
 204 extern struct req_format RQF_MDT_SET_INFO;
 205 extern struct req_format RQF_SEC_CTX;
 206 extern struct req_format RQF_OBD_IDX_READ;
 207 /* MGS req_format */
 208 extern struct req_format RQF_MGS_TARGET_REG;
 209 extern struct req_format RQF_MGS_SET_INFO;
 210 extern struct req_format RQF_MGS_CONFIG_READ;
 211 /* fid/fld req_format */
 212 extern struct req_format RQF_SEQ_QUERY;
 213 extern struct req_format RQF_FLD_QUERY;
 214 extern struct req_format RQF_FLD_READ;
 215 /* MDS req_format */
 216 extern struct req_format RQF_MDS_CONNECT;
 217 extern struct req_format RQF_MDS_DISCONNECT;
 218 extern struct req_format RQF_MDS_STATFS;
 219 extern struct req_format RQF_MDS_STATFS_NEW;
 220 extern struct req_format RQF_MDS_GET_ROOT;
 221 extern struct req_format RQF_MDS_SYNC;
 222 extern struct req_format RQF_MDS_GETXATTR;
 223 extern struct req_format RQF_MDS_GETATTR;
 224 extern struct req_format RQF_OUT_UPDATE;
 225
 226 /*
 227  * This is format of direct (non-intent) MDS_GETATTR_NAME request.
 228  */
 229 extern struct req_format RQF_MDS_GETATTR_NAME;
 230 extern struct req_format RQF_MDS_CLOSE;
 231 extern struct req_format RQF_MDS_CLOSE_INTENT;
 232 extern struct req_format RQF_MDS_CONNECT;
 233 extern struct req_format RQF_MDS_DISCONNECT;
 234 extern struct req_format RQF_MDS_GET_INFO;
 235 extern struct req_format RQF_MDS_READPAGE;
 236 extern struct req_format RQF_MDS_REINT;
 237 extern struct req_format RQF_MDS_REINT_CREATE;
 238 extern struct req_format RQF_MDS_REINT_CREATE_ACL;
 239 extern struct req_format RQF_MDS_REINT_CREATE_SLAVE;
 240 extern struct req_format RQF_MDS_REINT_CREATE_SYM;
 241 extern struct req_format RQF_MDS_REINT_OPEN;
 242 extern struct req_format RQF_MDS_REINT_UNLINK;
 243 extern struct req_format RQF_MDS_REINT_LINK;
 244 extern struct req_format RQF_MDS_REINT_RENAME;
 245 extern struct req_format RQF_MDS_REINT_SETATTR;
 246 extern struct req_format RQF_MDS_REINT_SETXATTR;
 247 extern struct req_format RQF_MDS_QUOTACTL;
 248 extern struct req_format RQF_QUOTA_DQACQ;
 249 extern struct req_format RQF_MDS_SWAP_LAYOUTS;
 250 extern struct req_format RQF_MDS_REINT_MIGRATE;
 251 extern struct req_format RQF_MDS_REINT_RESYNC;
 252 extern struct req_format RQF_MDS_RMFID;
 253 /* MDS hsm formats */
 254 extern struct req_format RQF_MDS_HSM_STATE_GET;
 255 extern struct req_format RQF_MDS_HSM_STATE_SET;
 256 extern struct req_format RQF_MDS_HSM_ACTION;
 257 extern struct req_format RQF_MDS_HSM_PROGRESS;
 258 extern struct req_format RQF_MDS_HSM_CT_REGISTER;
 259 extern struct req_format RQF_MDS_HSM_CT_UNREGISTER;
 260 extern struct req_format RQF_MDS_HSM_REQUEST;
 261 /* OST req_format */
 262 extern struct req_format RQF_OST_CONNECT;
 263 extern struct req_format RQF_OST_DISCONNECT;
 264 extern struct req_format RQF_OST_QUOTACTL;
 265 extern struct req_format RQF_OST_GETATTR;
 266 extern struct req_format RQF_OST_SETATTR;
 267 extern struct req_format RQF_OST_CREATE;
 268 extern struct req_format RQF_OST_PUNCH;
 269 extern struct req_format RQF_OST_FALLOCATE;
 270 extern struct req_format RQF_OST_SYNC;
 271 extern struct req_format RQF_OST_DESTROY;
 272 extern struct req_format RQF_OST_BRW_READ;
 273 extern struct req_format RQF_OST_BRW_WRITE;
 274 extern struct req_format RQF_OST_STATFS;
 275 extern struct req_format RQF_OST_SET_GRANT_INFO;
 276 extern struct req_format RQF_OST_GET_INFO;
 277 extern struct req_format RQF_OST_GET_INFO_LAST_ID;
 278 extern struct req_format RQF_OST_GET_INFO_LAST_FID;
 279 extern struct req_format RQF_OST_SET_INFO_LAST_FID;
 280 extern struct req_format RQF_OST_GET_INFO_FIEMAP;
 281 extern struct req_format RQF_OST_LADVISE;
 282 extern struct req_format RQF_OST_SEEK;
 283
 284 /* LDLM req_format */
 285 extern struct req_format RQF_LDLM_ENQUEUE;
 286 extern struct req_format RQF_LDLM_ENQUEUE_LVB;
 287 extern struct req_format RQF_LDLM_CONVERT;
 288 extern struct req_format RQF_LDLM_INTENT;
 289 extern struct req_format RQF_LDLM_INTENT_BASIC;
 290 extern struct req_format RQF_LDLM_INTENT_LAYOUT;
 291 extern struct req_format RQF_LDLM_INTENT_GETATTR;
 292 extern struct req_format RQF_LDLM_INTENT_OPEN;
 293 extern struct req_format RQF_LDLM_INTENT_CREATE;
 294 extern struct req_format RQF_LDLM_INTENT_GETXATTR;
 295 extern struct req_format RQF_LDLM_INTENT_QUOTA;
 296 extern struct req_format RQF_LDLM_CANCEL;
 297 extern struct req_format RQF_LDLM_CALLBACK;
 298 extern struct req_format RQF_LDLM_CP_CALLBACK;
 299 extern struct req_format RQF_LDLM_BL_CALLBACK;
 300 extern struct req_format RQF_LDLM_GL_CALLBACK;
 301 extern struct req_format RQF_LDLM_GL_CALLBACK_DESC;
 302 /* LOG req_format */
 303 extern struct req_format RQF_LLOG_ORIGIN_HANDLE_CREATE;
 304 extern struct req_format RQF_LLOG_ORIGIN_HANDLE_NEXT_BLOCK;
 305 extern struct req_format RQF_LLOG_ORIGIN_HANDLE_PREV_BLOCK;
 306 extern struct req_format RQF_LLOG_ORIGIN_HANDLE_READ_HEADER;
 307
 308 extern struct req_format RQF_CONNECT;
 309
 310 /* LFSCK req_format */
 311 extern struct req_format RQF_LFSCK_NOTIFY;
 312 extern struct req_format RQF_LFSCK_QUERY;
 313
 314 /* Batch UpdaTe req_format */
 315 extern struct req_format RQF_BUT_GETATTR;
 316 extern struct req_format RQF_MDS_BATCH;
 317
 318 extern struct req_msg_field RMF_GENERIC_DATA;
 319 extern struct req_msg_field RMF_PTLRPC_BODY;
 320 extern struct req_msg_field RMF_MDT_BODY;
 321 extern struct req_msg_field RMF_MDT_EPOCH;
 322 extern struct req_msg_field RMF_OBD_STATFS;
 323 extern struct req_msg_field RMF_NAME;
 324 extern struct req_msg_field RMF_SYMTGT;
 325 extern struct req_msg_field RMF_TGTUUID;
 326 extern struct req_msg_field RMF_CLUUID;
 327 extern struct req_msg_field RMF_SETINFO_VAL;
 328 extern struct req_msg_field RMF_SETINFO_KEY;
 329 extern struct req_msg_field RMF_GETINFO_VAL;
 330 extern struct req_msg_field RMF_GETINFO_VALLEN;
 331 extern struct req_msg_field RMF_GETINFO_KEY;
 332 extern struct req_msg_field RMF_IDX_INFO;
 333 extern struct req_msg_field RMF_CLOSE_DATA;
 334 extern struct req_msg_field RMF_FILE_SECCTX_NAME;
 335 extern struct req_msg_field RMF_FILE_SECCTX;
 336 extern struct req_msg_field RMF_FID_ARRAY;
 337 extern struct req_msg_field RMF_FILE_ENCCTX;
 338
 339 /*
 340  * connection handle received in MDS_CONNECT request.
 341  */
 342 extern struct req_msg_field RMF_CONN;
 343 extern struct req_msg_field RMF_CONNECT_DATA;
 344 extern struct req_msg_field RMF_DLM_REQ;
 345 extern struct req_msg_field RMF_DLM_REP;
 346 extern struct req_msg_field RMF_DLM_LVB;
 347 extern struct req_msg_field RMF_DLM_GL_DESC;
 348 extern struct req_msg_field RMF_LDLM_INTENT;
 349 extern struct req_msg_field RMF_LAYOUT_INTENT;
 350 extern struct req_msg_field RMF_MDT_MD;
 351 extern struct req_msg_field RMF_DEFAULT_MDT_MD;
 352 extern struct req_msg_field RMF_REC_REINT;
 353 extern struct req_msg_field RMF_EADATA;
 354 extern struct req_msg_field RMF_EAVALS;
 355 extern struct req_msg_field RMF_EAVALS_LENS;
 356 extern struct req_msg_field RMF_ACL;
 357 extern struct req_msg_field RMF_LOGCOOKIES;
 358 extern struct req_msg_field RMF_CAPA1;
 359 extern struct req_msg_field RMF_CAPA2;
 360 extern struct req_msg_field RMF_OBD_QUOTACHECK;
 361 extern struct req_msg_field RMF_OBD_QUOTACTL;
 362 extern struct req_msg_field RMF_OBD_QUOTA_ITER;
 363 extern struct req_msg_field RMF_OBD_QUOTACTL_POOL;
 364 extern struct req_msg_field RMF_QUOTA_BODY;
 365 extern struct req_msg_field RMF_STRING;
 366 extern struct req_msg_field RMF_SWAP_LAYOUTS;
 367 extern struct req_msg_field RMF_MDS_HSM_PROGRESS;
 368 extern struct req_msg_field RMF_MDS_HSM_REQUEST;
 369 extern struct req_msg_field RMF_MDS_HSM_USER_ITEM;
 370 extern struct req_msg_field RMF_MDS_HSM_ARCHIVE;
 371 extern struct req_msg_field RMF_HSM_USER_STATE;
 372 extern struct req_msg_field RMF_HSM_STATE_SET;
 373 extern struct req_msg_field RMF_MDS_HSM_CURRENT_ACTION;
 374 extern struct req_msg_field RMF_MDS_HSM_REQUEST;
 375 extern struct req_msg_field RMF_SELINUX_POL;
 376
 377 /* seq-mgr fields */
 378 extern struct req_msg_field RMF_SEQ_OPC;
 379 extern struct req_msg_field RMF_SEQ_RANGE;
 380 extern struct req_msg_field RMF_FID_SPACE;
 381
 382 /* FLD fields */
 383 extern struct req_msg_field RMF_FLD_OPC;
 384 extern struct req_msg_field RMF_FLD_MDFLD;
 385
 386 extern struct req_msg_field RMF_LLOGD_BODY;
 387 extern struct req_msg_field RMF_LLOG_LOG_HDR;
 388 extern struct req_msg_field RMF_LLOGD_CONN_BODY;
 389
 390 extern struct req_msg_field RMF_MGS_TARGET_INFO;
 391 extern struct req_msg_field RMF_MGS_SEND_PARAM;
 392
 393 extern struct req_msg_field RMF_OST_BODY;
 394 extern struct req_msg_field RMF_OBD_IOOBJ;
 395 extern struct req_msg_field RMF_OBD_ID;
 396 extern struct req_msg_field RMF_FID;
 397 extern struct req_msg_field RMF_NIOBUF_REMOTE;
 398 extern struct req_msg_field RMF_NIOBUF_INLINE;
 399 extern struct req_msg_field RMF_RCS;
 400 extern struct req_msg_field RMF_FIEMAP_KEY;
 401 extern struct req_msg_field RMF_FIEMAP_VAL;
 402 extern struct req_msg_field RMF_OST_ID;
 403 extern struct req_msg_field RMF_SHORT_IO;
 404
 405 /* MGS config read message format */
 406 extern struct req_msg_field RMF_MGS_CONFIG_BODY;
 407 extern struct req_msg_field RMF_MGS_CONFIG_RES;
 408
 409 /* generic uint32 */
 410 extern struct req_msg_field RMF_U32;
 411
 412 /* OBJ update format */
 413 extern struct req_msg_field RMF_OUT_UPDATE;
 414 extern struct req_msg_field RMF_OUT_UPDATE_REPLY;
 415 extern struct req_msg_field RMF_OUT_UPDATE_HEADER;
 416 extern struct req_msg_field RMF_OUT_UPDATE_BUF;
 417
 418 /* Batch UpdaTe format */
 419 extern struct req_msg_field RMF_BUT_REPLY;
 420 extern struct req_msg_field RMF_BUT_HEADER;
 421 extern struct req_msg_field RMF_BUT_BUF;
 422
 423 /* LFSCK format */
 424 extern struct req_msg_field RMF_LFSCK_REQUEST;
 425 extern struct req_msg_field RMF_LFSCK_REPLY;
 426
 427 extern struct req_msg_field RMF_OST_LADVISE_HDR;
 428 extern struct req_msg_field RMF_OST_LADVISE;
 429 /** @} req_layout */
 430
 431 #endif /* _LUSTRE_REQ_LAYOUT_H__ */