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 <asm/types.h>
19 # include <linux/config.h>
20 # include <linux/types.h>
21 # include <linux/string.h>
22 # include <linux/fs.h>
24 #include <linux/nfsd/const.h>
25 #include <linux/nfsd/debug.h>
28 * This is the old "dentry style" Linux NFSv2 file handle.
30 * The xino and xdev fields are currently used to transport the
31 * ino/dev of the exported inode.
33 struct nfs_fhbase_old
{
34 __u32 fb_dcookie
; /* dentry cookie - always 0xfeebbaca */
35 __u32 fb_ino
; /* our inode number */
36 __u32 fb_dirino
; /* dir inode number, 0 for directories */
37 __u32 fb_dev
; /* our device */
44 * This is the new flexible, extensible style NFSv2/v3 file handle.
45 * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000
47 * The file handle is seens as a list of 4byte words.
48 * The first word contains a version number (1) and four descriptor bytes
49 * that tell how the remaining 3 variable length fields should be handled.
50 * These three bytes are auth_type, fsid_type and fileid_type.
52 * All 4byte values are in host-byte-order.
54 * The auth_type field specifies how the filehandle can be authenticated
55 * This might allow a file to be confirmed to be in a writable part of a
56 * filetree without checking the path from it upto the root.
58 * 0 - No authentication. fb_auth is 0 bytes long
59 * Possible future values:
60 * 1 - 4 bytes taken from MD5 hash of the remainer of the file handle
61 * prefixed by a secret and with the important export flags.
63 * The fsid_type identifies how the filesystem (or export point) is
66 * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number
67 * NOTE: we cannot use the kdev_t device id value, because kdev_t.h
68 * says we mustn't. We must break it up and reassemble.
69 * Possible future encodings:
70 * 1 - 4 byte user specified identifier
72 * The fileid_type identified how the file within the filesystem is encoded.
73 * This is (will be) passed to, and set by, the underlying filesystem if it supports
74 * filehandle operations. The filesystem must not use the value '0' or '0xff' and may
75 * only use the values 1 and 2 as defined below:
77 * 0 - The root, or export point, of the filesystem. fb_fileid is 0 bytes.
78 * 1 - 32bit inode number, 32 bit generation number.
79 * 2 - 32bit inode number, 32 bit generation number, 32 bit parent directory inode number.
82 struct nfs_fhbase_new
{
83 __u8 fb_version
; /* == 1, even => nfs_fhbase_old */
88 /* __u32 fb_fsid[0]; floating */
89 /* __u32 fb_fileid[0]; floating */
93 unsigned int fh_size
; /* significant for NFSv3.
94 * Points to the current size while building
98 struct nfs_fhbase_old fh_old
;
99 __u32 fh_pad
[NFS4_FHSIZE
/4];
100 struct nfs_fhbase_new fh_new
;
104 #define ofh_dcookie fh_base.fh_old.fb_dcookie
105 #define ofh_ino fh_base.fh_old.fb_ino
106 #define ofh_dirino fh_base.fh_old.fb_dirino
107 #define ofh_dev fh_base.fh_old.fb_dev
108 #define ofh_xdev fh_base.fh_old.fb_xdev
109 #define ofh_xino fh_base.fh_old.fb_xino
110 #define ofh_generation fh_base.fh_old.fb_generation
112 #define fh_version fh_base.fh_new.fb_version
113 #define fh_fsid_type fh_base.fh_new.fb_fsid_type
114 #define fh_auth_type fh_base.fh_new.fb_auth_type
115 #define fh_fileid_type fh_base.fh_new.fb_fileid_type
116 #define fh_auth fh_base.fh_new.fb_auth
121 * Conversion macros for the filehandle fields.
123 * Keep the device numbers in "backwards compatible
124 * format", ie the low 16 bits contain the low 8 bits
125 * of the 20-bit minor and the 12-bit major number.
127 * The high 16 bits contain the rest (4 bits major
128 * and 12 bits minor),
131 static inline dev_t
u32_to_dev_t(__u32 udev
)
133 unsigned int minor
, major
;
135 minor
= (udev
& 0xff) | ((udev
>> 8) & 0xfff00);
136 major
= ((udev
>> 8) & 0xff) | ((udev
>> 20) & 0xf00);
137 return MKDEV(major
, minor
);
140 static inline __u32
ino_t_to_u32(ino_t ino
)
145 static inline ino_t
u32_to_ino_t(__u32 uino
)
151 * This is the internal representation of an NFS handle used in knfsd.
152 * pre_mtime/post_version will be used to support wcc_attr's in NFSv3.
154 typedef struct svc_fh
{
155 struct knfsd_fh fh_handle
; /* FH data */
156 struct dentry
* fh_dentry
; /* validated dentry */
157 struct svc_export
* fh_export
; /* export pointer */
158 int fh_maxsize
; /* max size for fh_handle */
160 unsigned char fh_locked
; /* inode locked by us */
162 #ifdef CONFIG_NFSD_V3
163 unsigned char fh_post_saved
; /* post-op attrs saved */
164 unsigned char fh_pre_saved
; /* pre-op attrs saved */
166 /* Pre-op attributes saved during fh_lock */
167 __u64 fh_pre_size
; /* size before operation */
168 time_t fh_pre_mtime
; /* mtime before oper */
169 time_t fh_pre_ctime
; /* ctime before oper */
171 /* Post-op attributes saved in fh_unlock */
172 umode_t fh_post_mode
; /* i_mode */
173 nlink_t fh_post_nlink
; /* i_nlink */
174 uid_t fh_post_uid
; /* i_uid */
175 gid_t fh_post_gid
; /* i_gid */
176 __u64 fh_post_size
; /* i_size */
177 unsigned long fh_post_blocks
; /* i_blocks */
178 unsigned long fh_post_blksize
;/* i_blksize */
179 __u32 fh_post_rdev
[2];/* i_rdev */
180 time_t fh_post_atime
; /* i_atime */
181 time_t fh_post_mtime
; /* i_mtime */
182 time_t fh_post_ctime
; /* i_ctime */
183 #endif /* CONFIG_NFSD_V3 */
187 static inline void mk_fsid_v0(u32
*fsidv
, dev_t dev
, ino_t ino
)
189 fsidv
[0] = htonl((MAJOR(dev
)<<16) |
191 fsidv
[1] = ino_t_to_u32(ino
);
194 static inline void mk_fsid_v1(u32
*fsidv
, u32 fsid
)
201 * Shorthand for dprintk()'s
203 inline static char * SVCFH_fmt(struct svc_fh
*fhp
)
205 struct knfsd_fh
*fh
= &fhp
->fh_handle
;
208 sprintf(buf
, "%d: %08x %08x %08x %08x %08x %08x",
210 fh
->fh_base
.fh_pad
[0],
211 fh
->fh_base
.fh_pad
[1],
212 fh
->fh_base
.fh_pad
[2],
213 fh
->fh_base
.fh_pad
[3],
214 fh
->fh_base
.fh_pad
[4],
215 fh
->fh_base
.fh_pad
[5]);
219 * Function prototypes
221 u32
fh_verify(struct svc_rqst
*, struct svc_fh
*, int, int);
222 int fh_compose(struct svc_fh
*, struct svc_export
*, struct dentry
*, struct svc_fh
*);
223 int fh_update(struct svc_fh
*);
224 void fh_put(struct svc_fh
*);
226 static __inline__
struct svc_fh
*
227 fh_copy(struct svc_fh
*dst
, struct svc_fh
*src
)
229 if (src
->fh_dentry
|| src
->fh_locked
) {
230 struct dentry
*dentry
= src
->fh_dentry
;
231 printk(KERN_ERR
"fh_copy: copying %s/%s, already verified!\n",
232 dentry
->d_parent
->d_name
.name
, dentry
->d_name
.name
);
239 static __inline__
void
240 fh_dup2(struct svc_fh
*dst
, struct svc_fh
*src
)
243 dget(src
->fh_dentry
);
247 static __inline__
struct svc_fh
*
248 fh_init(struct svc_fh
*fhp
, int maxsize
)
250 memset(fhp
, 0, sizeof(*fhp
));
251 fhp
->fh_maxsize
= maxsize
;
255 #ifdef CONFIG_NFSD_V3
257 * Fill in the pre_op attr for the wcc data
260 fill_pre_wcc(struct svc_fh
*fhp
)
264 inode
= fhp
->fh_dentry
->d_inode
;
265 if (!fhp
->fh_pre_saved
) {
266 fhp
->fh_pre_mtime
= inode
->i_mtime
.tv_sec
;
267 fhp
->fh_pre_ctime
= inode
->i_ctime
.tv_sec
;
268 fhp
->fh_pre_size
= inode
->i_size
;
269 fhp
->fh_pre_saved
= 1;
274 * Fill in the post_op attr for the wcc data
277 fill_post_wcc(struct svc_fh
*fhp
)
279 struct inode
*inode
= fhp
->fh_dentry
->d_inode
;
281 if (fhp
->fh_post_saved
)
282 printk("nfsd: inode locked twice during operation.\n");
284 fhp
->fh_post_mode
= inode
->i_mode
;
285 fhp
->fh_post_nlink
= inode
->i_nlink
;
286 fhp
->fh_post_uid
= inode
->i_uid
;
287 fhp
->fh_post_gid
= inode
->i_gid
;
288 fhp
->fh_post_size
= inode
->i_size
;
289 if (inode
->i_blksize
) {
290 fhp
->fh_post_blksize
= inode
->i_blksize
;
291 fhp
->fh_post_blocks
= inode
->i_blocks
;
293 fhp
->fh_post_blksize
= BLOCK_SIZE
;
294 /* how much do we care for accuracy with MinixFS? */
295 fhp
->fh_post_blocks
= (inode
->i_size
+511) >> 9;
297 fhp
->fh_post_rdev
[0] = htonl((u32
)major(inode
->i_rdev
));
298 fhp
->fh_post_rdev
[1] = htonl((u32
)minor(inode
->i_rdev
));
299 fhp
->fh_post_atime
= inode
->i_atime
.tv_sec
;
300 fhp
->fh_post_mtime
= inode
->i_mtime
.tv_sec
;
301 fhp
->fh_post_ctime
= inode
->i_ctime
.tv_sec
;
302 fhp
->fh_post_saved
= 1;
305 #define fill_pre_wcc(ignored)
306 #define fill_post_wcc(notused)
307 #endif /* CONFIG_NFSD_V3 */
311 * Lock a file handle/inode
312 * NOTE: both fh_lock and fh_unlock are done "by hand" in
313 * vfs.c:nfsd_rename as it needs to grab 2 i_sem's at once
314 * so, any changes here should be reflected there.
317 fh_lock(struct svc_fh
*fhp
)
319 struct dentry
*dentry
= fhp
->fh_dentry
;
322 dfprintk(FILEOP
, "nfsd: fh_lock(%s) locked = %d\n",
323 SVCFH_fmt(fhp
), fhp
->fh_locked
);
325 if (!fhp
->fh_dentry
) {
326 printk(KERN_ERR
"fh_lock: fh not verified!\n");
329 if (fhp
->fh_locked
) {
330 printk(KERN_WARNING
"fh_lock: %s/%s already locked!\n",
331 dentry
->d_parent
->d_name
.name
, dentry
->d_name
.name
);
335 inode
= dentry
->d_inode
;
342 * Unlock a file handle/inode
345 fh_unlock(struct svc_fh
*fhp
)
348 printk(KERN_ERR
"fh_unlock: fh not verified!\n");
350 if (fhp
->fh_locked
) {
352 up(&fhp
->fh_dentry
->d_inode
->i_sem
);
356 #endif /* __KERNEL__ */
359 #endif /* _LINUX_NFSD_FH_H */