xref: /xnu-8792.81.2/bsd/nfs/nfs.h (revision 19c3b8c28c31cb8130e034cfb5df6bf9ba342d90)
1 /*
2  * Copyright (c) 2000-2018 Apple Inc. All rights reserved.
3  *
4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5  *
6  * This file contains Original Code and/or Modifications of Original Code
7  * as defined in and that are subject to the Apple Public Source License
8  * Version 2.0 (the 'License'). You may not use this file except in
9  * compliance with the License. The rights granted to you under the License
10  * may not be used to create, or enable the creation or redistribution of,
11  * unlawful or unlicensed copies of an Apple operating system, or to
12  * circumvent, violate, or enable the circumvention or violation of, any
13  * terms of an Apple operating system software license agreement.
14  *
15  * Please obtain a copy of the License at
16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17  *
18  * The Original Code and all software distributed under the License are
19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23  * Please see the License for the specific language governing rights and
24  * limitations under the License.
25  *
26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27  */
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
29 /*
30  * Copyright (c) 1989, 1993, 1995
31  *	The Regents of the University of California.  All rights reserved.
32  *
33  * This code is derived from software contributed to Berkeley by
34  * Rick Macklem at The University of Guelph.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  * 1. Redistributions of source code must retain the above copyright
40  *    notice, this list of conditions and the following disclaimer.
41  * 2. Redistributions in binary form must reproduce the above copyright
42  *    notice, this list of conditions and the following disclaimer in the
43  *    documentation and/or other materials provided with the distribution.
44  * 3. All advertising materials mentioning features or use of this software
45  *    must display the following acknowledgement:
46  *	This product includes software developed by the University of
47  *	California, Berkeley and its contributors.
48  * 4. Neither the name of the University nor the names of its contributors
49  *    may be used to endorse or promote products derived from this software
50  *    without specific prior written permission.
51  *
52  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
53  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
54  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
55  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
56  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
57  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
58  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
62  * SUCH DAMAGE.
63  *
64  *	@(#)nfs.h	8.4 (Berkeley) 5/1/95
65  * FreeBSD-Id: nfs.h,v 1.32 1997/10/12 20:25:38 phk Exp $
66  */
67 
68 #ifndef _NFS_NFS_H_
69 #define _NFS_NFS_H_
70 
71 #include <sys/appleapiopts.h>
72 #include <sys/cdefs.h>
73 #include <sys/socket.h>
74 #include <sys/mount.h>
75 #include <sys/ioccom.h>
76 
77 #ifdef KERNEL
78 #include <sys/vnode.h>
79 #include <sys/user.h>
80 #include <net/radix.h>
81 #include <kern/locks.h>
82 #include <kern/lock_group.h>
83 #endif
84 
85 #include <nfs/rpcv2.h>
86 #include <nfs/nfsproto.h>
87 
88 #ifdef __APPLE_API_PRIVATE
89 /*
90  * Tunable constants for nfs
91  */
92 
93 #define NFS_TICKINTVL   5               /* Desired time for a tick (msec) */
94 #define NFS_HZ          (hz / nfs_ticks) /* Ticks/sec */
95 extern int nfs_ticks;
96 #define NFS_TIMEO       (1 * NFS_HZ)    /* Default timeout = 1 second */
97 #define NFS_MINTIMEO    (1 * NFS_HZ)    /* Min timeout to use */
98 #define NFS_MAXTIMEO    (60 * NFS_HZ)   /* Max timeout to backoff to */
99 #define NFS_MINIDEMTIMEO (5 * NFS_HZ)   /* Min timeout for non-idempotent ops*/
100 #define NFS_MAXREXMIT   100             /* Stop counting after this many */
101 #define NFS_RETRANS     10              /* Num of retrans for soft mounts */
102 #define NFS_TRYLATERDEL 4               /* Initial try later delay (sec) */
103 #define NFS_MAXGRPS     16U             /* Max. size of groups list */
104 #define NFS_MINATTRTIMO 5               /* Attribute cache timeout in sec */
105 #define NFS_MAXATTRTIMO 60
106 #define NFS_MINDIRATTRTIMO 5            /* directory attribute cache timeout in sec */
107 #define NFS_MAXDIRATTRTIMO 60
108 #define NFS_MAXPORT     0xffff
109 #define NFS_IOSIZE      (1024 * 1024)   /* suggested I/O size */
110 #define NFS_RWSIZE      32768           /* Def. read/write data size <= 32K */
111 #define NFS_WSIZE       NFS_RWSIZE      /* Def. write data size <= 32K */
112 #define NFS_RSIZE       NFS_RWSIZE      /* Def. read data size <= 32K */
113 #define NFS_DGRAM_WSIZE 8192            /* UDP Def. write data size <= 8K */
114 #define NFS_DGRAM_RSIZE 8192            /* UDP Def. read data size <= 8K */
115 #define NFS_READDIRSIZE 32768           /* Def. readdir size */
116 #define NFS_DEFRAHEAD   16              /* Def. read ahead # blocks */
117 #define NFS_MAXRAHEAD   128             /* Max. read ahead # blocks */
118 #define NFS_DEFMAXASYNCWRITES   128     /* Def. max # concurrent async write RPCs */
119 #define NFS_DEFASYNCTHREAD      16      /* Def. # nfsiod threads */
120 #define NFS_MAXASYNCTHREAD      64      /* max # nfsiod threads */
121 #define NFS_ASYNCTHREADMAXIDLE  60      /* Seconds before idle nfsiods are reaped */
122 #define NFS_DEFSTATFSRATELIMIT  10      /* Def. max # statfs RPCs per second */
123 #define NFS_REQUESTDELAY        10      /* ms interval to check request queue */
124 #define NFSRV_MAXWGATHERDELAY   100     /* Max. write gather delay (msec) */
125 #ifndef NFSRV_WGATHERDELAY
126 #define NFSRV_WGATHERDELAY      1       /* Default write gather delay (msec) */
127 #endif
128 #define NFS_DIRBLKSIZ   4096            /* size of NFS directory buffers */
129 #if defined(KERNEL) && !defined(DIRBLKSIZ)
130 #define DIRBLKSIZ       512             /* XXX we used to use ufs's DIRBLKSIZ */
131                                         /* can't be larger than NFS_FABLKSIZE */
132 #endif
133 
134 /* default values for unresponsive mount timeouts */
135 #define NFS_TPRINTF_INITIAL_DELAY       5
136 #define NFS_TPRINTF_DELAY               30
137 
138 /* NFS client mount timeouts */
139 #define NFS_MOUNT_TIMEOUT               30
140 #define NFS_MOUNT_QUICK_TIMEOUT         8
141 
142 /*
143  * Oddballs
144  */
145 #define NFS_CMPFH(n, f, s) \
146 	((n)->n_fhsize == (s) && !bcmp((caddr_t)(n)->n_fhp, (caddr_t)(f), (s)))
147 #define NFSRV_NDMAXDATA(n) \
148 	        (((n)->nd_vers == NFS_VER3) ? (((n)->nd_nam2) ? \
149 	         NFS_MAXDGRAMDATA : NFSRV_MAXDATA) : NFS_V2MAXDATA)
150 #define NFS_PORT_INVALID(port) \
151 	(((port) > NFS_MAXPORT) || ((port) < 0))
152 
153 /*
154  * The IO_METASYNC flag should be implemented for local file systems.
155  * (Until then, it is nothin at all.)
156  */
157 #ifndef IO_METASYNC
158 #define IO_METASYNC     0
159 #endif
160 
161 /*
162  * Expected allocation sizes for major data structures. If the actual size
163  * of the structure exceeds these sizes, then malloc() will be allocating
164  * almost twice the memory required. This is used in nfs_init() to warn
165  * the sysadmin that the size of a structure should be reduced.
166  * (These sizes are always a power of 2. If the kernel malloc() changes
167  *  to one that does not allocate space in powers of 2 size, then this all
168  *  becomes bunk!).
169  * Note that some of these structures come out of their own nfs zones.
170  */
171 #define NFS_NODEALLOC   1024
172 #define NFS_MNTALLOC    1024
173 #define NFS_SVCALLOC    512
174 
175 #define NFS_ARGSVERSION_XDR     88      /* NFS mount args are in XDR format */
176 
177 #define NFS_XDRARGS_VERSION_0   0
178 #define NFS_MATTR_BITMAP_LEN    1               /* length of mount attributes bitmap */
179 #define NFS_MFLAG_BITMAP_LEN    1               /* length of mount flags bitmap */
180 
181 /* NFS mount attributes */
182 #define NFS_MATTR_FLAGS                 0       /* mount flags (NFS_MATTR_*) */
183 #define NFS_MATTR_NFS_VERSION           1       /* NFS protocol version */
184 #define NFS_MATTR_NFS_MINOR_VERSION     2       /* NFS protocol minor version */
185 #define NFS_MATTR_READ_SIZE             3       /* READ RPC size */
186 #define NFS_MATTR_WRITE_SIZE            4       /* WRITE RPC size */
187 #define NFS_MATTR_READDIR_SIZE          5       /* READDIR RPC size */
188 #define NFS_MATTR_READAHEAD             6       /* block readahead count */
189 #define NFS_MATTR_ATTRCACHE_REG_MIN     7       /* minimum attribute cache time */
190 #define NFS_MATTR_ATTRCACHE_REG_MAX     8       /* maximum attribute cache time */
191 #define NFS_MATTR_ATTRCACHE_DIR_MIN     9       /* minimum attribute cache time for dirs */
192 #define NFS_MATTR_ATTRCACHE_DIR_MAX     10      /* maximum attribute cache time for dirs */
193 #define NFS_MATTR_LOCK_MODE             11      /* advisory file locking mode (NFS_LOCK_MODE_*) */
194 #define NFS_MATTR_SECURITY              12      /* RPC security flavors to use */
195 #define NFS_MATTR_MAX_GROUP_LIST        13      /* max # of RPC AUTH_SYS groups */
196 #define NFS_MATTR_SOCKET_TYPE           14      /* socket transport type as a netid-like string */
197 #define NFS_MATTR_NFS_PORT              15      /* port # to use for NFS protocol */
198 #define NFS_MATTR_MOUNT_PORT            16      /* port # to use for MOUNT protocol */
199 #define NFS_MATTR_REQUEST_TIMEOUT       17      /* initial RPC request timeout value */
200 #define NFS_MATTR_SOFT_RETRY_COUNT      18      /* max RPC retransmissions for soft mounts */
201 #define NFS_MATTR_DEAD_TIMEOUT          19      /* how long until unresponsive mount is considered dead */
202 #define NFS_MATTR_FH                    20      /* file handle for mount directory */
203 #define NFS_MATTR_FS_LOCATIONS          21      /* list of locations for the file system */
204 #define NFS_MATTR_MNTFLAGS              22      /* VFS mount flags (MNT_*) */
205 #define NFS_MATTR_MNTFROM               23      /* fixed string to use for "f_mntfromname" */
206 #define NFS_MATTR_REALM                 24      /* Realm to authenticate with */
207 #define NFS_MATTR_PRINCIPAL             25      /* GSS principal to authenticate with */
208 #define NFS_MATTR_SVCPRINCIPAL          26      /* GSS principal to authenticate to, the server principal */
209 #define NFS_MATTR_NFS_VERSION_RANGE     27      /* Packed version range to try */
210 #define NFS_MATTR_KERB_ETYPE            28      /* Enctype to use for kerberos mounts */
211 #define NFS_MATTR_LOCAL_NFS_PORT        29      /* Unix domain socket for NFS protocol */
212 #define NFS_MATTR_LOCAL_MOUNT_PORT      30      /* Unix domain socket for MOUNT protocol */
213 #define NFS_MATTR_SET_MOUNT_OWNER       31      /* Set owner of mount point */
214 
215 /* NFS mount flags */
216 #define NFS_MFLAG_SOFT                  0       /* soft mount (requests fail if unresponsive) */
217 #define NFS_MFLAG_INTR                  1       /* allow operations to be interrupted */
218 #define NFS_MFLAG_RESVPORT              2       /* use a reserved port */
219 #define NFS_MFLAG_NOCONNECT             3       /* don't connect the socket (UDP) */
220 #define NFS_MFLAG_DUMBTIMER             4       /* don't estimate RTT dynamically */
221 #define NFS_MFLAG_CALLUMNT              5       /* call MOUNTPROC_UMNT on unmount */
222 #define NFS_MFLAG_RDIRPLUS              6       /* request additional info when reading directories */
223 #define NFS_MFLAG_NONEGNAMECACHE        7       /* don't do negative name caching */
224 #define NFS_MFLAG_MUTEJUKEBOX           8       /* don't treat jukebox errors as unresponsive */
225 #define NFS_MFLAG_EPHEMERAL             9       /* ephemeral (mirror) mount */
226 #define NFS_MFLAG_NOCALLBACK            10      /* don't provide callback RPC service */
227 #define NFS_MFLAG_NAMEDATTR             11      /* don't use named attributes */
228 #define NFS_MFLAG_NOACL                 12      /* don't support ACLs */
229 #define NFS_MFLAG_ACLONLY               13      /* only support ACLs - not mode */
230 #define NFS_MFLAG_NFC                   14      /* send NFC strings */
231 #define NFS_MFLAG_NOQUOTA               15      /* don't support QUOTA requests */
232 #define NFS_MFLAG_MNTUDP                16      /* MOUNT protocol should use UDP */
233 #define NFS_MFLAG_MNTQUICK              17      /* use short timeouts while mounting */
234 #define NFS_MFLAG_NOOPAQUE_AUTH         19      /* don't make the mount AUTH_OPAQUE. Used by V3 */
235 
236 /* Macros for packing and unpacking packed versions */
237 #define PVER2MAJOR(M) ((uint32_t)(((M) >> 16) & 0xffff))
238 #define PVER2MINOR(m) ((uint32_t)((m) & 0xffff))
239 #define VER2PVER(M, m) ((uint32_t)((M) << 16) | ((m) & 0xffff))
240 
241 /* NFS advisory file locking modes */
242 #define NFS_LOCK_MODE_ENABLED           0       /* advisory file locking enabled */
243 #define NFS_LOCK_MODE_DISABLED          1       /* do not support advisory file locking */
244 #define NFS_LOCK_MODE_LOCAL             2       /* perform advisory file locking locally */
245 
246 #define NFS_STRLEN_INT(str) \
247 	        (int)strnlen(str, INT_MAX)
248 #define NFS_UIO_ADDIOV(a_uio, a_baseaddr, a_length) \
249 	        assert(a_length <= UINT32_MAX); uio_addiov(a_uio, a_baseaddr, (uint32_t)(a_length));
250 #define NFS_BZERO(off, bytes) \
251 	do { \
252 	        uint32_t bytes32 = bytes > UINT32_MAX ? UINT32_MAX : (uint32_t)(bytes); \
253 	        bzero(off, bytes32); \
254 	        if (bytes > UINT32_MAX) { \
255 	                bzero(off + bytes32, (uint32_t)(bytes - UINT32_MAX)); \
256 	        } \
257 	} while(0);
258 #define NFS_ZFREE(zone, ptr) \
259 	do { \
260 	        if ((ptr)) { \
261 	                zfree((zone), (ptr)); \
262 	                (ptr) = NULL; \
263 	        } \
264 	} while (0); \
265 
266 /* Supported encryption types for kerberos session keys */
267 typedef enum  nfs_supported_kerberos_etypes {
268 	NFS_DES3_CBC_SHA1_KD = 16,
269 	NFS_AES128_CTS_HMAC_SHA1_96 = 17,
270 	NFS_AES256_CTS_HMAC_SHA1_96 = 18
271 } nfs_supported_kerberos_etypes;
272 
273 /* Structure to hold an array of kerberos enctypes to allow on a mount */
274 #define NFS_MAX_ETYPES 3
275 struct nfs_etype {
276 	uint32_t count;
277 	uint32_t selected;  /* index in etypes that is being used. Set to count if nothing has been selected */
278 	nfs_supported_kerberos_etypes etypes[NFS_MAX_ETYPES];
279 };
280 
281 /*
282  * Old-style arguments to mount NFS
283  */
284 #define NFS_ARGSVERSION 6               /* change when nfs_args changes */
285 struct nfs_args {
286 	int             version;        /* args structure version number */
287 #ifdef KERNEL
288 	user32_addr_t addr;             /* file server address */
289 #else
290 	struct sockaddr *addr;          /* file server address */
291 #endif
292 	uint8_t         addrlen;        /* length of address */
293 	int             sotype;         /* Socket type */
294 	int             proto;          /* and Protocol */
295 #ifdef KERNEL
296 	user32_addr_t fh;               /* File handle to be mounted */
297 #else
298 	u_char          *fh;            /* File handle to be mounted */
299 #endif
300 	int             fhsize;         /* Size, in bytes, of fh */
301 	int             flags;          /* flags */
302 	int             wsize;          /* write size in bytes */
303 	int             rsize;          /* read size in bytes */
304 	int             readdirsize;    /* readdir size in bytes */
305 	int             timeo;          /* initial timeout in .1 secs */
306 	int             retrans;        /* times to retry send */
307 	int             maxgrouplist;   /* Max. size of group list */
308 	int             readahead;      /* # of blocks to readahead */
309 	int             leaseterm;      /* obsolete: Term (sec) of lease */
310 	int             deadthresh;     /* obsolete: Retrans threshold */
311 #ifdef KERNEL
312 	user32_addr_t hostname; /* server's name */
313 #else
314 	char            *hostname;      /* server's name */
315 #endif
316 	/* NFS_ARGSVERSION 3 ends here */
317 	int             acregmin;       /* reg file min attr cache timeout */
318 	int             acregmax;       /* reg file max attr cache timeout */
319 	int             acdirmin;       /* dir min attr cache timeout */
320 	int             acdirmax;       /* dir max attr cache timeout */
321 	/* NFS_ARGSVERSION 4 ends here */
322 	uint32_t        auth;           /* security mechanism flavor */
323 	/* NFS_ARGSVERSION 5 ends here */
324 	uint32_t        deadtimeout;    /* secs until unresponsive mount considered dead */
325 };
326 
327 /* incremental size additions in each version of nfs_args */
328 #define NFS_ARGSVERSION4_INCSIZE        (4 * sizeof(int))
329 #define NFS_ARGSVERSION5_INCSIZE        (sizeof(uint32_t))
330 #define NFS_ARGSVERSION6_INCSIZE        (sizeof(uint32_t))
331 
332 #ifdef KERNEL
333 /* LP64 version of nfs_args.  all pointers and longs
334  * grow when we're dealing with a 64-bit process.
335  * WARNING - keep in sync with nfs_args
336  */
337 struct user_nfs_args {
338 	int             version;        /* args structure version number */
339 	user_addr_t     addr __attribute((aligned(8)));         /* file server address */
340 	uint8_t         addrlen;        /* length of address */
341 	int             sotype;         /* Socket type */
342 	int             proto;          /* and Protocol */
343 	user_addr_t     fh __attribute((aligned(8)));           /* File handle to be mounted */
344 	int             fhsize;         /* Size, in bytes, of fh */
345 	int             flags;          /* flags */
346 	int             wsize;          /* write size in bytes */
347 	int             rsize;          /* read size in bytes */
348 	int             readdirsize;    /* readdir size in bytes */
349 	int             timeo;          /* initial timeout in .1 secs */
350 	int             retrans;        /* times to retry send */
351 	int             maxgrouplist;   /* Max. size of group list */
352 	int             readahead;      /* # of blocks to readahead */
353 	int             leaseterm;      /* obsolete: Term (sec) of lease */
354 	int             deadthresh;     /* obsolete: Retrans threshold */
355 	user_addr_t     hostname __attribute((aligned(8)));     /* server's name */
356 	/* NFS_ARGSVERSION 3 ends here */
357 	int             acregmin;       /* reg file min attr cache timeout */
358 	int             acregmax;       /* reg file max attr cache timeout */
359 	int             acdirmin;       /* dir min attr cache timeout */
360 	int             acdirmax;       /* dir max attr cache timeout */
361 	/* NFS_ARGSVERSION 4 ends here */
362 	uint32_t        auth;           /* security mechanism flavor */
363 	/* NFS_ARGSVERSION 5 ends here */
364 	uint32_t        deadtimeout;    /* secs until unresponsive mount considered dead */
365 };
366 #endif // KERNEL
367 
368 /*
369  * Old-style NFS mount option flags
370  */
371 #define NFSMNT_SOFT             0x00000001  /* soft mount (hard is default) */
372 #define NFSMNT_WSIZE            0x00000002  /* set write size */
373 #define NFSMNT_RSIZE            0x00000004  /* set read size */
374 #define NFSMNT_TIMEO            0x00000008  /* set initial timeout */
375 #define NFSMNT_RETRANS          0x00000010  /* set number of request retries */
376 #define NFSMNT_MAXGRPS          0x00000020  /* set maximum grouplist size */
377 #define NFSMNT_INT              0x00000040  /* allow interrupts on hard mount */
378 #define NFSMNT_NOCONN           0x00000080  /* Don't Connect the socket */
379 #define NFSMNT_NONEGNAMECACHE   0x00000100  /* Don't do negative name caching */
380 #define NFSMNT_NFSV3            0x00000200  /* Use NFS Version 3 protocol */
381 #define NFSMNT_NFSV4            0x00000400  /* Use NFS Version 4 protocol */
382 #define NFSMNT_DUMBTIMR         0x00000800  /* Don't estimate rtt dynamically */
383 #define NFSMNT_DEADTIMEOUT      0x00001000  /* unmount after a period of unresponsiveness */
384 #define NFSMNT_READAHEAD        0x00002000  /* set read ahead */
385 #define NFSMNT_CALLUMNT         0x00004000  /* call MOUNTPROC_UMNT on unmount */
386 #define NFSMNT_RESVPORT         0x00008000  /* Allocate a reserved port */
387 #define NFSMNT_RDIRPLUS         0x00010000  /* Use Readdirplus for V3 */
388 #define NFSMNT_READDIRSIZE      0x00020000  /* Set readdir size */
389 #define NFSMNT_NOLOCKS          0x00040000  /* don't support file locking */
390 #define NFSMNT_LOCALLOCKS       0x00080000  /* do file locking locally on client */
391 #define NFSMNT_ACREGMIN         0x00100000  /* reg min attr cache timeout */
392 #define NFSMNT_ACREGMAX         0x00200000  /* reg max attr cache timeout */
393 #define NFSMNT_ACDIRMIN         0x00400000  /* dir min attr cache timeout */
394 #define NFSMNT_ACDIRMAX         0x00800000  /* dir max attr cache timeout */
395 #define NFSMNT_SECFLAVOR        0x01000000  /* Use security flavor */
396 #define NFSMNT_SECSYSOK         0x02000000  /* Server can support auth sys */
397 #define NFSMNT_MUTEJUKEBOX      0x04000000  /* don't treat jukebox errors as unresponsive */
398 #define NFSMNT_NOQUOTA          0x08000000  /* don't support QUOTA requests */
399 
400 
401 /*
402  * fs.nfs sysctl(3) NFS_MOUNTINFO defines
403  */
404 #define NFS_MOUNT_INFO_VERSION  0       /* nfsstat mount information version */
405 #define NFS_MIATTR_BITMAP_LEN   1       /* length of mount info attributes bitmap */
406 #define NFS_MIFLAG_BITMAP_LEN   1       /* length of mount info flags bitmap */
407 
408 /* NFS mount info attributes */
409 #define NFS_MIATTR_FLAGS                0       /* mount info flags bitmap (MIFLAG_*) */
410 #define NFS_MIATTR_ORIG_ARGS            1       /* original mount args passed into mount call */
411 #define NFS_MIATTR_CUR_ARGS             2       /* current mount args values */
412 #define NFS_MIATTR_CUR_LOC_INDEX        3       /* current fs location index */
413 
414 /* NFS mount info flags */
415 #define NFS_MIFLAG_DEAD         0       /* mount is dead */
416 #define NFS_MIFLAG_NOTRESP      1       /* server is unresponsive */
417 #define NFS_MIFLAG_RECOVERY     2       /* mount in recovery */
418 
419 
420 /*
421  * Structures for the nfssvc(2) syscall. Not that anyone but nfsd
422  * should ever try and use it.
423  */
424 struct nfsd_args {
425 	int     sock;           /* Socket to serve */
426 #ifdef KERNEL
427 	user32_addr_t   name;           /* Client addr for connection based sockets */
428 #else
429 	caddr_t name;           /* Client addr for connection based sockets */
430 #endif
431 	int     namelen;        /* Length of name */
432 };
433 
434 #ifdef KERNEL
435 /* LP64 version of nfsd_args.  all pointers and longs
436  * grow when we're dealing with a 64-bit process.
437  * WARNING - keep in sync with nfsd_args
438  */
439 struct user_nfsd_args {
440 	int             sock;           /* Socket to serve */
441 	user_addr_t     name __attribute((aligned(8)));         /* Client addr for connection based sockets */
442 	int             namelen;        /* Length of name */
443 };
444 
445 #endif // KERNEL
446 
447 /*
448  * NFS Server File Handle structures
449  */
450 
451 /* NFS export handle identifies which NFS export */
452 #define NFS_FH_VERSION  0x4e580000              /* 'NX00' */
453 struct nfs_exphandle {
454 	uint32_t        nxh_version;            /* data structure version */
455 	uint32_t        nxh_fsid;               /* File System Export ID */
456 	uint32_t        nxh_expid;              /* Export ID */
457 	uint16_t        nxh_flags;              /* export handle flags */
458 	uint8_t         nxh_reserved;           /* future use */
459 	uint32_t        nxh_fidlen;             /* length of File ID */
460 };
461 
462 /* nxh_flags */
463 #define NXHF_INVALIDFH          0x0001          /* file handle is invalid */
464 
465 #define NFS_MAX_FID_SIZE        (NFS_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
466 #define NFSV4_MAX_FID_SIZE      (NFSV4_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
467 #define NFSV3_MAX_FID_SIZE      (NFSV3_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
468 #define NFSV2_MAX_FID_SIZE      (NFSV2_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
469 
470 /* NFS server internal view of fhandle_t */
471 /* The first sizeof(fhandle_t) bytes must match what goes into fhandle_t. */
472 /* (fhp is used to allow use of an external buffer) */
473 struct nfs_filehandle {
474 	uint32_t                nfh_len;        /* total length of file handle */
475 	struct nfs_exphandle    nfh_xh;         /* export handle */
476 	unsigned char           nfh_fid[NFS_MAX_FID_SIZE]; /* File ID */
477 	unsigned char           *nfh_fhp;       /* pointer to file handle */
478 };
479 
480 /*
481  * NFS export data structures
482  */
483 
484 /* Structure to hold an array of security flavors */
485 #define NX_MAX_SEC_FLAVORS 5
486 struct nfs_sec {
487 	int count;
488 	uint32_t flavors[NX_MAX_SEC_FLAVORS];
489 };
490 
491 struct nfs_export_net_args {
492 	uint32_t                nxna_flags;     /* export flags */
493 	struct xucred           nxna_cred;      /* mapped credential for root/all user */
494 	struct sockaddr_storage nxna_addr;      /* net address to which exported */
495 	struct sockaddr_storage nxna_mask;      /* mask for net address */
496 	struct nfs_sec          nxna_sec;       /* security mechanism flavors */
497 };
498 
499 struct nfs_export_args {
500 	uint32_t                nxa_fsid;       /* export FS ID */
501 	uint32_t                nxa_expid;      /* export ID */
502 #ifdef KERNEL
503 	user32_addr_t           nxa_fspath;     /* export FS path */
504 	user32_addr_t           nxa_exppath;    /* export sub-path */
505 #else
506 	char                    *nxa_fspath;    /* export FS path */
507 	char                    *nxa_exppath;   /* export sub-path */
508 #endif
509 	uint32_t                nxa_flags;      /* export arg flags */
510 	uint32_t                nxa_netcount;   /* #entries in ex_nets array */
511 #ifdef KERNEL
512 	user32_addr_t           nxa_nets;       /* array of net args */
513 #else
514 	struct nfs_export_net_args *nxa_nets;   /* array of net args */
515 #endif
516 };
517 
518 #ifdef KERNEL
519 /* LP64 version of export_args */
520 
521 struct user_nfs_export_args {
522 	uint32_t                nxa_fsid;       /* export FS ID */
523 	uint32_t                nxa_expid;      /* export ID */
524 	user_addr_t             nxa_fspath;     /* export FS path */
525 	user_addr_t             nxa_exppath;    /* export sub-path */
526 	uint32_t                nxa_flags;      /* export arg flags */
527 	uint32_t                nxa_netcount;   /* #entries in ex_nets array */
528 	user_addr_t             nxa_nets;       /* array of net args */
529 };
530 
531 #endif /* KERNEL */
532 
533 /* nfs export arg flags */
534 #define NXA_DELETE              0x0001  /* delete the specified export(s) */
535 #define NXA_ADD                 0x0002  /* add the specified export(s) */
536 #define NXA_REPLACE             0x0003  /* delete and add the specified export(s) */
537 #define NXA_DELETE_ALL          0x0004  /* delete all exports */
538 #define NXA_OFFLINE             0x0008  /* export is offline */
539 #define NXA_CHECK               0x0010  /* check if exportable */
540 
541 /* export option flags */
542 #define NX_READONLY             0x0001  /* exported read-only */
543 #define NX_DEFAULTEXPORT        0x0002  /* exported to the world */
544 #define NX_MAPROOT              0x0004  /* map root access to anon credential */
545 #define NX_MAPALL               0x0008  /* map all access to anon credential */
546 #define NX_32BITCLIENTS         0x0020  /* restrict directory cookies to 32 bits */
547 #define NX_OFFLINE              0x0040  /* export is offline */
548 #define NX_MANGLEDNAMES         0x0080  /* export will return mangled names for names > 255 bytes */
549 
550 /*
551  * fs.nfs sysctl(3) export stats record structures
552  */
553 #define NFS_EXPORT_STAT_REC_VERSION 1   /* export stat record version */
554 #define NFS_USER_STAT_REC_VERSION 1     /* active user list record version */
555 
556 /* descriptor describing following records */
557 struct nfs_export_stat_desc {
558 	uint32_t rec_vers;              /* version of export stat records */
559 	uint64_t rec_count;             /* total record count */
560 }__attribute__((__packed__));
561 
562 /* export stat record containing path and stat counters */
563 struct nfs_export_stat_rec {
564 	char     path[RPCMNT_PATHLEN + 1];
565 	uint64_t ops;           /* Count of NFS Requests received for this export */
566 	uint64_t bytes_read;    /* Count of bytes read from this export */
567 	uint64_t bytes_written; /* Count of bytes written to this export */
568 }__attribute__((__packed__));
569 
570 /* Active user list stat buffer descriptor */
571 struct nfs_user_stat_desc {
572 	uint32_t rec_vers;      /* version of active user stat records */
573 	uint32_t rec_count;     /* total record count */
574 }__attribute__((__packed__));
575 
576 /* Active user list user stat record format */
577 struct nfs_user_stat_user_rec {
578 	u_char                  rec_type;
579 	uid_t                   uid;
580 	struct sockaddr_storage sock;
581 	uint64_t                ops;
582 	uint64_t                bytes_read;
583 	uint64_t                bytes_written;
584 	time_t                  tm_start;
585 	time_t                  tm_last;
586 }__attribute__((__packed__));
587 
588 /* Active user list path record format */
589 struct nfs_user_stat_path_rec {
590 	u_char  rec_type;
591 	char    path[RPCMNT_PATHLEN + 1];
592 }__attribute__((__packed__));
593 
594 /* Defines for rec_type field of
595  * nfs_user_stat_rec & nfs_user_stat_rec
596  * data structures
597  */
598 #define NFS_USER_STAT_USER_REC  0
599 #define NFS_USER_STAT_PATH_REC  1
600 
601 
602 #ifdef XNU_KERNEL_PRIVATE
603 struct nfs_exportfs;
604 
605 struct nfs_export_options {
606 	uint32_t                nxo_flags;      /* export options */
607 	kauth_cred_t            nxo_cred;       /* mapped credential */
608 	struct nfs_sec          nxo_sec;        /* security mechanism flavors */
609 };
610 
611 /* Network address lookup element and individual export options */
612 struct nfs_netopt {
613 	struct radix_node               no_rnodes[2];   /* radix tree glue */
614 	struct nfs_export_options       no_opt;         /* export options */
615 	struct sockaddr                 *no_addr;       /* net address to which exported */
616 	struct sockaddr                 *no_mask;       /* mask for net address */
617 };
618 
619 /* statistic counters for each exported directory
620  *
621  * Since 64-bit atomic operations are not available on 32-bit platforms,
622  * 64-bit counters are implemented using 32-bit integers and 32-bit
623  * atomic operations
624  */
625 typedef struct nfsstatcount64 {
626 	uint32_t        hi;
627 	uint32_t        lo;
628 } nfsstatcount64;
629 
630 struct nfs_export_stat_counters {
631 	struct nfsstatcount64 ops;              /* Count of NFS Requests received for this export  */
632 	struct nfsstatcount64 bytes_read;       /* Count of bytes read from this export */
633 	struct nfsstatcount64 bytes_written;    /* Count of bytes written to his export */
634 };
635 
636 /* Macro for updating nfs export stat counters */
637 #define NFSStatAdd64(PTR, VAL) \
638 	do { \
639 	        uint32_t NFSSA_OldValue = \
640 	        OSAddAtomic((VAL), &(PTR)->lo); \
641 	        if ((NFSSA_OldValue + (VAL)) < NFSSA_OldValue) \
642 	                OSAddAtomic(1, &(PTR)->hi); \
643 	} while (0)
644 
645 /* Some defines for dealing with active user list stats */
646 #define NFSRV_USER_STAT_DEF_MAX_NODES 1024      /* default active user list size limit */
647 #define NFSRV_USER_STAT_DEF_IDLE_SEC  7200      /* default idle seconds (node no longer considered active) */
648 
649 /* active user list globals */
650 extern uint32_t nfsrv_user_stat_enabled;                /* enable/disable active user list */
651 extern uint32_t nfsrv_user_stat_node_count;             /* current count of user stat nodes */
652 extern uint32_t nfsrv_user_stat_max_idle_sec;   /* idle seconds (node no longer considered active) */
653 extern uint32_t nfsrv_user_stat_max_nodes;              /* active user list size limit */
654 extern lck_grp_t nfsrv_active_user_mutex_group;
655 
656 /* An active user node represented in the kernel */
657 struct nfs_user_stat_node {
658 	TAILQ_ENTRY(nfs_user_stat_node) lru_link;
659 	LIST_ENTRY(nfs_user_stat_node)  hash_link;
660 	uid_t                   uid;
661 	struct sockaddr_storage sock;
662 	uint64_t                ops;
663 	uint64_t                bytes_read;
664 	uint64_t                bytes_written;
665 	time_t                  tm_start;
666 	time_t                  tm_last;
667 };
668 
669 /* Hash table for active user nodes */
670 #define NFS_USER_STAT_HASH_SIZE 16      /* MUST be a power of 2 */
671 #define NFS_USER_STAT_HASH(userhashtbl, uid) \
672 	        &((userhashtbl)[(uid) & (NFS_USER_STAT_HASH_SIZE - 1)])
673 
674 TAILQ_HEAD(nfs_user_stat_lru_head, nfs_user_stat_node);
675 LIST_HEAD(nfs_user_stat_hashtbl_head, nfs_user_stat_node);
676 
677 /* Active user list data structure */
678 /* One per exported directory */
679 struct nfs_active_user_list {
680 	struct nfs_user_stat_lru_head           user_lru;
681 	struct nfs_user_stat_hashtbl_head       user_hashtbl[NFS_USER_STAT_HASH_SIZE];
682 	uint32_t                                node_count;
683 	lck_mtx_t user_mutex;
684 };
685 
686 
687 /* Network export information */
688 /* one of these for each exported directory */
689 struct nfs_export {
690 	LIST_ENTRY(nfs_export)          nx_next;        /* FS export list */
691 	LIST_ENTRY(nfs_export)          nx_hash;        /* export hash chain */
692 	struct nfs_export               *nx_parent;     /* parent export */
693 	uint32_t                        nx_id;          /* export ID */
694 	uint32_t                        nx_flags;       /* export flags */
695 	struct nfs_exportfs             *nx_fs;         /* exported file system */
696 	char                            *nx_path;       /* exported file system sub-path */
697 	struct nfs_filehandle           nx_fh;          /* export root file handle */
698 	struct nfs_export_options       nx_defopt;      /* default options */
699 	uint32_t                        nx_expcnt;      /* # exports in table */
700 	struct radix_node_head          *nx_rtable[AF_MAX + 1]; /* table of exports (netopts) */
701 	struct nfs_export_stat_counters nx_stats;       /* statistic counters for this exported directory */
702 	struct nfs_active_user_list     nx_user_list;   /* Active User List for this exported directory */
703 	struct timeval                  nx_exptime;     /* time of export for write verifier */
704 };
705 
706 /* NFS exported file system info */
707 /* one of these for each exported file system */
708 struct nfs_exportfs {
709 	LIST_ENTRY(nfs_exportfs)        nxfs_next;      /* exported file system list */
710 	uint32_t                        nxfs_id;        /* exported file system ID */
711 	char                            *nxfs_path;     /* exported file system path */
712 	LIST_HEAD(, nfs_export)          nxfs_exports;   /* list of exports for this file system */
713 };
714 
715 extern LIST_HEAD(nfsrv_expfs_list, nfs_exportfs) nfsrv_exports;
716 extern lck_rw_t nfsrv_export_rwlock;  // lock for export data structures
717 #define NFSRVEXPHASHSZ  64
718 #define NFSRVEXPHASHVAL(FSID, EXPID)    \
719 	(((FSID) >> 24) ^ ((FSID) >> 16) ^ ((FSID) >> 8) ^ (EXPID))
720 #define NFSRVEXPHASH(FSID, EXPID)       \
721 	(&nfsrv_export_hashtbl[NFSRVEXPHASHVAL((FSID),(EXPID)) & nfsrv_export_hash])
722 extern LIST_HEAD(nfsrv_export_hashhead, nfs_export) * nfsrv_export_hashtbl;
723 extern u_long nfsrv_export_hash;
724 
725 #if CONFIG_FSE
726 /*
727  * NFS server file mod fsevents
728  */
729 struct nfsrv_fmod {
730 	LIST_ENTRY(nfsrv_fmod)  fm_link;
731 	vnode_t                 fm_vp;
732 	struct vfs_context      fm_context;
733 	uint64_t                fm_deadline;
734 };
735 
736 #define NFSRVFMODHASHSZ 128
737 #define NFSRVFMODHASH(vp) (((uintptr_t) vp) & nfsrv_fmod_hash)
738 extern LIST_HEAD(nfsrv_fmod_hashhead, nfsrv_fmod) * nfsrv_fmod_hashtbl;
739 extern u_long nfsrv_fmod_hash;
740 extern lck_mtx_t nfsrv_fmod_mutex;
741 extern int nfsrv_fmod_pending, nfsrv_fsevents_enabled;
742 #endif
743 
744 extern int nfsrv_async, nfsrv_export_hash_size,
745     nfsrv_reqcache_size, nfsrv_sock_max_rec_queue_length;
746 extern uint32_t nfsrv_gss_context_ttl;
747 extern struct nfsrvstats nfsrvstats;
748 #define NFS_UC_Q_DEBUG
749 #ifdef NFS_UC_Q_DEBUG
750 extern int nfsrv_uc_use_proxy;
751 extern uint32_t nfsrv_uc_queue_limit;
752 extern uint32_t nfsrv_uc_queue_max_seen;
753 extern volatile uint32_t nfsrv_uc_queue_count;
754 #endif
755 
756 #endif // XNU_KERNEL_PRIVATE
757 
758 /*
759  * XXX to allow amd to include nfs.h without nfsproto.h
760  */
761 #ifdef NFS_NPROCS
762 /*
763  * Stats structure
764  */
765 struct nfsclntstats {
766 	uint64_t        attrcache_hits;
767 	uint64_t        attrcache_misses;
768 	uint64_t        lookupcache_hits;
769 	uint64_t        lookupcache_misses;
770 	uint64_t        direofcache_hits;
771 	uint64_t        direofcache_misses;
772 	uint64_t        biocache_reads;
773 	uint64_t        read_bios;
774 	uint64_t        read_physios;
775 	uint64_t        biocache_writes;
776 	uint64_t        write_bios;
777 	uint64_t        write_physios;
778 	uint64_t        biocache_readlinks;
779 	uint64_t        readlink_bios;
780 	uint64_t        biocache_readdirs;
781 	uint64_t        readdir_bios;
782 	uint64_t        rpccntv3[NFS_NPROCS];
783 	uint64_t        opcntv4[NFS_OP_COUNT];
784 	uint64_t        rpcretries;
785 	uint64_t        rpcrequests;
786 	uint64_t        rpctimeouts;
787 	uint64_t        rpcunexpected;
788 	uint64_t        rpcinvalid;
789 	uint64_t        pageins;
790 	uint64_t        pageouts;
791 };
792 
793 struct nfsrvstats {
794 	uint64_t        srvrpccntv3[NFS_NPROCS];
795 	uint64_t        srvrpc_errs;
796 	uint64_t        srv_errs;
797 	uint64_t        srvcache_inproghits;
798 	uint64_t        srvcache_idemdonehits;
799 	uint64_t        srvcache_nonidemdonehits;
800 	uint64_t        srvcache_misses;
801 	uint64_t        srvvop_writes;
802 };
803 
804 #endif
805 
806 /*
807  * Flags for nfssvc() system call.
808  */
809 #define NFSSVC_NFSD             0x004
810 #define NFSSVC_ADDSOCK          0x008
811 #define NFSSVC_EXPORTSTATS      0x010    /* gets exported directory stats */
812 #define NFSSVC_USERSTATS        0x020    /* gets exported directory active user stats */
813 #define NFSSVC_USERCOUNT        0x040    /* gets current count of active nfs users */
814 #define NFSSVC_ZEROSTATS        0x080    /* zero nfs server statistics */
815 #define NFSSVC_SRVSTATS         0x100    /* struct: struct nfsrvstats */
816 #define NFSSVC_EXPORT           0x200
817 
818 /*
819  * The structure that lockd hands the kernel for each lock answer.
820  */
821 #define LOCKD_ANS_VERSION       2
822 struct lockd_ans {
823 	int             la_version;             /* lockd_ans version */
824 	int             la_errno;               /* return status */
825 	u_int64_t       la_xid;                 /* unique message transaction ID */
826 	int             la_flags;               /* answer flags */
827 	pid_t           la_pid;                 /* pid of lock requester/owner */
828 	off_t           la_start;               /* lock starting offset */
829 	off_t           la_len;                 /* lock length */
830 	int             la_fh_len;              /* The file handle length. */
831 	u_int8_t        la_fh[NFSV3_MAX_FH_SIZE];/* The file handle. */
832 };
833 
834 /*
835  * The structure that lockd hands the kernel for each notify.
836  */
837 #define LOCKD_NOTIFY_VERSION    1
838 struct lockd_notify {
839 	int                     ln_version;             /* lockd_notify version */
840 	int                     ln_flags;               /* notify flags */
841 	int                     ln_pad;                 /* (for alignment) */
842 	int                     ln_addrcount;           /* # of addresss */
843 	struct sockaddr_storage *ln_addr;               /* List of addresses. */
844 };
845 
846 #include <sys/_types/_guid_t.h> /* for guid_t below */
847 #define MAXIDNAMELEN            1024
848 struct nfs_testmapid {
849 	uint32_t                ntm_lookup;     /* lookup name 2 id or id 2 name */
850 	uint32_t                ntm_grpflag;    /* Is this a group or user maping */
851 	uint32_t                ntm_id;         /* id to map or return */
852 	uint32_t                pad;
853 	guid_t                  ntm_guid;       /* intermidiate guid used in conversion */
854 	char                    ntm_name[MAXIDNAMELEN]; /* name to map or return */
855 };
856 
857 #define NTM_ID2NAME     0
858 #define NTM_NAME2ID     1
859 #define NTM_NAME2GUID   2
860 #define NTM_GUID2NAME   3
861 
862 /*
863  * Flags for nfsclnt() system call.
864  */
865 #define NFSCLNT_LOCKDANS        _IOW('n', 101, struct lockd_ans)
866 #define NFSCLNT_LOCKDNOTIFY     _IOW('n', 102, struct lockd_notify)
867 #define NFSCLNT_TESTIDMAP       _IOWR('n', 103, struct nfs_testmapid)
868 
869 /* nfsclnt() system call character device */
870 #define NFSCLNT_DEVICE         "nfsclnt"
871 
872 /* nfsclnt() system call */
873 int nfsclnt(unsigned long request, void *argstructp);
874 
875 /*
876  * fs.nfs sysctl(3) identifiers
877  */
878 #define NFS_NFSSTATS        1       /* struct: struct nfsclntstats */
879 #define NFS_MOUNTINFO       6       /* gets information about an NFS mount */
880 #define NFS_NFSZEROSTATS    7       /* zero nfs client statistics */
881 
882 #ifndef NFS_WDELAYHASHSIZ
883 #define NFS_WDELAYHASHSIZ 16    /* and with this */
884 #endif
885 
886 #ifdef KERNEL_PRIVATE
887 
888 /* NFS hooks */
889 
890 /* NFS hooks in struct */
891 struct nfs_hooks_in {
892 	int       (*f_vinvalbuf)(vnode_t, int, vfs_context_t, int);
893 	int       (*f_buf_page_inval)(vnode_t, off_t);
894 };
895 
896 /* NFS hooks out struct */
897 struct nfs_hooks_out {
898 	void *    (*f_get_bsdthreadtask_info)(thread_t);
899 };
900 
901 /* NFS hooks registration functions */
902 void nfs_register_hooks(struct nfs_hooks_in *, struct nfs_hooks_out *);
903 void nfs_unregister_hooks(void);
904 
905 #ifdef XNU_KERNEL_PRIVATE
906 
907 /* NFS hooks wrappers */
908 int           nfs_vinvalbuf(vnode_t, int, vfs_context_t, int);
909 int           nfs_buf_page_inval(vnode_t, off_t);
910 
911 #endif /* XNU_KERNEL_PRIVATE */
912 
913 /* Debug support */
914 #define __NFS_DEBUG_LEVEL(dbgctl)              ((dbgctl) & 0xf)
915 #define __NFS_DEBUG_FACILITY(dbgctl)           (((dbgctl) >> 4) & 0xfff)
916 #define __NFS_DEBUG_FLAGS(dbgctl)              (((dbgctl) >> 16) & 0xf)
917 #define __NFS_DEBUG_VALUE(dbgctl)              (((dbgctl) >> 20) & 0xfff)
918 #define __NFS_IS_DBG(dbgctl, fac, lev)         (__builtin_expect((__NFS_DEBUG_FACILITY(dbgctl) & (fac)) && ((lev) <= __NFS_DEBUG_LEVEL(dbgctl)), 0))
919 #define __NFS_DBG(dbgctl, fac, lev, fmt, ...)  nfs_printf((dbgctl), (fac), (lev), "%s: %d: " fmt, __func__, __LINE__, ## __VA_ARGS__)
920 void nfs_printf(unsigned int, unsigned int, unsigned int, const char *, ...) __printflike(4, 5);
921 void nfs_dump_mbuf(const char *, int, const char *, mbuf_t);
922 
923 /*
924  * NFS mbuf chain structure used for managing the building/dissection of RPCs
925  */
926 struct nfsm_chain {
927 	mbuf_t          nmc_mhead;      /* mbuf chain head */
928 	mbuf_t          nmc_mcur;       /* current mbuf */
929 	caddr_t         nmc_ptr;        /* pointer into current mbuf */
930 	size_t          nmc_left;       /* bytes remaining in current mbuf */
931 	uint32_t        nmc_flags;      /* flags for this nfsm_chain */
932 };
933 #define NFSM_CHAIN_FLAG_ADD_CLUSTERS    0x1     /* always add mbuf clusters */
934 
935 extern size_t nfs_mbuf_mhlen, nfs_mbuf_minclsize;
936 
937 /*
938  * Each retransmission of an RPCSEC_GSS request
939  * has an additional sequence number.
940  */
941 struct gss_seq {
942 	SLIST_ENTRY(gss_seq)    gss_seqnext;
943 	uint32_t                gss_seqnum;
944 };
945 
946 #endif /* KERNEL_PRIVATE */
947 
948 #ifdef XNU_KERNEL_PRIVATE
949 
950 extern uint32_t nfsrv_debug_ctl;
951 
952 /* Server debug support */
953 #define NFSRV_FAC_GSS                    0x001
954 #define NFSRV_FAC_SRV                    0x002
955 #define NFSRV_DEBUG_LEVEL                __NFS_DEBUG_LEVEL(nfsrv_debug_ctl)
956 #define NFSRV_DEBUG_FACILITY             __NFS_DEBUG_FACILITY(nfsrv_debug_ctl)
957 #define NFSRV_DEBUG_FLAGS                __NFS_DEBUG_FLAGS(nfsrv_debug_ctl)
958 #define NFSRV_DEBUG_VALUE                __NFS_DEBUG_VALUE(nfsrv_debug_ctl)
959 #define NFSRV_IS_DBG(fac, lev)           __NFS_IS_DBG(nfsrv_debug_ctl, fac, lev)
960 #define NFSRV_DBG(fac, lev, fmt, ...)    __NFS_DBG(nfsrv_debug_ctl, fac, lev, fmt, ## __VA_ARGS__)
961 
962 #ifdef MALLOC_DECLARE
963 MALLOC_DECLARE(M_NFSD);
964 #endif
965 
966 struct nameidata;
967 struct nfsrv_uc_arg;
968 
969 /*
970  * One nfsrv_sock structure is maintained for each socket the
971  * server is servicing requests on.
972  */
973 struct nfsrv_sock {
974 	TAILQ_ENTRY(nfsrv_sock) ns_chain;       /* List of all nfsrv_sock's */
975 	TAILQ_ENTRY(nfsrv_sock) ns_svcq;        /* List of sockets needing servicing */
976 	TAILQ_ENTRY(nfsrv_sock) ns_wgq;         /* List of sockets with a pending write gather */
977 	struct nfsrv_uc_arg *ns_ua;             /* Opaque pointer to upcall */
978 	lck_rw_t        ns_rwlock;              /* lock for most fields */
979 	socket_t        ns_so;
980 	mbuf_t          ns_nam;
981 	mbuf_t          ns_raw;
982 	mbuf_t          ns_rawend;
983 	mbuf_t          ns_rec;
984 	mbuf_t          ns_recend;
985 	mbuf_t          ns_frag;
986 	int             ns_flag;
987 	int             ns_sotype;
988 	size_t          ns_cc;
989 	size_t          ns_reclen;
990 	int             ns_reccnt;
991 	int             ns_sobufsize;
992 	u_int32_t       ns_sref;
993 	time_t          ns_timestamp;           /* socket timestamp */
994 	lck_mtx_t       ns_wgmutex;             /* mutex for write gather fields */
995 	time_t          ns_wgtime;              /* next Write deadline (usec) */
996 	LIST_HEAD(, nfsrv_descript) ns_tq;      /* Write gather lists */
997 	LIST_HEAD(nfsrv_wg_delayhash, nfsrv_descript) ns_wdelayhashtbl[NFS_WDELAYHASHSIZ];
998 };
999 
1000 /* Bits for "ns_flag" */
1001 #define SLP_VALID       0x0001 /* nfs sock valid */
1002 #define SLP_DOREC       0x0002 /* nfs sock has received data to process */
1003 #define SLP_NEEDQ       0x0004 /* network socket has data to receive */
1004 #define SLP_DISCONN     0x0008 /* socket needs to be zapped */
1005 #define SLP_GETSTREAM   0x0010 /* currently in nfsrv_getstream() */
1006 #define SLP_LASTFRAG    0x0020 /* on last fragment of RPC record */
1007 #define SLP_DOWRITES    0x0040 /* nfs sock has gathered writes to service */
1008 #define SLP_WORKTODO    0x004e /* mask of all "work to do" flags */
1009 #define SLP_ALLFLAGS    0x007f
1010 #define SLP_WAITQ       0x4000 /* nfs sock is on the wait queue */
1011 #define SLP_WORKQ       0x8000 /* nfs sock is on the work queue */
1012 #define SLP_QUEUED      0xc000 /* nfs sock is on a queue */
1013 
1014 #define SLPNOLIST ((struct nfsrv_sock *)0xdeadbeef)     /* sentinel value for sockets not in the nfsrv_sockwg list */
1015 
1016 extern struct nfsrv_sock *nfsrv_udpsock, *nfsrv_udp6sock;
1017 
1018 /*
1019  * global NFS server socket lists:
1020  *
1021  * nfsrv_socklist - list of all sockets (ns_chain)
1022  * nfsrv_sockwait - sockets w/new data waiting to be worked on (ns_svcq)
1023  * nfsrv_sockwork - sockets being worked on which may have more work to do (ns_svcq)
1024  * nfsrv_sockwg - sockets with pending write gather input (ns_wgq)
1025  */
1026 extern TAILQ_HEAD(nfsrv_sockhead, nfsrv_sock) nfsrv_socklist, nfsrv_sockwg,
1027 nfsrv_sockwait, nfsrv_sockwork;
1028 
1029 /* lock groups for nfsrv_sock's */
1030 extern lck_grp_t nfsrv_slp_rwlock_group;
1031 extern lck_grp_t nfsrv_slp_mutex_group;
1032 
1033 /*
1034  * One of these structures is allocated for each nfsd.
1035  */
1036 struct nfsd {
1037 	TAILQ_ENTRY(nfsd)       nfsd_chain;     /* List of all nfsd's */
1038 	TAILQ_ENTRY(nfsd)       nfsd_queue;     /* List of waiting nfsd's */
1039 	int                     nfsd_flag;      /* NFSD_ flags */
1040 	struct nfsrv_sock       *nfsd_slp;      /* Current socket */
1041 	struct nfsrv_descript   *nfsd_nd;       /* Associated nfsrv_descript */
1042 };
1043 
1044 /* Bits for "nfsd_flag" */
1045 #define NFSD_WAITING    0x01
1046 #define NFSD_REQINPROG  0x02
1047 
1048 /*
1049  * This structure is used by the server for describing each request.
1050  * Some fields are used only when write request gathering is performed.
1051  */
1052 struct nfsrv_descript {
1053 	time_t                  nd_time;        /* Write deadline (usec) */
1054 	off_t                   nd_off;         /* Start byte offset */
1055 	off_t                   nd_eoff;        /* and end byte offset */
1056 	LIST_ENTRY(nfsrv_descript) nd_hash;     /* Hash list */
1057 	LIST_ENTRY(nfsrv_descript) nd_tq;       /* and timer list */
1058 	LIST_HEAD(, nfsrv_descript) nd_coalesce; /* coalesced writes */
1059 	struct nfsm_chain       nd_nmreq;       /* Request mbuf chain */
1060 	mbuf_t                  nd_mrep;        /* Reply mbuf list (WG) */
1061 	mbuf_t                  nd_nam;         /* and socket addr */
1062 	mbuf_t                  nd_nam2;        /* return socket addr */
1063 	u_int32_t               nd_procnum;     /* RPC # */
1064 	int                     nd_stable;      /* storage type */
1065 	int                     nd_vers;        /* NFS version */
1066 	int                     nd_len;         /* Length of this write */
1067 	int                     nd_repstat;     /* Reply status */
1068 	u_int32_t               nd_retxid;      /* Reply xid */
1069 	struct timeval          nd_starttime;   /* Time RPC initiated */
1070 	struct nfs_filehandle   nd_fh;          /* File handle */
1071 	uint32_t                nd_sec;         /* Security flavor */
1072 	struct nfs_gss_svc_ctx  *nd_gss_context;/* RPCSEC_GSS context */
1073 	uint32_t                nd_gss_seqnum;  /* RPCSEC_GSS seq num */
1074 	mbuf_t                  nd_gss_mb;      /* RPCSEC_GSS results mbuf */
1075 	kauth_cred_t            nd_cr;          /* Credentials */
1076 };
1077 
1078 extern TAILQ_HEAD(nfsd_head, nfsd) nfsd_head, nfsd_queue;
1079 
1080 typedef int (*nfsrv_proc_t)(struct nfsrv_descript *, struct nfsrv_sock *,
1081     vfs_context_t, mbuf_t *);
1082 
1083 /* mutex for nfs server */
1084 extern lck_mtx_t nfsd_mutex;
1085 extern int nfsd_thread_count, nfsd_thread_max;
1086 
1087 /* nfs timer call structures */
1088 extern thread_call_t    nfsrv_idlesock_timer_call;
1089 #if CONFIG_FSE
1090 extern thread_call_t    nfsrv_fmod_timer_call;
1091 #endif
1092 
1093 __BEGIN_DECLS
1094 
1095 nfstype vtonfs_type(enum vtype, int);
1096 enum vtype nfstov_type(nfstype, int);
1097 int     vtonfsv2_mode(enum vtype, mode_t);
1098 
1099 void    nfs_mbuf_init(void);
1100 
1101 int     nfs_sockaddr_cmp(struct sockaddr *, struct sockaddr *);
1102 
1103 void    nfsrv_active_user_list_reclaim(void);
1104 void    nfsrv_cleancache(void);
1105 void    nfsrv_cleanup(void);
1106 int     nfsrv_credcheck(struct nfsrv_descript *, vfs_context_t, struct nfs_export *,
1107     struct nfs_export_options *);
1108 void    nfsrv_idlesock_timer(void *, void *);
1109 int     nfsrv_dorec(struct nfsrv_sock *, struct nfsd *, struct nfsrv_descript **);
1110 int     nfsrv_errmap(struct nfsrv_descript *, int);
1111 int     nfsrv_export(struct user_nfs_export_args *, vfs_context_t);
1112 int     nfsrv_fhmatch(struct nfs_filehandle *, struct nfs_filehandle *);
1113 int     nfsrv_fhtovp(struct nfs_filehandle *, struct nfsrv_descript *, vnode_t *,
1114     struct nfs_export **, struct nfs_export_options **);
1115 int     nfsrv_check_exports_allow_address(mbuf_t);
1116 #if CONFIG_FSE
1117 void    nfsrv_fmod_timer(void *, void *);
1118 #endif
1119 int     nfsrv_getcache(struct nfsrv_descript *, struct nfsrv_sock *, mbuf_t *);
1120 void    nfsrv_group_sort(gid_t *, int);
1121 void    nfsrv_init(void);
1122 void    nfsrv_initcache(void);
1123 int     nfsrv_is_initialized(void);
1124 int     nfsrv_namei(struct nfsrv_descript *, vfs_context_t, struct nameidata *,
1125     struct nfs_filehandle *, vnode_t *,
1126     struct nfs_export **, struct nfs_export_options **);
1127 void    nfsrv_rcv(socket_t, void *, int);
1128 void    nfsrv_rcv_locked(socket_t, struct nfsrv_sock *, int);
1129 int     nfsrv_rephead(struct nfsrv_descript *, struct nfsrv_sock *, struct nfsm_chain *, size_t);
1130 int     nfsrv_send(struct nfsrv_sock *, mbuf_t, mbuf_t);
1131 void    nfsrv_updatecache(struct nfsrv_descript *, int, mbuf_t);
1132 void    nfsrv_update_user_stat(struct nfs_export *, struct nfsrv_descript *, uid_t, u_int, u_int, u_int);
1133 int     nfsrv_vptofh(struct nfs_export *, int, struct nfs_filehandle *,
1134     vnode_t, vfs_context_t, struct nfs_filehandle *);
1135 void    nfsrv_wakenfsd(struct nfsrv_sock *);
1136 void    nfsrv_wg_timer(void *, void *);
1137 int     nfsrv_writegather(struct nfsrv_descript **, struct nfsrv_sock *,
1138     vfs_context_t, mbuf_t *);
1139 
1140 int     nfsrv_access(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1141 int     nfsrv_commit(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1142 int     nfsrv_create(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1143 int     nfsrv_fsinfo(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1144 int     nfsrv_getattr(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1145 int     nfsrv_link(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1146 int     nfsrv_lookup(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1147 int     nfsrv_mkdir(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1148 int     nfsrv_mknod(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1149 int     nfsrv_noop(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1150 int     nfsrv_null(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1151 int     nfsrv_pathconf(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1152 int     nfsrv_read(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1153 int     nfsrv_readdir(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1154 int     nfsrv_readdirplus(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1155 int     nfsrv_readlink(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1156 int     nfsrv_remove(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1157 int     nfsrv_rename(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1158 int     nfsrv_rmdir(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1159 int     nfsrv_setattr(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1160 int     nfsrv_statfs(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1161 int     nfsrv_symlink(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1162 int     nfsrv_write(struct nfsrv_descript *, struct nfsrv_sock *, vfs_context_t, mbuf_t *);
1163 
1164 void    nfs_interval_timer_start(thread_call_t, time_t);
1165 
1166 /* socket upcall interfaces */
1167 void nfsrv_uc_init(void);
1168 void nfsrv_uc_cleanup(void);
1169 void nfsrv_uc_addsock(struct nfsrv_sock *, int);
1170 void nfsrv_uc_dequeue(struct nfsrv_sock *);
1171 
1172 #include <kern/kalloc.h>
1173 
1174 extern zone_t nfsrv_descript_zone;
1175 
1176 __END_DECLS
1177 #endif /* XNU_KERNEL_PRIVATE */
1178 
1179 #endif /* __APPLE_API_PRIVATE */
1180 
1181 #endif
1182