[apple/xnu.git] / bsd / nfs / nfsproto.h

/*
 * Copyright (c) 2000-2003 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This Original Code and all software distributed under the License are
 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
/*
 * Copyright (c) 1989, 1993
 *	The Regents of the University of California.  All rights reserved.
 *
 * This code is derived from software contributed to Berkeley by
 * Rick Macklem at The University of Guelph.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *	This product includes software developed by the University of
 *	California, Berkeley and its contributors.
 * 4. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *	@(#)nfsproto.h	8.2 (Berkeley) 3/30/95
 * FreeBSD-Id: nfsproto.h,v 1.3 1997/02/22 09:42:50 peter Exp $
 */

#ifndef _NFS_NFSPROTO_H_
#define _NFS_NFSPROTO_H_

#include <sys/appleapiopts.h>

#ifdef __APPLE_API_PRIVATE
/*
 * nfs definitions as per the Version 2 and 3 specs
 */

/*
 * Constants as defined in the Sun NFS Version 2 and 3 specs.
 * "NFS: Network File System Protocol Specification" RFC1094
 * and in the "NFS: Network File System Version 3 Protocol
 * Specification"
 */

/* Only define these if nfs_prot.h hasn't been included */
#ifndef NFS_PROGRAM

#define NFS_PORT	2049
#define	NFS_PROG	100003
#define NFS_VER2	2
#define	NFS_VER3	3
#define NFS_V2MAXDATA	8192
#define	NFS_MAXDGRAMDATA 16384
#define	NFS_MAXDATA	(60*1024) // XXX not ready for 64K-128K
#define	NFS_MAXPATHLEN	1024
#define	NFS_MAXNAMLEN	255
#define	NFS_MAXPKTHDR	404
#define NFS_MAXPACKET	(NFS_MAXPKTHDR + NFS_MAXDATA)
#define	NFS_MINPACKET	20
#define	NFS_MAXSOCKBUF	(224*1024)
#define	NFS_FABLKSIZE	512	/* Size in bytes of a block wrt fa_blocks */

/* Stat numbers for rpc returns (version 2 and 3) */
#define	NFS_OK			0
#define	NFSERR_PERM		1
#define	NFSERR_NOENT		2
#define	NFSERR_IO		5
#define	NFSERR_NXIO		6
#define	NFSERR_ACCES		13
#define	NFSERR_EXIST		17
#define	NFSERR_XDEV		18	/* Version 3 only */
#define	NFSERR_NODEV		19
#define	NFSERR_NOTDIR		20
#define	NFSERR_ISDIR		21
#define	NFSERR_INVAL		22	/* Version 3 only */
#define	NFSERR_FBIG		27
#define	NFSERR_NOSPC		28
#define	NFSERR_ROFS		30
#define	NFSERR_MLINK		31	/* Version 3 only */
#define	NFSERR_NAMETOL		63
#define	NFSERR_NOTEMPTY		66
#define	NFSERR_DQUOT		69
#define	NFSERR_STALE		70
#define	NFSERR_REMOTE		71	/* Version 3 only */
#define	NFSERR_WFLUSH		99	/* Version 2 only */
#define	NFSERR_BADHANDLE	10001	/* The rest Version 3 only */
#define	NFSERR_NOT_SYNC		10002
#define	NFSERR_BAD_COOKIE	10003
#define	NFSERR_NOTSUPP		10004
#define	NFSERR_TOOSMALL		10005
#define	NFSERR_SERVERFAULT	10006
#define	NFSERR_BADTYPE		10007
#define	NFSERR_JUKEBOX		10008
#define NFSERR_TRYLATER		NFSERR_JUKEBOX
#define	NFSERR_STALEWRITEVERF	30001	/* Fake return for nfs_commit() */

#define NFSERR_RETVOID		0x20000000 /* Return void, not error */
#define NFSERR_AUTHERR		0x40000000 /* Mark an authentication error */
#define NFSERR_RETERR		0x80000000 /* Mark an error return for V3 */

#endif /* !NFS_PROGRAM */

/* Sizes in bytes of various nfs rpc components */
#define	NFSX_UNSIGNED	4

/* specific to NFS Version 2 */
#define	NFSX_V2FH	32
#define	NFSX_V2FATTR	68
#define	NFSX_V2SATTR	32
#define	NFSX_V2COOKIE	4
#define NFSX_V2STATFS	20

/* specific to NFS Version 3 */
#define NFSX_V3FH		(sizeof (fhandle_t)) /* size this server uses */
#define	NFSX_V3FHMAX		64	/* max. allowed by protocol */
#define NFSX_V3FATTR		84
#define NFSX_V3SATTR		60	/* max. all fields filled in */
#define NFSX_V3SRVSATTR		(sizeof (struct nfsv3_sattr))
#define NFSX_V3POSTOPATTR	(NFSX_V3FATTR + NFSX_UNSIGNED)
#define NFSX_V3WCCDATA		(NFSX_V3POSTOPATTR + 8 * NFSX_UNSIGNED)
#define NFSX_V3COOKIEVERF 	8
#define NFSX_V3WRITEVERF 	8
#define NFSX_V3CREATEVERF	8
#define NFSX_V3STATFS		52
#define NFSX_V3FSINFO		48
#define NFSX_V3PATHCONF		24

