xref: /openbmc/linux/fs/nfs/nfs4_fs.h (revision 9659281c)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * linux/fs/nfs/nfs4_fs.h
4  *
5  * Copyright (C) 2005 Trond Myklebust
6  *
7  * NFSv4-specific filesystem definitions and declarations
8  */
9 
10 #ifndef __LINUX_FS_NFS_NFS4_FS_H
11 #define __LINUX_FS_NFS_NFS4_FS_H
12 
13 #if defined(CONFIG_NFS_V4_2)
14 #define NFS4_MAX_MINOR_VERSION 2
15 #elif defined(CONFIG_NFS_V4_1)
16 #define NFS4_MAX_MINOR_VERSION 1
17 #else
18 #define NFS4_MAX_MINOR_VERSION 0
19 #endif
20 
21 #if IS_ENABLED(CONFIG_NFS_V4)
22 
23 #define NFS4_MAX_LOOP_ON_RECOVER (10)
24 
25 #include <linux/seqlock.h>
26 
27 struct idmap;
28 
29 enum nfs4_client_state {
30 	NFS4CLNT_MANAGER_RUNNING  = 0,
31 	NFS4CLNT_CHECK_LEASE,
32 	NFS4CLNT_LEASE_EXPIRED,
33 	NFS4CLNT_RECLAIM_REBOOT,
34 	NFS4CLNT_RECLAIM_NOGRACE,
35 	NFS4CLNT_DELEGRETURN,
36 	NFS4CLNT_SESSION_RESET,
37 	NFS4CLNT_LEASE_CONFIRM,
38 	NFS4CLNT_SERVER_SCOPE_MISMATCH,
39 	NFS4CLNT_PURGE_STATE,
40 	NFS4CLNT_BIND_CONN_TO_SESSION,
41 	NFS4CLNT_MOVED,
42 	NFS4CLNT_LEASE_MOVED,
43 	NFS4CLNT_DELEGATION_EXPIRED,
44 	NFS4CLNT_RUN_MANAGER,
45 	NFS4CLNT_RECALL_RUNNING,
46 	NFS4CLNT_RECALL_ANY_LAYOUT_READ,
47 	NFS4CLNT_RECALL_ANY_LAYOUT_RW,
48 	NFS4CLNT_DELEGRETURN_DELAYED,
49 };
50 
51 #define NFS4_RENEW_TIMEOUT		0x01
52 #define NFS4_RENEW_DELEGATION_CB	0x02
53 
54 struct nfs_seqid_counter;
55 struct nfs4_minor_version_ops {
56 	u32	minor_version;
57 	unsigned init_caps;
58 
59 	int	(*init_client)(struct nfs_client *);
60 	void	(*shutdown_client)(struct nfs_client *);
61 	bool	(*match_stateid)(const nfs4_stateid *,
62 			const nfs4_stateid *);
63 	int	(*find_root_sec)(struct nfs_server *, struct nfs_fh *,
64 			struct nfs_fsinfo *);
65 	void	(*free_lock_state)(struct nfs_server *,
66 			struct nfs4_lock_state *);
67 	int	(*test_and_free_expired)(struct nfs_server *,
68 			nfs4_stateid *, const struct cred *);
69 	struct nfs_seqid *
70 		(*alloc_seqid)(struct nfs_seqid_counter *, gfp_t);
71 	void	(*session_trunk)(struct rpc_clnt *clnt,
72 			struct rpc_xprt *xprt, void *data);
73 	const struct rpc_call_ops *call_sync_ops;
74 	const struct nfs4_state_recovery_ops *reboot_recovery_ops;
75 	const struct nfs4_state_recovery_ops *nograce_recovery_ops;
76 	const struct nfs4_state_maintenance_ops *state_renewal_ops;
77 	const struct nfs4_mig_recovery_ops *mig_recovery_ops;
78 };
79 
80 #define NFS_SEQID_CONFIRMED 1
81 struct nfs_seqid_counter {
82 	ktime_t create_time;
83 	int owner_id;
84 	int flags;
85 	u32 counter;
86 	spinlock_t lock;		/* Protects the list */
87 	struct list_head list;		/* Defines sequence of RPC calls */
88 	struct rpc_wait_queue	wait;	/* RPC call delay queue */
89 };
90 
91 struct nfs_seqid {
92 	struct nfs_seqid_counter *sequence;
93 	struct list_head list;
94 	struct rpc_task *task;
95 };
96 
97 static inline void nfs_confirm_seqid(struct nfs_seqid_counter *seqid, int status)
98 {
99 	if (seqid_mutating_err(-status))
100 		seqid->flags |= NFS_SEQID_CONFIRMED;
101 }
102 
103 /*
104  * NFS4 state_owners and lock_owners are simply labels for ordered
105  * sequences of RPC calls. Their sole purpose is to provide once-only
106  * semantics by allowing the server to identify replayed requests.
107  */
108 struct nfs4_state_owner {
109 	struct nfs_server    *so_server;
110 	struct list_head     so_lru;
111 	unsigned long        so_expires;
112 	struct rb_node	     so_server_node;
113 
114 	const struct cred    *so_cred;	 /* Associated cred */
115 
116 	spinlock_t	     so_lock;
117 	atomic_t	     so_count;
118 	unsigned long	     so_flags;
119 	struct list_head     so_states;
120 	struct nfs_seqid_counter so_seqid;
121 	seqcount_spinlock_t  so_reclaim_seqcount;
122 	struct mutex	     so_delegreturn_mutex;
123 };
124 
125 enum {
126 	NFS_OWNER_RECLAIM_REBOOT,
127 	NFS_OWNER_RECLAIM_NOGRACE
128 };
129 
130 #define NFS_LOCK_NEW		0
131 #define NFS_LOCK_RECLAIM	1
132 #define NFS_LOCK_EXPIRED	2
133 
134 /*
135  * struct nfs4_state maintains the client-side state for a given
136  * (state_owner,inode) tuple (OPEN) or state_owner (LOCK).
137  *
138  * OPEN:
139  * In order to know when to OPEN_DOWNGRADE or CLOSE the state on the server,
140  * we need to know how many files are open for reading or writing on a
141  * given inode. This information too is stored here.
142  *
143  * LOCK: one nfs4_state (LOCK) to hold the lock stateid nfs4_state(OPEN)
144  */
145 
146 struct nfs4_lock_state {
147 	struct list_head	ls_locks;	/* Other lock stateids */
148 	struct nfs4_state *	ls_state;	/* Pointer to open state */
149 #define NFS_LOCK_INITIALIZED 0
150 #define NFS_LOCK_LOST        1
151 	unsigned long		ls_flags;
152 	struct nfs_seqid_counter	ls_seqid;
153 	nfs4_stateid		ls_stateid;
154 	refcount_t		ls_count;
155 	fl_owner_t		ls_owner;
156 };
157 
158 /* bits for nfs4_state->flags */
159 enum {
160 	LK_STATE_IN_USE,
161 	NFS_DELEGATED_STATE,		/* Current stateid is delegation */
162 	NFS_OPEN_STATE,			/* OPEN stateid is set */
163 	NFS_O_RDONLY_STATE,		/* OPEN stateid has read-only state */
164 	NFS_O_WRONLY_STATE,		/* OPEN stateid has write-only state */
165 	NFS_O_RDWR_STATE,		/* OPEN stateid has read/write state */
166 	NFS_STATE_RECLAIM_REBOOT,	/* OPEN stateid server rebooted */
167 	NFS_STATE_RECLAIM_NOGRACE,	/* OPEN stateid needs to recover state */
168 	NFS_STATE_POSIX_LOCKS,		/* Posix locks are supported */
169 	NFS_STATE_RECOVERY_FAILED,	/* OPEN stateid state recovery failed */
170 	NFS_STATE_MAY_NOTIFY_LOCK,	/* server may CB_NOTIFY_LOCK */
171 	NFS_STATE_CHANGE_WAIT,		/* A state changing operation is outstanding */
172 	NFS_CLNT_DST_SSC_COPY_STATE,    /* dst server open state on client*/
173 	NFS_CLNT_SRC_SSC_COPY_STATE,    /* src server open state on client*/
174 	NFS_SRV_SSC_COPY_STATE,		/* ssc state on the dst server */
175 };
176 
177 struct nfs4_state {
178 	struct list_head open_states;	/* List of states for the same state_owner */
179 	struct list_head inode_states;	/* List of states for the same inode */
180 	struct list_head lock_states;	/* List of subservient lock stateids */
181 
182 	struct nfs4_state_owner *owner;	/* Pointer to the open owner */
183 	struct inode *inode;		/* Pointer to the inode */
184 
185 	unsigned long flags;		/* Do we hold any locks? */
186 	spinlock_t state_lock;		/* Protects the lock_states list */
187 
188 	seqlock_t seqlock;		/* Protects the stateid/open_stateid */
189 	nfs4_stateid stateid;		/* Current stateid: may be delegation */
190 	nfs4_stateid open_stateid;	/* OPEN stateid */
191 
192 	/* The following 3 fields are protected by owner->so_lock */
193 	unsigned int n_rdonly;		/* Number of read-only references */
194 	unsigned int n_wronly;		/* Number of write-only references */
195 	unsigned int n_rdwr;		/* Number of read/write references */
196 	fmode_t state;			/* State on the server (R,W, or RW) */
197 	refcount_t count;
198 
199 	wait_queue_head_t waitq;
200 	struct rcu_head rcu_head;
201 };
202 
203 
204 struct nfs4_exception {
205 	struct nfs4_state *state;
206 	struct inode *inode;
207 	nfs4_stateid *stateid;
208 	long timeout;
209 	unsigned char task_is_privileged : 1;
210 	unsigned char delay : 1,
211 		      recovering : 1,
212 		      retry : 1;
213 	bool interruptible;
214 };
215 
216 struct nfs4_state_recovery_ops {
217 	int owner_flag_bit;
218 	int state_flag_bit;
219 	int (*recover_open)(struct nfs4_state_owner *, struct nfs4_state *);
220 	int (*recover_lock)(struct nfs4_state *, struct file_lock *);
221 	int (*establish_clid)(struct nfs_client *, const struct cred *);
222 	int (*reclaim_complete)(struct nfs_client *, const struct cred *);
223 	int (*detect_trunking)(struct nfs_client *, struct nfs_client **,
224 		const struct cred *);
225 };
226 
227 struct nfs4_opendata {
228 	struct kref kref;
229 	struct nfs_openargs o_arg;
230 	struct nfs_openres o_res;
231 	struct nfs_open_confirmargs c_arg;
232 	struct nfs_open_confirmres c_res;
233 	struct nfs4_string owner_name;
234 	struct nfs4_string group_name;
235 	struct nfs4_label *a_label;
236 	struct nfs_fattr f_attr;
237 	struct nfs4_label *f_label;
238 	struct dentry *dir;
239 	struct dentry *dentry;
240 	struct nfs4_state_owner *owner;
241 	struct nfs4_state *state;
242 	struct iattr attrs;
243 	struct nfs4_layoutget *lgp;
244 	unsigned long timestamp;
245 	bool rpc_done;
246 	bool file_created;
247 	bool is_recover;
248 	bool cancelled;
249 	int rpc_status;
250 };
251 
252 struct nfs4_add_xprt_data {
253 	struct nfs_client	*clp;
254 	const struct cred	*cred;
255 };
256 
257 struct nfs4_state_maintenance_ops {
258 	int (*sched_state_renewal)(struct nfs_client *, const struct cred *, unsigned);
259 	const struct cred * (*get_state_renewal_cred)(struct nfs_client *);
260 	int (*renew_lease)(struct nfs_client *, const struct cred *);
261 };
262 
263 struct nfs4_mig_recovery_ops {
264 	int (*get_locations)(struct inode *, struct nfs4_fs_locations *,
265 		struct page *, const struct cred *);
266 	int (*fsid_present)(struct inode *, const struct cred *);
267 };
268 
269 extern const struct dentry_operations nfs4_dentry_operations;
270 
271 /* dir.c */
272 int nfs_atomic_open(struct inode *, struct dentry *, struct file *,
273 		    unsigned, umode_t);
274 
275 /* fs_context.c */
276 extern struct file_system_type nfs4_fs_type;
277 
278 /* nfs4namespace.c */
279 struct rpc_clnt *nfs4_negotiate_security(struct rpc_clnt *, struct inode *,
280 					 const struct qstr *);
281 int nfs4_submount(struct fs_context *, struct nfs_server *);
282 int nfs4_replace_transport(struct nfs_server *server,
283 				const struct nfs4_fs_locations *locations);
284 
285 /* nfs4proc.c */
286 extern int nfs4_handle_exception(struct nfs_server *, int, struct nfs4_exception *);
287 extern int nfs4_async_handle_error(struct rpc_task *task,
288 				   struct nfs_server *server,
289 				   struct nfs4_state *state, long *timeout);
290 extern int nfs4_call_sync(struct rpc_clnt *, struct nfs_server *,
291 			  struct rpc_message *, struct nfs4_sequence_args *,
292 			  struct nfs4_sequence_res *, int);
293 extern void nfs4_init_sequence(struct nfs4_sequence_args *, struct nfs4_sequence_res *, int, int);
294 extern int nfs4_proc_setclientid(struct nfs_client *, u32, unsigned short, const struct cred *, struct nfs4_setclientid_res *);
295 extern int nfs4_proc_setclientid_confirm(struct nfs_client *, struct nfs4_setclientid_res *arg, const struct cred *);
296 extern int nfs4_proc_get_rootfh(struct nfs_server *, struct nfs_fh *, struct nfs_fsinfo *, bool);
297 extern int nfs4_proc_bind_conn_to_session(struct nfs_client *, const struct cred *cred);
298 extern int nfs4_proc_exchange_id(struct nfs_client *clp, const struct cred *cred);
299 extern int nfs4_destroy_clientid(struct nfs_client *clp);
300 extern int nfs4_init_clientid(struct nfs_client *, const struct cred *);
301 extern int nfs41_init_clientid(struct nfs_client *, const struct cred *);
302 extern int nfs4_do_close(struct nfs4_state *state, gfp_t gfp_mask, int wait);
303 extern int nfs4_server_capabilities(struct nfs_server *server, struct nfs_fh *fhandle);
304 extern int nfs4_proc_fs_locations(struct rpc_clnt *, struct inode *, const struct qstr *,
305 				  struct nfs4_fs_locations *, struct page *);
306 extern int nfs4_proc_get_locations(struct inode *, struct nfs4_fs_locations *,
307 		struct page *page, const struct cred *);
308 extern int nfs4_proc_fsid_present(struct inode *, const struct cred *);
309 extern struct rpc_clnt *nfs4_proc_lookup_mountpoint(struct inode *,
310 						    struct dentry *,
311 						    struct nfs_fh *,
312 						    struct nfs_fattr *);
313 extern int nfs4_proc_secinfo(struct inode *, const struct qstr *, struct nfs4_secinfo_flavors *);
314 extern const struct xattr_handler *nfs4_xattr_handlers[];
315 extern int nfs4_set_rw_stateid(nfs4_stateid *stateid,
316 		const struct nfs_open_context *ctx,
317 		const struct nfs_lock_context *l_ctx,
318 		fmode_t fmode);
319 extern int nfs4_proc_getattr(struct nfs_server *server, struct nfs_fh *fhandle,
320 			     struct nfs_fattr *fattr, struct nfs4_label *label,
321 			     struct inode *inode);
322 extern int update_open_stateid(struct nfs4_state *state,
323 				const nfs4_stateid *open_stateid,
324 				const nfs4_stateid *deleg_stateid,
325 				fmode_t fmode);
326 extern int nfs4_proc_setlease(struct file *file, long arg,
327 			      struct file_lock **lease, void **priv);
328 extern int nfs4_proc_get_lease_time(struct nfs_client *clp,
329 		struct nfs_fsinfo *fsinfo);
330 extern void nfs4_update_changeattr(struct inode *dir,
331 				   struct nfs4_change_info *cinfo,
332 				   unsigned long timestamp,
333 				   unsigned long cache_validity);
334 extern int nfs4_buf_to_pages_noslab(const void *buf, size_t buflen,
335 				    struct page **pages);
336 
337 #if defined(CONFIG_NFS_V4_1)
338 extern int nfs41_sequence_done(struct rpc_task *, struct nfs4_sequence_res *);
339 extern int nfs4_proc_create_session(struct nfs_client *, const struct cred *);
340 extern int nfs4_proc_destroy_session(struct nfs4_session *, const struct cred *);
341 extern int nfs4_proc_layoutcommit(struct nfs4_layoutcommit_data *data,
342 				  bool sync);
343 extern int nfs4_detect_session_trunking(struct nfs_client *clp,
344 		struct nfs41_exchange_id_res *res, struct rpc_xprt *xprt);
345 
346 static inline bool
347 is_ds_only_client(struct nfs_client *clp)
348 {
349 	return (clp->cl_exchange_flags & EXCHGID4_FLAG_MASK_PNFS) ==
350 		EXCHGID4_FLAG_USE_PNFS_DS;
351 }
352 
353 static inline bool
354 is_ds_client(struct nfs_client *clp)
355 {
356 	return clp->cl_exchange_flags & EXCHGID4_FLAG_USE_PNFS_DS;
357 }
358 
359 static inline bool
360 _nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_mode,
361 		    struct rpc_clnt **clntp, struct rpc_message *msg)
362 {
363 	rpc_authflavor_t flavor;
364 
365 	if (sp4_mode == NFS_SP4_MACH_CRED_CLEANUP ||
366 	    sp4_mode == NFS_SP4_MACH_CRED_PNFS_CLEANUP) {
367 		/* Using machine creds for cleanup operations
368 		 * is only relevent if the client credentials
369 		 * might expire. So don't bother for
370 		 * RPC_AUTH_UNIX.  If file was only exported to
371 		 * sec=sys, the PUTFH would fail anyway.
372 		 */
373 		if ((*clntp)->cl_auth->au_flavor == RPC_AUTH_UNIX)
374 			return false;
375 	}
376 	if (test_bit(sp4_mode, &clp->cl_sp4_flags)) {
377 		msg->rpc_cred = rpc_machine_cred();
378 
379 		flavor = clp->cl_rpcclient->cl_auth->au_flavor;
380 		WARN_ON_ONCE(flavor != RPC_AUTH_GSS_KRB5I &&
381 			     flavor != RPC_AUTH_GSS_KRB5P);
382 		*clntp = clp->cl_rpcclient;
383 
384 		return true;
385 	}
386 	return false;
387 }
388 
389 /*
390  * Function responsible for determining if an rpc_message should use the
391  * machine cred under SP4_MACH_CRED and if so switching the credential and
392  * authflavor (using the nfs_client's rpc_clnt which will be krb5i/p).
393  * Should be called before rpc_call_sync/rpc_call_async.
394  */
395 static inline void
396 nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_mode,
397 		   struct rpc_clnt **clntp, struct rpc_message *msg)
398 {
399 	_nfs4_state_protect(clp, sp4_mode, clntp, msg);
400 }
401 
402 /*
403  * Special wrapper to nfs4_state_protect for write.
404  * If WRITE can use machine cred but COMMIT cannot, make sure all writes
405  * that use machine cred use NFS_FILE_SYNC.
406  */
407 static inline void
408 nfs4_state_protect_write(struct nfs_client *clp, struct rpc_clnt **clntp,
409 			 struct rpc_message *msg, struct nfs_pgio_header *hdr)
410 {
411 	if (_nfs4_state_protect(clp, NFS_SP4_MACH_CRED_WRITE, clntp, msg) &&
412 	    !test_bit(NFS_SP4_MACH_CRED_COMMIT, &clp->cl_sp4_flags))
413 		hdr->args.stable = NFS_FILE_SYNC;
414 }
415 #else /* CONFIG_NFS_v4_1 */
416 static inline bool
417 is_ds_only_client(struct nfs_client *clp)
418 {
419 	return false;
420 }
421 
422 static inline bool
423 is_ds_client(struct nfs_client *clp)
424 {
425 	return false;
426 }
427 
428 static inline void
429 nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_flags,
430 		   struct rpc_clnt **clntp, struct rpc_message *msg)
431 {
432 }
433 
434 static inline void
435 nfs4_state_protect_write(struct nfs_client *clp, struct rpc_clnt **clntp,
436 			 struct rpc_message *msg, struct nfs_pgio_header *hdr)
437 {
438 }
439 #endif /* CONFIG_NFS_V4_1 */
440 
441 extern const struct nfs4_minor_version_ops *nfs_v4_minor_ops[];
442 
443 extern const u32 nfs4_fattr_bitmap[3];
444 extern const u32 nfs4_statfs_bitmap[3];
445 extern const u32 nfs4_pathconf_bitmap[3];
446 extern const u32 nfs4_fsinfo_bitmap[3];
447 extern const u32 nfs4_fs_locations_bitmap[3];
448 
449 void nfs40_shutdown_client(struct nfs_client *);
450 void nfs41_shutdown_client(struct nfs_client *);
451 int nfs40_init_client(struct nfs_client *);
452 int nfs41_init_client(struct nfs_client *);
453 void nfs4_free_client(struct nfs_client *);
454 
455 struct nfs_client *nfs4_alloc_client(const struct nfs_client_initdata *);
456 
457 /* nfs4renewd.c */
458 extern void nfs4_schedule_state_renewal(struct nfs_client *);
459 extern void nfs4_renewd_prepare_shutdown(struct nfs_server *);
460 extern void nfs4_kill_renewd(struct nfs_client *);
461 extern void nfs4_renew_state(struct work_struct *);
462 extern void nfs4_set_lease_period(struct nfs_client *clp, unsigned long lease);
463 
464 
465 /* nfs4state.c */
466 extern const nfs4_stateid current_stateid;
467 
468 const struct cred *nfs4_get_clid_cred(struct nfs_client *clp);
469 const struct cred *nfs4_get_machine_cred(struct nfs_client *clp);
470 const struct cred *nfs4_get_renew_cred(struct nfs_client *clp);
471 int nfs4_discover_server_trunking(struct nfs_client *clp,
472 			struct nfs_client **);
473 int nfs40_discover_server_trunking(struct nfs_client *clp,
474 			struct nfs_client **, const struct cred *);
475 #if defined(CONFIG_NFS_V4_1)
476 int nfs41_discover_server_trunking(struct nfs_client *clp,
477 			struct nfs_client **, const struct cred *);
478 extern void nfs4_schedule_session_recovery(struct nfs4_session *, int);
479 extern void nfs41_notify_server(struct nfs_client *);
480 bool nfs4_check_serverowner_major_id(struct nfs41_server_owner *o1,
481 			struct nfs41_server_owner *o2);
482 #else
483 static inline void nfs4_schedule_session_recovery(struct nfs4_session *session, int err)
484 {
485 }
486 #endif /* CONFIG_NFS_V4_1 */
487 
488 extern struct nfs4_state_owner *nfs4_get_state_owner(struct nfs_server *, const struct cred *, gfp_t);
489 extern void nfs4_put_state_owner(struct nfs4_state_owner *);
490 extern void nfs4_purge_state_owners(struct nfs_server *, struct list_head *);
491 extern void nfs4_free_state_owners(struct list_head *head);
492 extern struct nfs4_state * nfs4_get_open_state(struct inode *, struct nfs4_state_owner *);
493 extern void nfs4_put_open_state(struct nfs4_state *);
494 extern void nfs4_close_state(struct nfs4_state *, fmode_t);
495 extern void nfs4_close_sync(struct nfs4_state *, fmode_t);
496 extern void nfs4_state_set_mode_locked(struct nfs4_state *, fmode_t);
497 extern void nfs_inode_find_state_and_recover(struct inode *inode,
498 		const nfs4_stateid *stateid);
499 extern int nfs4_state_mark_reclaim_nograce(struct nfs_client *, struct nfs4_state *);
500 extern void nfs4_schedule_lease_recovery(struct nfs_client *);
501 extern int nfs4_wait_clnt_recover(struct nfs_client *clp);
502 extern int nfs4_client_recover_expired_lease(struct nfs_client *clp);
503 extern void nfs4_schedule_state_manager(struct nfs_client *);
504 extern void nfs4_schedule_path_down_recovery(struct nfs_client *clp);
505 extern int nfs4_schedule_stateid_recovery(const struct nfs_server *, struct nfs4_state *);
506 extern int nfs4_schedule_migration_recovery(const struct nfs_server *);
507 extern void nfs4_schedule_lease_moved_recovery(struct nfs_client *);
508 extern void nfs41_handle_sequence_flag_errors(struct nfs_client *clp, u32 flags, bool);
509 extern void nfs41_handle_server_scope(struct nfs_client *,
510 				      struct nfs41_server_scope **);
511 extern void nfs4_put_lock_state(struct nfs4_lock_state *lsp);
512 extern int nfs4_set_lock_state(struct nfs4_state *state, struct file_lock *fl);
513 extern int nfs4_select_rw_stateid(struct nfs4_state *, fmode_t,
514 		const struct nfs_lock_context *, nfs4_stateid *,
515 		const struct cred **);
516 extern bool nfs4_copy_open_stateid(nfs4_stateid *dst,
517 		struct nfs4_state *state);
518 
519 extern struct nfs_seqid *nfs_alloc_seqid(struct nfs_seqid_counter *counter, gfp_t gfp_mask);
520 extern int nfs_wait_on_sequence(struct nfs_seqid *seqid, struct rpc_task *task);
521 extern void nfs_increment_open_seqid(int status, struct nfs_seqid *seqid);
522 extern void nfs_increment_lock_seqid(int status, struct nfs_seqid *seqid);
523 extern void nfs_release_seqid(struct nfs_seqid *seqid);
524 extern void nfs_free_seqid(struct nfs_seqid *seqid);
525 extern int nfs4_setup_sequence(struct nfs_client *client,
526 				struct nfs4_sequence_args *args,
527 				struct nfs4_sequence_res *res,
528 				struct rpc_task *task);
529 extern int nfs4_sequence_done(struct rpc_task *task,
530 			      struct nfs4_sequence_res *res);
531 
532 extern void nfs4_free_lock_state(struct nfs_server *server, struct nfs4_lock_state *lsp);
533 extern int nfs4_proc_commit(struct file *dst, __u64 offset, __u32 count, struct nfs_commitres *res);
534 extern const nfs4_stateid zero_stateid;
535 extern const nfs4_stateid invalid_stateid;
536 
537 /* nfs4super.c */
538 struct nfs_mount_info;
539 extern struct nfs_subversion nfs_v4;
540 extern bool nfs4_disable_idmapping;
541 extern unsigned short max_session_slots;
542 extern unsigned short max_session_cb_slots;
543 extern unsigned short send_implementation_id;
544 extern bool recover_lost_locks;
545 
546 #define NFS4_CLIENT_ID_UNIQ_LEN		(64)
547 extern char nfs4_client_id_uniquifier[NFS4_CLIENT_ID_UNIQ_LEN];
548 
549 extern int nfs4_try_get_tree(struct fs_context *);
550 extern int nfs4_get_referral_tree(struct fs_context *);
551 
552 /* nfs4sysctl.c */
553 #ifdef CONFIG_SYSCTL
554 int nfs4_register_sysctl(void);
555 void nfs4_unregister_sysctl(void);
556 #else
557 static inline int nfs4_register_sysctl(void)
558 {
559 	return 0;
560 }
561 
562 static inline void nfs4_unregister_sysctl(void)
563 {
564 }
565 #endif
566 
567 /* nfs4xdr.c */
568 extern const struct rpc_procinfo nfs4_procedures[];
569 
570 #ifdef CONFIG_NFS_V4_2
571 extern const u32 nfs42_maxsetxattr_overhead;
572 extern const u32 nfs42_maxgetxattr_overhead;
573 extern const u32 nfs42_maxlistxattrs_overhead;
574 #endif
575 
576 struct nfs4_mount_data;
577 
578 /* callback_xdr.c */
579 extern const struct svc_version nfs4_callback_version1;
580 extern const struct svc_version nfs4_callback_version4;
581 
582 static inline void nfs4_stateid_copy(nfs4_stateid *dst, const nfs4_stateid *src)
583 {
584 	memcpy(dst->data, src->data, sizeof(dst->data));
585 	dst->type = src->type;
586 }
587 
588 static inline bool nfs4_stateid_match(const nfs4_stateid *dst, const nfs4_stateid *src)
589 {
590 	if (dst->type != src->type)
591 		return false;
592 	return memcmp(dst->data, src->data, sizeof(dst->data)) == 0;
593 }
594 
595 static inline bool nfs4_stateid_match_other(const nfs4_stateid *dst, const nfs4_stateid *src)
596 {
597 	return memcmp(dst->other, src->other, NFS4_STATEID_OTHER_SIZE) == 0;
598 }
599 
600 static inline bool nfs4_stateid_is_newer(const nfs4_stateid *s1, const nfs4_stateid *s2)
601 {
602 	return (s32)(be32_to_cpu(s1->seqid) - be32_to_cpu(s2->seqid)) > 0;
603 }
604 
605 static inline bool nfs4_stateid_is_next(const nfs4_stateid *s1, const nfs4_stateid *s2)
606 {
607 	u32 seq1 = be32_to_cpu(s1->seqid);
608 	u32 seq2 = be32_to_cpu(s2->seqid);
609 
610 	return seq2 == seq1 + 1U || (seq2 == 1U && seq1 == 0xffffffffU);
611 }
612 
613 static inline bool nfs4_stateid_match_or_older(const nfs4_stateid *dst, const nfs4_stateid *src)
614 {
615 	return nfs4_stateid_match_other(dst, src) &&
616 		!(src->seqid && nfs4_stateid_is_newer(dst, src));
617 }
618 
619 static inline void nfs4_stateid_seqid_inc(nfs4_stateid *s1)
620 {
621 	u32 seqid = be32_to_cpu(s1->seqid);
622 
623 	if (++seqid == 0)
624 		++seqid;
625 	s1->seqid = cpu_to_be32(seqid);
626 }
627 
628 static inline bool nfs4_valid_open_stateid(const struct nfs4_state *state)
629 {
630 	return test_bit(NFS_STATE_RECOVERY_FAILED, &state->flags) == 0;
631 }
632 
633 static inline bool nfs4_state_match_open_stateid_other(const struct nfs4_state *state,
634 		const nfs4_stateid *stateid)
635 {
636 	return test_bit(NFS_OPEN_STATE, &state->flags) &&
637 		nfs4_stateid_match_other(&state->open_stateid, stateid);
638 }
639 
640 /* nfs42xattr.c */
641 #ifdef CONFIG_NFS_V4_2
642 extern int __init nfs4_xattr_cache_init(void);
643 extern void nfs4_xattr_cache_exit(void);
644 extern void nfs4_xattr_cache_add(struct inode *inode, const char *name,
645 				 const char *buf, struct page **pages,
646 				 ssize_t buflen);
647 extern void nfs4_xattr_cache_remove(struct inode *inode, const char *name);
648 extern ssize_t nfs4_xattr_cache_get(struct inode *inode, const char *name,
649 				char *buf, ssize_t buflen);
650 extern void nfs4_xattr_cache_set_list(struct inode *inode, const char *buf,
651 				      ssize_t buflen);
652 extern ssize_t nfs4_xattr_cache_list(struct inode *inode, char *buf,
653 				     ssize_t buflen);
654 extern void nfs4_xattr_cache_zap(struct inode *inode);
655 #else
656 static inline void nfs4_xattr_cache_zap(struct inode *inode)
657 {
658 }
659 #endif /* CONFIG_NFS_V4_2 */
660 
661 #else /* CONFIG_NFS_V4 */
662 
663 #define nfs4_close_state(a, b) do { } while (0)
664 #define nfs4_close_sync(a, b) do { } while (0)
665 #define nfs4_state_protect(a, b, c, d) do { } while (0)
666 #define nfs4_state_protect_write(a, b, c, d) do { } while (0)
667 
668 
669 #endif /* CONFIG_NFS_V4 */
670 #endif /* __LINUX_FS_NFS_NFS4_FS.H */
671