xref: /linux/include/linux/nfs4.h (revision 5394eea106517d5b0d4a372f00e63d5db8cb0370)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  *  include/linux/nfs4.h
4  *
5  *  NFSv4 protocol definitions.
6  *
7  *  Copyright (c) 2002 The Regents of the University of Michigan.
8  *  All rights reserved.
9  *
10  *  Kendrick Smith <kmsmith@umich.edu>
11  *  Andy Adamson   <andros@umich.edu>
12  */
13 #ifndef _LINUX_NFS4_H
14 #define _LINUX_NFS4_H
15 
16 #include <linux/list.h>
17 #include <linux/uidgid.h>
18 #include <uapi/linux/nfs4.h>
19 #include <linux/sunrpc/msg_prot.h>
20 #include <linux/sunrpc/xdrgen/nfs4_1.h>
21 
22 enum nfs4_acl_whotype {
23 	NFS4_ACL_WHO_NAMED = 0,
24 	NFS4_ACL_WHO_OWNER,
25 	NFS4_ACL_WHO_GROUP,
26 	NFS4_ACL_WHO_EVERYONE,
27 };
28 
29 struct nfs4_ace {
30 	uint32_t	type;
31 	uint32_t	flag;
32 	uint32_t	access_mask;
33 	int		whotype;
34 	union {
35 		kuid_t	who_uid;
36 		kgid_t	who_gid;
37 	};
38 };
39 
40 struct nfs4_acl {
41 	uint32_t	naces;
42 	struct nfs4_ace	aces[];
43 };
44 
45 #define NFS4_MAXLABELLEN	2048
46 
47 struct nfs4_label {
48 	uint32_t	lfs;
49 	uint32_t	pi;
50 	u32		lsmid;
51 	u32		len;
52 	char	*label;
53 };
54 
55 typedef struct { char data[NFS4_VERIFIER_SIZE]; } nfs4_verifier;
56 
57 struct nfs4_stateid_struct {
58 	union {
59 		char data[NFS4_STATEID_SIZE];
60 		struct {
61 			__be32 seqid;
62 			char other[NFS4_STATEID_OTHER_SIZE];
63 		} __attribute__ ((packed));
64 	};
65 
66 	enum {
67 		NFS4_INVALID_STATEID_TYPE = 0,
68 		NFS4_SPECIAL_STATEID_TYPE,
69 		NFS4_OPEN_STATEID_TYPE,
70 		NFS4_LOCK_STATEID_TYPE,
71 		NFS4_DELEGATION_STATEID_TYPE,
72 		NFS4_LAYOUT_STATEID_TYPE,
73 		NFS4_PNFS_DS_STATEID_TYPE,
74 		NFS4_REVOKED_STATEID_TYPE,
75 	} type;
76 };
77 
78 typedef struct nfs4_stateid_struct nfs4_stateid;
79 
80 enum nfs_opnum4 {
81 	OP_ACCESS = 3,
82 	OP_CLOSE = 4,
83 	OP_COMMIT = 5,
84 	OP_CREATE = 6,
85 	OP_DELEGPURGE = 7,
86 	OP_DELEGRETURN = 8,
87 	OP_GETATTR = 9,
88 	OP_GETFH = 10,
89 	OP_LINK = 11,
90 	OP_LOCK = 12,
91 	OP_LOCKT = 13,
92 	OP_LOCKU = 14,
93 	OP_LOOKUP = 15,
94 	OP_LOOKUPP = 16,
95 	OP_NVERIFY = 17,
96 	OP_OPEN = 18,
97 	OP_OPENATTR = 19,
98 	OP_OPEN_CONFIRM = 20,
99 	OP_OPEN_DOWNGRADE = 21,
100 	OP_PUTFH = 22,
101 	OP_PUTPUBFH = 23,
102 	OP_PUTROOTFH = 24,
103 	OP_READ = 25,
104 	OP_READDIR = 26,
105 	OP_READLINK = 27,
106 	OP_REMOVE = 28,
107 	OP_RENAME = 29,
108 	OP_RENEW = 30,
109 	OP_RESTOREFH = 31,
110 	OP_SAVEFH = 32,
111 	OP_SECINFO = 33,
112 	OP_SETATTR = 34,
113 	OP_SETCLIENTID = 35,
114 	OP_SETCLIENTID_CONFIRM = 36,
115 	OP_VERIFY = 37,
116 	OP_WRITE = 38,
117 	OP_RELEASE_LOCKOWNER = 39,
118 
119 	/* nfs41 */
120 	OP_BACKCHANNEL_CTL = 40,
121 	OP_BIND_CONN_TO_SESSION = 41,
122 	OP_EXCHANGE_ID = 42,
123 	OP_CREATE_SESSION = 43,
124 	OP_DESTROY_SESSION = 44,
125 	OP_FREE_STATEID = 45,
126 	OP_GET_DIR_DELEGATION = 46,
127 	OP_GETDEVICEINFO = 47,
128 	OP_GETDEVICELIST = 48,
129 	OP_LAYOUTCOMMIT = 49,
130 	OP_LAYOUTGET = 50,
131 	OP_LAYOUTRETURN = 51,
132 	OP_SECINFO_NO_NAME = 52,
133 	OP_SEQUENCE = 53,
134 	OP_SET_SSV = 54,
135 	OP_TEST_STATEID = 55,
136 	OP_WANT_DELEGATION = 56,
137 	OP_DESTROY_CLIENTID = 57,
138 	OP_RECLAIM_COMPLETE = 58,
139 
140 	/* nfs42 */
141 	OP_ALLOCATE = 59,
142 	OP_COPY = 60,
143 	OP_COPY_NOTIFY = 61,
144 	OP_DEALLOCATE = 62,
145 	OP_IO_ADVISE = 63,
146 	OP_LAYOUTERROR = 64,
147 	OP_LAYOUTSTATS = 65,
148 	OP_OFFLOAD_CANCEL = 66,
149 	OP_OFFLOAD_STATUS = 67,
150 	OP_READ_PLUS = 68,
151 	OP_SEEK = 69,
152 	OP_WRITE_SAME = 70,
153 	OP_CLONE = 71,
154 
155 	/* xattr support (RFC8276) */
156 	OP_GETXATTR                = 72,
157 	OP_SETXATTR                = 73,
158 	OP_LISTXATTRS              = 74,
159 	OP_REMOVEXATTR             = 75,
160 
161 	OP_ILLEGAL = 10044,
162 };
163 
164 /*Defining first and last NFS4 operations implemented.
165 Needs to be updated if more operations are defined in future.*/
166 
167 #define FIRST_NFS4_OP	OP_ACCESS
168 #define LAST_NFS40_OP	OP_RELEASE_LOCKOWNER
169 #define LAST_NFS41_OP	OP_RECLAIM_COMPLETE
170 #define LAST_NFS42_OP	OP_REMOVEXATTR
171 #define LAST_NFS4_OP	LAST_NFS42_OP
172 
173 enum nfsstat4 {
174 	NFS4_OK = 0,
175 	NFS4ERR_PERM = 1,
176 	NFS4ERR_NOENT = 2,
177 	NFS4ERR_IO = 5,
178 	NFS4ERR_NXIO = 6,
179 	NFS4ERR_ACCESS = 13,
180 	NFS4ERR_EXIST = 17,
181 	NFS4ERR_XDEV = 18,
182 	/* Unused/reserved 19 */
183 	NFS4ERR_NOTDIR = 20,
184 	NFS4ERR_ISDIR = 21,
185 	NFS4ERR_INVAL = 22,
186 	NFS4ERR_FBIG = 27,
187 	NFS4ERR_NOSPC = 28,
188 	NFS4ERR_ROFS = 30,
189 	NFS4ERR_MLINK = 31,
190 	NFS4ERR_NAMETOOLONG = 63,
191 	NFS4ERR_NOTEMPTY = 66,
192 	NFS4ERR_DQUOT = 69,
193 	NFS4ERR_STALE = 70,
194 	NFS4ERR_BADHANDLE = 10001,
195 	NFS4ERR_BAD_COOKIE = 10003,
196 	NFS4ERR_NOTSUPP = 10004,
197 	NFS4ERR_TOOSMALL = 10005,
198 	NFS4ERR_SERVERFAULT = 10006,
199 	NFS4ERR_BADTYPE = 10007,
200 	NFS4ERR_DELAY = 10008,
201 	NFS4ERR_SAME = 10009,
202 	NFS4ERR_DENIED = 10010,
203 	NFS4ERR_EXPIRED = 10011,
204 	NFS4ERR_LOCKED = 10012,
205 	NFS4ERR_GRACE = 10013,
206 	NFS4ERR_FHEXPIRED = 10014,
207 	NFS4ERR_SHARE_DENIED = 10015,
208 	NFS4ERR_WRONGSEC = 10016,
209 	NFS4ERR_CLID_INUSE = 10017,
210 	NFS4ERR_RESOURCE = 10018,
211 	NFS4ERR_MOVED = 10019,
212 	NFS4ERR_NOFILEHANDLE = 10020,
213 	NFS4ERR_MINOR_VERS_MISMATCH = 10021,
214 	NFS4ERR_STALE_CLIENTID = 10022,
215 	NFS4ERR_STALE_STATEID = 10023,
216 	NFS4ERR_OLD_STATEID = 10024,
217 	NFS4ERR_BAD_STATEID = 10025,
218 	NFS4ERR_BAD_SEQID = 10026,
219 	NFS4ERR_NOT_SAME = 10027,
220 	NFS4ERR_LOCK_RANGE = 10028,
221 	NFS4ERR_SYMLINK = 10029,
222 	NFS4ERR_RESTOREFH = 10030,
223 	NFS4ERR_LEASE_MOVED = 10031,
224 	NFS4ERR_ATTRNOTSUPP = 10032,
225 	NFS4ERR_NO_GRACE = 10033,
226 	NFS4ERR_RECLAIM_BAD = 10034,
227 	NFS4ERR_RECLAIM_CONFLICT = 10035,
228 	NFS4ERR_BADXDR = 10036,
229 	NFS4ERR_LOCKS_HELD = 10037,
230 	NFS4ERR_OPENMODE = 10038,
231 	NFS4ERR_BADOWNER = 10039,
232 	NFS4ERR_BADCHAR = 10040,
233 	NFS4ERR_BADNAME = 10041,
234 	NFS4ERR_BAD_RANGE = 10042,
235 	NFS4ERR_LOCK_NOTSUPP = 10043,
236 	NFS4ERR_OP_ILLEGAL = 10044,
237 	NFS4ERR_DEADLOCK = 10045,
238 	NFS4ERR_FILE_OPEN = 10046,
239 	NFS4ERR_ADMIN_REVOKED = 10047,
240 	NFS4ERR_CB_PATH_DOWN = 10048,
241 
242 	/* nfs41 */
243 	NFS4ERR_BADIOMODE	= 10049,
244 	NFS4ERR_BADLAYOUT	= 10050,
245 	NFS4ERR_BAD_SESSION_DIGEST = 10051,
246 	NFS4ERR_BADSESSION	= 10052,
247 	NFS4ERR_BADSLOT		= 10053,
248 	NFS4ERR_COMPLETE_ALREADY = 10054,
249 	NFS4ERR_CONN_NOT_BOUND_TO_SESSION = 10055,
250 	NFS4ERR_DELEG_ALREADY_WANTED = 10056,
251 	NFS4ERR_BACK_CHAN_BUSY	= 10057,	/* backchan reqs outstanding */
252 	NFS4ERR_LAYOUTTRYLATER	= 10058,
253 	NFS4ERR_LAYOUTUNAVAILABLE = 10059,
254 	NFS4ERR_NOMATCHING_LAYOUT = 10060,
255 	NFS4ERR_RECALLCONFLICT	= 10061,
256 	NFS4ERR_UNKNOWN_LAYOUTTYPE = 10062,
257 	NFS4ERR_SEQ_MISORDERED = 10063, 	/* unexpected seq.id in req */
258 	NFS4ERR_SEQUENCE_POS	= 10064,	/* [CB_]SEQ. op not 1st op */
259 	NFS4ERR_REQ_TOO_BIG	= 10065,	/* request too big */
260 	NFS4ERR_REP_TOO_BIG	= 10066,	/* reply too big */
261 	NFS4ERR_REP_TOO_BIG_TO_CACHE = 10067,	/* rep. not all cached */
262 	NFS4ERR_RETRY_UNCACHED_REP = 10068,	/* retry & rep. uncached */
263 	NFS4ERR_UNSAFE_COMPOUND = 10069,	/* retry/recovery too hard */
264 	NFS4ERR_TOO_MANY_OPS	= 10070,	/* too many ops in [CB_]COMP */
265 	NFS4ERR_OP_NOT_IN_SESSION = 10071,	/* op needs [CB_]SEQ. op */
266 	NFS4ERR_HASH_ALG_UNSUPP = 10072,	/* hash alg. not supp. */
267 						/* Error 10073 is unused. */
268 	NFS4ERR_CLIENTID_BUSY	= 10074,	/* clientid has state */
269 	NFS4ERR_PNFS_IO_HOLE	= 10075,	/* IO to _SPARSE file hole */
270 	NFS4ERR_SEQ_FALSE_RETRY	= 10076,	/* retry not original */
271 	NFS4ERR_BAD_HIGH_SLOT	= 10077,	/* sequence arg bad */
272 	NFS4ERR_DEADSESSION	= 10078,	/* persistent session dead */
273 	NFS4ERR_ENCR_ALG_UNSUPP = 10079,	/* SSV alg mismatch */
274 	NFS4ERR_PNFS_NO_LAYOUT	= 10080,	/* direct I/O with no layout */
275 	NFS4ERR_NOT_ONLY_OP	= 10081,	/* bad compound */
276 	NFS4ERR_WRONG_CRED	= 10082,	/* permissions:state change */
277 	NFS4ERR_WRONG_TYPE	= 10083,	/* current operation mismatch */
278 	NFS4ERR_DIRDELEG_UNAVAIL = 10084,	/* no directory delegation */
279 	NFS4ERR_REJECT_DELEG	= 10085,	/* on callback */
280 	NFS4ERR_RETURNCONFLICT	= 10086,	/* outstanding layoutreturn */
281 	NFS4ERR_DELEG_REVOKED	= 10087,	/* deleg./layout revoked */
282 
283 	/* nfs42 */
284 	NFS4ERR_PARTNER_NOTSUPP	= 10088,
285 	NFS4ERR_PARTNER_NO_AUTH	= 10089,
286 	NFS4ERR_UNION_NOTSUPP	= 10090,
287 	NFS4ERR_OFFLOAD_DENIED	= 10091,
288 	NFS4ERR_WRONG_LFS	= 10092,
289 	NFS4ERR_BADLABEL	= 10093,
290 	NFS4ERR_OFFLOAD_NO_REQS	= 10094,
291 
292 	/* xattr (RFC8276) */
293 	NFS4ERR_NOXATTR		= 10095,
294 	NFS4ERR_XATTR2BIG	= 10096,
295 
296 	/* can be used for internal errors */
297 	NFS4ERR_FIRST_FREE
298 };
299 
300 /* error codes for internal client use */
301 #define NFS4ERR_RESET_TO_MDS   12001
302 #define NFS4ERR_RESET_TO_PNFS  12002
303 
seqid_mutating_err(u32 err)304 static inline bool seqid_mutating_err(u32 err)
305 {
306 	/* See RFC 7530, section 9.1.7 */
307 	switch (err) {
308 	case NFS4ERR_STALE_CLIENTID:
309 	case NFS4ERR_STALE_STATEID:
310 	case NFS4ERR_BAD_STATEID:
311 	case NFS4ERR_BAD_SEQID:
312 	case NFS4ERR_BADXDR:
313 	case NFS4ERR_RESOURCE:
314 	case NFS4ERR_NOFILEHANDLE:
315 	case NFS4ERR_MOVED:
316 		return false;
317 	}
318 	return true;
319 }
320 
321 /*
322  * Note: NF4BAD is not actually part of the protocol; it is just used
323  * internally by nfsd.
324  */
325 enum nfs_ftype4 {
326 	NF4BAD		= 0,
327         NF4REG          = 1,    /* Regular File */
328         NF4DIR          = 2,    /* Directory */
329         NF4BLK          = 3,    /* Special File - block device */
330         NF4CHR          = 4,    /* Special File - character device */
331         NF4LNK          = 5,    /* Symbolic Link */
332         NF4SOCK         = 6,    /* Special File - socket */
333         NF4FIFO         = 7,    /* Special File - fifo */
334         NF4ATTRDIR      = 8,    /* Attribute Directory */
335         NF4NAMEDATTR    = 9     /* Named Attribute */
336 };
337 
338 enum open_claim_type4 {
339 	NFS4_OPEN_CLAIM_NULL = 0,
340 	NFS4_OPEN_CLAIM_PREVIOUS = 1,
341 	NFS4_OPEN_CLAIM_DELEGATE_CUR = 2,
342 	NFS4_OPEN_CLAIM_DELEGATE_PREV = 3,
343 	NFS4_OPEN_CLAIM_FH = 4, /* 4.1 */
344 	NFS4_OPEN_CLAIM_DELEG_CUR_FH = 5, /* 4.1 */
345 	NFS4_OPEN_CLAIM_DELEG_PREV_FH = 6, /* 4.1 */
346 };
347 
348 enum opentype4 {
349 	NFS4_OPEN_NOCREATE = 0,
350 	NFS4_OPEN_CREATE = 1
351 };
352 
353 enum createmode4 {
354 	NFS4_CREATE_UNCHECKED = 0,
355 	NFS4_CREATE_GUARDED = 1,
356 	NFS4_CREATE_EXCLUSIVE = 2,
357 	/*
358 	 * New to NFSv4.1. If session is persistent,
359 	 * GUARDED4 MUST be used. Otherwise, use
360 	 * EXCLUSIVE4_1 instead of EXCLUSIVE4.
361 	 */
362 	NFS4_CREATE_EXCLUSIVE4_1 = 3
363 };
364 
365 enum limit_by4 {
366 	NFS4_LIMIT_SIZE = 1,
367 	NFS4_LIMIT_BLOCKS = 2
368 };
369 
370 enum nfs4_open_delegation_type4 {
371 	NFS4_OPEN_DELEGATE_NONE = 0,
372 	NFS4_OPEN_DELEGATE_READ = 1,
373 	NFS4_OPEN_DELEGATE_WRITE = 2,
374 	NFS4_OPEN_DELEGATE_NONE_EXT = 3, /* 4.1 */
375 	NFS4_OPEN_DELEGATE_READ_ATTRS_DELEG = 4,
376 	NFS4_OPEN_DELEGATE_WRITE_ATTRS_DELEG = 5,
377 };
378 
379 enum why_no_delegation4 { /* new to v4.1 */
380 	WND4_NOT_WANTED = 0,
381 	WND4_CONTENTION = 1,
382 	WND4_RESOURCE = 2,
383 	WND4_NOT_SUPP_FTYPE = 3,
384 	WND4_WRITE_DELEG_NOT_SUPP_FTYPE = 4,
385 	WND4_NOT_SUPP_UPGRADE = 5,
386 	WND4_NOT_SUPP_DOWNGRADE = 6,
387 	WND4_CANCELLED = 7,
388 	WND4_IS_DIR = 8,
389 };
390 
391 enum lock_type4 {
392 	NFS4_UNLOCK_LT = 0,
393 	NFS4_READ_LT = 1,
394 	NFS4_WRITE_LT = 2,
395 	NFS4_READW_LT = 3,
396 	NFS4_WRITEW_LT = 4
397 };
398 
399 /*
400  * Symbol names and values are from RFC 7531 Section 2.
401  * "XDR Description of NFSv4.0"
402  */
403 enum {
404 	FATTR4_SUPPORTED_ATTRS		= 0,
405 	FATTR4_TYPE			= 1,
406 	FATTR4_FH_EXPIRE_TYPE		= 2,
407 	FATTR4_CHANGE			= 3,
408 	FATTR4_SIZE			= 4,
409 	FATTR4_LINK_SUPPORT		= 5,
410 	FATTR4_SYMLINK_SUPPORT		= 6,
411 	FATTR4_NAMED_ATTR		= 7,
412 	FATTR4_FSID			= 8,
413 	FATTR4_UNIQUE_HANDLES		= 9,
414 	FATTR4_LEASE_TIME		= 10,
415 	FATTR4_RDATTR_ERROR		= 11,
416 	FATTR4_ACL			= 12,
417 	FATTR4_ACLSUPPORT		= 13,
418 	FATTR4_ARCHIVE			= 14,
419 	FATTR4_CANSETTIME		= 15,
420 	FATTR4_CASE_INSENSITIVE		= 16,
421 	FATTR4_CASE_PRESERVING		= 17,
422 	FATTR4_CHOWN_RESTRICTED		= 18,
423 	FATTR4_FILEHANDLE		= 19,
424 	FATTR4_FILEID			= 20,
425 	FATTR4_FILES_AVAIL		= 21,
426 	FATTR4_FILES_FREE		= 22,
427 	FATTR4_FILES_TOTAL		= 23,
428 	FATTR4_FS_LOCATIONS		= 24,
429 	FATTR4_HIDDEN			= 25,
430 	FATTR4_HOMOGENEOUS		= 26,
431 	FATTR4_MAXFILESIZE		= 27,
432 	FATTR4_MAXLINK			= 28,
433 	FATTR4_MAXNAME			= 29,
434 	FATTR4_MAXREAD			= 30,
435 	FATTR4_MAXWRITE			= 31,
436 	FATTR4_MIMETYPE			= 32,
437 	FATTR4_MODE			= 33,
438 	FATTR4_NO_TRUNC			= 34,
439 	FATTR4_NUMLINKS			= 35,
440 	FATTR4_OWNER			= 36,
441 	FATTR4_OWNER_GROUP		= 37,
442 	FATTR4_QUOTA_AVAIL_HARD		= 38,
443 	FATTR4_QUOTA_AVAIL_SOFT		= 39,
444 	FATTR4_QUOTA_USED		= 40,
445 	FATTR4_RAWDEV			= 41,
446 	FATTR4_SPACE_AVAIL		= 42,
447 	FATTR4_SPACE_FREE		= 43,
448 	FATTR4_SPACE_TOTAL		= 44,
449 	FATTR4_SPACE_USED		= 45,
450 	FATTR4_SYSTEM			= 46,
451 	FATTR4_TIME_ACCESS		= 47,
452 	FATTR4_TIME_ACCESS_SET		= 48,
453 	FATTR4_TIME_BACKUP		= 49,
454 	FATTR4_TIME_CREATE		= 50,
455 	FATTR4_TIME_DELTA		= 51,
456 	FATTR4_TIME_METADATA		= 52,
457 	FATTR4_TIME_MODIFY		= 53,
458 	FATTR4_TIME_MODIFY_SET		= 54,
459 	FATTR4_MOUNTED_ON_FILEID	= 55,
460 };
461 
462 /*
463  * Symbol names and values are from RFC 5662 Section 2.
464  * "XDR Description of NFSv4.1"
465  */
466 enum {
467 	FATTR4_DIR_NOTIF_DELAY		= 56,
468 	FATTR4_DIRENT_NOTIF_DELAY	= 57,
469 	FATTR4_DACL			= 58,
470 	FATTR4_SACL			= 59,
471 	FATTR4_CHANGE_POLICY		= 60,
472 	FATTR4_FS_STATUS		= 61,
473 	FATTR4_FS_LAYOUT_TYPES		= 62,
474 	FATTR4_LAYOUT_HINT		= 63,
475 	FATTR4_LAYOUT_TYPES		= 64,
476 	FATTR4_LAYOUT_BLKSIZE		= 65,
477 	FATTR4_LAYOUT_ALIGNMENT		= 66,
478 	FATTR4_FS_LOCATIONS_INFO	= 67,
479 	FATTR4_MDSTHRESHOLD		= 68,
480 	FATTR4_RETENTION_GET		= 69,
481 	FATTR4_RETENTION_SET		= 70,
482 	FATTR4_RETENTEVT_GET		= 71,
483 	FATTR4_RETENTEVT_SET		= 72,
484 	FATTR4_RETENTION_HOLD		= 73,
485 	FATTR4_MODE_SET_MASKED		= 74,
486 	FATTR4_SUPPATTR_EXCLCREAT	= 75,
487 	FATTR4_FS_CHARSET_CAP		= 76,
488 };
489 
490 /*
491  * Symbol names and values are from RFC 7863 Section 2.
492  * "XDR Description of NFSv4.2"
493  */
494 enum {
495 	FATTR4_CLONE_BLKSIZE		= 77,
496 	FATTR4_SPACE_FREED		= 78,
497 	FATTR4_CHANGE_ATTR_TYPE		= 79,
498 	FATTR4_SEC_LABEL		= 80,
499 };
500 
501 /*
502  * Symbol names and values are from RFC 8275 Section 5.
503  * "The mode_umask Attribute"
504  */
505 enum {
506 	FATTR4_MODE_UMASK		= 81,
507 };
508 
509 /*
510  * Symbol names and values are from RFC 8276 Section 8.6.
511  * "Numeric Values Assigned to Protocol Extensions"
512  */
513 enum {
514 	FATTR4_XATTR_SUPPORT		= 82,
515 };
516 
517 /*
518  * The following internal definitions enable processing the above
519  * attribute bits within 32-bit word boundaries.
520  */
521 
522 /* Mandatory Attributes */
523 #define FATTR4_WORD0_SUPPORTED_ATTRS    BIT(FATTR4_SUPPORTED_ATTRS)
524 #define FATTR4_WORD0_TYPE               BIT(FATTR4_TYPE)
525 #define FATTR4_WORD0_FH_EXPIRE_TYPE     BIT(FATTR4_FH_EXPIRE_TYPE)
526 #define FATTR4_WORD0_CHANGE             BIT(FATTR4_CHANGE)
527 #define FATTR4_WORD0_SIZE               BIT(FATTR4_SIZE)
528 #define FATTR4_WORD0_LINK_SUPPORT       BIT(FATTR4_LINK_SUPPORT)
529 #define FATTR4_WORD0_SYMLINK_SUPPORT    BIT(FATTR4_SYMLINK_SUPPORT)
530 #define FATTR4_WORD0_NAMED_ATTR         BIT(FATTR4_NAMED_ATTR)
531 #define FATTR4_WORD0_FSID               BIT(FATTR4_FSID)
532 #define FATTR4_WORD0_UNIQUE_HANDLES     BIT(FATTR4_UNIQUE_HANDLES)
533 #define FATTR4_WORD0_LEASE_TIME         BIT(FATTR4_LEASE_TIME)
534 #define FATTR4_WORD0_RDATTR_ERROR       BIT(FATTR4_RDATTR_ERROR)
535 /* Mandatory in NFSv4.1 */
536 #define FATTR4_WORD2_SUPPATTR_EXCLCREAT BIT(FATTR4_SUPPATTR_EXCLCREAT - 64)
537 
538 /* Recommended Attributes */
539 #define FATTR4_WORD0_ACL                BIT(FATTR4_ACL)
540 #define FATTR4_WORD0_ACLSUPPORT         BIT(FATTR4_ACLSUPPORT)
541 #define FATTR4_WORD0_ARCHIVE            BIT(FATTR4_ARCHIVE)
542 #define FATTR4_WORD0_CANSETTIME         BIT(FATTR4_CANSETTIME)
543 #define FATTR4_WORD0_CASE_INSENSITIVE   BIT(FATTR4_CASE_INSENSITIVE)
544 #define FATTR4_WORD0_CASE_PRESERVING    BIT(FATTR4_CASE_PRESERVING)
545 #define FATTR4_WORD0_CHOWN_RESTRICTED   BIT(FATTR4_CHOWN_RESTRICTED)
546 #define FATTR4_WORD0_FILEHANDLE         BIT(FATTR4_FILEHANDLE)
547 #define FATTR4_WORD0_FILEID             BIT(FATTR4_FILEID)
548 #define FATTR4_WORD0_FILES_AVAIL        BIT(FATTR4_FILES_AVAIL)
549 #define FATTR4_WORD0_FILES_FREE         BIT(FATTR4_FILES_FREE)
550 #define FATTR4_WORD0_FILES_TOTAL        BIT(FATTR4_FILES_TOTAL)
551 #define FATTR4_WORD0_FS_LOCATIONS       BIT(FATTR4_FS_LOCATIONS)
552 #define FATTR4_WORD0_HIDDEN             BIT(FATTR4_HIDDEN)
553 #define FATTR4_WORD0_HOMOGENEOUS        BIT(FATTR4_HOMOGENEOUS)
554 #define FATTR4_WORD0_MAXFILESIZE        BIT(FATTR4_MAXFILESIZE)
555 #define FATTR4_WORD0_MAXLINK            BIT(FATTR4_MAXLINK)
556 #define FATTR4_WORD0_MAXNAME            BIT(FATTR4_MAXNAME)
557 #define FATTR4_WORD0_MAXREAD            BIT(FATTR4_MAXREAD)
558 #define FATTR4_WORD0_MAXWRITE           BIT(FATTR4_MAXWRITE)
559 
560 #define FATTR4_WORD1_MIMETYPE           BIT(FATTR4_MIMETYPE - 32)
561 #define FATTR4_WORD1_MODE               BIT(FATTR4_MODE	- 32)
562 #define FATTR4_WORD1_NO_TRUNC           BIT(FATTR4_NO_TRUNC - 32)
563 #define FATTR4_WORD1_NUMLINKS           BIT(FATTR4_NUMLINKS - 32)
564 #define FATTR4_WORD1_OWNER              BIT(FATTR4_OWNER - 32)
565 #define FATTR4_WORD1_OWNER_GROUP        BIT(FATTR4_OWNER_GROUP - 32)
566 #define FATTR4_WORD1_QUOTA_HARD         BIT(FATTR4_QUOTA_AVAIL_HARD - 32)
567 #define FATTR4_WORD1_QUOTA_SOFT         BIT(FATTR4_QUOTA_AVAIL_SOFT - 32)
568 #define FATTR4_WORD1_QUOTA_USED         BIT(FATTR4_QUOTA_USED - 32)
569 #define FATTR4_WORD1_RAWDEV             BIT(FATTR4_RAWDEV - 32)
570 #define FATTR4_WORD1_SPACE_AVAIL        BIT(FATTR4_SPACE_AVAIL - 32)
571 #define FATTR4_WORD1_SPACE_FREE         BIT(FATTR4_SPACE_FREE - 32)
572 #define FATTR4_WORD1_SPACE_TOTAL        BIT(FATTR4_SPACE_TOTAL - 32)
573 #define FATTR4_WORD1_SPACE_USED         BIT(FATTR4_SPACE_USED - 32)
574 #define FATTR4_WORD1_SYSTEM             BIT(FATTR4_SYSTEM - 32)
575 #define FATTR4_WORD1_TIME_ACCESS        BIT(FATTR4_TIME_ACCESS - 32)
576 #define FATTR4_WORD1_TIME_ACCESS_SET    BIT(FATTR4_TIME_ACCESS_SET - 32)
577 #define FATTR4_WORD1_TIME_BACKUP        BIT(FATTR4_TIME_BACKUP - 32)
578 #define FATTR4_WORD1_TIME_CREATE        BIT(FATTR4_TIME_CREATE - 32)
579 #define FATTR4_WORD1_TIME_DELTA         BIT(FATTR4_TIME_DELTA - 32)
580 #define FATTR4_WORD1_TIME_METADATA      BIT(FATTR4_TIME_METADATA - 32)
581 #define FATTR4_WORD1_TIME_MODIFY        BIT(FATTR4_TIME_MODIFY - 32)
582 #define FATTR4_WORD1_TIME_MODIFY_SET    BIT(FATTR4_TIME_MODIFY_SET - 32)
583 #define FATTR4_WORD1_MOUNTED_ON_FILEID  BIT(FATTR4_MOUNTED_ON_FILEID - 32)
584 #define FATTR4_WORD1_DACL               BIT(FATTR4_DACL	- 32)
585 #define FATTR4_WORD1_SACL               BIT(FATTR4_SACL	- 32)
586 #define FATTR4_WORD1_FS_LAYOUT_TYPES    BIT(FATTR4_FS_LAYOUT_TYPES - 32)
587 
588 #define FATTR4_WORD2_LAYOUT_TYPES       BIT(FATTR4_LAYOUT_TYPES - 64)
589 #define FATTR4_WORD2_LAYOUT_BLKSIZE     BIT(FATTR4_LAYOUT_BLKSIZE - 64)
590 #define FATTR4_WORD2_MDSTHRESHOLD       BIT(FATTR4_MDSTHRESHOLD	- 64)
591 #define FATTR4_WORD2_CLONE_BLKSIZE	BIT(FATTR4_CLONE_BLKSIZE - 64)
592 #define FATTR4_WORD2_CHANGE_ATTR_TYPE	BIT(FATTR4_CHANGE_ATTR_TYPE - 64)
593 #define FATTR4_WORD2_SECURITY_LABEL     BIT(FATTR4_SEC_LABEL - 64)
594 #define FATTR4_WORD2_MODE_UMASK		BIT(FATTR4_MODE_UMASK - 64)
595 #define FATTR4_WORD2_XATTR_SUPPORT	BIT(FATTR4_XATTR_SUPPORT - 64)
596 #define FATTR4_WORD2_TIME_DELEG_ACCESS	BIT(FATTR4_TIME_DELEG_ACCESS - 64)
597 #define FATTR4_WORD2_TIME_DELEG_MODIFY	BIT(FATTR4_TIME_DELEG_MODIFY - 64)
598 #define FATTR4_WORD2_OPEN_ARGUMENTS	BIT(FATTR4_OPEN_ARGUMENTS - 64)
599 
600 /* MDS threshold bitmap bits */
601 #define THRESHOLD_RD                    (1UL << 0)
602 #define THRESHOLD_WR                    (1UL << 1)
603 #define THRESHOLD_RD_IO                 (1UL << 2)
604 #define THRESHOLD_WR_IO                 (1UL << 3)
605 
606 #define NFSPROC4_NULL 0
607 #define NFSPROC4_COMPOUND 1
608 #define NFS4_VERSION 4
609 #define NFS4_MINOR_VERSION 0
610 
611 #define NFS4_DEBUG 1
612 
613 /*
614  * Index of predefined Linux client operations
615  *
616  * To ensure that /proc/net/rpc/nfs remains correctly ordered, please
617  * append only to this enum when adding new client operations.
618  */
619 
620 enum {
621 	NFSPROC4_CLNT_NULL = 0,		/* Unused */
622 	NFSPROC4_CLNT_READ,
623 	NFSPROC4_CLNT_WRITE,
624 	NFSPROC4_CLNT_COMMIT,
625 	NFSPROC4_CLNT_OPEN,
626 	NFSPROC4_CLNT_OPEN_CONFIRM,
627 	NFSPROC4_CLNT_OPEN_NOATTR,
628 	NFSPROC4_CLNT_OPEN_DOWNGRADE,
629 	NFSPROC4_CLNT_CLOSE,
630 	NFSPROC4_CLNT_SETATTR,
631 	NFSPROC4_CLNT_FSINFO,
632 	NFSPROC4_CLNT_RENEW,
633 	NFSPROC4_CLNT_SETCLIENTID,
634 	NFSPROC4_CLNT_SETCLIENTID_CONFIRM,
635 	NFSPROC4_CLNT_LOCK,
636 	NFSPROC4_CLNT_LOCKT,
637 	NFSPROC4_CLNT_LOCKU,
638 	NFSPROC4_CLNT_ACCESS,
639 	NFSPROC4_CLNT_GETATTR,
640 	NFSPROC4_CLNT_LOOKUP,
641 	NFSPROC4_CLNT_LOOKUP_ROOT,
642 	NFSPROC4_CLNT_REMOVE,
643 	NFSPROC4_CLNT_RENAME,
644 	NFSPROC4_CLNT_LINK,
645 	NFSPROC4_CLNT_SYMLINK,
646 	NFSPROC4_CLNT_CREATE,
647 	NFSPROC4_CLNT_PATHCONF,
648 	NFSPROC4_CLNT_STATFS,
649 	NFSPROC4_CLNT_READLINK,
650 	NFSPROC4_CLNT_READDIR,
651 	NFSPROC4_CLNT_SERVER_CAPS,
652 	NFSPROC4_CLNT_DELEGRETURN,
653 	NFSPROC4_CLNT_GETACL,
654 	NFSPROC4_CLNT_SETACL,
655 	NFSPROC4_CLNT_FS_LOCATIONS,
656 	NFSPROC4_CLNT_RELEASE_LOCKOWNER,
657 	NFSPROC4_CLNT_SECINFO,
658 	NFSPROC4_CLNT_FSID_PRESENT,
659 
660 	NFSPROC4_CLNT_EXCHANGE_ID,
661 	NFSPROC4_CLNT_CREATE_SESSION,
662 	NFSPROC4_CLNT_DESTROY_SESSION,
663 	NFSPROC4_CLNT_SEQUENCE,
664 	NFSPROC4_CLNT_GET_LEASE_TIME,
665 	NFSPROC4_CLNT_RECLAIM_COMPLETE,
666 	NFSPROC4_CLNT_LAYOUTGET,
667 	NFSPROC4_CLNT_GETDEVICEINFO,
668 	NFSPROC4_CLNT_LAYOUTCOMMIT,
669 	NFSPROC4_CLNT_LAYOUTRETURN,
670 	NFSPROC4_CLNT_SECINFO_NO_NAME,
671 	NFSPROC4_CLNT_TEST_STATEID,
672 	NFSPROC4_CLNT_FREE_STATEID,
673 	NFSPROC4_CLNT_GETDEVICELIST,
674 	NFSPROC4_CLNT_BIND_CONN_TO_SESSION,
675 	NFSPROC4_CLNT_DESTROY_CLIENTID,
676 
677 	NFSPROC4_CLNT_SEEK,
678 	NFSPROC4_CLNT_ALLOCATE,
679 	NFSPROC4_CLNT_DEALLOCATE,
680 	NFSPROC4_CLNT_LAYOUTSTATS,
681 	NFSPROC4_CLNT_CLONE,
682 	NFSPROC4_CLNT_COPY,
683 	NFSPROC4_CLNT_OFFLOAD_CANCEL,
684 
685 	NFSPROC4_CLNT_LOOKUPP,
686 	NFSPROC4_CLNT_LAYOUTERROR,
687 	NFSPROC4_CLNT_COPY_NOTIFY,
688 
689 	NFSPROC4_CLNT_GETXATTR,
690 	NFSPROC4_CLNT_SETXATTR,
691 	NFSPROC4_CLNT_LISTXATTRS,
692 	NFSPROC4_CLNT_REMOVEXATTR,
693 	NFSPROC4_CLNT_READ_PLUS,
694 };
695 
696 /* nfs41 types */
697 struct nfs4_sessionid {
698 	unsigned char data[NFS4_MAX_SESSIONID_LEN];
699 };
700 
701 /* Create Session Flags */
702 #define SESSION4_PERSIST	0x001
703 #define SESSION4_BACK_CHAN	0x002
704 #define SESSION4_RDMA		0x004
705 
706 #define SESSION4_FLAG_MASK_A	0x007
707 
708 enum state_protect_how4 {
709 	SP4_NONE	= 0,
710 	SP4_MACH_CRED	= 1,
711 	SP4_SSV		= 2
712 };
713 
714 /* GET_DIR_DELEGATION non-fatal status codes */
715 enum gddrnf4_status {
716 	GDD4_OK		= 0,
717 	GDD4_UNAVAIL	= 1
718 };
719 
720 enum pnfs_layouttype {
721 	LAYOUT_NFSV4_1_FILES  = 1,
722 	LAYOUT_OSD2_OBJECTS = 2,
723 	LAYOUT_BLOCK_VOLUME = 3,
724 	LAYOUT_FLEX_FILES = 4,
725 	LAYOUT_SCSI = 5,
726 	LAYOUT_TYPE_MAX
727 };
728 
729 /* used for both layout return and recall */
730 enum pnfs_layoutreturn_type {
731 	RETURN_FILE = 1,
732 	RETURN_FSID = 2,
733 	RETURN_ALL  = 3
734 };
735 
736 enum pnfs_iomode {
737 	IOMODE_READ = 1,
738 	IOMODE_RW = 2,
739 	IOMODE_ANY = 3,
740 };
741 
742 enum pnfs_notify_deviceid_type4 {
743 	NOTIFY_DEVICEID4_CHANGE = 1 << 1,
744 	NOTIFY_DEVICEID4_DELETE = 1 << 2,
745 };
746 
747 enum pnfs_block_volume_type {
748 	PNFS_BLOCK_VOLUME_SIMPLE	= 0,
749 	PNFS_BLOCK_VOLUME_SLICE		= 1,
750 	PNFS_BLOCK_VOLUME_CONCAT	= 2,
751 	PNFS_BLOCK_VOLUME_STRIPE	= 3,
752 	PNFS_BLOCK_VOLUME_SCSI		= 4,
753 };
754 
755 enum pnfs_block_extent_state {
756 	PNFS_BLOCK_READWRITE_DATA	= 0,
757 	PNFS_BLOCK_READ_DATA		= 1,
758 	PNFS_BLOCK_INVALID_DATA		= 2,
759 	PNFS_BLOCK_NONE_DATA		= 3,
760 };
761 
762 /* on the wire size of a block layout extent */
763 #define PNFS_BLOCK_EXTENT_SIZE \
764 	(7 * sizeof(__be32) + NFS4_DEVICEID4_SIZE)
765 
766 /* on the wire size of a scsi commit range */
767 #define PNFS_SCSI_RANGE_SIZE \
768 	(4 * sizeof(__be32))
769 
770 enum scsi_code_set {
771 	PS_CODE_SET_BINARY	= 1,
772 	PS_CODE_SET_ASCII	= 2,
773 	PS_CODE_SET_UTF8	= 3
774 };
775 
776 enum scsi_designator_type {
777 	PS_DESIGNATOR_T10	= 1,
778 	PS_DESIGNATOR_EUI64	= 2,
779 	PS_DESIGNATOR_NAA	= 3,
780 	PS_DESIGNATOR_NAME	= 8
781 };
782 
783 #define NFL4_UFLG_MASK			0x0000003F
784 #define NFL4_UFLG_DENSE			0x00000001
785 #define NFL4_UFLG_COMMIT_THRU_MDS	0x00000002
786 #define NFL4_UFLG_STRIPE_UNIT_SIZE_MASK	0xFFFFFFC0
787 
788 /* Encoded in the loh_body field of type layouthint4 */
789 enum filelayout_hint_care4 {
790 	NFLH4_CARE_DENSE		= NFL4_UFLG_DENSE,
791 	NFLH4_CARE_COMMIT_THRU_MDS	= NFL4_UFLG_COMMIT_THRU_MDS,
792 	NFLH4_CARE_STRIPE_UNIT_SIZE	= 0x00000040,
793 	NFLH4_CARE_STRIPE_COUNT		= 0x00000080
794 };
795 
796 #define NFS4_DEVICEID4_SIZE 16
797 
798 struct nfs4_deviceid {
799 	char data[NFS4_DEVICEID4_SIZE];
800 };
801 
802 enum data_content4 {
803 	NFS4_CONTENT_DATA		= 0,
804 	NFS4_CONTENT_HOLE		= 1,
805 };
806 
807 enum pnfs_update_layout_reason {
808 	PNFS_UPDATE_LAYOUT_UNKNOWN = 0,
809 	PNFS_UPDATE_LAYOUT_NO_PNFS,
810 	PNFS_UPDATE_LAYOUT_RD_ZEROLEN,
811 	PNFS_UPDATE_LAYOUT_MDSTHRESH,
812 	PNFS_UPDATE_LAYOUT_NOMEM,
813 	PNFS_UPDATE_LAYOUT_BULK_RECALL,
814 	PNFS_UPDATE_LAYOUT_IO_TEST_FAIL,
815 	PNFS_UPDATE_LAYOUT_FOUND_CACHED,
816 	PNFS_UPDATE_LAYOUT_RETURN,
817 	PNFS_UPDATE_LAYOUT_RETRY,
818 	PNFS_UPDATE_LAYOUT_BLOCKED,
819 	PNFS_UPDATE_LAYOUT_INVALID_OPEN,
820 	PNFS_UPDATE_LAYOUT_SEND_LAYOUTGET,
821 	PNFS_UPDATE_LAYOUT_EXIT,
822 };
823 
824 #define NFS4_OP_MAP_NUM_LONGS					\
825 	DIV_ROUND_UP(LAST_NFS4_OP, 8 * sizeof(unsigned long))
826 #define NFS4_OP_MAP_NUM_WORDS \
827 	(NFS4_OP_MAP_NUM_LONGS * sizeof(unsigned long) / sizeof(u32))
828 struct nfs4_op_map {
829 	union {
830 		unsigned long longs[NFS4_OP_MAP_NUM_LONGS];
831 		u32 words[NFS4_OP_MAP_NUM_WORDS];
832 	} u;
833 };
834 
835 struct nfs42_netaddr {
836 	char		netid[RPCBIND_MAXNETIDLEN];
837 	char		addr[RPCBIND_MAXUADDRLEN + 1];
838 	u32		netid_len;
839 	u32		addr_len;
840 };
841 
842 enum netloc_type4 {
843 	NL4_NAME		= 1,
844 	NL4_URL			= 2,
845 	NL4_NETADDR		= 3,
846 };
847 
848 struct nl4_server {
849 	enum netloc_type4	nl4_type;
850 	union {
851 		struct { /* NL4_NAME, NL4_URL */
852 			int	nl4_str_sz;
853 			char	nl4_str[NFS4_OPAQUE_LIMIT + 1];
854 		};
855 		struct nfs42_netaddr	nl4_addr; /* NL4_NETADDR */
856 	} u;
857 };
858 
859 enum nfs4_change_attr_type {
860 	NFS4_CHANGE_TYPE_IS_MONOTONIC_INCR = 0,
861 	NFS4_CHANGE_TYPE_IS_VERSION_COUNTER = 1,
862 	NFS4_CHANGE_TYPE_IS_VERSION_COUNTER_NOPNFS = 2,
863 	NFS4_CHANGE_TYPE_IS_TIME_METADATA = 3,
864 	NFS4_CHANGE_TYPE_IS_UNDEFINED = 4,
865 };
866 
867 /*
868  * Options for setxattr. These match the flags for setxattr(2).
869  */
870 enum nfs4_setxattr_options {
871 	SETXATTR4_EITHER	= 0,
872 	SETXATTR4_CREATE	= 1,
873 	SETXATTR4_REPLACE	= 2,
874 };
875 
876 enum {
877 	RCA4_TYPE_MASK_RDATA_DLG	= 0,
878 	RCA4_TYPE_MASK_WDATA_DLG	= 1,
879 	RCA4_TYPE_MASK_DIR_DLG		= 2,
880 	RCA4_TYPE_MASK_FILE_LAYOUT	= 3,
881 	RCA4_TYPE_MASK_BLK_LAYOUT	= 4,
882 	RCA4_TYPE_MASK_OBJ_LAYOUT_MIN	= 8,
883 	RCA4_TYPE_MASK_OBJ_LAYOUT_MAX	= 9,
884 	RCA4_TYPE_MASK_OTHER_LAYOUT_MIN	= 12,
885 	RCA4_TYPE_MASK_OTHER_LAYOUT_MAX	= 15,
886 };
887 
888 enum nfs_cb_opnum4 {
889 	OP_CB_GETATTR = 3,
890 	OP_CB_RECALL  = 4,
891 
892 	/* Callback operations new to NFSv4.1 */
893 	OP_CB_LAYOUTRECALL  = 5,
894 	OP_CB_NOTIFY        = 6,
895 	OP_CB_PUSH_DELEG    = 7,
896 	OP_CB_RECALL_ANY    = 8,
897 	OP_CB_RECALLABLE_OBJ_AVAIL = 9,
898 	OP_CB_RECALL_SLOT   = 10,
899 	OP_CB_SEQUENCE      = 11,
900 	OP_CB_WANTS_CANCELLED = 12,
901 	OP_CB_NOTIFY_LOCK   = 13,
902 	OP_CB_NOTIFY_DEVICEID = 14,
903 
904 	/* Callback operations new to NFSv4.2 */
905 	OP_CB_OFFLOAD = 15,
906 
907 	OP_CB_ILLEGAL = 10044,
908 };
909 
910 #endif
911