/* variants for both versions */
#define NFSX_FH(v3)		((v3) ? (NFSX_V3FHMAX + NFSX_UNSIGNED) : \
					NFSX_V2FH)
#define NFSX_SRVFH(v3)		((v3) ? NFSX_V3FH : NFSX_V2FH)
#define	NFSX_FATTR(v3)		((v3) ? NFSX_V3FATTR : NFSX_V2FATTR)
#define NFSX_PREOPATTR(v3)	((v3) ? (7 * NFSX_UNSIGNED) : 0)
#define NFSX_POSTOPATTR(v3)	((v3) ? (NFSX_V3FATTR + NFSX_UNSIGNED) : 0)
#define NFSX_POSTOPORFATTR(v3)	((v3) ? (NFSX_V3FATTR + NFSX_UNSIGNED) : \
					NFSX_V2FATTR)
#define NFSX_WCCDATA(v3)	((v3) ? NFSX_V3WCCDATA : 0)
#define NFSX_WCCORFATTR(v3)	((v3) ? NFSX_V3WCCDATA : NFSX_V2FATTR)
#define	NFSX_SATTR(v3)		((v3) ? NFSX_V3SATTR : NFSX_V2SATTR)
#define	NFSX_COOKIEVERF(v3)	((v3) ? NFSX_V3COOKIEVERF : 0)
#define	NFSX_WRITEVERF(v3)	((v3) ? NFSX_V3WRITEVERF : 0)
#define NFSX_READDIR(v3)	((v3) ? (5 * NFSX_UNSIGNED) : \
					(2 * NFSX_UNSIGNED))
#define	NFSX_STATFS(v3)		((v3) ? NFSX_V3STATFS : NFSX_V2STATFS)

/* Only define these if nfs_prot.h hasn't been included */
#ifndef NFS_PROGRAM

/* nfs rpc procedure numbers (before version mapping) */
#define	NFSPROC_NULL		0
#define	NFSPROC_GETATTR		1
#define	NFSPROC_SETATTR		2
#define	NFSPROC_LOOKUP		3
#define	NFSPROC_ACCESS		4
#define	NFSPROC_READLINK	5
#define	NFSPROC_READ		6
#define	NFSPROC_WRITE		7
#define	NFSPROC_CREATE		8
#define	NFSPROC_MKDIR		9
#define	NFSPROC_SYMLINK		10
#define	NFSPROC_MKNOD		11
#define	NFSPROC_REMOVE		12
#define	NFSPROC_RMDIR		13
#define	NFSPROC_RENAME		14
#define	NFSPROC_LINK		15
#define	NFSPROC_READDIR		16
#define	NFSPROC_READDIRPLUS	17
#define	NFSPROC_FSSTAT		18
#define	NFSPROC_FSINFO		19
#define	NFSPROC_PATHCONF	20
#define	NFSPROC_COMMIT		21

#endif /* !NFS_PROGRAM */

/* And leasing (nqnfs) procedure numbers (must be last) */
#define	NQNFSPROC_GETLEASE	22
#define	NQNFSPROC_VACATED	23
#define	NQNFSPROC_EVICTED	24

#define NFSPROC_NOOP		25
#define	NFS_NPROCS		26

/* Actual Version 2 procedure numbers */
#define	NFSV2PROC_NULL		0
#define	NFSV2PROC_GETATTR	1
#define	NFSV2PROC_SETATTR	2
#define	NFSV2PROC_NOOP		3
#define	NFSV2PROC_ROOT		NFSV2PROC_NOOP	/* Obsolete */
#define	NFSV2PROC_LOOKUP	4
#define	NFSV2PROC_READLINK	5
#define	NFSV2PROC_READ		6
#define	NFSV2PROC_WRITECACHE	NFSV2PROC_NOOP	/* Obsolete */
#define	NFSV2PROC_WRITE		8
#define	NFSV2PROC_CREATE	9
#define	NFSV2PROC_REMOVE	10
#define	NFSV2PROC_RENAME	11
#define	NFSV2PROC_LINK		12
#define	NFSV2PROC_SYMLINK	13
#define	NFSV2PROC_MKDIR		14
#define	NFSV2PROC_RMDIR		15
#define	NFSV2PROC_READDIR	16
#define	NFSV2PROC_STATFS	17

/*
 * Constants used by the Version 3 protocol for various RPCs
 */
#define NFSV3SATTRTIME_DONTCHANGE	0
#define NFSV3SATTRTIME_TOSERVER		1
#define NFSV3SATTRTIME_TOCLIENT		2

#define NFSV3ACCESS_READ		0x01
#define NFSV3ACCESS_LOOKUP		0x02
#define NFSV3ACCESS_MODIFY		0x04
#define NFSV3ACCESS_EXTEND		0x08
#define NFSV3ACCESS_DELETE		0x10
#define NFSV3ACCESS_EXECUTE		0x20

#define NFSV3WRITE_UNSTABLE		0
#define NFSV3WRITE_DATASYNC		1
#define NFSV3WRITE_FILESYNC		2

#define NFSV3CREATE_UNCHECKED		0
#define NFSV3CREATE_GUARDED		1
#define NFSV3CREATE_EXCLUSIVE		2

#define NFSV3FSINFO_LINK		0x01
#define NFSV3FSINFO_SYMLINK		0x02
#define NFSV3FSINFO_HOMOGENEOUS		0x08
#define NFSV3FSINFO_CANSETTIME		0x10

