2 * include/linux/nfsd/nfsfh.h
4 * This file describes the layout of the file handles as passed
7 * Earlier versions of knfsd used to sign file handles using keyed MD5
8 * or SHA. I've removed this code, because it doesn't give you more
9 * security than blocking external access to port 2049 on your firewall.
11 * Copyright (C) 1995, 1996, 1997 Olaf Kirch <okir@monad.swb.de>
14 #ifndef _LINUX_NFSD_FH_H
15 #define _LINUX_NFSD_FH_H
17 # include <linux/types.h>
18 #include <linux/nfsd/const.h>
21 * This is the old "dentry style" Linux NFSv2 file handle.
23 * The xino and xdev fields are currently used to transport the
24 * ino/dev of the exported inode.
26 struct nfs_fhbase_old
{
27 __u32 fb_dcookie
; /* dentry cookie - always 0xfeebbaca */
28 __u32 fb_ino
; /* our inode number */
29 __u32 fb_dirino
; /* dir inode number, 0 for directories */
30 __u32 fb_dev
; /* our device */
37 * This is the new flexible, extensible style NFSv2/v3 file handle.
38 * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000
40 * The file handle starts with a sequence of four-byte words.
41 * The first word contains a version number (1) and three descriptor bytes
42 * that tell how the remaining 3 variable length fields should be handled.
43 * These three bytes are auth_type, fsid_type and fileid_type.
45 * All four-byte values are in host-byte-order.
47 * The auth_type field specifies how the filehandle can be authenticated
48 * This might allow a file to be confirmed to be in a writable part of a
49 * filetree without checking the path from it upto the root.
51 * 0 - No authentication. fb_auth is 0 bytes long
52 * Possible future values:
53 * 1 - 4 bytes taken from MD5 hash of the remainer of the file handle
54 * prefixed by a secret and with the important export flags.
56 * The fsid_type identifies how the filesystem (or export point) is
59 * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number
60 * NOTE: we cannot use the kdev_t device id value, because kdev_t.h
61 * says we mustn't. We must break it up and reassemble.
62 * 1 - 4 byte user specified identifier
63 * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED
64 * 3 - 4 byte device id, encoded for user-space, 4 byte inode number
65 * 4 - 4 byte inode number and 4 byte uuid
68 * 7 - 8 byte inode number and 16 byte uuid
70 * The fileid_type identified how the file within the filesystem is encoded.
71 * This is (will be) passed to, and set by, the underlying filesystem if it supports
72 * filehandle operations. The filesystem must not use the value '0' or '0xff' and may
73 * only use the values 1 and 2 as defined below:
75 * 0 - The root, or export point, of the filesystem. fb_fileid is 0 bytes.
76 * 1 - 32bit inode number, 32 bit generation number.
77 * 2 - 32bit inode number, 32 bit generation number, 32 bit parent directory inode number.
80 struct nfs_fhbase_new
{
81 __u8 fb_version
; /* == 1, even => nfs_fhbase_old */
86 /* __u32 fb_fsid[0]; floating */
87 /* __u32 fb_fileid[0]; floating */
91 unsigned int fh_size
; /* significant for NFSv3.
92 * Points to the current size while building
96 struct nfs_fhbase_old fh_old
;
97 __u32 fh_pad
[NFS4_FHSIZE
/4];
98 struct nfs_fhbase_new fh_new
;
102 #define ofh_dcookie fh_base.fh_old.fb_dcookie
103 #define ofh_ino fh_base.fh_old.fb_ino
104 #define ofh_dirino fh_base.fh_old.fb_dirino
105 #define ofh_dev fh_base.fh_old.fb_dev
106 #define ofh_xdev fh_base.fh_old.fb_xdev
107 #define ofh_xino fh_base.fh_old.fb_xino
108 #define ofh_generation fh_base.fh_old.fb_generation
110 #define fh_version fh_base.fh_new.fb_version
111 #define fh_fsid_type fh_base.fh_new.fb_fsid_type
112 #define fh_auth_type fh_base.fh_new.fb_auth_type
113 #define fh_fileid_type fh_base.fh_new.fb_fileid_type
114 #define fh_auth fh_base.fh_new.fb_auth
115 #define fh_fsid fh_base.fh_new.fb_auth
119 #endif /* _LINUX_NFSD_FH_H */