Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

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