/* Conversion macros */
#define	vtonfsv2_mode(t,m) \
		txdr_unsigned(((t) == VFIFO) ? MAKEIMODE(VCHR, (m)) : \
				MAKEIMODE((t), (m)))
#define vtonfsv3_mode(m)	txdr_unsigned((m) & 07777)
#define	nfstov_mode(a)		(fxdr_unsigned(u_short, (a))&07777)
#define	vtonfsv2_type(a)	txdr_unsigned(nfsv2_type[((long)(a))])
#define	vtonfsv3_type(a)	txdr_unsigned(nfsv3_type[((long)(a))])
#define	nfsv2tov_type(a)	nv2tov_type[fxdr_unsigned(u_long,(a))&0x7]
#define	nfsv3tov_type(a)	nv3tov_type[fxdr_unsigned(u_long,(a))&0x7]

/* Only define these if nfs_prot.h hasn't been included */
#ifndef NFS_PROGRAM

/* File types */
typedef enum { NFNON=0, NFREG=1, NFDIR=2, NFBLK=3, NFCHR=4, NFLNK=5,
	NFSOCK=6, NFFIFO=7 } nfstype;
#endif /* !NFS_PROGRAM */

/* Structs for common parts of the rpc's */
/*
 * File Handle (32 bytes for version 2), variable up to 64 for version 3.
 * File Handles of up to NFS_SMALLFH in size are stored directly in the
 * nfs node, whereas larger ones are malloc'd. (This never happens when
 * NFS_SMALLFH is set to 64.)
 * NFS_SMALLFH should be in the range of 32 to 64 and be divisible by 4.
 */
#ifndef NFS_SMALLFH
#define NFS_SMALLFH	64
#endif
union nfsfh {
	fhandle_t	fh_generic;
	u_char		fh_bytes[NFS_SMALLFH];
};
typedef union nfsfh nfsfh_t;

struct nfsv2_time {
	u_long	nfsv2_sec;
	u_long	nfsv2_usec;
};
typedef struct nfsv2_time	nfstime2;

struct nfsv3_time {
	u_long	nfsv3_sec;
	u_long	nfsv3_nsec;
};
typedef struct nfsv3_time	nfstime3;

/*
 * Quads are defined as arrays of 2 longs to ensure dense packing for the
 * protocol and to facilitate xdr conversion.
 */
struct nfs_uquad {
	u_long	nfsuquad[2];
};
typedef	struct nfs_uquad	nfsuint64;

/*
 * Used to convert between two u_longs and a u_quad_t.
 */
union nfs_quadconvert {
	u_long		lval[2];
	u_quad_t	qval;
};
typedef union nfs_quadconvert	nfsquad_t;

/*
 * NFS Version 3 special file number.
 */
struct nfsv3_spec {
	u_long	specdata1;
	u_long	specdata2;
};
typedef	struct nfsv3_spec	nfsv3spec;

/*
 * File attributes and setable attributes. These structures cover both
 * NFS version 2 and the version 3 protocol. Note that the union is only
 * used so that one pointer can refer to both variants. These structures
 * go out on the wire and must be densely packed, so no quad data types
 * are used. (all fields are longs or u_longs or structures of same)
 * NB: You can't do sizeof(struct nfs_fattr), you must use the
 *     NFSX_FATTR(v3) macro.
 */
struct nfs_fattr {
	u_long	fa_type;
	u_long	fa_mode;
	u_long	fa_nlink;
	u_long	fa_uid;
	u_long	fa_gid;
	union {
		struct {
			u_long		nfsv2fa_size;
			u_long		nfsv2fa_blocksize;
			u_long		nfsv2fa_rdev;
			u_long		nfsv2fa_blocks;
			u_long		nfsv2fa_fsid;
			u_long		nfsv2fa_fileid;
			nfstime2	nfsv2fa_atime;
			nfstime2	nfsv2fa_mtime;
			nfstime2	nfsv2fa_ctime;
		} fa_nfsv2;
		struct {
			nfsuint64	nfsv3fa_size;
			nfsuint64	nfsv3fa_used;
			nfsv3spec	nfsv3fa_rdev;
			nfsuint64	nfsv3fa_fsid;
			nfsuint64	nfsv3fa_fileid;
			nfstime3	nfsv3fa_atime;
			nfstime3	nfsv3fa_mtime;
			nfstime3	nfsv3fa_ctime;
		} fa_nfsv3;
	} fa_un;
};

/* and some ugly defines for accessing union components */
#define	fa2_size		fa_un.fa_nfsv2.nfsv2fa_size
#define	fa2_blocksize		fa_un.fa_nfsv2.nfsv2fa_blocksize
#define	fa2_rdev		fa_un.fa_nfsv2.nfsv2fa_rdev
#define	fa2_blocks		fa_un.fa_nfsv2.nfsv2fa_blocks
#define	fa2_fsid		fa_un.fa_nfsv2.nfsv2fa_fsid
#define	fa2_fileid		fa_un.fa_nfsv2.nfsv2fa_fileid
#define	fa2_atime		fa_un.fa_nfsv2.nfsv2fa_atime
#define	fa2_mtime		fa_un.fa_nfsv2.nfsv2fa_mtime
#define	fa2_ctime		fa_un.fa_nfsv2.nfsv2fa_ctime
#define	fa3_size		fa_un.fa_nfsv3.nfsv3fa_size
#define	fa3_used		fa_un.fa_nfsv3.nfsv3fa_used
#define	fa3_rdev		fa_un.fa_nfsv3.nfsv3fa_rdev
#define	fa3_fsid		fa_un.fa_nfsv3.nfsv3fa_fsid
#define	fa3_fileid		fa_un.fa_nfsv3.nfsv3fa_fileid
#define	fa3_atime		fa_un.fa_nfsv3.nfsv3fa_atime
#define	fa3_mtime		fa_un.fa_nfsv3.nfsv3fa_mtime
#define	fa3_ctime		fa_un.fa_nfsv3.nfsv3fa_ctime

