1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef _NFS_FS_SB
3#define _NFS_FS_SB
4
5#include <linux/list.h>
6#include <linux/backing-dev.h>
7#include <linux/idr.h>
8#include <linux/wait.h>
9#include <linux/nfs_xdr.h>
10#include <linux/sunrpc/xprt.h>
11
12#include <linux/atomic.h>
13#include <linux/refcount.h>
14
15struct nfs4_session;
16struct nfs_iostats;
17struct nlm_host;
18struct nfs4_sequence_args;
19struct nfs4_sequence_res;
20struct nfs_server;
21struct nfs4_minor_version_ops;
22struct nfs41_server_scope;
23struct nfs41_impl_id;
24
25/*
26 * The nfs_client identifies our client state to the server.
27 */
28struct nfs_client {
29	refcount_t		cl_count;
30	atomic_t		cl_mds_count;
31	int			cl_cons_state;	/* current construction state (-ve: init error) */
32#define NFS_CS_READY		0		/* ready to be used */
33#define NFS_CS_INITING		1		/* busy initialising */
34#define NFS_CS_SESSION_INITING	2		/* busy initialising  session */
35	unsigned long		cl_res_state;	/* NFS resources state */
36#define NFS_CS_CALLBACK		1		/* - callback started */
37#define NFS_CS_IDMAP		2		/* - idmap started */
38#define NFS_CS_RENEWD		3		/* - renewd started */
39#define NFS_CS_STOP_RENEW	4		/* no more state to renew */
40#define NFS_CS_CHECK_LEASE_TIME	5		/* need to check lease time */
41	unsigned long		cl_flags;	/* behavior switches */
42#define NFS_CS_NORESVPORT	0		/* - use ephemeral src port */
43#define NFS_CS_DISCRTRY		1		/* - disconnect on RPC retry */
44#define NFS_CS_MIGRATION	2		/* - transparent state migr */
45#define NFS_CS_INFINITE_SLOTS	3		/* - don't limit TCP slots */
46#define NFS_CS_NO_RETRANS_TIMEOUT	4	/* - Disable retransmit timeouts */
47#define NFS_CS_TSM_POSSIBLE	5		/* - Maybe state migration */
48#define NFS_CS_NOPING		6		/* - don't ping on connect */
49#define NFS_CS_DS		7		/* - Server is a DS */
50#define NFS_CS_REUSEPORT	8		/* - reuse src port on reconnect */
51#define NFS_CS_PNFS		9		/* - Server used for pnfs */
52	struct sockaddr_storage	cl_addr;	/* server identifier */
53	size_t			cl_addrlen;
54	char *			cl_hostname;	/* hostname of server */
55	char *			cl_acceptor;	/* GSSAPI acceptor name */
56	struct list_head	cl_share_link;	/* link in global client list */
57	struct list_head	cl_superblocks;	/* List of nfs_server structs */
58
59	struct rpc_clnt *	cl_rpcclient;
60	const struct nfs_rpc_ops *rpc_ops;	/* NFS protocol vector */
61	int			cl_proto;	/* Network transport protocol */
62	struct nfs_subversion *	cl_nfs_mod;	/* pointer to nfs version module */
63
64	u32			cl_minorversion;/* NFSv4 minorversion */
65	unsigned int		cl_nconnect;	/* Number of connections */
66	unsigned int		cl_max_connect; /* max number of xprts allowed */
67	const char *		cl_principal;	/* used for machine cred */
68	struct xprtsec_parms	cl_xprtsec;	/* xprt security policy */
69
70#if IS_ENABLED(CONFIG_NFS_V4)
71	struct list_head	cl_ds_clients; /* auth flavor data servers */
72	u64			cl_clientid;	/* constant */
73	nfs4_verifier		cl_confirm;	/* Clientid verifier */
74	unsigned long		cl_state;
75
76	spinlock_t		cl_lock;
77
78	unsigned long		cl_lease_time;
79	unsigned long		cl_last_renewal;
80	struct delayed_work	cl_renewd;
81
82	struct rpc_wait_queue	cl_rpcwaitq;
83
84	/* idmapper */
85	struct idmap *		cl_idmap;
86
87	/* Client owner identifier */
88	const char *		cl_owner_id;
89
90	u32			cl_cb_ident;	/* v4.0 callback identifier */
91	const struct nfs4_minor_version_ops *cl_mvops;
92	unsigned long		cl_mig_gen;
93
94	/* NFSv4.0 transport blocking */
95	struct nfs4_slot_table	*cl_slot_tbl;
96
97	/* The sequence id to use for the next CREATE_SESSION */
98	u32			cl_seqid;
99	/* The flags used for obtaining the clientid during EXCHANGE_ID */
100	u32			cl_exchange_flags;
101	struct nfs4_session	*cl_session;	/* shared session */
102	bool			cl_preserve_clid;
103	struct nfs41_server_owner *cl_serverowner;
104	struct nfs41_server_scope *cl_serverscope;
105	struct nfs41_impl_id	*cl_implid;
106	/* nfs 4.1+ state protection modes: */
107	unsigned long		cl_sp4_flags;
108#define NFS_SP4_MACH_CRED_MINIMAL  1	/* Minimal sp4_mach_cred - state ops
109					 * must use machine cred */
110#define NFS_SP4_MACH_CRED_CLEANUP  2	/* CLOSE and LOCKU */
111#define NFS_SP4_MACH_CRED_SECINFO  3	/* SECINFO and SECINFO_NO_NAME */
112#define NFS_SP4_MACH_CRED_STATEID  4	/* TEST_STATEID and FREE_STATEID */
113#define NFS_SP4_MACH_CRED_WRITE    5	/* WRITE */
114#define NFS_SP4_MACH_CRED_COMMIT   6	/* COMMIT */
115#define NFS_SP4_MACH_CRED_PNFS_CLEANUP  7 /* LAYOUTRETURN */
116#if IS_ENABLED(CONFIG_NFS_V4_1)
117	wait_queue_head_t	cl_lock_waitq;
118#endif /* CONFIG_NFS_V4_1 */
119#endif /* CONFIG_NFS_V4 */
120
121	/* Our own IP address, as a null-terminated string.
122	 * This is used to generate the mv0 callback address.
123	 */
124	char			cl_ipaddr[48];
125	struct net		*cl_net;
126	struct list_head	pending_cb_stateids;
127	struct rcu_head		rcu;
128};
129
130/*
131 * NFS client parameters stored in the superblock.
132 */
133struct nfs_server {
134	struct nfs_client *	nfs_client;	/* shared client and NFS4 state */
135	struct list_head	client_link;	/* List of other nfs_server structs
136						 * that share the same client
137						 */
138	struct list_head	master_link;	/* link in master servers list */
139	struct rpc_clnt *	client;		/* RPC client handle */
140	struct rpc_clnt *	client_acl;	/* ACL RPC client handle */
141	struct nlm_host		*nlm_host;	/* NLM client handle */
142	struct nfs_iostats __percpu *io_stats;	/* I/O statistics */
143	atomic_long_t		writeback;	/* number of writeback pages */
144	unsigned int		write_congested;/* flag set when writeback gets too high */
145	unsigned int		flags;		/* various flags */
146
147/* The following are for internal use only. Also see uapi/linux/nfs_mount.h */
148#define NFS_MOUNT_LOOKUP_CACHE_NONEG	0x10000
149#define NFS_MOUNT_LOOKUP_CACHE_NONE	0x20000
150#define NFS_MOUNT_NORESVPORT		0x40000
151#define NFS_MOUNT_LEGACY_INTERFACE	0x80000
152#define NFS_MOUNT_LOCAL_FLOCK		0x100000
153#define NFS_MOUNT_LOCAL_FCNTL		0x200000
154#define NFS_MOUNT_SOFTERR		0x400000
155#define NFS_MOUNT_SOFTREVAL		0x800000
156#define NFS_MOUNT_WRITE_EAGER		0x01000000
157#define NFS_MOUNT_WRITE_WAIT		0x02000000
158#define NFS_MOUNT_TRUNK_DISCOVERY	0x04000000
159#define NFS_MOUNT_SHUTDOWN			0x08000000
160
161	unsigned int		fattr_valid;	/* Valid attributes */
162	unsigned int		caps;		/* server capabilities */
163	unsigned int		rsize;		/* read size */
164	unsigned int		rpages;		/* read size (in pages) */
165	unsigned int		wsize;		/* write size */
166	unsigned int		wpages;		/* write size (in pages) */
167	unsigned int		wtmult;		/* server disk block size */
168	unsigned int		dtsize;		/* readdir size */
169	unsigned short		port;		/* "port=" setting */
170	unsigned int		bsize;		/* server block size */
171#ifdef CONFIG_NFS_V4_2
172	unsigned int		gxasize;	/* getxattr size */
173	unsigned int		sxasize;	/* setxattr size */
174	unsigned int		lxasize;	/* listxattr size */
175#endif
176	unsigned int		acregmin;	/* attr cache timeouts */
177	unsigned int		acregmax;
178	unsigned int		acdirmin;
179	unsigned int		acdirmax;
180	unsigned int		namelen;
181	unsigned int		options;	/* extra options enabled by mount */
182	unsigned int		clone_blksize;	/* granularity of a CLONE operation */
183#define NFS_OPTION_FSCACHE	0x00000001	/* - local caching enabled */
184#define NFS_OPTION_MIGRATION	0x00000002	/* - NFSv4 migration enabled */
185
186	enum nfs4_change_attr_type
187				change_attr_type;/* Description of change attribute */
188
189	struct nfs_fsid		fsid;
190	int			s_sysfs_id;	/* sysfs dentry index */
191	__u64			maxfilesize;	/* maximum file size */
192	struct timespec64	time_delta;	/* smallest time granularity */
193	unsigned long		mount_time;	/* when this fs was mounted */
194	struct super_block	*super;		/* VFS super block */
195	dev_t			s_dev;		/* superblock dev numbers */
196	struct nfs_auth_info	auth_info;	/* parsed auth flavors */
197
198#ifdef CONFIG_NFS_FSCACHE
199	struct fscache_volume	*fscache;	/* superblock cookie */
200	char			*fscache_uniq;	/* Uniquifier (or NULL) */
201#endif
202
203	u32			pnfs_blksize;	/* layout_blksize attr */
204#if IS_ENABLED(CONFIG_NFS_V4)
205	u32			attr_bitmask[3];/* V4 bitmask representing the set
206						   of attributes supported on this
207						   filesystem */
208	u32			attr_bitmask_nl[3];
209						/* V4 bitmask representing the
210						   set of attributes supported
211						   on this filesystem excluding
212						   the label support bit. */
213	u32			exclcreat_bitmask[3];
214						/* V4 bitmask representing the
215						   set of attributes supported
216						   on this filesystem for the
217						   exclusive create. */
218	u32			cache_consistency_bitmask[3];
219						/* V4 bitmask representing the subset
220						   of change attribute, size, ctime
221						   and mtime attributes supported by
222						   the server */
223	u32			acl_bitmask;	/* V4 bitmask representing the ACEs
224						   that are supported on this
225						   filesystem */
226	u32			fh_expire_type;	/* V4 bitmask representing file
227						   handle volatility type for
228						   this filesystem */
229	struct pnfs_layoutdriver_type  *pnfs_curr_ld; /* Active layout driver */
230	struct rpc_wait_queue	roc_rpcwaitq;
231	void			*pnfs_ld_data;	/* per mount point data */
232
233	/* the following fields are protected by nfs_client->cl_lock */
234	struct rb_root		state_owners;
235#endif
236	struct ida		openowner_id;
237	struct ida		lockowner_id;
238	struct list_head	state_owners_lru;
239	struct list_head	layouts;
240	struct list_head	delegations;
241	struct list_head	ss_copies;
242
243	unsigned long		delegation_gen;
244	unsigned long		mig_gen;
245	unsigned long		mig_status;
246#define NFS_MIG_IN_TRANSITION		(1)
247#define NFS_MIG_FAILED			(2)
248#define NFS_MIG_TSM_POSSIBLE		(3)
249
250	void (*destroy)(struct nfs_server *);
251
252	atomic_t active; /* Keep trace of any activity to this server */
253
254	/* mountd-related mount options */
255	struct sockaddr_storage	mountd_address;
256	size_t			mountd_addrlen;
257	u32			mountd_version;
258	unsigned short		mountd_port;
259	unsigned short		mountd_protocol;
260	struct rpc_wait_queue	uoc_rpcwaitq;
261
262	/* XDR related information */
263	unsigned int		read_hdrsize;
264
265	/* User namespace info */
266	const struct cred	*cred;
267	bool			has_sec_mnt_opts;
268	struct kobject		kobj;
269	struct rcu_head		rcu;
270};
271
272/* Server capabilities */
273#define NFS_CAP_READDIRPLUS	(1U << 0)
274#define NFS_CAP_HARDLINKS	(1U << 1)
275#define NFS_CAP_SYMLINKS	(1U << 2)
276#define NFS_CAP_ACLS		(1U << 3)
277#define NFS_CAP_ATOMIC_OPEN	(1U << 4)
278#define NFS_CAP_LGOPEN		(1U << 5)
279#define NFS_CAP_CASE_INSENSITIVE	(1U << 6)
280#define NFS_CAP_CASE_PRESERVING	(1U << 7)
281#define NFS_CAP_POSIX_LOCK	(1U << 14)
282#define NFS_CAP_UIDGID_NOMAP	(1U << 15)
283#define NFS_CAP_STATEID_NFSV41	(1U << 16)
284#define NFS_CAP_ATOMIC_OPEN_V1	(1U << 17)
285#define NFS_CAP_SECURITY_LABEL	(1U << 18)
286#define NFS_CAP_SEEK		(1U << 19)
287#define NFS_CAP_ALLOCATE	(1U << 20)
288#define NFS_CAP_DEALLOCATE	(1U << 21)
289#define NFS_CAP_LAYOUTSTATS	(1U << 22)
290#define NFS_CAP_CLONE		(1U << 23)
291#define NFS_CAP_COPY		(1U << 24)
292#define NFS_CAP_OFFLOAD_CANCEL	(1U << 25)
293#define NFS_CAP_LAYOUTERROR	(1U << 26)
294#define NFS_CAP_COPY_NOTIFY	(1U << 27)
295#define NFS_CAP_XATTR		(1U << 28)
296#define NFS_CAP_READ_PLUS	(1U << 29)
297#define NFS_CAP_FS_LOCATIONS	(1U << 30)
298#define NFS_CAP_MOVEABLE	(1U << 31)
299#endif
300