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