struct nfsv2_sattr {
	u_long		sa_mode;
	u_long		sa_uid;
	u_long		sa_gid;
	u_long		sa_size;
	nfstime2	sa_atime;
	nfstime2	sa_mtime;
};

/*
 * NFS Version 3 sattr structure for the new node creation case.
 */
struct nfsv3_sattr {
	u_long		sa_modetrue;
	u_long		sa_mode;
	u_long		sa_uidtrue;
	u_long		sa_uid;
	u_long		sa_gidtrue;
	u_long		sa_gid;
	u_long		sa_sizefalse;
	u_long		sa_atimetype;
	u_long		sa_mtimetype;
};

struct nfs_statfs {
	union {
		struct {
			u_long		nfsv2sf_tsize;
			u_long		nfsv2sf_bsize;
			u_long		nfsv2sf_blocks;
			u_long		nfsv2sf_bfree;
			u_long		nfsv2sf_bavail;
		} sf_nfsv2;
		struct {
			nfsuint64	nfsv3sf_tbytes;
			nfsuint64	nfsv3sf_fbytes;
			nfsuint64	nfsv3sf_abytes;
			nfsuint64	nfsv3sf_tfiles;
			nfsuint64	nfsv3sf_ffiles;
			nfsuint64	nfsv3sf_afiles;
			u_long		nfsv3sf_invarsec;
		} sf_nfsv3;
	} sf_un;
};

#define sf_tsize	sf_un.sf_nfsv2.nfsv2sf_tsize
#define sf_bsize	sf_un.sf_nfsv2.nfsv2sf_bsize
#define sf_blocks	sf_un.sf_nfsv2.nfsv2sf_blocks
#define sf_bfree	sf_un.sf_nfsv2.nfsv2sf_bfree
#define sf_bavail	sf_un.sf_nfsv2.nfsv2sf_bavail
#define sf_tbytes	sf_un.sf_nfsv3.nfsv3sf_tbytes
#define sf_fbytes	sf_un.sf_nfsv3.nfsv3sf_fbytes
#define sf_abytes	sf_un.sf_nfsv3.nfsv3sf_abytes
#define sf_tfiles	sf_un.sf_nfsv3.nfsv3sf_tfiles
#define sf_ffiles	sf_un.sf_nfsv3.nfsv3sf_ffiles
#define sf_afiles	sf_un.sf_nfsv3.nfsv3sf_afiles
#define sf_invarsec	sf_un.sf_nfsv3.nfsv3sf_invarsec

struct nfsv3_fsinfo {
	u_long		fs_rtmax;
	u_long		fs_rtpref;
	u_long		fs_rtmult;
	u_long		fs_wtmax;
	u_long		fs_wtpref;
	u_long		fs_wtmult;
	u_long		fs_dtpref;
	nfsuint64	fs_maxfilesize;
	nfstime3	fs_timedelta;
	u_long		fs_properties;
};

struct nfsv3_pathconf {
	u_long		pc_linkmax;
	u_long		pc_namemax;
	u_long		pc_notrunc;
	u_long		pc_chownrestricted;
	u_long		pc_caseinsensitive;
	u_long		pc_casepreserving;
};

#endif /* __APPLE_API_PRIVATE */
#endif /* _NFS_NFSPROTO_H_ */
Commit	Line	Data
1c79356b	1	/*
55e303ae	2	* Copyright (c) 2000-2003 Apple Computer, Inc. All rights reserved.
1c79356b A	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
e5568f75 A	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
1c79356b	11	*
e5568f75 A	12	* This Original Code and all software distributed under the License are
e5568f75 A	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
1c79356b A	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
1c79356b A	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
e5568f75 A	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
1c79356b A	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
	23	/*
	24	* Copyright (c) 1989, 1993
	25	* The Regents of the University of California. All rights reserved.
	26	*
	27	* This code is derived from software contributed to Berkeley by
	28	* Rick Macklem at The University of Guelph.
	29	*
	30	* Redistribution and use in source and binary forms, with or without
	31	* modification, are permitted provided that the following conditions
	32	* are met:
	33	* 1. Redistributions of source code must retain the above copyright
	34	* notice, this list of conditions and the following disclaimer.
	35	* 2. Redistributions in binary form must reproduce the above copyright
	36	* notice, this list of conditions and the following disclaimer in the
	37	* documentation and/or other materials provided with the distribution.
	38	* 3. All advertising materials mentioning features or use of this software
	39	* must display the following acknowledgement:
	40	* This product includes software developed by the University of
	41	* California, Berkeley and its contributors.
	42	* 4. Neither the name of the University nor the names of its contributors
	43	* may be used to endorse or promote products derived from this software
	44	* without specific prior written permission.
	45	*
	46	* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	47	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	48	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	49	* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	50	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	51	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	52	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	53	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	54	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	55	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	56	* SUCH DAMAGE.
	57	*
	58	* @(#)nfsproto.h 8.2 (Berkeley) 3/30/95
	59	* FreeBSD-Id: nfsproto.h,v 1.3 1997/02/22 09:42:50 peter Exp $
	60	*/
	61
	62	#ifndef _NFS_NFSPROTO_H_
	63	#define _NFS_NFSPROTO_H_
	64
