xref: /freebsd/sys/fs/nfs/nfsclstate.h (revision 094fc1ed0f2627525c7b0342efcbad5be7a8546a)
1 /*-
2  * Copyright (c) 2009 Rick Macklem, University of Guelph
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _NFS_NFSCLSTATE_H_
30 #define	_NFS_NFSCLSTATE_H_
31 
32 /*
33  * Definitions for NFS V4 client state handling.
34  */
35 LIST_HEAD(nfsclopenhead, nfsclopen);
36 LIST_HEAD(nfscllockownerhead, nfscllockowner);
37 SLIST_HEAD(nfscllockownerfhhead, nfscllockownerfh);
38 LIST_HEAD(nfscllockhead, nfscllock);
39 LIST_HEAD(nfsclhead, nfsclclient);
40 LIST_HEAD(nfsclownerhead, nfsclowner);
41 TAILQ_HEAD(nfscldeleghead, nfscldeleg);
42 LIST_HEAD(nfscldeleghash, nfscldeleg);
43 TAILQ_HEAD(nfscllayouthead, nfscllayout);
44 LIST_HEAD(nfscllayouthash, nfscllayout);
45 LIST_HEAD(nfsclflayouthead, nfsclflayout);
46 LIST_HEAD(nfscldevinfohead, nfscldevinfo);
47 LIST_HEAD(nfsclrecalllayouthead, nfsclrecalllayout);
48 #define	NFSCLDELEGHASHSIZE	256
49 #define	NFSCLDELEGHASH(c, f, l)							\
50 	(&((c)->nfsc_deleghash[ncl_hash((f), (l)) % NFSCLDELEGHASHSIZE]))
51 #define	NFSCLLAYOUTHASHSIZE	256
52 #define	NFSCLLAYOUTHASH(c, f, l)						\
53 	(&((c)->nfsc_layouthash[ncl_hash((f), (l)) % NFSCLLAYOUTHASHSIZE]))
54 
55 /* Structure for NFSv4.1 session stuff. */
56 struct nfsclsession {
57 	struct mtx	nfsess_mtx;
58 	struct nfsslot	nfsess_cbslots[NFSV4_CBSLOTS];
59 	nfsquad_t	nfsess_clientid;
60 	SVCXPRT		*nfsess_xprt;		/* For backchannel callback */
61 	uint32_t	nfsess_slotseq[64];	/* Max for 64bit nm_slots */
62 	uint64_t	nfsess_slots;
63 	uint32_t	nfsess_sequenceid;
64 	uint32_t	nfsess_maxcache;	/* Max size for cached reply. */
65 	uint16_t	nfsess_foreslots;
66 	uint16_t	nfsess_backslots;
67 	uint8_t		nfsess_sessionid[NFSX_V4SESSIONID];
68 	uint8_t		nfsess_defunct;		/* Non-zero for old sessions */
69 };
70 
71 /*
72  * This structure holds the session, clientid and related information
73  * needed for an NFSv4.1 Meta Data Server (MDS) or Data Server (DS).
74  * It is malloc'd to the correct length.
75  */
76 struct nfsclds {
77 	TAILQ_ENTRY(nfsclds)	nfsclds_list;
78 	struct nfsclsession	nfsclds_sess;
79 	struct mtx		nfsclds_mtx;
80 	struct nfssockreq	*nfsclds_sockp;
81 	time_t			nfsclds_expire;
82 	uint16_t		nfsclds_flags;
83 	uint16_t		nfsclds_servownlen;
84 	uint8_t			nfsclds_verf[NFSX_VERF];
85 	uint8_t			nfsclds_serverown[0];
86 };
87 
88 /*
89  * Flags for nfsclds_flags.
90  */
91 #define	NFSCLDS_HASWRITEVERF	0x0001
92 #define	NFSCLDS_MDS		0x0002
93 #define	NFSCLDS_DS		0x0004
94 
95 struct nfsclclient {
96 	LIST_ENTRY(nfsclclient) nfsc_list;
97 	struct nfsclownerhead	nfsc_owner;
98 	struct nfscldeleghead	nfsc_deleg;
99 	struct nfscldeleghash	nfsc_deleghash[NFSCLDELEGHASHSIZE];
100 	struct nfscllayouthead	nfsc_layout;
101 	struct nfscllayouthash	nfsc_layouthash[NFSCLLAYOUTHASHSIZE];
102 	struct nfscldevinfohead	nfsc_devinfo;
103 	struct nfsv4lock	nfsc_lock;
104 	struct proc		*nfsc_renewthread;
105 	struct nfsmount		*nfsc_nmp;
106 	time_t			nfsc_expire;
107 	u_int32_t		nfsc_clientidrev;
108 	u_int32_t		nfsc_rev;
109 	u_int32_t		nfsc_renew;
110 	u_int32_t		nfsc_cbident;
111 	u_int16_t		nfsc_flags;
112 	u_int16_t		nfsc_idlen;
113 	u_int8_t		nfsc_id[1];	/* Malloc'd to correct length */
114 };
115 
116 /*
117  * Bits for nfsc_flags.
118  */
119 #define	NFSCLFLAGS_INITED	0x0001
120 #define	NFSCLFLAGS_HASCLIENTID	0x0002
121 #define	NFSCLFLAGS_RECOVER	0x0004
122 #define	NFSCLFLAGS_UMOUNT	0x0008
123 #define	NFSCLFLAGS_HASTHREAD	0x0010
124 #define	NFSCLFLAGS_AFINET6	0x0020
125 #define	NFSCLFLAGS_EXPIREIT	0x0040
126 #define	NFSCLFLAGS_FIRSTDELEG	0x0080
127 #define	NFSCLFLAGS_GOTDELEG	0x0100
128 #define	NFSCLFLAGS_RECVRINPROG	0x0200
129 
130 struct nfsclowner {
131 	LIST_ENTRY(nfsclowner)	nfsow_list;
132 	struct nfsclopenhead	nfsow_open;
133 	struct nfsclclient	*nfsow_clp;
134 	u_int32_t		nfsow_seqid;
135 	u_int32_t		nfsow_defunct;
136 	struct nfsv4lock	nfsow_rwlock;
137 	u_int8_t		nfsow_owner[NFSV4CL_LOCKNAMELEN];
138 };
139 
140 /*
141  * MALLOC'd to the correct length to accommodate the file handle.
142  */
143 struct nfscldeleg {
144 	TAILQ_ENTRY(nfscldeleg)	nfsdl_list;
145 	LIST_ENTRY(nfscldeleg)	nfsdl_hash;
146 	struct nfsclownerhead	nfsdl_owner;	/* locally issued state */
147 	struct nfscllockownerhead nfsdl_lock;
148 	nfsv4stateid_t		nfsdl_stateid;
149 	struct acl_entry	nfsdl_ace;	/* Delegation ace */
150 	struct nfsclclient	*nfsdl_clp;
151 	struct nfsv4lock	nfsdl_rwlock;	/* for active I/O ops */
152 	struct nfscred		nfsdl_cred;	/* Cred. used for Open */
153 	time_t			nfsdl_timestamp; /* used for stale cleanup */
154 	u_int64_t		nfsdl_sizelimit; /* Limit for file growth */
155 	u_int64_t		nfsdl_size;	/* saved copy of file size */
156 	u_int64_t		nfsdl_change;	/* and change attribute */
157 	struct timespec		nfsdl_modtime;	/* local modify time */
158 	u_int16_t		nfsdl_fhlen;
159 	u_int8_t		nfsdl_flags;
160 	u_int8_t		nfsdl_fh[1];	/* must be last */
161 };
162 
163 /*
164  * nfsdl_flags bits.
165  */
166 #define	NFSCLDL_READ		0x01
167 #define	NFSCLDL_WRITE		0x02
168 #define	NFSCLDL_RECALL		0x04
169 #define	NFSCLDL_NEEDRECLAIM	0x08
170 #define	NFSCLDL_ZAPPED		0x10
171 #define	NFSCLDL_MODTIMESET	0x20
172 #define	NFSCLDL_DELEGRET	0x40
173 
174 /*
175  * MALLOC'd to the correct length to accommodate the file handle.
176  */
177 struct nfsclopen {
178 	LIST_ENTRY(nfsclopen)	nfso_list;
179 	struct nfscllockownerhead nfso_lock;
180 	nfsv4stateid_t		nfso_stateid;
181 	struct nfsclowner	*nfso_own;
182 	struct nfscred		nfso_cred;	/* Cred. used for Open */
183 	u_int32_t		nfso_mode;
184 	u_int32_t		nfso_opencnt;
185 	u_int16_t		nfso_fhlen;
186 	u_int8_t		nfso_posixlock;	/* 1 for POSIX type locking */
187 	u_int8_t		nfso_fh[1];	/* must be last */
188 };
189 
190 /*
191  * Return values for nfscl_open(). NFSCLOPEN_OK must == 0.
192  */
193 #define	NFSCLOPEN_OK		0
194 #define	NFSCLOPEN_DOOPEN	1
195 #define	NFSCLOPEN_DOOPENDOWNGRADE 2
196 #define	NFSCLOPEN_SETCRED	3
197 
198 struct nfscllockowner {
199 	LIST_ENTRY(nfscllockowner) nfsl_list;
200 	struct nfscllockhead	nfsl_lock;
201 	struct nfsclopen	*nfsl_open;
202 	NFSPROC_T		*nfsl_inprog;
203 	nfsv4stateid_t		nfsl_stateid;
204 	int			nfsl_lockflags;
205 	u_int32_t		nfsl_seqid;
206 	struct nfsv4lock	nfsl_rwlock;
207 	u_int8_t		nfsl_owner[NFSV4CL_LOCKNAMELEN];
208 	u_int8_t		nfsl_openowner[NFSV4CL_LOCKNAMELEN];
209 };
210 
211 /*
212  * Byte range entry for the above lock owner.
213  */
214 struct nfscllock {
215 	LIST_ENTRY(nfscllock)	nfslo_list;
216 	u_int64_t		nfslo_first;
217 	u_int64_t		nfslo_end;
218 	short			nfslo_type;
219 };
220 
221 /* This structure is used to collect a list of lockowners to free up. */
222 struct nfscllockownerfh {
223 	SLIST_ENTRY(nfscllockownerfh)	nfslfh_list;
224 	struct nfscllockownerhead	nfslfh_lock;
225 	int				nfslfh_len;
226 	uint8_t				nfslfh_fh[NFSX_V4FHMAX];
227 };
228 
229 /*
230  * MALLOC'd to the correct length to accommodate the file handle.
231  */
232 struct nfscllayout {
233 	TAILQ_ENTRY(nfscllayout)	nfsly_list;
234 	LIST_ENTRY(nfscllayout)		nfsly_hash;
235 	nfsv4stateid_t			nfsly_stateid;
236 	struct nfsv4lock		nfsly_lock;
237 	uint64_t			nfsly_filesid[2];
238 	uint64_t			nfsly_lastbyte;
239 	struct nfsclflayouthead		nfsly_flayread;
240 	struct nfsclflayouthead		nfsly_flayrw;
241 	struct nfsclrecalllayouthead	nfsly_recall;
242 	time_t				nfsly_timestamp;
243 	struct nfsclclient		*nfsly_clp;
244 	uint16_t			nfsly_flags;
245 	uint16_t			nfsly_fhlen;
246 	uint8_t				nfsly_fh[1];
247 };
248 
249 /*
250  * Flags for nfsly_flags.
251  */
252 #define	NFSLY_FILES		0x0001
253 #define	NFSLY_BLOCK		0x0002
254 #define	NFSLY_OBJECT		0x0004
255 #define	NFSLY_RECALL		0x0008
256 #define	NFSLY_RECALLFILE	0x0010
257 #define	NFSLY_RECALLFSID	0x0020
258 #define	NFSLY_RECALLALL		0x0040
259 #define	NFSLY_RETONCLOSE	0x0080
260 #define	NFSLY_WRITTEN		0x0100	/* Has been used to write to a DS. */
261 #define	NFSLY_FLEXFILE		0x0200
262 
263 /*
264  * Flex file layout mirror specific stuff for nfsclflayout.
265  */
266 struct nfsffm {
267 	nfsv4stateid_t		st;
268 	char			dev[NFSX_V4DEVICEID];
269 	uint32_t		eff;
270 	uid_t			user;
271 	gid_t			group;
272 	struct nfsfh		*fh[NFSDEV_MAXVERS];
273 	uint16_t		fhcnt;
274 };
275 
276 /*
277  * MALLOC'd to the correct length to accommodate the file handle list for File
278  * layout and the list of mirrors for the Flex File Layout.
279  * These hang off of nfsly_flayread and nfsly_flayrw, sorted in increasing
280  * offset order.
281  * The nfsly_flayread list holds the ones with iomode == NFSLAYOUTIOMODE_READ,
282  * whereas the nfsly_flayrw holds the ones with iomode == NFSLAYOUTIOMODE_RW.
283  */
284 struct nfsclflayout {
285 	LIST_ENTRY(nfsclflayout)	nfsfl_list;
286 	uint64_t			nfsfl_off;
287 	uint64_t			nfsfl_end;
288 	uint32_t			nfsfl_iomode;
289 	struct nfscldevinfo		*nfsfl_devp;
290 	uint16_t			nfsfl_flags;
291 	union {
292 		struct {
293 			uint64_t	patoff;
294 			uint32_t	util;
295 			uint32_t	stripe1;
296 			uint8_t		dev[NFSX_V4DEVICEID];
297 			uint16_t	fhcnt;
298 		} fl;
299 		struct {
300 			uint64_t	stripeunit;
301 			uint32_t	fflags;
302 			uint32_t	statshint;
303 			uint16_t	mirrorcnt;
304 		} ff;
305 	} nfsfl_un;
306 	union {
307 		struct nfsfh		*fh[0];	/* FH list for DS File layout */
308 		struct nfsffm		ffm[0];	/* Mirror list for Flex File */
309 	} nfsfl_un2;	/* Must be last. Malloc'd to correct array length */
310 };
311 #define	nfsfl_patoff		nfsfl_un.fl.patoff
312 #define	nfsfl_util		nfsfl_un.fl.util
313 #define	nfsfl_stripe1		nfsfl_un.fl.stripe1
314 #define	nfsfl_dev		nfsfl_un.fl.dev
315 #define	nfsfl_fhcnt		nfsfl_un.fl.fhcnt
316 #define	nfsfl_stripeunit	nfsfl_un.ff.stripeunit
317 #define	nfsfl_fflags		nfsfl_un.ff.fflags
318 #define	nfsfl_statshint		nfsfl_un.ff.statshint
319 #define	nfsfl_mirrorcnt		nfsfl_un.ff.mirrorcnt
320 #define	nfsfl_fh		nfsfl_un2.fh
321 #define	nfsfl_ffm		nfsfl_un2.ffm
322 
323 /*
324  * Flags for nfsfl_flags.
325  */
326 #define	NFSFL_RECALL	0x0001		/* File layout has been recalled */
327 #define	NFSFL_FILE	0x0002		/* File layout */
328 #define	NFSFL_FLEXFILE	0x0004		/* Flex File layout */
329 
330 /*
331  * Structure that is used to store a LAYOUTRECALL.
332  */
333 struct nfsclrecalllayout {
334 	LIST_ENTRY(nfsclrecalllayout)	nfsrecly_list;
335 	uint64_t			nfsrecly_off;
336 	uint64_t			nfsrecly_len;
337 	int				nfsrecly_recalltype;
338 	uint32_t			nfsrecly_iomode;
339 	uint32_t			nfsrecly_stateseqid;
340 };
341 
342 /*
343  * Stores the NFSv4.1 Device Info. Malloc'd to the correct length to
344  * store the list of network connections and list of indices.
345  * nfsdi_data[] is allocated the following way:
346  * - nfsdi_addrcnt * struct nfsclds
347  * - stripe indices, each stored as one byte, since there can be many
348  *   of them. (This implies a limit of 256 on nfsdi_addrcnt, since the
349  *   indices select which address.)
350  * For Flex File, the addrcnt is always one and no stripe indices exist.
351  */
352 struct nfscldevinfo {
353 	LIST_ENTRY(nfscldevinfo)	nfsdi_list;
354 	uint8_t				nfsdi_deviceid[NFSX_V4DEVICEID];
355 	struct nfsclclient		*nfsdi_clp;
356 	uint32_t			nfsdi_refcnt;
357 	uint32_t			nfsdi_layoutrefs;
358 	union {
359 		struct {
360 			uint16_t	stripecnt;
361 		} fl;
362 		struct {
363 			int		versindex;
364 			uint32_t	vers;
365 			uint32_t	minorvers;
366 			uint32_t	rsize;
367 			uint32_t	wsize;
368 		} ff;
369 	} nfsdi_un;
370 	uint16_t			nfsdi_addrcnt;
371 	uint16_t			nfsdi_flags;
372 	struct nfsclds			*nfsdi_data[0];
373 };
374 #define	nfsdi_stripecnt	nfsdi_un.fl.stripecnt
375 #define	nfsdi_versindex	nfsdi_un.ff.versindex
376 #define	nfsdi_vers	nfsdi_un.ff.vers
377 #define	nfsdi_minorvers	nfsdi_un.ff.minorvers
378 #define	nfsdi_rsize	nfsdi_un.ff.rsize
379 #define	nfsdi_wsize	nfsdi_un.ff.wsize
380 
381 /* Flags for nfsdi_flags. */
382 #define	NFSDI_FILELAYOUT	0x0001
383 #define	NFSDI_FLEXFILE		0x0002
384 #define	NFSDI_TIGHTCOUPLED	0X0004
385 
386 /* These inline functions return values from nfsdi_data[]. */
387 /*
388  * Return a pointer to the address at "pos".
389  */
390 static __inline struct nfsclds **
391 nfsfldi_addr(struct nfscldevinfo *ndi, int pos)
392 {
393 
394 	if (pos >= ndi->nfsdi_addrcnt)
395 		return (NULL);
396 	return (&ndi->nfsdi_data[pos]);
397 }
398 
399 /*
400  * Return the Nth ("pos") stripe index.
401  */
402 static __inline int
403 nfsfldi_stripeindex(struct nfscldevinfo *ndi, int pos)
404 {
405 	uint8_t *valp;
406 
407 	if (pos >= ndi->nfsdi_stripecnt)
408 		return (-1);
409 	valp = (uint8_t *)&ndi->nfsdi_data[ndi->nfsdi_addrcnt];
410 	valp += pos;
411 	return ((int)*valp);
412 }
413 
414 /*
415  * Set the Nth ("pos") stripe index to "val".
416  */
417 static __inline void
418 nfsfldi_setstripeindex(struct nfscldevinfo *ndi, int pos, uint8_t val)
419 {
420 	uint8_t *valp;
421 
422 	if (pos >= ndi->nfsdi_stripecnt)
423 		return;
424 	valp = (uint8_t *)&ndi->nfsdi_data[ndi->nfsdi_addrcnt];
425 	valp += pos;
426 	*valp = val;
427 }
428 
429 /*
430  * Macro for incrementing the seqid#.
431  */
432 #define	NFSCL_INCRSEQID(s, n)	do { 					\
433 	    if (((n)->nd_flag & ND_INCRSEQID))				\
434 		(s)++; 							\
435 	} while (0)
436 
437 #endif	/* _NFS_NFSCLSTATE_H_ */
438