1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
4 * Copyright (C) 2001 Cluster File Systems, Inc. <braam@clusterfs.com>
6 * This file is part of Lustre, http://www.lustre.org.
8 * Lustre is free software; you can redistribute it and/or
9 * modify it under the terms of version 2 of the GNU General Public
10 * License as published by the Free Software Foundation.
12 * Lustre is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Lustre; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 * (Un)packing of OST requests
23 * We assume all nodes are either little-endian or big-endian, and we
24 * always send messages in the sender's native format. The receiver
25 * detects the message format by checking the 'magic' field of the message
26 * (see lustre_msg_swabbed() below).
28 * Each wire type has corresponding 'lustre_swab_xxxtypexxx()' routines,
29 * implemented either here, inline (trivial implementations) or in
30 * ptlrpc/pack_generic.c. These 'swabbers' convert the type from "other"
31 * endian, in-place in the message buffer.
33 * A swabber takes a single pointer argument. The caller must already have
34 * verified that the length of the message buffer >= sizeof (type).
36 * For variable length types, a second 'lustre_swab_v_xxxtypexxx()' routine
37 * may be defined that swabs just the variable part, after the caller has
38 * verified that the message buffer is large enough.
41 #ifndef _LUSTRE_IDL_H_
42 #define _LUSTRE_IDL_H_
45 # include <linux/ioctl.h>
46 # include <asm/types.h>
47 # include <linux/types.h>
48 # include <linux/list.h>
49 # include <linux/string.h> /* for strncpy, below */
50 # include <asm/byteorder.h>
53 # include <sys/types.h>
55 # include <asm/types.h>
58 # include <portals/list.h>
61 * this file contains all data structures used in Lustre interfaces:
62 * - obdo and obd_request records
63 * - mds_request records
75 static inline int obd_uuid_equals(struct obd_uuid *u1, struct obd_uuid *u2)
77 return strcmp(u1->uuid, u2->uuid) == 0;
80 static inline void obd_str2uuid(struct obd_uuid *uuid, char *tmp)
82 strncpy(uuid->uuid, tmp, sizeof(*uuid));
83 uuid->uuid[sizeof(*uuid) - 1] = '\0';
86 extern struct obd_uuid lctl_fake_uuid;
88 /* FOO_REQUEST_PORTAL is for incoming requests on the FOO
89 * FOO_REPLY_PORTAL is for incoming replies on the FOO
90 * FOO_BULK_PORTAL is for incoming bulk on the FOO
93 #define CONNMGR_REQUEST_PORTAL 1
94 #define CONNMGR_REPLY_PORTAL 2
95 //#define OSC_REQUEST_PORTAL 3
96 #define OSC_REPLY_PORTAL 4
97 //#define OSC_BULK_PORTAL 5
98 #define OST_REQUEST_PORTAL 6
99 //#define OST_REPLY_PORTAL 7
100 #define OST_BULK_PORTAL 8
101 //#define MDC_REQUEST_PORTAL 9
102 #define MDC_REPLY_PORTAL 10
103 //#define MDC_BULK_PORTAL 11
104 #define MDS_REQUEST_PORTAL 12
105 //#define MDS_REPLY_PORTAL 13
106 #define MDS_BULK_PORTAL 14
107 #define LDLM_CB_REQUEST_PORTAL 15
108 #define LDLM_CB_REPLY_PORTAL 16
109 #define LDLM_CANCEL_REQUEST_PORTAL 17
110 #define LDLM_CANCEL_REPLY_PORTAL 18
111 #define PTLBD_REQUEST_PORTAL 19
112 #define PTLBD_REPLY_PORTAL 20
113 #define PTLBD_BULK_PORTAL 21
114 #define MDS_SETATTR_PORTAL 22
115 #define MDS_READPAGE_PORTAL 23
120 #define SVC_RUNNING 8
121 #define SVC_STOPPING 16
122 #define SVC_STOPPED 32
124 #define LUSTRE_CONN_NEW 1
125 #define LUSTRE_CONN_CON 2
126 #define LUSTRE_CONN_NOTCONN 3
127 #define LUSTRE_CONN_RECOVD 4
128 #define LUSTRE_CONN_FULL 5
131 #define PTL_RPC_MSG_REQUEST 4711
132 #define PTL_RPC_MSG_ERR 4712
133 #define PTL_RPC_MSG_REPLY 4713
135 #define PTLRPC_MSG_MAGIC 0x0BD00BD0
136 #define PTLRPC_MSG_VERSION 0x00040002
138 struct lustre_handle {
141 #define DEAD_HANDLE_MAGIC 0xdeadbeefcafebabe
143 /* we depend on this structure to be 8-byte aligned */
144 /* this type is only endian-adjusted in lustre_unpack_msg() */
146 struct lustre_handle handle;
152 __u64 last_committed;
160 static inline int lustre_msg_swabbed (struct lustre_msg *msg)
162 return (msg->magic == __swab32 (PTLRPC_MSG_MAGIC));
165 /* Flags that are operation-specific go in the top 16 bits. */
166 #define MSG_OP_FLAG_MASK 0xffff0000
167 #define MSG_OP_FLAG_SHIFT 16
169 /* Flags that apply to all requests are in the bottom 16 bits */
170 #define MSG_GEN_FLAG_MASK 0x0000ffff
171 #define MSG_LAST_REPLAY 1
174 static inline int lustre_msg_get_flags(struct lustre_msg *msg)
176 return (msg->flags & MSG_GEN_FLAG_MASK);
179 static inline void lustre_msg_add_flags(struct lustre_msg *msg, int flags)
181 msg->flags |= MSG_GEN_FLAG_MASK & flags;
184 static inline void lustre_msg_set_flags(struct lustre_msg *msg, int flags)
186 msg->flags &= ~MSG_GEN_FLAG_MASK;
187 lustre_msg_add_flags(msg, flags);
190 static inline int lustre_msg_get_op_flags(struct lustre_msg *msg)
192 return (msg->flags >> MSG_OP_FLAG_SHIFT);
195 static inline void lustre_msg_add_op_flags(struct lustre_msg *msg, int flags)
197 msg->flags |= ((flags & MSG_GEN_FLAG_MASK) << MSG_OP_FLAG_SHIFT);
200 static inline void lustre_msg_set_op_flags(struct lustre_msg *msg, int flags)
202 msg->flags &= ~MSG_OP_FLAG_MASK;
203 lustre_msg_add_op_flags(msg, flags);
207 * Flags for all connect opcodes (MDS_CONNECT, OST_CONNECT)
210 #define MSG_CONNECT_RECOVERING 0x1
211 #define MSG_CONNECT_RECONNECT 0x2
212 #define MSG_CONNECT_REPLAYABLE 0x4
215 * OST requests: OBDO & OBD request records
219 #define OST_REPLY 0 /* reply ? */
220 #define OST_GETATTR 1
221 #define OST_SETATTR 2
225 #define OST_DESTROY 6
226 #define OST_GET_INFO 7
227 #define OST_CONNECT 8
228 #define OST_DISCONNECT 9
232 #define OST_STATFS 13
233 #define OST_SAN_READ 14
234 #define OST_SAN_WRITE 15
235 #define OST_SYNCFS 16
236 /* When adding OST RPC opcodes, please update
237 * LAST/FIRST macros used in ptlrpc/ptlrpc_internals.h */
238 #define OST_LAST_OPC (OST_SYNCFS+1)
239 #define OST_FIRST_OPC OST_REPLY
242 typedef uint64_t obd_id;
243 typedef uint64_t obd_gr;
244 typedef uint64_t obd_time;
245 typedef uint64_t obd_size;
246 typedef uint64_t obd_off;
247 typedef uint64_t obd_blocks;
248 typedef uint32_t obd_blksize;
249 typedef uint32_t obd_mode;
250 typedef uint32_t obd_uid;
251 typedef uint32_t obd_gid;
252 typedef uint64_t obd_rdev;
253 typedef uint32_t obd_flag;
254 typedef uint32_t obd_count;
256 #define OBD_FL_INLINEDATA (0x00000001)
257 #define OBD_FL_OBDMDEXISTS (0x00000002)
259 #define OBD_INLINESZ 60
260 #define FD_OSTDATA_SIZE sizeof(struct obd_client_handle)
262 /* Note: 64-bit types are 64-bit aligned in structure */
272 obd_blksize o_blksize; /* optimal IO blocksize */
278 obd_count o_generation;
279 obd_flag o_valid; /* hot fields in this obdo */
282 char o_inline[OBD_INLINESZ];
285 extern void lustre_swab_obdo (struct obdo *o);
287 struct lov_object_id { /* per-child structure */
291 #define LOV_MAGIC 0x0BD00BD0
295 __u64 lmm_object_id; /* lov object id */
296 __u32 lmm_stripe_size; /* size of the stripe */
297 __u32 lmm_stripe_offset; /* starting stripe offset in lmm_objects */
298 __u16 lmm_stripe_count; /* number of stipes in use for this object */
299 __u16 lmm_ost_count; /* how many OST idx are in this LOV md */
300 struct lov_object_id lmm_objects[0];
303 #define OBD_MD_FLALL (0xffffffff)
304 #define OBD_MD_FLID (0x00000001) /* object ID */
305 #define OBD_MD_FLATIME (0x00000002) /* access time */
306 #define OBD_MD_FLMTIME (0x00000004) /* data modification time */
307 #define OBD_MD_FLCTIME (0x00000008) /* change time */
308 #define OBD_MD_FLSIZE (0x00000010) /* size */
309 #define OBD_MD_FLBLOCKS (0x00000020) /* allocated blocks count */
310 #define OBD_MD_FLBLKSZ (0x00000040) /* block size */
311 #define OBD_MD_FLMODE (0x00000080) /* access bits (mode & ~S_IFMT) */
312 #define OBD_MD_FLTYPE (0x00000100) /* object type (mode & S_IFMT) */
313 #define OBD_MD_FLUID (0x00000200) /* user ID */
314 #define OBD_MD_FLGID (0x00000400) /* group ID */
315 #define OBD_MD_FLFLAGS (0x00000800) /* flags word */
316 #define OBD_MD_FLOBDFLG (0x00001000)
317 #define OBD_MD_FLNLINK (0x00002000) /* link count */
318 #define OBD_MD_FLGENER (0x00004000) /* generation number */
319 #define OBD_MD_FLINLINE (0x00008000) /* inline data */
320 #define OBD_MD_FLRDEV (0x00010000) /* device number */
321 #define OBD_MD_FLEASIZE (0x00020000) /* extended attribute data */
322 #define OBD_MD_LINKNAME (0x00040000) /* symbolic link target */
323 #define OBD_MD_FLHANDLE (0x00080000) /* file handle */
324 #define OBD_MD_FLCKSUM (0x00100000) /* bulk data checksum */
325 #define OBD_MD_FLNOTOBD (~(OBD_MD_FLOBDFLG | OBD_MD_FLBLOCKS | OBD_MD_LINKNAME|\
326 OBD_MD_FLEASIZE | OBD_MD_FLHANDLE | OBD_MD_FLCKSUM))
342 extern void lustre_swab_obd_statfs (struct obd_statfs *os);
344 /* ost_body.data values for OST_BRW */
346 #define OBD_BRW_READ 0x01
347 #define OBD_BRW_WRITE 0x02
348 #define OBD_BRW_RWMASK (OBD_BRW_READ | OBD_BRW_WRITE)
349 #define OBD_BRW_CREATE 0x04
350 #define OBD_BRW_SYNC 0x08
351 #define OBD_BRW_CHECK 0x10
353 #define OBD_OBJECT_EOF 0xffffffffffffffffULL
360 } __attribute__((packed));
362 extern void lustre_swab_obd_ioobj (struct obd_ioobj *ioo);
364 /* multiple of 8 bytes => can array */
365 struct niobuf_remote {
369 } __attribute__((packed));
371 extern void lustre_swab_niobuf_remote (struct niobuf_remote *nbr);
373 /* request structure for OST's */
375 #define OST_REQ_HAS_OA1 0x1
381 extern void lustre_swab_ost_body (struct ost_body *b);
388 #define MDS_GETATTR 33
389 #define MDS_GETATTR_NAME 34
392 #define MDS_READPAGE 37
393 #define MDS_CONNECT 38
394 #define MDS_DISCONNECT 39
395 #define MDS_GETSTATUS 40
396 #define MDS_STATFS 41
397 #define MDS_GETLOVINFO 42
398 /* When adding MDS RPC opcodes, please update
399 * LAST/FIRST macros used in ptlrpc/ptlrpc_internals.h */
400 #define MDS_LAST_OPC (MDS_GETLOVINFO+1)
401 #define MDS_FIRST_OPC MDS_GETATTR
406 #define REINT_SETATTR 1
407 #define REINT_CREATE 2
409 #define REINT_UNLINK 4
410 #define REINT_RENAME 5
414 #define IT_INTENT_EXEC 1
415 #define IT_OPEN_LOOKUP (1 << 1)
416 #define IT_OPEN_NEG (1 << 2)
417 #define IT_OPEN_POS (1 << 3)
418 #define IT_OPEN_CREATE (1 << 4)
419 #define IT_OPEN_OPEN (1 << 5)
427 extern void lustre_swab_ll_fid (struct ll_fid *fid);
429 #define MDS_STATUS_CONN 1
430 #define MDS_STATUS_LOV 2
432 struct mds_status_req {
437 extern void lustre_swab_mds_status_req (struct mds_status_req *r);
439 struct mds_fileh_body {
441 struct lustre_handle f_handle;
444 extern void lustre_swab_mds_fileh_body (struct mds_fileh_body *f);
449 struct lustre_handle handle;
450 __u64 size; /* Offset, in the case of MDS_READPAGE */
451 __u64 blocks; /* XID, in the case of MDS_READPAGE */
452 __u32 ino; /* make this a __u64 */
465 __u32 nlink; /* #bytes to read in the case of MDS_READPAGE */
471 extern void lustre_swab_mds_body (struct mds_body *b);
473 /* This is probably redundant with OBD_MD_FLEASIZE, but we need an audit */
474 #define MDS_OPEN_HAS_EA 1 /* this open has an EA, for a delayed create*/
476 /* MDS update records */
478 //struct mds_update_record_hdr {
482 struct mds_rec_setattr {
489 struct ll_fid sa_fid;
501 extern void lustre_swab_mds_rec_setattr (struct mds_rec_setattr *sa);
503 struct mds_rec_create {
508 __u32 cr_flags; /* for use with open */
510 struct ll_fid cr_fid;
511 struct ll_fid cr_replayfid;
519 extern void lustre_swab_mds_rec_create (struct mds_rec_create *cr);
521 struct mds_rec_link {
528 struct ll_fid lk_fid1;
529 struct ll_fid lk_fid2;
532 extern void lustre_swab_mds_rec_link (struct mds_rec_link *lk);
534 struct mds_rec_unlink {
542 struct ll_fid ul_fid1;
543 struct ll_fid ul_fid2;
546 extern void lustre_swab_mds_rec_unlink (struct mds_rec_unlink *ul);
548 struct mds_rec_rename {
555 struct ll_fid rn_fid1;
556 struct ll_fid rn_fid2;
559 extern void lustre_swab_mds_rec_rename (struct mds_rec_rename *rn);
562 * LOV data structures
568 #define LOV_MAX_UUID_BUFFER_SIZE 8192
569 /* The size of the buffer the lov/mdc reserves for the
570 * array of UUIDs returned by the MDS. With the current
571 * protocol, this will limit the max number of OSTs per LOV */
574 __u32 ld_tgt_count; /* how many OBD's */
575 __u32 ld_active_tgt_count; /* how many active */
576 __u32 ld_default_stripe_count; /* how many objects are used */
577 __u64 ld_default_stripe_size; /* in bytes */
578 __u64 ld_default_stripe_offset; /* in bytes */
579 __u32 ld_pattern; /* RAID 0,1 etc */
580 struct obd_uuid ld_uuid;
583 extern void lustre_swab_lov_desc (struct lov_desc *ld);
588 /* opcodes -- MUST be distinct from OST/MDS opcodes */
589 #define LDLM_ENQUEUE 101
590 #define LDLM_CONVERT 102
591 #define LDLM_CANCEL 103
592 #define LDLM_BL_CALLBACK 104
593 #define LDLM_CP_CALLBACK 105
594 /* When adding LDLM RPC opcodes, please update
595 * LAST/FIRST macros used in ptlrpc/ptlrpc_internals.h */
596 #define LDLM_LAST_OPC (LDLM_CP_CALLBACK+1)
597 #define LDLM_FIRST_OPC LDLM_ENQUEUE
599 #define RES_NAME_SIZE 3
600 #define RES_VERSION_SIZE 4
603 __u64 name[RES_NAME_SIZE];
606 extern void lustre_swab_ldlm_res_id (struct ldlm_res_id *id);
623 extern void lustre_swab_ldlm_extent (struct ldlm_extent *e);
629 extern void lustre_swab_ldlm_intent (struct ldlm_intent *i);
631 /* Note this unaligned structure; as long as it's only used in ldlm_request
632 * below, we're probably fine. */
633 struct ldlm_resource_desc {
635 struct ldlm_res_id lr_name;
636 __u32 lr_version[RES_VERSION_SIZE];
639 extern void lustre_swab_ldlm_resource_desc (struct ldlm_resource_desc *r);
641 struct ldlm_lock_desc {
642 struct ldlm_resource_desc l_resource;
643 ldlm_mode_t l_req_mode;
644 ldlm_mode_t l_granted_mode;
645 struct ldlm_extent l_extent;
646 __u32 l_version[RES_VERSION_SIZE];
649 extern void lustre_swab_ldlm_lock_desc (struct ldlm_lock_desc *l);
651 struct ldlm_request {
653 struct ldlm_lock_desc lock_desc;
654 struct lustre_handle lock_handle1;
655 struct lustre_handle lock_handle2;
658 extern void lustre_swab_ldlm_request (struct ldlm_request *rq);
663 struct ldlm_res_id lock_resource_name;
664 struct lustre_handle lock_handle;
665 struct ldlm_extent lock_extent; /* XXX make this policy 1 &2 */
666 __u64 lock_policy_res1;
667 __u64 lock_policy_res2;
670 extern void lustre_swab_ldlm_reply (struct ldlm_reply *r);
673 * ptlbd, portal block device requests
681 PTLBD_DISCONNECT = 205,
683 /* When adding PTLBD RPC opcodes, please update
684 * LAST/FIRST macros used in ptlrpc/ptlrpc_internals.h */
685 #define PTLBD_LAST_OPC (PTLBD_FLUSH+1)
686 #define PTLBD_FIRST_OPC PTLBD_QUERY
696 extern void lustre_swab_ptlbd_op (struct ptlbd_op *op);
705 extern void lustre_swab_ptlbd_niob (struct ptlbd_niob *n);
712 extern void lustre_swab_ptlbd_rsp (struct ptlbd_rsp *r);
715 * Opcodes for multiple servers.