9bccf70c A	65	#include <sys/appleapiopts.h>
	66
	67	#ifdef __APPLE_API_PRIVATE
1c79356b A	68	/*
	69	* nfs definitions as per the Version 2 and 3 specs
	70	*/
	71
	72	/*
	73	* Constants as defined in the Sun NFS Version 2 and 3 specs.
	74	* "NFS: Network File System Protocol Specification" RFC1094
	75	* and in the "NFS: Network File System Version 3 Protocol
	76	* Specification"
	77	*/
	78
	79	/* Only define these if nfs_prot.h hasn't been included */
	80	#ifndef NFS_PROGRAM
	81
	82	#define NFS_PORT 2049
	83	#define NFS_PROG 100003
	84	#define NFS_VER2 2
	85	#define NFS_VER3 3
	86	#define NFS_V2MAXDATA 8192
	87	#define NFS_MAXDGRAMDATA 16384
55e303ae	88	#define NFS_MAXDATA (60*1024) // XXX not ready for 64K-128K
1c79356b A	89	#define NFS_MAXPATHLEN 1024
	90	#define NFS_MAXNAMLEN 255
	91	#define NFS_MAXPKTHDR 404
	92	#define NFS_MAXPACKET (NFS_MAXPKTHDR + NFS_MAXDATA)
	93	#define NFS_MINPACKET 20
55e303ae	94	#define NFS_MAXSOCKBUF (224*1024)
1c79356b A	95	#define NFS_FABLKSIZE 512 /* Size in bytes of a block wrt fa_blocks */
	96
	97	/* Stat numbers for rpc returns (version 2 and 3) */
	98	#define NFS_OK 0
	99	#define NFSERR_PERM 1
	100	#define NFSERR_NOENT 2
	101	#define NFSERR_IO 5
	102	#define NFSERR_NXIO 6
	103	#define NFSERR_ACCES 13
	104	#define NFSERR_EXIST 17
	105	#define NFSERR_XDEV 18 /* Version 3 only */
	106	#define NFSERR_NODEV 19
	107	#define NFSERR_NOTDIR 20
	108	#define NFSERR_ISDIR 21
	109	#define NFSERR_INVAL 22 /* Version 3 only */
	110	#define NFSERR_FBIG 27
	111	#define NFSERR_NOSPC 28
	112	#define NFSERR_ROFS 30
	113	#define NFSERR_MLINK 31 /* Version 3 only */
	114	#define NFSERR_NAMETOL 63
	115	#define NFSERR_NOTEMPTY 66
	116	#define NFSERR_DQUOT 69
	117	#define NFSERR_STALE 70
	118	#define NFSERR_REMOTE 71 /* Version 3 only */
	119	#define NFSERR_WFLUSH 99 /* Version 2 only */
	120	#define NFSERR_BADHANDLE 10001 /* The rest Version 3 only */
	121	#define NFSERR_NOT_SYNC 10002
	122	#define NFSERR_BAD_COOKIE 10003
	123	#define NFSERR_NOTSUPP 10004
	124	#define NFSERR_TOOSMALL 10005
	125	#define NFSERR_SERVERFAULT 10006
	126	#define NFSERR_BADTYPE 10007
	127	#define NFSERR_JUKEBOX 10008
	128	#define NFSERR_TRYLATER NFSERR_JUKEBOX
	129	#define NFSERR_STALEWRITEVERF 30001 /* Fake return for nfs_commit() */
	130
	131	#define NFSERR_RETVOID 0x20000000 /* Return void, not error */
	132	#define NFSERR_AUTHERR 0x40000000 /* Mark an authentication error */
	133	#define NFSERR_RETERR 0x80000000 /* Mark an error return for V3 */
	134
	135	#endif /* !NFS_PROGRAM */
	136
	137	/* Sizes in bytes of various nfs rpc components */
	138	#define NFSX_UNSIGNED 4
	139
	140	/* specific to NFS Version 2 */
	141	#define NFSX_V2FH 32
	142	#define NFSX_V2FATTR 68
	143	#define NFSX_V2SATTR 32
	144	#define NFSX_V2COOKIE 4
	145	#define NFSX_V2STATFS 20
	146
	147	/* specific to NFS Version 3 */
	148	#define NFSX_V3FH (sizeof (fhandle_t)) /* size this server uses */
	149	#define NFSX_V3FHMAX 64 /* max. allowed by protocol */
	150	#define NFSX_V3FATTR 84
	151	#define NFSX_V3SATTR 60 /* max. all fields filled in */
	152	#define NFSX_V3SRVSATTR (sizeof (struct nfsv3_sattr))
	153	#define NFSX_V3POSTOPATTR (NFSX_V3FATTR + NFSX_UNSIGNED)
	154	#define NFSX_V3WCCDATA (NFSX_V3POSTOPATTR + 8 * NFSX_UNSIGNED)
	155	#define NFSX_V3COOKIEVERF 8
	156	#define NFSX_V3WRITEVERF 8
	157	#define NFSX_V3CREATEVERF 8
	158	#define NFSX_V3STATFS 52
