4 * NFSv4 protocol definitions.
6 * Copyright (c) 2002 The Regents of the University of Michigan.
9 * Kendrick Smith <kmsmith@umich.edu>
10 * Andy Adamson <andros@umich.edu>
15 #include <linux/list.h>
16 #include <linux/uidgid.h>
17 #include <uapi/linux/nfs4.h>
19 enum nfs4_acl_whotype {
20 NFS4_ACL_WHO_NAMED = 0,
23 NFS4_ACL_WHO_EVERYONE,
39 struct nfs4_ace aces[0];
42 #define NFS4_MAXLABELLEN 2048
51 typedef struct { char data[NFS4_VERIFIER_SIZE]; } nfs4_verifier;
55 char other[NFS4_STATEID_OTHER_SIZE];
56 } __attribute__ ((packed));
58 typedef struct nfs_stateid4 nfs4_stateid;
79 OP_OPEN_DOWNGRADE = 21,
94 OP_SETCLIENTID_CONFIRM = 36,
97 OP_RELEASE_LOCKOWNER = 39,
100 OP_BACKCHANNEL_CTL = 40,
101 OP_BIND_CONN_TO_SESSION = 41,
103 OP_CREATE_SESSION = 43,
104 OP_DESTROY_SESSION = 44,
105 OP_FREE_STATEID = 45,
106 OP_GET_DIR_DELEGATION = 46,
107 OP_GETDEVICEINFO = 47,
108 OP_GETDEVICELIST = 48,
109 OP_LAYOUTCOMMIT = 49,
111 OP_LAYOUTRETURN = 51,
112 OP_SECINFO_NO_NAME = 52,
115 OP_TEST_STATEID = 55,
116 OP_WANT_DELEGATION = 56,
117 OP_DESTROY_CLIENTID = 57,
118 OP_RECLAIM_COMPLETE = 58,
128 OP_OFFLOAD_CANCEL = 66,
129 OP_OFFLOAD_STATUS = 67,
137 /*Defining first and last NFS4 operations implemented.
138 Needs to be updated if more operations are defined in future.*/
140 #define FIRST_NFS4_OP OP_ACCESS
141 #define LAST_NFS4_OP OP_WRITE_SAME
142 #define LAST_NFS40_OP OP_RELEASE_LOCKOWNER
143 #define LAST_NFS41_OP OP_RECLAIM_COMPLETE
144 #define LAST_NFS42_OP OP_WRITE_SAME
155 /* Unused/reserved 19 */
163 NFS4ERR_NAMETOOLONG = 63,
164 NFS4ERR_NOTEMPTY = 66,
167 NFS4ERR_BADHANDLE = 10001,
168 NFS4ERR_BAD_COOKIE = 10003,
169 NFS4ERR_NOTSUPP = 10004,
170 NFS4ERR_TOOSMALL = 10005,
171 NFS4ERR_SERVERFAULT = 10006,
172 NFS4ERR_BADTYPE = 10007,
173 NFS4ERR_DELAY = 10008,
174 NFS4ERR_SAME = 10009,
175 NFS4ERR_DENIED = 10010,
176 NFS4ERR_EXPIRED = 10011,
177 NFS4ERR_LOCKED = 10012,
178 NFS4ERR_GRACE = 10013,
179 NFS4ERR_FHEXPIRED = 10014,
180 NFS4ERR_SHARE_DENIED = 10015,
181 NFS4ERR_WRONGSEC = 10016,
182 NFS4ERR_CLID_INUSE = 10017,
183 NFS4ERR_RESOURCE = 10018,
184 NFS4ERR_MOVED = 10019,
185 NFS4ERR_NOFILEHANDLE = 10020,
186 NFS4ERR_MINOR_VERS_MISMATCH = 10021,
187 NFS4ERR_STALE_CLIENTID = 10022,
188 NFS4ERR_STALE_STATEID = 10023,
189 NFS4ERR_OLD_STATEID = 10024,
190 NFS4ERR_BAD_STATEID = 10025,
191 NFS4ERR_BAD_SEQID = 10026,
192 NFS4ERR_NOT_SAME = 10027,
193 NFS4ERR_LOCK_RANGE = 10028,
194 NFS4ERR_SYMLINK = 10029,
195 NFS4ERR_RESTOREFH = 10030,
196 NFS4ERR_LEASE_MOVED = 10031,
197 NFS4ERR_ATTRNOTSUPP = 10032,
198 NFS4ERR_NO_GRACE = 10033,
199 NFS4ERR_RECLAIM_BAD = 10034,
200 NFS4ERR_RECLAIM_CONFLICT = 10035,
201 NFS4ERR_BADXDR = 10036,
202 NFS4ERR_LOCKS_HELD = 10037,
203 NFS4ERR_OPENMODE = 10038,
204 NFS4ERR_BADOWNER = 10039,
205 NFS4ERR_BADCHAR = 10040,
206 NFS4ERR_BADNAME = 10041,
207 NFS4ERR_BAD_RANGE = 10042,
208 NFS4ERR_LOCK_NOTSUPP = 10043,
209 NFS4ERR_OP_ILLEGAL = 10044,
210 NFS4ERR_DEADLOCK = 10045,
211 NFS4ERR_FILE_OPEN = 10046,
212 NFS4ERR_ADMIN_REVOKED = 10047,
213 NFS4ERR_CB_PATH_DOWN = 10048,
216 NFS4ERR_BADIOMODE = 10049,
217 NFS4ERR_BADLAYOUT = 10050,
218 NFS4ERR_BAD_SESSION_DIGEST = 10051,
219 NFS4ERR_BADSESSION = 10052,
220 NFS4ERR_BADSLOT = 10053,
221 NFS4ERR_COMPLETE_ALREADY = 10054,
222 NFS4ERR_CONN_NOT_BOUND_TO_SESSION = 10055,
223 NFS4ERR_DELEG_ALREADY_WANTED = 10056,
224 NFS4ERR_BACK_CHAN_BUSY = 10057, /* backchan reqs outstanding */
225 NFS4ERR_LAYOUTTRYLATER = 10058,
226 NFS4ERR_LAYOUTUNAVAILABLE = 10059,
227 NFS4ERR_NOMATCHING_LAYOUT = 10060,
228 NFS4ERR_RECALLCONFLICT = 10061,
229 NFS4ERR_UNKNOWN_LAYOUTTYPE = 10062,
230 NFS4ERR_SEQ_MISORDERED = 10063, /* unexpected seq.id in req */
231 NFS4ERR_SEQUENCE_POS = 10064, /* [CB_]SEQ. op not 1st op */
232 NFS4ERR_REQ_TOO_BIG = 10065, /* request too big */
233 NFS4ERR_REP_TOO_BIG = 10066, /* reply too big */
234 NFS4ERR_REP_TOO_BIG_TO_CACHE = 10067, /* rep. not all cached */
235 NFS4ERR_RETRY_UNCACHED_REP = 10068, /* retry & rep. uncached */
236 NFS4ERR_UNSAFE_COMPOUND = 10069, /* retry/recovery too hard */
237 NFS4ERR_TOO_MANY_OPS = 10070, /* too many ops in [CB_]COMP */
238 NFS4ERR_OP_NOT_IN_SESSION = 10071, /* op needs [CB_]SEQ. op */
239 NFS4ERR_HASH_ALG_UNSUPP = 10072, /* hash alg. not supp. */
240 /* Error 10073 is unused. */
241 NFS4ERR_CLIENTID_BUSY = 10074, /* clientid has state */
242 NFS4ERR_PNFS_IO_HOLE = 10075, /* IO to _SPARSE file hole */
243 NFS4ERR_SEQ_FALSE_RETRY = 10076, /* retry not original */
244 NFS4ERR_BAD_HIGH_SLOT = 10077, /* sequence arg bad */
245 NFS4ERR_DEADSESSION = 10078, /* persistent session dead */
246 NFS4ERR_ENCR_ALG_UNSUPP = 10079, /* SSV alg mismatch */
247 NFS4ERR_PNFS_NO_LAYOUT = 10080, /* direct I/O with no layout */
248 NFS4ERR_NOT_ONLY_OP = 10081, /* bad compound */
249 NFS4ERR_WRONG_CRED = 10082, /* permissions:state change */
250 NFS4ERR_WRONG_TYPE = 10083, /* current operation mismatch */
251 NFS4ERR_DIRDELEG_UNAVAIL = 10084, /* no directory delegation */
252 NFS4ERR_REJECT_DELEG = 10085, /* on callback */
253 NFS4ERR_RETURNCONFLICT = 10086, /* outstanding layoutreturn */
254 NFS4ERR_DELEG_REVOKED = 10087, /* deleg./layout revoked */
257 NFS4ERR_PARTNER_NOTSUPP = 10088,
258 NFS4ERR_PARTNER_NO_AUTH = 10089,
259 NFS4ERR_UNION_NOTSUPP = 10090,
260 NFS4ERR_OFFLOAD_DENIED = 10091,
261 NFS4ERR_WRONG_LFS = 10092,
262 NFS4ERR_BADLABEL = 10093,
263 NFS4ERR_OFFLOAD_NO_REQS = 10094,
266 static inline bool seqid_mutating_err(u32 err)
268 /* rfc 3530 section 8.1.5: */
270 case NFS4ERR_STALE_CLIENTID:
271 case NFS4ERR_STALE_STATEID:
272 case NFS4ERR_BAD_STATEID:
273 case NFS4ERR_BAD_SEQID:
275 case NFS4ERR_RESOURCE:
276 case NFS4ERR_NOFILEHANDLE:
283 * Note: NF4BAD is not actually part of the protocol; it is just used
284 * internally by nfsd.
288 NF4REG = 1, /* Regular File */
289 NF4DIR = 2, /* Directory */
290 NF4BLK = 3, /* Special File - block device */
291 NF4CHR = 4, /* Special File - character device */
292 NF4LNK = 5, /* Symbolic Link */
293 NF4SOCK = 6, /* Special File - socket */
294 NF4FIFO = 7, /* Special File - fifo */
295 NF4ATTRDIR = 8, /* Attribute Directory */
296 NF4NAMEDATTR = 9 /* Named Attribute */
299 enum open_claim_type4 {
300 NFS4_OPEN_CLAIM_NULL = 0,
301 NFS4_OPEN_CLAIM_PREVIOUS = 1,
302 NFS4_OPEN_CLAIM_DELEGATE_CUR = 2,
303 NFS4_OPEN_CLAIM_DELEGATE_PREV = 3,
304 NFS4_OPEN_CLAIM_FH = 4, /* 4.1 */
305 NFS4_OPEN_CLAIM_DELEG_CUR_FH = 5, /* 4.1 */
306 NFS4_OPEN_CLAIM_DELEG_PREV_FH = 6, /* 4.1 */
310 NFS4_OPEN_NOCREATE = 0,
315 NFS4_CREATE_UNCHECKED = 0,
316 NFS4_CREATE_GUARDED = 1,
317 NFS4_CREATE_EXCLUSIVE = 2,
319 * New to NFSv4.1. If session is persistent,
320 * GUARDED4 MUST be used. Otherwise, use
321 * EXCLUSIVE4_1 instead of EXCLUSIVE4.
323 NFS4_CREATE_EXCLUSIVE4_1 = 3
328 NFS4_LIMIT_BLOCKS = 2
331 enum open_delegation_type4 {
332 NFS4_OPEN_DELEGATE_NONE = 0,
333 NFS4_OPEN_DELEGATE_READ = 1,
334 NFS4_OPEN_DELEGATE_WRITE = 2,
335 NFS4_OPEN_DELEGATE_NONE_EXT = 3, /* 4.1 */
338 enum why_no_delegation4 { /* new to v4.1 */
342 WND4_NOT_SUPP_FTYPE = 3,
343 WND4_WRITE_DELEG_NOT_SUPP_FTYPE = 4,
344 WND4_NOT_SUPP_UPGRADE = 5,
345 WND4_NOT_SUPP_DOWNGRADE = 6,
359 /* Mandatory Attributes */
360 #define FATTR4_WORD0_SUPPORTED_ATTRS (1UL << 0)
361 #define FATTR4_WORD0_TYPE (1UL << 1)
362 #define FATTR4_WORD0_FH_EXPIRE_TYPE (1UL << 2)
363 #define FATTR4_WORD0_CHANGE (1UL << 3)
364 #define FATTR4_WORD0_SIZE (1UL << 4)
365 #define FATTR4_WORD0_LINK_SUPPORT (1UL << 5)
366 #define FATTR4_WORD0_SYMLINK_SUPPORT (1UL << 6)
367 #define FATTR4_WORD0_NAMED_ATTR (1UL << 7)
368 #define FATTR4_WORD0_FSID (1UL << 8)
369 #define FATTR4_WORD0_UNIQUE_HANDLES (1UL << 9)
370 #define FATTR4_WORD0_LEASE_TIME (1UL << 10)
371 #define FATTR4_WORD0_RDATTR_ERROR (1UL << 11)
372 /* Mandatory in NFSv4.1 */
373 #define FATTR4_WORD2_SUPPATTR_EXCLCREAT (1UL << 11)
375 /* Recommended Attributes */
376 #define FATTR4_WORD0_ACL (1UL << 12)
377 #define FATTR4_WORD0_ACLSUPPORT (1UL << 13)
378 #define FATTR4_WORD0_ARCHIVE (1UL << 14)
379 #define FATTR4_WORD0_CANSETTIME (1UL << 15)
380 #define FATTR4_WORD0_CASE_INSENSITIVE (1UL << 16)
381 #define FATTR4_WORD0_CASE_PRESERVING (1UL << 17)
382 #define FATTR4_WORD0_CHOWN_RESTRICTED (1UL << 18)
383 #define FATTR4_WORD0_FILEHANDLE (1UL << 19)
384 #define FATTR4_WORD0_FILEID (1UL << 20)
385 #define FATTR4_WORD0_FILES_AVAIL (1UL << 21)
386 #define FATTR4_WORD0_FILES_FREE (1UL << 22)
387 #define FATTR4_WORD0_FILES_TOTAL (1UL << 23)
388 #define FATTR4_WORD0_FS_LOCATIONS (1UL << 24)
389 #define FATTR4_WORD0_HIDDEN (1UL << 25)
390 #define FATTR4_WORD0_HOMOGENEOUS (1UL << 26)
391 #define FATTR4_WORD0_MAXFILESIZE (1UL << 27)
392 #define FATTR4_WORD0_MAXLINK (1UL << 28)
393 #define FATTR4_WORD0_MAXNAME (1UL << 29)
394 #define FATTR4_WORD0_MAXREAD (1UL << 30)
395 #define FATTR4_WORD0_MAXWRITE (1UL << 31)
396 #define FATTR4_WORD1_MIMETYPE (1UL << 0)
397 #define FATTR4_WORD1_MODE (1UL << 1)
398 #define FATTR4_WORD1_NO_TRUNC (1UL << 2)
399 #define FATTR4_WORD1_NUMLINKS (1UL << 3)
400 #define FATTR4_WORD1_OWNER (1UL << 4)
401 #define FATTR4_WORD1_OWNER_GROUP (1UL << 5)
402 #define FATTR4_WORD1_QUOTA_HARD (1UL << 6)
403 #define FATTR4_WORD1_QUOTA_SOFT (1UL << 7)
404 #define FATTR4_WORD1_QUOTA_USED (1UL << 8)
405 #define FATTR4_WORD1_RAWDEV (1UL << 9)
406 #define FATTR4_WORD1_SPACE_AVAIL (1UL << 10)
407 #define FATTR4_WORD1_SPACE_FREE (1UL << 11)
408 #define FATTR4_WORD1_SPACE_TOTAL (1UL << 12)
409 #define FATTR4_WORD1_SPACE_USED (1UL << 13)
410 #define FATTR4_WORD1_SYSTEM (1UL << 14)
411 #define FATTR4_WORD1_TIME_ACCESS (1UL << 15)
412 #define FATTR4_WORD1_TIME_ACCESS_SET (1UL << 16)
413 #define FATTR4_WORD1_TIME_BACKUP (1UL << 17)
414 #define FATTR4_WORD1_TIME_CREATE (1UL << 18)
415 #define FATTR4_WORD1_TIME_DELTA (1UL << 19)
416 #define FATTR4_WORD1_TIME_METADATA (1UL << 20)
417 #define FATTR4_WORD1_TIME_MODIFY (1UL << 21)
418 #define FATTR4_WORD1_TIME_MODIFY_SET (1UL << 22)
419 #define FATTR4_WORD1_MOUNTED_ON_FILEID (1UL << 23)
420 #define FATTR4_WORD1_FS_LAYOUT_TYPES (1UL << 30)
421 #define FATTR4_WORD2_LAYOUT_TYPES (1UL << 0)
422 #define FATTR4_WORD2_LAYOUT_BLKSIZE (1UL << 1)
423 #define FATTR4_WORD2_MDSTHRESHOLD (1UL << 4)
424 #define FATTR4_WORD2_SECURITY_LABEL (1UL << 16)
426 /* MDS threshold bitmap bits */
427 #define THRESHOLD_RD (1UL << 0)
428 #define THRESHOLD_WR (1UL << 1)
429 #define THRESHOLD_RD_IO (1UL << 2)
430 #define THRESHOLD_WR_IO (1UL << 3)
432 #define NFSPROC4_NULL 0
433 #define NFSPROC4_COMPOUND 1
434 #define NFS4_VERSION 4
435 #define NFS4_MINOR_VERSION 0
439 /* Index of predefined Linux client operations */
442 NFSPROC4_CLNT_NULL = 0, /* Unused */
445 NFSPROC4_CLNT_COMMIT,
447 NFSPROC4_CLNT_OPEN_CONFIRM,
448 NFSPROC4_CLNT_OPEN_NOATTR,
449 NFSPROC4_CLNT_OPEN_DOWNGRADE,
451 NFSPROC4_CLNT_SETATTR,
452 NFSPROC4_CLNT_FSINFO,
454 NFSPROC4_CLNT_SETCLIENTID,
455 NFSPROC4_CLNT_SETCLIENTID_CONFIRM,
459 NFSPROC4_CLNT_ACCESS,
460 NFSPROC4_CLNT_GETATTR,
461 NFSPROC4_CLNT_LOOKUP,
462 NFSPROC4_CLNT_LOOKUP_ROOT,
463 NFSPROC4_CLNT_REMOVE,
464 NFSPROC4_CLNT_RENAME,
466 NFSPROC4_CLNT_SYMLINK,
467 NFSPROC4_CLNT_CREATE,
468 NFSPROC4_CLNT_PATHCONF,
469 NFSPROC4_CLNT_STATFS,
470 NFSPROC4_CLNT_READLINK,
471 NFSPROC4_CLNT_READDIR,
472 NFSPROC4_CLNT_SERVER_CAPS,
473 NFSPROC4_CLNT_DELEGRETURN,
474 NFSPROC4_CLNT_GETACL,
475 NFSPROC4_CLNT_SETACL,
476 NFSPROC4_CLNT_FS_LOCATIONS,
477 NFSPROC4_CLNT_RELEASE_LOCKOWNER,
478 NFSPROC4_CLNT_SECINFO,
479 NFSPROC4_CLNT_FSID_PRESENT,
482 NFSPROC4_CLNT_EXCHANGE_ID,
483 NFSPROC4_CLNT_CREATE_SESSION,
484 NFSPROC4_CLNT_DESTROY_SESSION,
485 NFSPROC4_CLNT_SEQUENCE,
486 NFSPROC4_CLNT_GET_LEASE_TIME,
487 NFSPROC4_CLNT_RECLAIM_COMPLETE,
488 NFSPROC4_CLNT_LAYOUTGET,
489 NFSPROC4_CLNT_GETDEVICEINFO,
490 NFSPROC4_CLNT_LAYOUTCOMMIT,
491 NFSPROC4_CLNT_LAYOUTRETURN,
492 NFSPROC4_CLNT_SECINFO_NO_NAME,
493 NFSPROC4_CLNT_TEST_STATEID,
494 NFSPROC4_CLNT_FREE_STATEID,
495 NFSPROC4_CLNT_GETDEVICELIST,
496 NFSPROC4_CLNT_BIND_CONN_TO_SESSION,
497 NFSPROC4_CLNT_DESTROY_CLIENTID,
501 NFSPROC4_CLNT_ALLOCATE,
502 NFSPROC4_CLNT_DEALLOCATE,
506 struct nfs4_sessionid {
507 unsigned char data[NFS4_MAX_SESSIONID_LEN];
510 /* Create Session Flags */
511 #define SESSION4_PERSIST 0x001
512 #define SESSION4_BACK_CHAN 0x002
513 #define SESSION4_RDMA 0x004
515 #define SESSION4_FLAG_MASK_A 0x007
517 enum state_protect_how4 {
523 enum pnfs_layouttype {
524 LAYOUT_NFSV4_1_FILES = 1,
525 LAYOUT_OSD2_OBJECTS = 2,
526 LAYOUT_BLOCK_VOLUME = 3,
527 LAYOUT_FLEX_FILES = 4,
531 /* used for both layout return and recall */
532 enum pnfs_layoutreturn_type {
544 enum pnfs_notify_deviceid_type4 {
545 NOTIFY_DEVICEID4_CHANGE = 1 << 1,
546 NOTIFY_DEVICEID4_DELETE = 1 << 2,
549 #define NFL4_UFLG_MASK 0x0000003F
550 #define NFL4_UFLG_DENSE 0x00000001
551 #define NFL4_UFLG_COMMIT_THRU_MDS 0x00000002
552 #define NFL4_UFLG_STRIPE_UNIT_SIZE_MASK 0xFFFFFFC0
554 /* Encoded in the loh_body field of type layouthint4 */
555 enum filelayout_hint_care4 {
556 NFLH4_CARE_DENSE = NFL4_UFLG_DENSE,
557 NFLH4_CARE_COMMIT_THRU_MDS = NFL4_UFLG_COMMIT_THRU_MDS,
558 NFLH4_CARE_STRIPE_UNIT_SIZE = 0x00000040,
559 NFLH4_CARE_STRIPE_COUNT = 0x00000080
562 #define NFS4_DEVICEID4_SIZE 16
564 struct nfs4_deviceid {
565 char data[NFS4_DEVICEID4_SIZE];
569 NFS4_CONTENT_DATA = 0,
570 NFS4_CONTENT_HOLE = 1,