2 * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
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.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
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.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1989, 1993, 1995
31 * The Regents of the University of California. All rights reserved.
33 * This code is derived from software contributed to Berkeley by
34 * Rick Macklem at The University of Guelph.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
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.
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
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 $
71 #include <sys/appleapiopts.h>
72 #include <sys/cdefs.h>
74 #ifdef __APPLE_API_PRIVATE
76 * Tunable constants for nfs
79 #define NFS_MAXIOVEC 34
80 #define NFS_TICKINTVL 5 /* Desired time for a tick (msec) */
81 #define NFS_HZ (hz / nfs_ticks) /* Ticks/sec */
82 #define NFS_TIMEO (1 * NFS_HZ) /* Default timeout = 1 second */
83 #define NFS_MINTIMEO (1 * NFS_HZ) /* Min timeout to use */
84 #define NFS_MAXTIMEO (60 * NFS_HZ) /* Max timeout to backoff to */
85 #define NFS_MINIDEMTIMEO (5 * NFS_HZ) /* Min timeout for non-idempotent ops*/
86 #define NFS_MAXREXMIT 100 /* Stop counting after this many */
87 #define NFS_MAXWINDOW 1024 /* Max number of outstanding requests */
88 #define NFS_RETRANS 10 /* Num of retrans for soft mounts */
89 #define NFS_TRYLATERDEL 15 /* Initial try later delay (sec) */
90 #define NFS_MAXGRPS 16 /* Max. size of groups list */
91 #ifndef NFS_MINATTRTIMO
92 #define NFS_MINATTRTIMO 5 /* Attribute cache timeout in sec */
94 #ifndef NFS_MAXATTRTIMO
95 #define NFS_MAXATTRTIMO 60
97 #ifndef NFS_MINDIRATTRTIMO
98 #define NFS_MINDIRATTRTIMO 5 /* directory attribute cache timeout in sec */
100 #ifndef NFS_MAXDIRATTRTIMO
101 #define NFS_MAXDIRATTRTIMO 60
103 #define NFS_IOSIZE (256 * 1024) /* suggested I/O size */
104 #define NFS_WSIZE 16384 /* Def. write data size <= 16K */
105 #define NFS_RSIZE 16384 /* Def. read data size <= 16K */
106 #define NFS_DGRAM_WSIZE 8192 /* UDP Def. write data size <= 8K */
107 #define NFS_DGRAM_RSIZE 8192 /* UDP Def. read data size <= 8K */
108 #define NFS_READDIRSIZE 8192 /* Def. readdir size */
109 #define NFS_DEFRAHEAD 4 /* Def. read ahead # blocks */
110 #define NFS_MAXRAHEAD 16 /* Max. read ahead # blocks */
111 #define NFS_MAXUIDHASH 64 /* Max. # of hashed uid entries/mp */
112 #define NFS_MAXASYNCDAEMON 32 /* Max. number async_daemons runnable */
113 #define NFS_MAXGATHERDELAY 100 /* Max. write gather delay (msec) */
114 #ifndef NFS_GATHERDELAY
115 #define NFS_GATHERDELAY 10 /* Default write gather delay (msec) */
117 #define NFS_DIRBLKSIZ 4096 /* Must be a multiple of DIRBLKSIZ */
118 #if defined(KERNEL) && !defined(DIRBLKSIZ)
119 #define DIRBLKSIZ 512 /* XXX we used to use ufs's DIRBLKSIZ */
120 /* can't be larger than NFS_FABLKSIZE */
126 #define NMOD(a) ((a) % nfs_asyncdaemons)
127 #define NFS_CMPFH(n, f, s) \
128 ((n)->n_fhsize == (s) && !bcmp((caddr_t)(n)->n_fhp, (caddr_t)(f), (s)))
129 #define NFS_ISV3(v) (VFSTONFS(vnode_mount(v))->nm_flag & NFSMNT_NFSV3)
130 #define NFS_SRVMAXDATA(n) \
131 (((n)->nd_flag & ND_NFSV3) ? (((n)->nd_nam2) ? \
132 NFS_MAXDGRAMDATA : NFS_MAXDATA) : NFS_V2MAXDATA)
136 * The NB_INVAFTERWRITE flag should be set to whatever is required by the
137 * buffer cache code to say "Invalidate the block after it is written back".
140 #define NB_INVAFTERWRITE NB_NOCACHE
142 #define NB_INVAFTERWRITE NB_INVAL
146 * The IO_METASYNC flag should be implemented for local file systems.
147 * (Until then, it is nothin at all.)
150 #define IO_METASYNC 0
154 * Expected allocation sizes for major data structures. If the actual size
155 * of the structure exceeds these sizes, then malloc() will be allocating
156 * almost twice the memory required. This is used in nfs_init() to warn
157 * the sysadmin that the size of a structure should be reduced.
158 * (These sizes are always a power of 2. If the kernel malloc() changes
159 * to one that does not allocate space in powers of 2 size, then this all
161 * Note that some of these structures come out of there own nfs zones.
163 #define NFS_NODEALLOC 512
164 #define NFS_MNTALLOC 512
165 #define NFS_SVCALLOC 256
166 #define NFS_UIDALLOC 128
169 * Arguments to mount NFS
171 #define NFS_ARGSVERSION 4 /* change when nfs_args changes */
173 int version
; /* args structure version number */
174 struct sockaddr
*addr
; /* file server address */
175 int addrlen
; /* length of address */
176 int sotype
; /* Socket type */
177 int proto
; /* and Protocol */
178 u_char
*fh
; /* File handle to be mounted */
179 int fhsize
; /* Size, in bytes, of fh */
180 int flags
; /* flags */
181 int wsize
; /* write size in bytes */
182 int rsize
; /* read size in bytes */
183 int readdirsize
; /* readdir size in bytes */
184 int timeo
; /* initial timeout in .1 secs */
185 int retrans
; /* times to retry send */
186 int maxgrouplist
; /* Max. size of group list */
187 int readahead
; /* # of blocks to readahead */
188 int leaseterm
; /* obsolete: Term (sec) of lease */
189 int deadthresh
; /* obsolete: Retrans threshold */
190 char *hostname
; /* server's name */
191 /* NFS_ARGSVERSION 3 ends here */
192 int acregmin
; /* reg file min attr cache timeout */
193 int acregmax
; /* reg file max attr cache timeout */
194 int acdirmin
; /* dir min attr cache timeout */
195 int acdirmax
; /* dir max attr cache timeout */
199 int version
; /* args structure version number */
200 struct sockaddr
*addr
; /* file server address */
201 int addrlen
; /* length of address */
202 int sotype
; /* Socket type */
203 int proto
; /* and Protocol */
204 u_char
*fh
; /* File handle to be mounted */
205 int fhsize
; /* Size, in bytes, of fh */
206 int flags
; /* flags */
207 int wsize
; /* write size in bytes */
208 int rsize
; /* read size in bytes */
209 int readdirsize
; /* readdir size in bytes */
210 int timeo
; /* initial timeout in .1 secs */
211 int retrans
; /* times to retry send */
212 int maxgrouplist
; /* Max. size of group list */
213 int readahead
; /* # of blocks to readahead */
214 int leaseterm
; /* obsolete: Term (sec) of lease */
215 int deadthresh
; /* obsolete: Retrans threshold */
216 char *hostname
; /* server's name */
219 // LP64todo - should this move?
221 /* LP64 version of nfs_args. all pointers and longs
222 * grow when we're dealing with a 64-bit process.
223 * WARNING - keep in sync with nfs_args
225 struct user_nfs_args
{
226 int version
; /* args structure version number */
227 user_addr_t addr
__attribute((aligned(8))); /* file server address */
228 int addrlen
; /* length of address */
229 int sotype
; /* Socket type */
230 int proto
; /* and Protocol */
231 user_addr_t fh
__attribute((aligned(8))); /* File handle to be mounted */
232 int fhsize
; /* Size, in bytes, of fh */
233 int flags
; /* flags */
234 int wsize
; /* write size in bytes */
235 int rsize
; /* read size in bytes */
236 int readdirsize
; /* readdir size in bytes */
237 int timeo
; /* initial timeout in .1 secs */
238 int retrans
; /* times to retry send */
239 int maxgrouplist
; /* Max. size of group list */
240 int readahead
; /* # of blocks to readahead */
241 int leaseterm
; /* obsolete: Term (sec) of lease */
242 int deadthresh
; /* obsolete: Retrans threshold */
243 user_addr_t hostname
__attribute((aligned(8))); /* server's name */
244 /* NFS_ARGSVERSION 3 ends here */
245 int acregmin
; /* reg file min attr cache timeout */
246 int acregmax
; /* reg file max attr cache timeout */
247 int acdirmin
; /* dir min attr cache timeout */
248 int acdirmax
; /* dir max attr cache timeout */
250 struct user_nfs_args3
{
251 int version
; /* args structure version number */
252 user_addr_t addr
__attribute((aligned(8))); /* file server address */
253 int addrlen
; /* length of address */
254 int sotype
; /* Socket type */
255 int proto
; /* and Protocol */
256 user_addr_t fh
__attribute((aligned(8))); /* File handle to be mounted */
257 int fhsize
; /* Size, in bytes, of fh */
258 int flags
; /* flags */
259 int wsize
; /* write size in bytes */
260 int rsize
; /* read size in bytes */
261 int readdirsize
; /* readdir size in bytes */
262 int timeo
; /* initial timeout in .1 secs */
263 int retrans
; /* times to retry send */
264 int maxgrouplist
; /* Max. size of group list */
265 int readahead
; /* # of blocks to readahead */
266 int leaseterm
; /* obsolete: Term (sec) of lease */
267 int deadthresh
; /* obsolete: Retrans threshold */
268 user_addr_t hostname
__attribute((aligned(8))); /* server's name */
274 * NFS mount option flags
276 #define NFSMNT_SOFT 0x00000001 /* soft mount (hard is default) */
277 #define NFSMNT_WSIZE 0x00000002 /* set write size */
278 #define NFSMNT_RSIZE 0x00000004 /* set read size */
279 #define NFSMNT_TIMEO 0x00000008 /* set initial timeout */
280 #define NFSMNT_RETRANS 0x00000010 /* set number of request retries */
281 #define NFSMNT_MAXGRPS 0x00000020 /* set maximum grouplist size */
282 #define NFSMNT_INT 0x00000040 /* allow interrupts on hard mount */
283 #define NFSMNT_NOCONN 0x00000080 /* Don't Connect the socket */
284 #define NFSMNT_NFSV3 0x00000200 /* Use NFS Version 3 protocol */
285 #define NFSMNT_KERB 0x00000400 /* Use Kerberos authentication */
286 #define NFSMNT_DUMBTIMR 0x00000800 /* Don't estimate rtt dynamically */
287 #define NFSMNT_READAHEAD 0x00002000 /* set read ahead */
288 #define NFSMNT_RESVPORT 0x00008000 /* Allocate a reserved port */
289 #define NFSMNT_RDIRPLUS 0x00010000 /* Use Readdirplus for V3 */
290 #define NFSMNT_READDIRSIZE 0x00020000 /* Set readdir size */
291 #define NFSMNT_NOLOCKS 0x00040000 /* don't support file locking */
292 #define NFSMNT_ACREGMIN 0x00100000 /* reg min attr cache timeout */
293 #define NFSMNT_ACREGMAX 0x00200000 /* reg max attr cache timeout */
294 #define NFSMNT_ACDIRMIN 0x00400000 /* dir min attr cache timeout */
295 #define NFSMNT_ACDIRMAX 0x00800000 /* dir max attr cache timeout */
298 * NFS mount state flags (nm_state)
300 #define NFSSTA_LOCKTIMEO 0x00002000 /* experienced a lock req timeout */
301 #define NFSSTA_MOUNTED 0x00004000 /* completely mounted */
302 #define NFSSTA_LOCKSWORK 0x00008000 /* lock ops have worked. */
303 #define NFSSTA_TIMEO 0x00010000 /* experienced a timeout. */
304 #define NFSSTA_FORCE 0x00020000 /* doing a forced unmount. */
305 #define NFSSTA_HASWRITEVERF 0x00040000 /* Has write verifier for V3 */
306 #define NFSSTA_GOTPATHCONF 0x00080000 /* Got the V3 pathconf info */
307 #define NFSSTA_GOTFSINFO 0x00100000 /* Got the V3 fsinfo */
308 #define NFSSTA_MNTD 0x00200000 /* Mnt server for mnt point */
309 #define NFSSTA_SNDLOCK 0x01000000 /* Send socket lock */
310 #define NFSSTA_WANTSND 0x02000000 /* Want above */
311 #define NFSSTA_RCVLOCK 0x04000000 /* Rcv socket lock */
312 #define NFSSTA_WANTRCV 0x08000000 /* Want above */
313 #define NFSSTA_WAITAUTH 0x10000000 /* Wait for authentication */
314 #define NFSSTA_HASAUTH 0x20000000 /* Has authenticator */
315 #define NFSSTA_WANTAUTH 0x40000000 /* Wants an authenticator */
316 #define NFSSTA_AUTHERR 0x80000000 /* Authentication error */
319 * NFS mount pathconf info flags (nm_fsinfo.pcflags)
321 #define NFSPCINFO_NOTRUNC 0x01
322 #define NFSPCINFO_CHOWN_RESTRICTED 0x02
323 #define NFSPCINFO_CASE_INSENSITIVE 0x04
324 #define NFSPCINFO_CASE_PRESERVING 0x08
327 * Structures for the nfssvc(2) syscall. Not that anyone but nfsd and mount_nfs
328 * should ever try and use it.
331 int sock
; /* Socket to serve */
332 caddr_t name
; /* Client addr for connection based sockets */
333 int namelen
; /* Length of name */
336 // LP64todo - should this move?
338 /* LP64 version of nfsd_args. all pointers and longs
339 * grow when we're dealing with a 64-bit process.
340 * WARNING - keep in sync with nfsd_args
342 struct user_nfsd_args
{
343 int sock
; /* Socket to serve */
344 user_addr_t name
__attribute((aligned(8))); /* Client addr for connection based sockets */
345 int namelen
; /* Length of name */
350 struct nfsd_srvargs
{
351 struct nfsd
*nsd_nfsd
; /* Pointer to in kernel nfsd struct */
352 uid_t nsd_uid
; /* Effective uid mapped to cred */
353 u_long nsd_haddr
; /* Ip address of client */
354 struct ucred nsd_cr
; /* Cred. uid maps to */
355 int nsd_authlen
; /* Length of auth string (ret) */
356 u_char
*nsd_authstr
; /* Auth string (ret) */
357 int nsd_verflen
; /* and the verfier */
359 struct timeval nsd_timestamp
; /* timestamp from verifier */
360 u_long nsd_ttl
; /* credential ttl (sec) */
361 NFSKERBKEY_T nsd_key
; /* Session key */
365 char *ncd_dirp
; /* Mount dir path */
366 uid_t ncd_authuid
; /* Effective uid */
367 int ncd_authtype
; /* Type of authenticator */
368 int ncd_authlen
; /* Length of authenticator string */
369 u_char
*ncd_authstr
; /* Authenticator string */
370 int ncd_verflen
; /* and the verifier */
372 NFSKERBKEY_T ncd_key
; /* Session key */
376 * NFS Server File Handle structures
379 /* NFS export handle identifies which NFS export */
380 #define NFS_FH_VERSION 0x4e580000 /* 'NX00' */
381 struct nfs_exphandle
{
382 uint32_t nxh_version
; /* data structure version */
383 uint32_t nxh_fsid
; /* File System Export ID */
384 uint32_t nxh_expid
; /* Export ID */
385 uint16_t nxh_flags
; /* export handle flags */
386 uint8_t nxh_reserved
; /* future use */
387 uint8_t nxh_fidlen
; /* length of File ID */
391 #define NXHF_INVALIDFH 0x0001 /* file handle is invalid */
393 #define NFS_MAX_FID_SIZE (NFS_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
394 #define NFSV2_MAX_FID_SIZE (NFSV2_MAX_FH_SIZE - sizeof(struct nfs_exphandle))
396 /* NFS server internal view of fhandle_t */
397 struct nfs_filehandle
{
398 int nfh_len
; /* total length of file handle */
399 struct nfs_exphandle nfh_xh
; /* export handle */
400 unsigned char nfh_fid
[NFS_MAX_FID_SIZE
]; /* File ID */
404 * NFS export data structures
407 struct nfs_export_net_args
{
408 uint32_t nxna_flags
; /* export flags */
409 struct xucred nxna_cred
; /* mapped credential for root/all user */
410 struct sockaddr_storage nxna_addr
; /* net address to which exported */
411 struct sockaddr_storage nxna_mask
; /* mask for net address */
414 struct nfs_export_args
{
415 uint32_t nxa_fsid
; /* export FS ID */
416 uint32_t nxa_expid
; /* export ID */
417 char *nxa_fspath
; /* export FS path */
418 char *nxa_exppath
; /* export sub-path */
419 uint32_t nxa_flags
; /* export arg flags */
420 uint32_t nxa_netcount
; /* #entries in ex_nets array */
421 struct nfs_export_net_args
*nxa_nets
; /* array of net args */
425 /* LP64 version of export_args */
427 struct user_nfs_export_args
{
428 uint32_t nxa_fsid
; /* export FS ID */
429 uint32_t nxa_expid
; /* export ID */
430 user_addr_t nxa_fspath
; /* export FS path */
431 user_addr_t nxa_exppath
; /* export sub-path */
432 uint32_t nxa_flags
; /* export arg flags */
433 uint32_t nxa_netcount
; /* #entries in ex_nets array */
434 user_addr_t nxa_nets
; /* array of net args */
439 /* nfs export arg flags */
440 #define NXA_DELETE 0x0001 /* delete the specified export(s) */
441 #define NXA_ADD 0x0002 /* add the specified export(s) */
442 #define NXA_REPLACE 0x0003 /* delete and add the specified export(s) */
443 #define NXA_DELETE_ALL 0x0004 /* delete all exports */
445 /* export option flags */
446 #define NX_READONLY 0x0001 /* exported read-only */
447 #define NX_DEFAULTEXPORT 0x0002 /* exported to the world */
448 #define NX_MAPROOT 0x0004 /* map root access to anon credential */
449 #define NX_MAPALL 0x0008 /* map all access to anon credential */
450 #define NX_KERB 0x0010 /* exported with Kerberos uid mapping */
451 #define NX_32BITCLIENTS 0x0020 /* restrict directory cookies to 32 bits */
456 struct nfs_export_options
{
457 uint32_t nxo_flags
; /* export options */
458 kauth_cred_t nxo_cred
; /* mapped credential */
461 /* Network address lookup element and individual export options */
463 struct radix_node no_rnodes
[2]; /* radix tree glue */
464 struct nfs_export_options no_opt
; /* export options */
467 /* Network export information */
468 /* one of these for each exported directory */
470 LIST_ENTRY(nfs_export
) nx_next
; /* FS export list */
471 LIST_ENTRY(nfs_export
) nx_hash
; /* export hash chain */
472 struct nfs_export
*nx_parent
; /* parent export */
473 uint32_t nx_id
; /* export ID */
474 uint32_t nx_flags
; /* export flags */
475 struct nfs_exportfs
*nx_fs
; /* exported file system */
476 char *nx_path
; /* exported file system sub-path */
477 struct nfs_filehandle nx_fh
; /* export root file handle */
478 struct nfs_export_options nx_defopt
; /* default options */
479 uint32_t nx_expcnt
; /* # exports in table */
480 struct radix_node_head
*nx_rtable
[AF_MAX
+1]; /* table of exports (netopts) */
483 /* NFS exported file system info */
484 /* one of these for each exported file system */
485 struct nfs_exportfs
{
486 LIST_ENTRY(nfs_exportfs
) nxfs_next
; /* exported file system list */
487 uint32_t nxfs_id
; /* exported file system ID */
488 char *nxfs_path
; /* exported file system path */
489 LIST_HEAD(,nfs_export
) nxfs_exports
; /* list of exports for this file system */
492 extern LIST_HEAD(nfsexpfslist
, nfs_exportfs
) nfs_exports
;
493 extern lck_rw_t nfs_export_rwlock
; // lock for export data structures
494 #define NFSEXPHASHVAL(FSID, EXPID) \
495 (((FSID) >> 24) ^ ((FSID) >> 16) ^ ((FSID) >> 8) ^ (EXPID))
496 #define NFSEXPHASH(FSID, EXPID) \
497 (&nfsexphashtbl[NFSEXPHASHVAL((FSID),(EXPID)) & nfsexphash])
498 extern LIST_HEAD(nfsexphashhead
, nfs_export
) *nfsexphashtbl
;
499 extern u_long nfsexphash
;
504 * XXX to allow amd to include nfs.h without nfsproto.h
512 int attrcache_misses
;
513 int lookupcache_hits
;
514 int lookupcache_misses
;
515 int direofcache_hits
;
516 int direofcache_misses
;
523 int biocache_readlinks
;
525 int biocache_readdirs
;
527 int rpccnt
[NFS_NPROCS
];
529 int srvrpccnt
[NFS_NPROCS
];
536 int srvcache_inproghits
;
537 int srvcache_idemdonehits
;
538 int srvcache_nonidemdonehits
;
547 * Flags for nfssvc() system call.
549 #define NFSSVC_BIOD 0x002
550 #define NFSSVC_NFSD 0x004
551 #define NFSSVC_ADDSOCK 0x008
552 #define NFSSVC_AUTHIN 0x010
553 #define NFSSVC_GOTAUTH 0x040
554 #define NFSSVC_AUTHINFAIL 0x080
555 #define NFSSVC_MNTD 0x100
556 #define NFSSVC_EXPORT 0x200
559 * Flags for nfsclnt() system call.
561 #define NFSCLNT_LOCKDANS 0x200
562 #define NFSCLNT_LOCKDFD 0x400
563 #define NFSCLNT_LOCKDWAIT 0x800
566 * fs.nfs sysctl(3) identifiers
568 #define NFS_NFSSTATS 1 /* struct: struct nfsstats */
569 #define NFS_NFSPRIVPORT 2 /* int: prohibit nfs to resvports */
571 #define FS_NFS_NAMES { \
573 { "nfsstats", CTLTYPE_STRUCT }, \
574 { "nfsprivport", CTLTYPE_INT }, \
577 #ifndef NFS_MUIDHASHSIZ
578 #define NFS_MUIDHASHSIZ 63 /* Tune the size of nfsmount with this */
580 #ifndef NFS_WDELAYHASHSIZ
581 #define NFS_WDELAYHASHSIZ 16 /* and with this */
585 * The set of signals the interrupt an I/O in progress for NFSMNT_INT mounts.
586 * What should be in this set is open to debate, but I believe that since
587 * I/O system calls on ufs are never interrupted by signals the set should
588 * be minimal. My reasoning is that many current programs that use signals
589 * such as SIGALRM will not expect file I/O system calls to be interrupted
593 #include <sys/kernel_types.h>
595 #ifdef MALLOC_DECLARE
596 MALLOC_DECLARE(M_NFSREQ
);
597 MALLOC_DECLARE(M_NFSMNT
);
598 MALLOC_DECLARE(M_NFSDIROFF
);
599 MALLOC_DECLARE(M_NFSRVDESC
);
600 MALLOC_DECLARE(M_NFSUID
);
601 MALLOC_DECLARE(M_NFSD
);
602 MALLOC_DECLARE(M_NFSBIGFH
);
605 struct uio
; struct vnode_attr
; struct nameidata
; /* XXX */
610 #define NFSINT_SIGMASK (sigmask(SIGINT)|sigmask(SIGTERM)|sigmask(SIGKILL)| \
611 sigmask(SIGHUP)|sigmask(SIGQUIT))
613 __private_extern__
int nfs_mbuf_mlen
, nfs_mbuf_mhlen
,
614 nfs_mbuf_minclsize
, nfs_mbuf_mclbytes
;
617 * Socket errors ignored for connectionless sockets??
618 * For now, ignore them all
620 #define NFSIGNORE_SOERROR(s, e) \
621 ((e) != EINTR && (e) != ERESTART && (e) != EWOULDBLOCK && \
622 (e) != EIO && ((s)) != SOCK_STREAM)
625 * Nfs outstanding request list element
628 TAILQ_ENTRY(nfsreq
) r_chain
;
633 struct nfsmount
*r_nmp
;
636 int r_flags
; /* flags on request, see below */
637 int r_retry
; /* max retransmission count */
638 int r_rexmit
; /* current retrans count */
639 int r_timer
; /* tick counter on reply */
640 u_int32_t r_procnum
; /* NFS procedure number */
641 int r_rtt
; /* RTT for rpc */
642 proc_t r_procp
; /* Proc that did I/O system call */
643 long r_lastmsg
; /* time of last tprintf */
647 * Queue head for nfsreq's
649 extern TAILQ_HEAD(nfs_reqq
, nfsreq
) nfs_reqq
;
651 /* Flag values for r_flags */
652 #define R_TIMING 0x0001 /* timing request (in mntp) */
653 #define R_SENT 0x0002 /* request has been sent */
654 #define R_SOFTTERM 0x0004 /* soft mnt, too many retries */
655 #define R_INTR 0x0008 /* intr mnt, signal pending */
656 #define R_SOCKERR 0x0010 /* Fatal error on socket */
657 #define R_TPRINTFMSG 0x0020 /* Did a tprintf msg. */
658 #define R_MUSTRESEND 0x0040 /* Must resend request */
659 #define R_BUSY 0x0100 /* Locked. */
660 #define R_WAITING 0x0200 /* Someone waiting for lock. */
661 #define R_RESENDERR 0x0400 /* resend failed. */
664 * A list of nfssvc_sock structures is maintained with all the sockets
665 * that require service by the nfsd.
666 * The nfsuid structs hang off of the nfssvc_sock structs in both lru
667 * and uid hash lists.
669 #ifndef NFS_UIDHASHSIZ
670 #define NFS_UIDHASHSIZ 13 /* Tune the size of nfssvc_sock with this */
672 #define NUIDHASH(sock, uid) \
673 (&(sock)->ns_uidhashtbl[(uid) % NFS_UIDHASHSIZ])
674 #define NWDELAYHASH(sock, f) \
675 (&(sock)->ns_wdelayhashtbl[(*((u_long *)(f))) % NFS_WDELAYHASHSIZ])
676 #define NMUIDHASH(nmp, uid) \
677 (&(nmp)->nm_uidhashtbl[(uid) % NFS_MUIDHASHSIZ])
678 #define NFSNOHASH(fhsum) \
679 (&nfsnodehashtbl[(fhsum) & nfsnodehash])
682 * Network address hash list element
690 TAILQ_ENTRY(nfsuid
) nu_lru
; /* LRU chain */
691 LIST_ENTRY(nfsuid
) nu_hash
; /* Hash list */
692 int nu_flag
; /* Flags */
693 union nethostaddr nu_haddr
; /* Host addr. for dgram sockets */
694 kauth_cred_t nu_cr
; /* Cred uid mapped to */
695 int nu_expire
; /* Expiry time (sec) */
696 struct timeval nu_timestamp
; /* Kerb. timestamp */
697 u_long nu_nickname
; /* Nickname on server */
698 NFSKERBKEY_T nu_key
; /* and session key */
701 #define nu_inetaddr nu_haddr.had_inetaddr
702 #define nu_nam nu_haddr.had_nam
703 /* Bits for nu_flag */
704 #define NU_INETADDR 0x1
706 #define NU_NETFAM(u) (((u)->nu_flag & NU_INETADDR) ? AF_INET : AF_ISO)
709 /* XXX CSM 12/2/97 When/if we merge queue.h */
711 STAILQ_ENTRY(nfsrv_rec
) nr_link
;
712 struct sockaddr
*nr_address
;
718 TAILQ_ENTRY(nfssvc_sock
) ns_chain
; /* List of all nfssvc_sock's */
719 lck_rw_t ns_rwlock
; /* lock for most fields */
733 time_t ns_timestamp
; /* socket timestamp */
734 lck_mtx_t ns_wgmutex
; /* mutex for write gather fields */
735 u_quad_t ns_wgtime
; /* next Write deadline (usec) */
736 LIST_HEAD(, nfsrv_descript
) ns_tq
; /* Write gather lists */
737 LIST_HEAD(nfsrvw_delayhash
, nfsrv_descript
) ns_wdelayhashtbl
[NFS_WDELAYHASHSIZ
];
738 TAILQ_HEAD(, nfsuid
) ns_uidlruhead
;
739 LIST_HEAD(, nfsuid
) ns_uidhashtbl
[NFS_UIDHASHSIZ
];
742 /* Bits for "ns_flag" */
743 #define SLP_VALID 0x01 /* nfs sock valid */
744 #define SLP_DOREC 0x02 /* nfs sock has received data to process */
745 #define SLP_NEEDQ 0x04 /* network socket has data to receive */
746 #define SLP_DISCONN 0x08 /* socket needs to be zapped */
747 #define SLP_GETSTREAM 0x10 /* currently in nfsrv_getstream() */
748 #define SLP_LASTFRAG 0x20 /* on last fragment of RPC record */
749 #define SLP_ALLFLAGS 0xff
751 extern TAILQ_HEAD(nfssvc_sockhead
, nfssvc_sock
) nfssvc_sockhead
, nfssvc_deadsockhead
;
753 /* locks for nfssvc_sock's */
754 extern lck_grp_attr_t
*nfs_slp_group_attr
;
755 extern lck_attr_t
*nfs_slp_lock_attr
;
756 extern lck_grp_t
*nfs_slp_rwlock_group
;
757 extern lck_grp_t
*nfs_slp_mutex_group
;
760 * One of these structures is allocated for each nfsd.
763 TAILQ_ENTRY(nfsd
) nfsd_chain
; /* List of all nfsd's */
764 int nfsd_flag
; /* NFSD_ flags */
765 struct nfssvc_sock
*nfsd_slp
; /* Current socket */
766 int nfsd_authlen
; /* Authenticator len */
767 u_char nfsd_authstr
[RPCAUTH_MAXSIZ
]; /* Authenticator data */
768 int nfsd_verflen
; /* and the Verifier */
769 u_char nfsd_verfstr
[RPCVERF_MAXSIZ
];
770 proc_t nfsd_procp
; /* Proc ptr */
771 struct nfsrv_descript
*nfsd_nd
; /* Associated nfsrv_descript */
774 /* Bits for "nfsd_flag" */
775 #define NFSD_WAITING 0x01
776 #define NFSD_REQINPROG 0x02
777 #define NFSD_NEEDAUTH 0x04
778 #define NFSD_AUTHFAIL 0x08
781 * This structure is used by the server for describing each request.
782 * Some fields are used only when write request gathering is performed.
784 struct nfsrv_descript
{
785 u_quad_t nd_time
; /* Write deadline (usec) */
786 off_t nd_off
; /* Start byte offset */
787 off_t nd_eoff
; /* and end byte offset */
788 LIST_ENTRY(nfsrv_descript
) nd_hash
; /* Hash list */
789 LIST_ENTRY(nfsrv_descript
) nd_tq
; /* and timer list */
790 LIST_HEAD(,nfsrv_descript
) nd_coalesce
; /* coalesced writes */
791 mbuf_t nd_mrep
; /* Request mbuf list */
792 mbuf_t nd_md
; /* Current dissect mbuf */
793 mbuf_t nd_mreq
; /* Reply mbuf list */
794 mbuf_t nd_nam
; /* and socket addr */
795 mbuf_t nd_nam2
; /* return socket addr */
796 caddr_t nd_dpos
; /* Current dissect pos */
797 u_int32_t nd_procnum
; /* RPC # */
798 int nd_stable
; /* storage type */
799 int nd_flag
; /* nd_flag */
800 int nd_len
; /* Length of this write */
801 int nd_repstat
; /* Reply status */
802 u_long nd_retxid
; /* Reply xid */
803 struct timeval nd_starttime
; /* Time RPC initiated */
804 struct nfs_filehandle nd_fh
; /* File handle */
805 kauth_cred_t nd_cr
; /* Credentials */
808 /* Bits for "nd_flag" */
809 #define ND_NFSV3 0x08
810 #define ND_KERBNICK 0x20
811 #define ND_KERBFULL 0x40
812 #define ND_KERBAUTH (ND_KERBNICK | ND_KERBFULL)
814 extern TAILQ_HEAD(nfsd_head
, nfsd
) nfsd_head
;
815 extern int nfsd_head_flag
;
816 #define NFSD_CHECKSLP 0x01
819 * These macros compare nfsrv_descript structures.
821 #define NFSW_CONTIG(o, n) \
822 (((o)->nd_eoff >= (n)->nd_off) && \
823 ((o)->nd_fh.nfh_len == (n)->nd_fh.nfh_len) && \
824 !bcmp((caddr_t)&(o)->nd_fh, (caddr_t)&(n)->nd_fh, (o)->nd_fh.nfh_len))
826 #define NFSW_SAMECRED(o, n) \
827 (((o)->nd_flag & ND_KERBAUTH) == ((n)->nd_flag & ND_KERBAUTH) && \
828 !bcmp((caddr_t)(o)->nd_cr, (caddr_t)(n)->nd_cr, \
829 sizeof (struct ucred)))
831 /* mutex for nfs server */
832 extern lck_grp_t
* nfsd_lck_grp
;
833 extern lck_grp_attr_t
* nfsd_lck_grp_attr
;
834 extern lck_attr_t
* nfsd_lck_attr
;
835 extern lck_mtx_t
*nfsd_mutex
;
837 extern int nfs_numnfsd
, nfsd_waiting
;
843 #define WEBNFS_ESC_CHAR '%'
844 #define WEBNFS_SPECCHAR_START 0x80
846 #define WEBNFS_NATIVE_CHAR 0x80
849 * Possibly more here in the future.
853 * Macro for converting escape characters in WebNFS pathnames.
854 * Should really be in libkern.
857 ((((c) >= 'a') && ((c) <= 'f')) || \
858 (((c) >= 'A') && ((c) <= 'F')) || \
859 (((c) >= '0') && ((c) <= '9')))
861 ((c) >= 'a' ? ((c) - ('a' - 10)) : \
862 ((c) >= 'A' ? ((c) - ('A' - 10)) : ((c) - '0')))
863 #define HEXSTRTOI(p) \
864 ((HEXTOC(p[0]) << 4) + HEXTOC(p[1]))
868 int nfs_init(struct vfsconf
*vfsp
);
869 void nfs_mbuf_init(void);
870 int nfs_reply(struct nfsreq
*);
871 int nfs_getreq(struct nfsrv_descript
*,struct nfsd
*,int);
872 int nfs_send(socket_t
, mbuf_t
, mbuf_t
, struct nfsreq
*);
873 int nfs_rephead(int, struct nfsrv_descript
*, struct nfssvc_sock
*,
874 int, mbuf_t
*, mbuf_t
*, caddr_t
*);
875 int nfs_sndlock(struct nfsreq
*);
876 void nfs_sndunlock(struct nfsreq
*);
877 int nfs_vinvalbuf(vnode_t
, int, struct ucred
*, proc_t
, int);
878 int nfs_buf_page_inval(vnode_t vp
, off_t offset
);
879 int nfs_readrpc(vnode_t
, struct uio
*, struct ucred
*, proc_t
);
880 int nfs_writerpc(vnode_t
, struct uio
*, struct ucred
*, proc_t
, int *, uint64_t *);
881 int nfs_readdirrpc(vnode_t
, struct uio
*, struct ucred
*, proc_t
);
882 int nfs_readdirplusrpc(vnode_t
, struct uio
*, struct ucred
*, proc_t
);
883 int nfs_asyncio(struct nfsbuf
*, struct ucred
*);
884 int nfs_doio(struct nfsbuf
*, struct ucred
*, proc_t
);
885 int nfs_readlinkrpc(vnode_t
, struct uio
*, struct ucred
*, proc_t
);
886 int nfs_sigintr(struct nfsmount
*, struct nfsreq
*, proc_t
);
887 int nfsm_disct(mbuf_t
*, caddr_t
*, int, int, caddr_t
*);
888 void nfsm_srvfattr(struct nfsrv_descript
*, struct vnode_attr
*,
890 void nfsm_srvwcc(struct nfsrv_descript
*, int, struct vnode_attr
*, int,
891 struct vnode_attr
*, mbuf_t
*, char **);
892 void nfsm_srvpostopattr(struct nfsrv_descript
*, int, struct vnode_attr
*,
894 int netaddr_match(int, union nethostaddr
*, mbuf_t
);
895 int nfs_request(vnode_t
, mount_t
, mbuf_t
, int, proc_t
,
896 struct ucred
*, mbuf_t
*, mbuf_t
*,
897 caddr_t
*, u_int64_t
*);
898 int nfs_parsefattr(mbuf_t
*, caddr_t
*, int, struct nfs_vattr
*);
899 int nfs_loadattrcache(struct nfsnode
*, struct nfs_vattr
*, u_int64_t
*, int);
900 int nfsm_path_mbuftond(mbuf_t
*, caddr_t
*, int, int, int *, struct nameidata
*);
901 int nfs_namei(struct nfsrv_descript
*, struct vfs_context
*, struct nameidata
*,
902 struct nfs_filehandle
*, mbuf_t
, int, vnode_t
*,
903 struct nfs_export
**, struct nfs_export_options
**);
904 void nfsm_adj(mbuf_t
, int, int);
905 int nfsm_mbuftouio(mbuf_t
*, struct uio
*, int, caddr_t
*);
906 void nfsrv_initcache(void);
907 int nfs_getauth(struct nfsmount
*, struct nfsreq
*, struct ucred
*,
908 char **, int *, char *, int *, NFSKERBKEY_T
);
909 int nfs_getnickauth(struct nfsmount
*, struct ucred
*, char **,
911 int nfs_savenickauth(struct nfsmount
*, struct ucred
*, int,
912 NFSKERBKEY_T
, mbuf_t
*, char **,
914 int nfs_adv(mbuf_t
*, caddr_t
*, int, int);
915 void nfs_nhinit(void);
916 void nfs_timer_funnel(void*);
917 void nfs_timer(void*);
918 u_long
nfs_hash(u_char
*, int);
919 int nfsrv_dorec(struct nfssvc_sock
*, struct nfsd
*,
920 struct nfsrv_descript
**);
921 int nfsrv_getcache(struct nfsrv_descript
*, struct nfssvc_sock
*,
923 void nfsrv_updatecache(struct nfsrv_descript
*, int, mbuf_t
);
924 void nfsrv_cleancache(void);
925 int nfs_bind_resv_thread_wake(void);
926 int nfs_connect(struct nfsmount
*, struct nfsreq
*);
927 void nfs_disconnect(struct nfsmount
*);
928 int nfs_getattr_no_vnode(mount_t
,u_char
*,int,struct ucred
*,proc_t
,struct nfs_vattr
*,u_int64_t
*);
929 int nfs_getattr(vnode_t vp
, struct nfs_vattr
*nvap
, struct ucred
*cred
, proc_t p
);
930 int nfs_getattrcache(vnode_t
, struct nfs_vattr
*);
931 int nfs_attrcachetimeout(vnode_t
);
932 int nfsm_strtmbuf(mbuf_t
*, char **, char *, long);
933 int nfs_bioread(vnode_t
, struct uio
*, int, struct ucred
*, proc_t
);
934 int nfsm_uiotombuf(struct uio
*, mbuf_t
*, int, caddr_t
*);
935 void nfsrv_init(int);
936 int nfs_commit(vnode_t vp
, u_quad_t offset
, u_int32_t count
,
937 struct ucred
*cred
, proc_t procp
);
938 int nfs_flushcommits(vnode_t
, proc_t
, int);
939 int nfs_flush(vnode_t
,int,struct ucred
*,proc_t
,int);
940 int nfsrv_errmap(struct nfsrv_descript
*, int);
941 void nfsrvw_sort(gid_t
*, int);
942 void nfsrv_setcred(struct ucred
*, struct ucred
*);
943 int nfs_buf_write(struct nfsbuf
*);
944 void nfsrv_wakenfsd(struct nfssvc_sock
*slp
);
945 int nfsrv_writegather(struct nfsrv_descript
**, struct nfssvc_sock
*,
947 int nfs_fsinfo(struct nfsmount
*, vnode_t
, struct ucred
*, proc_t p
);
948 int nfs_pathconfrpc(vnode_t
, struct nfsv3_pathconf
*, kauth_cred_t
, proc_t
);
949 void nfs_pathconf_cache(struct nfsmount
*, struct nfsv3_pathconf
*);
951 int nfsrv3_access(struct nfsrv_descript
*nfsd
,
952 struct nfssvc_sock
*slp
,
953 proc_t procp
, mbuf_t
*mrq
);
954 int nfsrv_commit(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
955 proc_t procp
, mbuf_t
*mrq
);
956 int nfsrv_create(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
957 proc_t procp
, mbuf_t
*mrq
);
958 int nfsrv_credcheck(struct nfsrv_descript
*, struct nfs_export
*,
959 struct nfs_export_options
*);
960 int nfsrv_export(struct user_nfs_export_args
*, struct vfs_context
*);
961 int nfsrv_fhmatch(struct nfs_filehandle
*fh1
, struct nfs_filehandle
*fh2
);
962 int nfsrv_fhtovp(struct nfs_filehandle
*, mbuf_t
, int, vnode_t
*,
963 struct nfs_export
**, struct nfs_export_options
**);
964 int nfs_ispublicfh(struct nfs_filehandle
*);
965 int nfsrv_fsinfo(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
966 proc_t procp
, mbuf_t
*mrq
);
967 int nfsrv_getattr(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
968 proc_t procp
, mbuf_t
*mrq
);
969 int nfsrv_link(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
970 proc_t procp
, mbuf_t
*mrq
);
971 int nfsrv_lookup(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
972 proc_t procp
, mbuf_t
*mrq
);
973 int nfsrv_mkdir(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
974 proc_t procp
, mbuf_t
*mrq
);
975 int nfsrv_mknod(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
976 proc_t procp
, mbuf_t
*mrq
);
977 int nfsrv_noop(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
978 proc_t procp
, mbuf_t
*mrq
);
979 int nfsrv_null(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
980 proc_t procp
, mbuf_t
*mrq
);
981 int nfsrv_pathconf(struct nfsrv_descript
*nfsd
,
982 struct nfssvc_sock
*slp
, proc_t procp
,
984 void nfsrv_rcv(socket_t
, caddr_t arg
, int waitflag
);
985 void nfsrv_rcv_locked(socket_t
, struct nfssvc_sock
*slp
, int waitflag
);
986 int nfsrv_read(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
987 proc_t procp
, mbuf_t
*mrq
);
988 int nfsrv_readdir(struct nfsrv_descript
*nfsd
,
989 struct nfssvc_sock
*slp
,
990 proc_t procp
, mbuf_t
*mrq
);
991 int nfsrv_readdirplus(struct nfsrv_descript
*nfsd
,
992 struct nfssvc_sock
*slp
, proc_t procp
,
994 int nfsrv_readlink(struct nfsrv_descript
*nfsd
,
995 struct nfssvc_sock
*slp
, proc_t procp
,
997 int nfsrv_remove(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
998 proc_t procp
, mbuf_t
*mrq
);
999 int nfsrv_rename(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
1000 proc_t procp
, mbuf_t
*mrq
);
1001 int nfsrv_rmdir(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
1002 proc_t procp
, mbuf_t
*mrq
);
1003 int nfsrv_setattr(struct nfsrv_descript
*nfsd
,
1004 struct nfssvc_sock
*slp
,
1005 proc_t procp
, mbuf_t
*mrq
);
1006 void nfsrv_slpderef(struct nfssvc_sock
*slp
);
1007 void nfsrv_slpfree(struct nfssvc_sock
*slp
);
1008 int nfsrv_statfs(struct nfsrv_descript
*nfsd
,
1009 struct nfssvc_sock
*slp
,
1010 proc_t procp
, mbuf_t
*mrq
);
1011 int nfsrv_symlink(struct nfsrv_descript
*nfsd
,
1012 struct nfssvc_sock
*slp
,
1013 proc_t procp
, mbuf_t
*mrq
);
1014 int nfsrv_write(struct nfsrv_descript
*nfsd
, struct nfssvc_sock
*slp
,
1015 proc_t procp
, mbuf_t
*mrq
);
1016 int nfsrv_vptofh( struct nfs_export
*, int, struct nfs_filehandle
*,
1017 vnode_t
, struct vfs_context
*, struct nfs_filehandle
*);
1019 void nfs_up(struct nfsmount
*, proc_t
, int, const char *);
1020 void nfs_down(struct nfsmount
*, proc_t
, int, int, const char *);
1022 struct nfs_diskless
;
1023 int nfs_boot_init(struct nfs_diskless
*nd
, proc_t procp
);
1024 int nfs_boot_getfh(struct nfs_diskless
*nd
, proc_t procp
, int v3
, int sotype
);
1029 #endif /* __APPLE_API_PRIVATE */