159	#define NFSX_V3FSINFO 48
160	#define NFSX_V3PATHCONF 24
161
162	/* variants for both versions */
163	#define NFSX_FH(v3) ((v3) ? (NFSX_V3FHMAX + NFSX_UNSIGNED) : \
164	NFSX_V2FH)
165	#define NFSX_SRVFH(v3) ((v3) ? NFSX_V3FH : NFSX_V2FH)
166	#define NFSX_FATTR(v3) ((v3) ? NFSX_V3FATTR : NFSX_V2FATTR)
167	#define NFSX_PREOPATTR(v3) ((v3) ? (7 * NFSX_UNSIGNED) : 0)
168	#define NFSX_POSTOPATTR(v3) ((v3) ? (NFSX_V3FATTR + NFSX_UNSIGNED) : 0)
169	#define NFSX_POSTOPORFATTR(v3) ((v3) ? (NFSX_V3FATTR + NFSX_UNSIGNED) : \
170	NFSX_V2FATTR)
171	#define NFSX_WCCDATA(v3) ((v3) ? NFSX_V3WCCDATA : 0)
172	#define NFSX_WCCORFATTR(v3) ((v3) ? NFSX_V3WCCDATA : NFSX_V2FATTR)
173	#define NFSX_SATTR(v3) ((v3) ? NFSX_V3SATTR : NFSX_V2SATTR)
174	#define NFSX_COOKIEVERF(v3) ((v3) ? NFSX_V3COOKIEVERF : 0)
175	#define NFSX_WRITEVERF(v3) ((v3) ? NFSX_V3WRITEVERF : 0)
176	#define NFSX_READDIR(v3) ((v3) ? (5 * NFSX_UNSIGNED) : \
177	(2 * NFSX_UNSIGNED))
178	#define NFSX_STATFS(v3) ((v3) ? NFSX_V3STATFS : NFSX_V2STATFS)
179
180	/* Only define these if nfs_prot.h hasn't been included */
181	#ifndef NFS_PROGRAM
182
183	/* nfs rpc procedure numbers (before version mapping) */
184	#define NFSPROC_NULL 0
185	#define NFSPROC_GETATTR 1
186	#define NFSPROC_SETATTR 2
187	#define NFSPROC_LOOKUP 3
188	#define NFSPROC_ACCESS 4
189	#define NFSPROC_READLINK 5
190	#define NFSPROC_READ 6
191	#define NFSPROC_WRITE 7
192	#define NFSPROC_CREATE 8
193	#define NFSPROC_MKDIR 9
194	#define NFSPROC_SYMLINK 10
195	#define NFSPROC_MKNOD 11
196	#define NFSPROC_REMOVE 12
197	#define NFSPROC_RMDIR 13
198	#define NFSPROC_RENAME 14
199	#define NFSPROC_LINK 15
200	#define NFSPROC_READDIR 16
201	#define NFSPROC_READDIRPLUS 17
202	#define NFSPROC_FSSTAT 18
203	#define NFSPROC_FSINFO 19
204	#define NFSPROC_PATHCONF 20
205	#define NFSPROC_COMMIT 21
206
207	#endif /* !NFS_PROGRAM */
208
209	/* And leasing (nqnfs) procedure numbers (must be last) */
210	#define NQNFSPROC_GETLEASE 22
211	#define NQNFSPROC_VACATED 23
212	#define NQNFSPROC_EVICTED 24
213
214	#define NFSPROC_NOOP 25
215	#define NFS_NPROCS 26
216
217	/* Actual Version 2 procedure numbers */
218	#define NFSV2PROC_NULL 0
219	#define NFSV2PROC_GETATTR 1
220	#define NFSV2PROC_SETATTR 2
221	#define NFSV2PROC_NOOP 3
222	#define NFSV2PROC_ROOT NFSV2PROC_NOOP /* Obsolete */
223	#define NFSV2PROC_LOOKUP 4
224	#define NFSV2PROC_READLINK 5
225	#define NFSV2PROC_READ 6
226	#define NFSV2PROC_WRITECACHE NFSV2PROC_NOOP /* Obsolete */
227	#define NFSV2PROC_WRITE 8
228	#define NFSV2PROC_CREATE 9
229	#define NFSV2PROC_REMOVE 10
230	#define NFSV2PROC_RENAME 11
231	#define NFSV2PROC_LINK 12
232	#define NFSV2PROC_SYMLINK 13
233	#define NFSV2PROC_MKDIR 14
234	#define NFSV2PROC_RMDIR 15
235	#define NFSV2PROC_READDIR 16
236	#define NFSV2PROC_STATFS 17
237
238	/*
239	* Constants used by the Version 3 protocol for various RPCs
240	*/
241	#define NFSV3SATTRTIME_DONTCHANGE 0
242	#define NFSV3SATTRTIME_TOSERVER 1
243	#define NFSV3SATTRTIME_TOCLIENT 2
244
245	#define NFSV3ACCESS_READ 0x01
246	#define NFSV3ACCESS_LOOKUP 0x02
247	#define NFSV3ACCESS_MODIFY 0x04
248	#define NFSV3ACCESS_EXTEND 0x08
249	#define NFSV3ACCESS_DELETE 0x10
250	#define NFSV3ACCESS_EXECUTE 0x20
251
252	#define NFSV3WRITE_UNSTABLE 0
253	#define NFSV3WRITE_DATASYNC 1
254	#define NFSV3WRITE_FILESYNC 2
255
256	#define NFSV3CREATE_UNCHECKED 0
257	#define NFSV3CREATE_GUARDED 1
258	#define NFSV3CREATE_EXCLUSIVE 2
259
260	#define NFSV3FSINFO_LINK 0x01
261	#define NFSV3FSINFO_SYMLINK 0x02
262	#define NFSV3FSINFO_HOMOGENEOUS 0x08
263	#define NFSV3FSINFO_CANSETTIME 0x10
264
265	/* Conversion macros */
266	#define vtonfsv2_mode(t,m) \
267	txdr_unsigned(((t) == VFIFO) ? MAKEIMODE(VCHR, (m)) : \
268	MAKEIMODE((t), (m)))
269	#define vtonfsv3_mode(m) txdr_unsigned((m) & 07777)
270	#define nfstov_mode(a) (fxdr_unsigned(u_short, (a))&07777)
271	#define vtonfsv2_type(a) txdr_unsigned(nfsv2_type[((long)(a))])
272	#define vtonfsv3_type(a) txdr_unsigned(nfsv3_type[((long)(a))])
273	#define nfsv2tov_type(a) nv2tov_type[fxdr_unsigned(u_long,(a))&0x7]
274	#define nfsv3tov_type(a) nv3tov_type[fxdr_unsigned(u_long,(a))&0x7]
275
276	/* Only define these if nfs_prot.h hasn't been included */
277	#ifndef NFS_PROGRAM
278
279	/* File types */
280	typedef enum { NFNON=0, NFREG=1, NFDIR=2, NFBLK=3, NFCHR=4, NFLNK=5,
281	NFSOCK=6, NFFIFO=7 } nfstype;
282	#endif /* !NFS_PROGRAM */
283
284	/* Structs for common parts of the rpc's */
285	/*
286	* File Handle (32 bytes for version 2), variable up to 64 for version 3.
287	* File Handles of up to NFS_SMALLFH in size are stored directly in the
288	* nfs node, whereas larger ones are malloc'd. (This never happens when
289	* NFS_SMALLFH is set to 64.)
290	* NFS_SMALLFH should be in the range of 32 to 64 and be divisible by 4.
291	*/
292	#ifndef NFS_SMALLFH
293	#define NFS_SMALLFH 64
294	#endif
295	union nfsfh {
296	fhandle_t fh_generic;
297	u_char fh_bytes[NFS_SMALLFH];
298	};
299	typedef union nfsfh nfsfh_t;
300
301	struct nfsv2_time {
302	u_long nfsv2_sec;
303	u_long nfsv2_usec;
304	};
305	typedef struct nfsv2_time nfstime2;
306
307	struct nfsv3_time {
308	u_long nfsv3_sec;
309	u_long nfsv3_nsec;
310	};
311	typedef struct nfsv3_time nfstime3;
312
313	/*
314	* Quads are defined as arrays of 2 longs to ensure dense packing for the
315	* protocol and to facilitate xdr conversion.
316	*/
317	struct nfs_uquad {
318	u_long nfsuquad[2];
319	};
320	typedef struct nfs_uquad nfsuint64;
321
322	/*
323	* Used to convert between two u_longs and a u_quad_t.
324	*/
325	union nfs_quadconvert {
326	u_long lval[2];
327	u_quad_t qval;
328	};
329	typedef union nfs_quadconvert nfsquad_t;
330
331	/*
332	* NFS Version 3 special file number.
333	*/
334	struct nfsv3_spec {
335	u_long specdata1;
336	u_long specdata2;
337	};
338	typedef struct nfsv3_spec nfsv3spec;
339
340	/*
341	* File attributes and setable attributes. These structures cover both
342	* NFS version 2 and the version 3 protocol. Note that the union is only
343	* used so that one pointer can refer to both variants. These structures
344	* go out on the wire and must be densely packed, so no quad data types
345	* are used. (all fields are longs or u_longs or structures of same)
346	* NB: You can't do sizeof(struct nfs_fattr), you must use the
347	* NFSX_FATTR(v3) macro.
348	*/
349	struct nfs_fattr {
350	u_long fa_type;
351	u_long fa_mode;
352	u_long fa_nlink;
353	u_long fa_uid;
354	u_long fa_gid;
355	union {
356	struct {
357	u_long nfsv2fa_size;
358	u_long nfsv2fa_blocksize;
359	u_long nfsv2fa_rdev;
360	u_long nfsv2fa_blocks;
361	u_long nfsv2fa_fsid;
362	u_long nfsv2fa_fileid;
363	nfstime2 nfsv2fa_atime;
364	nfstime2 nfsv2fa_mtime;
365	nfstime2 nfsv2fa_ctime;
366	} fa_nfsv2;
367	struct {
368	nfsuint64 nfsv3fa_size;
369	nfsuint64 nfsv3fa_used;
370	nfsv3spec nfsv3fa_rdev;
371	nfsuint64 nfsv3fa_fsid;
372	nfsuint64 nfsv3fa_fileid;
373	nfstime3 nfsv3fa_atime;
374	nfstime3 nfsv3fa_mtime;
375	nfstime3 nfsv3fa_ctime;
376	} fa_nfsv3;
377	} fa_un;
378	};
379
380	/* and some ugly defines for accessing union components */
381	#define fa2_size fa_un.fa_nfsv2.nfsv2fa_size
382	#define fa2_blocksize fa_un.fa_nfsv2.nfsv2fa_blocksize
383	#define fa2_rdev fa_un.fa_nfsv2.nfsv2fa_rdev
384	#define fa2_blocks fa_un.fa_nfsv2.nfsv2fa_blocks
385	#define fa2_fsid fa_un.fa_nfsv2.nfsv2fa_fsid
386	#define fa2_fileid fa_un.fa_nfsv2.nfsv2fa_fileid
387	#define fa2_atime fa_un.fa_nfsv2.nfsv2fa_atime
388	#define fa2_mtime fa_un.fa_nfsv2.nfsv2fa_mtime
389	#define fa2_ctime fa_un.fa_nfsv2.nfsv2fa_ctime
390	#define fa3_size fa_un.fa_nfsv3.nfsv3fa_size
391	#define fa3_used fa_un.fa_nfsv3.nfsv3fa_used
392	#define fa3_rdev fa_un.fa_nfsv3.nfsv3fa_rdev
393	#define fa3_fsid fa_un.fa_nfsv3.nfsv3fa_fsid
394	#define fa3_fileid fa_un.fa_nfsv3.nfsv3fa_fileid
395	#define fa3_atime fa_un.fa_nfsv3.nfsv3fa_atime
396	#define fa3_mtime fa_un.fa_nfsv3.nfsv3fa_mtime
397	#define fa3_ctime fa_un.fa_nfsv3.nfsv3fa_ctime
398
399	struct nfsv2_sattr {
400	u_long sa_mode;
401	u_long sa_uid;
402	u_long sa_gid;
403	u_long sa_size;
404	nfstime2 sa_atime;
405	nfstime2 sa_mtime;
406	};
407
408	/*
409	* NFS Version 3 sattr structure for the new node creation case.
410	*/
411	struct nfsv3_sattr {
412	u_long sa_modetrue;
413	u_long sa_mode;
414	u_long sa_uidtrue;
415	u_long sa_uid;
416	u_long sa_gidtrue;
417	u_long sa_gid;
418	u_long sa_sizefalse;
419	u_long sa_atimetype;
420	u_long sa_mtimetype;
421	};
422
423	struct nfs_statfs {
424	union {
425	struct {
426	u_long nfsv2sf_tsize;
427	u_long nfsv2sf_bsize;
428	u_long nfsv2sf_blocks;
429	u_long nfsv2sf_bfree;
430	u_long nfsv2sf_bavail;
431	} sf_nfsv2;
432	struct {
433	nfsuint64 nfsv3sf_tbytes;
434	nfsuint64 nfsv3sf_fbytes;
435	nfsuint64 nfsv3sf_abytes;
436	nfsuint64 nfsv3sf_tfiles;
437	nfsuint64 nfsv3sf_ffiles;
438	nfsuint64 nfsv3sf_afiles;
439	u_long nfsv3sf_invarsec;
440	} sf_nfsv3;
441	} sf_un;
442	};
443
444	#define sf_tsize sf_un.sf_nfsv2.nfsv2sf_tsize
445	#define sf_bsize sf_un.sf_nfsv2.nfsv2sf_bsize
446	#define sf_blocks sf_un.sf_nfsv2.nfsv2sf_blocks
447	#define sf_bfree sf_un.sf_nfsv2.nfsv2sf_bfree
448	#define sf_bavail sf_un.sf_nfsv2.nfsv2sf_bavail
449	#define sf_tbytes sf_un.sf_nfsv3.nfsv3sf_tbytes
450	#define sf_fbytes sf_un.sf_nfsv3.nfsv3sf_fbytes
451	#define sf_abytes sf_un.sf_nfsv3.nfsv3sf_abytes
452	#define sf_tfiles sf_un.sf_nfsv3.nfsv3sf_tfiles
453	#define sf_ffiles sf_un.sf_nfsv3.nfsv3sf_ffiles
454	#define sf_afiles sf_un.sf_nfsv3.nfsv3sf_afiles
455	#define sf_invarsec sf_un.sf_nfsv3.nfsv3sf_invarsec
456
457	struct nfsv3_fsinfo {
458	u_long fs_rtmax;
459	u_long fs_rtpref;
460	u_long fs_rtmult;
461	u_long fs_wtmax;
462	u_long fs_wtpref;
463	u_long fs_wtmult;
464	u_long fs_dtpref;
465	nfsuint64 fs_maxfilesize;
466	nfstime3 fs_timedelta;
467	u_long fs_properties;
468	};
469
470	struct nfsv3_pathconf {
471	u_long pc_linkmax;
472	u_long pc_namemax;
473	u_long pc_notrunc;
474	u_long pc_chownrestricted;
475	u_long pc_caseinsensitive;
476	u_long pc_casepreserving;
477	};
478
9bccf70c A	479	#endif /* __APPLE_API_PRIVATE */
9bccf70c A	480	#endif /* _NFS_NFSPROTO_H_ */