| Message ID | 163054528774.24419.6639477440713170169@noble.neil.brown.name (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | [1/3,v3] NFSD: move filehandle format declarations out of "uapi". | expand |
Looks good,
Reviewed-by: Christoph Hellwig <hch@lst.de>
These 3 still apply after fixing up a couple minor conflicts; queued up for 5.16.--b. On Thu, Sep 02, 2021 at 11:14:47AM +1000, NeilBrown wrote: > > A small part of the declaration concerning filehandle format are > currently in the "uapi" include directory: > include/uapi/linux/nfsd/nfsfh.h > > There is a lot more to the filehandle format, including "enum fid_type" > and "enum nfsd_fsid" which are not exported via "uapi". > > This small part of the filehandle definition is of minimal use outside > of the kernel, and I can find no evidence that an other code is using > it. Certainly nfs-utils and wireshark (The most likely candidates) do not > use these declarations. > > So move it out of "uapi" by copying the content from > include/uapi/linux/nfsd/nfsfh.h > into > fs/nfsd/nfsfh.h > > A few unnecessary "#include" directives are not copied, and neither is > the #define of fh_auth, which is annotated as being for userspace only. > > The copyright claims in the uapi file are identical to those in the nfsd > file, so there is no need to copy those. > > The "__u32" style integer types are only needed in "uapi". In > kernel-only code we can use the more familiar "u32" style. > > Signed-off-by: NeilBrown <neilb@suse.de> > --- > fs/nfsd/nfsfh.h | 98 ++++++++++++++++++++++++++- > include/uapi/linux/nfsd/nfsfh.h | 116 -------------------------------- > 2 files changed, 97 insertions(+), 117 deletions(-) > delete mode 100644 include/uapi/linux/nfsd/nfsfh.h > > diff --git a/fs/nfsd/nfsfh.h b/fs/nfsd/nfsfh.h > index 6106697adc04..988e4dfdfbd9 100644 > --- a/fs/nfsd/nfsfh.h > +++ b/fs/nfsd/nfsfh.h > @@ -10,9 +10,105 @@ > > #include <linux/crc32.h> > #include <linux/sunrpc/svc.h> > -#include <uapi/linux/nfsd/nfsfh.h> > #include <linux/iversion.h> > #include <linux/exportfs.h> > +#include <linux/nfs4.h> > + > + > +/* > + * This is the old "dentry style" Linux NFSv2 file handle. > + * > + * The xino and xdev fields are currently used to transport the > + * ino/dev of the exported inode. > + */ > +struct nfs_fhbase_old { > + u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ > + u32 fb_ino; /* our inode number */ > + u32 fb_dirino; /* dir inode number, 0 for directories */ > + u32 fb_dev; /* our device */ > + u32 fb_xdev; > + u32 fb_xino; > + u32 fb_generation; > +}; > + > +/* > + * This is the new flexible, extensible style NFSv2/v3/v4 file handle. > + * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 > + * > + * The file handle starts with a sequence of four-byte words. > + * The first word contains a version number (1) and three descriptor bytes > + * that tell how the remaining 3 variable length fields should be handled. > + * These three bytes are auth_type, fsid_type and fileid_type. > + * > + * All four-byte values are in host-byte-order. > + * > + * The auth_type field is deprecated and must be set to 0. > + * > + * The fsid_type identifies how the filesystem (or export point) is > + * encoded. > + * Current values: > + * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number > + * NOTE: we cannot use the kdev_t device id value, because kdev_t.h > + * says we mustn't. We must break it up and reassemble. > + * 1 - 4 byte user specified identifier > + * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED > + * 3 - 4 byte device id, encoded for user-space, 4 byte inode number > + * 4 - 4 byte inode number and 4 byte uuid > + * 5 - 8 byte uuid > + * 6 - 16 byte uuid > + * 7 - 8 byte inode number and 16 byte uuid > + * > + * The fileid_type identified how the file within the filesystem is encoded. > + * The values for this field are filesystem specific, exccept that > + * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' > + * in include/linux/exportfs.h for currently registered values. > + */ > +struct nfs_fhbase_new { > + union { > + struct { > + u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ > + u8 fb_auth_type_aux; > + u8 fb_fsid_type_aux; > + u8 fb_fileid_type_aux; > + u32 fb_auth[1]; > + /* u32 fb_fsid[0]; floating */ > + /* u32 fb_fileid[0]; floating */ > + }; > + struct { > + u8 fb_version; /* == 1, even => nfs_fhbase_old */ > + u8 fb_auth_type; > + u8 fb_fsid_type; > + u8 fb_fileid_type; > + u32 fb_auth_flex[]; /* flexible-array member */ > + }; > + }; > +}; > + > +struct knfsd_fh { > + unsigned int fh_size; /* significant for NFSv3. > + * Points to the current size while building > + * a new file handle > + */ > + union { > + struct nfs_fhbase_old fh_old; > + u32 fh_pad[NFS4_FHSIZE/4]; > + struct nfs_fhbase_new fh_new; > + } fh_base; > +}; > + > +#define ofh_dcookie fh_base.fh_old.fb_dcookie > +#define ofh_ino fh_base.fh_old.fb_ino > +#define ofh_dirino fh_base.fh_old.fb_dirino > +#define ofh_dev fh_base.fh_old.fb_dev > +#define ofh_xdev fh_base.fh_old.fb_xdev > +#define ofh_xino fh_base.fh_old.fb_xino > +#define ofh_generation fh_base.fh_old.fb_generation > + > +#define fh_version fh_base.fh_new.fb_version > +#define fh_fsid_type fh_base.fh_new.fb_fsid_type > +#define fh_auth_type fh_base.fh_new.fb_auth_type > +#define fh_fileid_type fh_base.fh_new.fb_fileid_type > +#define fh_fsid fh_base.fh_new.fb_auth_flex > > static inline __u32 ino_t_to_u32(ino_t ino) > { > diff --git a/include/uapi/linux/nfsd/nfsfh.h b/include/uapi/linux/nfsd/nfsfh.h > deleted file mode 100644 > index 427294dd56a1..000000000000 > --- a/include/uapi/linux/nfsd/nfsfh.h > +++ /dev/null > @@ -1,116 +0,0 @@ > -/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ > -/* > - * This file describes the layout of the file handles as passed > - * over the wire. > - * > - * Copyright (C) 1995, 1996, 1997 Olaf Kirch <okir@monad.swb.de> > - */ > - > -#ifndef _UAPI_LINUX_NFSD_FH_H > -#define _UAPI_LINUX_NFSD_FH_H > - > -#include <linux/types.h> > -#include <linux/nfs.h> > -#include <linux/nfs2.h> > -#include <linux/nfs3.h> > -#include <linux/nfs4.h> > - > -/* > - * This is the old "dentry style" Linux NFSv2 file handle. > - * > - * The xino and xdev fields are currently used to transport the > - * ino/dev of the exported inode. > - */ > -struct nfs_fhbase_old { > - __u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ > - __u32 fb_ino; /* our inode number */ > - __u32 fb_dirino; /* dir inode number, 0 for directories */ > - __u32 fb_dev; /* our device */ > - __u32 fb_xdev; > - __u32 fb_xino; > - __u32 fb_generation; > -}; > - > -/* > - * This is the new flexible, extensible style NFSv2/v3/v4 file handle. > - * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 > - * > - * The file handle starts with a sequence of four-byte words. > - * The first word contains a version number (1) and three descriptor bytes > - * that tell how the remaining 3 variable length fields should be handled. > - * These three bytes are auth_type, fsid_type and fileid_type. > - * > - * All four-byte values are in host-byte-order. > - * > - * The auth_type field is deprecated and must be set to 0. > - * > - * The fsid_type identifies how the filesystem (or export point) is > - * encoded. > - * Current values: > - * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number > - * NOTE: we cannot use the kdev_t device id value, because kdev_t.h > - * says we mustn't. We must break it up and reassemble. > - * 1 - 4 byte user specified identifier > - * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED > - * 3 - 4 byte device id, encoded for user-space, 4 byte inode number > - * 4 - 4 byte inode number and 4 byte uuid > - * 5 - 8 byte uuid > - * 6 - 16 byte uuid > - * 7 - 8 byte inode number and 16 byte uuid > - * > - * The fileid_type identified how the file within the filesystem is encoded. > - * The values for this field are filesystem specific, exccept that > - * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' > - * in include/linux/exportfs.h for currently registered values. > - */ > -struct nfs_fhbase_new { > - union { > - struct { > - __u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ > - __u8 fb_auth_type_aux; > - __u8 fb_fsid_type_aux; > - __u8 fb_fileid_type_aux; > - __u32 fb_auth[1]; > - /* __u32 fb_fsid[0]; floating */ > - /* __u32 fb_fileid[0]; floating */ > - }; > - struct { > - __u8 fb_version; /* == 1, even => nfs_fhbase_old */ > - __u8 fb_auth_type; > - __u8 fb_fsid_type; > - __u8 fb_fileid_type; > - __u32 fb_auth_flex[]; /* flexible-array member */ > - }; > - }; > -}; > - > -struct knfsd_fh { > - unsigned int fh_size; /* significant for NFSv3. > - * Points to the current size while building > - * a new file handle > - */ > - union { > - struct nfs_fhbase_old fh_old; > - __u32 fh_pad[NFS4_FHSIZE/4]; > - struct nfs_fhbase_new fh_new; > - } fh_base; > -}; > - > -#define ofh_dcookie fh_base.fh_old.fb_dcookie > -#define ofh_ino fh_base.fh_old.fb_ino > -#define ofh_dirino fh_base.fh_old.fb_dirino > -#define ofh_dev fh_base.fh_old.fb_dev > -#define ofh_xdev fh_base.fh_old.fb_xdev > -#define ofh_xino fh_base.fh_old.fb_xino > -#define ofh_generation fh_base.fh_old.fb_generation > - > -#define fh_version fh_base.fh_new.fb_version > -#define fh_fsid_type fh_base.fh_new.fb_fsid_type > -#define fh_auth_type fh_base.fh_new.fb_auth_type > -#define fh_fileid_type fh_base.fh_new.fb_fileid_type > -#define fh_fsid fh_base.fh_new.fb_auth_flex > - > -/* Do not use, provided for userspace compatiblity. */ > -#define fh_auth fh_base.fh_new.fb_auth > - > -#endif /* _UAPI_LINUX_NFSD_FH_H */ > -- > 2.32.0
On Fri, 24 Sep 2021, Bruce Fields wrote: > These 3 still apply after fixing up a couple minor conflicts; queued up > for 5.16.--b. Cool, thanks. NeilBrown > > On Thu, Sep 02, 2021 at 11:14:47AM +1000, NeilBrown wrote: > > > > A small part of the declaration concerning filehandle format are > > currently in the "uapi" include directory: > > include/uapi/linux/nfsd/nfsfh.h > > > > There is a lot more to the filehandle format, including "enum fid_type" > > and "enum nfsd_fsid" which are not exported via "uapi". > > > > This small part of the filehandle definition is of minimal use outside > > of the kernel, and I can find no evidence that an other code is using > > it. Certainly nfs-utils and wireshark (The most likely candidates) do not > > use these declarations. > > > > So move it out of "uapi" by copying the content from > > include/uapi/linux/nfsd/nfsfh.h > > into > > fs/nfsd/nfsfh.h > > > > A few unnecessary "#include" directives are not copied, and neither is > > the #define of fh_auth, which is annotated as being for userspace only. > > > > The copyright claims in the uapi file are identical to those in the nfsd > > file, so there is no need to copy those. > > > > The "__u32" style integer types are only needed in "uapi". In > > kernel-only code we can use the more familiar "u32" style. > > > > Signed-off-by: NeilBrown <neilb@suse.de> > > --- > > fs/nfsd/nfsfh.h | 98 ++++++++++++++++++++++++++- > > include/uapi/linux/nfsd/nfsfh.h | 116 -------------------------------- > > 2 files changed, 97 insertions(+), 117 deletions(-) > > delete mode 100644 include/uapi/linux/nfsd/nfsfh.h > > > > diff --git a/fs/nfsd/nfsfh.h b/fs/nfsd/nfsfh.h > > index 6106697adc04..988e4dfdfbd9 100644 > > --- a/fs/nfsd/nfsfh.h > > +++ b/fs/nfsd/nfsfh.h > > @@ -10,9 +10,105 @@ > > > > #include <linux/crc32.h> > > #include <linux/sunrpc/svc.h> > > -#include <uapi/linux/nfsd/nfsfh.h> > > #include <linux/iversion.h> > > #include <linux/exportfs.h> > > +#include <linux/nfs4.h> > > + > > + > > +/* > > + * This is the old "dentry style" Linux NFSv2 file handle. > > + * > > + * The xino and xdev fields are currently used to transport the > > + * ino/dev of the exported inode. > > + */ > > +struct nfs_fhbase_old { > > + u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ > > + u32 fb_ino; /* our inode number */ > > + u32 fb_dirino; /* dir inode number, 0 for directories */ > > + u32 fb_dev; /* our device */ > > + u32 fb_xdev; > > + u32 fb_xino; > > + u32 fb_generation; > > +}; > > + > > +/* > > + * This is the new flexible, extensible style NFSv2/v3/v4 file handle. > > + * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 > > + * > > + * The file handle starts with a sequence of four-byte words. > > + * The first word contains a version number (1) and three descriptor bytes > > + * that tell how the remaining 3 variable length fields should be handled. > > + * These three bytes are auth_type, fsid_type and fileid_type. > > + * > > + * All four-byte values are in host-byte-order. > > + * > > + * The auth_type field is deprecated and must be set to 0. > > + * > > + * The fsid_type identifies how the filesystem (or export point) is > > + * encoded. > > + * Current values: > > + * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number > > + * NOTE: we cannot use the kdev_t device id value, because kdev_t.h > > + * says we mustn't. We must break it up and reassemble. > > + * 1 - 4 byte user specified identifier > > + * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED > > + * 3 - 4 byte device id, encoded for user-space, 4 byte inode number > > + * 4 - 4 byte inode number and 4 byte uuid > > + * 5 - 8 byte uuid > > + * 6 - 16 byte uuid > > + * 7 - 8 byte inode number and 16 byte uuid > > + * > > + * The fileid_type identified how the file within the filesystem is encoded. > > + * The values for this field are filesystem specific, exccept that > > + * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' > > + * in include/linux/exportfs.h for currently registered values. > > + */ > > +struct nfs_fhbase_new { > > + union { > > + struct { > > + u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ > > + u8 fb_auth_type_aux; > > + u8 fb_fsid_type_aux; > > + u8 fb_fileid_type_aux; > > + u32 fb_auth[1]; > > + /* u32 fb_fsid[0]; floating */ > > + /* u32 fb_fileid[0]; floating */ > > + }; > > + struct { > > + u8 fb_version; /* == 1, even => nfs_fhbase_old */ > > + u8 fb_auth_type; > > + u8 fb_fsid_type; > > + u8 fb_fileid_type; > > + u32 fb_auth_flex[]; /* flexible-array member */ > > + }; > > + }; > > +}; > > + > > +struct knfsd_fh { > > + unsigned int fh_size; /* significant for NFSv3. > > + * Points to the current size while building > > + * a new file handle > > + */ > > + union { > > + struct nfs_fhbase_old fh_old; > > + u32 fh_pad[NFS4_FHSIZE/4]; > > + struct nfs_fhbase_new fh_new; > > + } fh_base; > > +}; > > + > > +#define ofh_dcookie fh_base.fh_old.fb_dcookie > > +#define ofh_ino fh_base.fh_old.fb_ino > > +#define ofh_dirino fh_base.fh_old.fb_dirino > > +#define ofh_dev fh_base.fh_old.fb_dev > > +#define ofh_xdev fh_base.fh_old.fb_xdev > > +#define ofh_xino fh_base.fh_old.fb_xino > > +#define ofh_generation fh_base.fh_old.fb_generation > > + > > +#define fh_version fh_base.fh_new.fb_version > > +#define fh_fsid_type fh_base.fh_new.fb_fsid_type > > +#define fh_auth_type fh_base.fh_new.fb_auth_type > > +#define fh_fileid_type fh_base.fh_new.fb_fileid_type > > +#define fh_fsid fh_base.fh_new.fb_auth_flex > > > > static inline __u32 ino_t_to_u32(ino_t ino) > > { > > diff --git a/include/uapi/linux/nfsd/nfsfh.h b/include/uapi/linux/nfsd/nfsfh.h > > deleted file mode 100644 > > index 427294dd56a1..000000000000 > > --- a/include/uapi/linux/nfsd/nfsfh.h > > +++ /dev/null > > @@ -1,116 +0,0 @@ > > -/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ > > -/* > > - * This file describes the layout of the file handles as passed > > - * over the wire. > > - * > > - * Copyright (C) 1995, 1996, 1997 Olaf Kirch <okir@monad.swb.de> > > - */ > > - > > -#ifndef _UAPI_LINUX_NFSD_FH_H > > -#define _UAPI_LINUX_NFSD_FH_H > > - > > -#include <linux/types.h> > > -#include <linux/nfs.h> > > -#include <linux/nfs2.h> > > -#include <linux/nfs3.h> > > -#include <linux/nfs4.h> > > - > > -/* > > - * This is the old "dentry style" Linux NFSv2 file handle. > > - * > > - * The xino and xdev fields are currently used to transport the > > - * ino/dev of the exported inode. > > - */ > > -struct nfs_fhbase_old { > > - __u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ > > - __u32 fb_ino; /* our inode number */ > > - __u32 fb_dirino; /* dir inode number, 0 for directories */ > > - __u32 fb_dev; /* our device */ > > - __u32 fb_xdev; > > - __u32 fb_xino; > > - __u32 fb_generation; > > -}; > > - > > -/* > > - * This is the new flexible, extensible style NFSv2/v3/v4 file handle. > > - * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 > > - * > > - * The file handle starts with a sequence of four-byte words. > > - * The first word contains a version number (1) and three descriptor bytes > > - * that tell how the remaining 3 variable length fields should be handled. > > - * These three bytes are auth_type, fsid_type and fileid_type. > > - * > > - * All four-byte values are in host-byte-order. > > - * > > - * The auth_type field is deprecated and must be set to 0. > > - * > > - * The fsid_type identifies how the filesystem (or export point) is > > - * encoded. > > - * Current values: > > - * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number > > - * NOTE: we cannot use the kdev_t device id value, because kdev_t.h > > - * says we mustn't. We must break it up and reassemble. > > - * 1 - 4 byte user specified identifier > > - * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED > > - * 3 - 4 byte device id, encoded for user-space, 4 byte inode number > > - * 4 - 4 byte inode number and 4 byte uuid > > - * 5 - 8 byte uuid > > - * 6 - 16 byte uuid > > - * 7 - 8 byte inode number and 16 byte uuid > > - * > > - * The fileid_type identified how the file within the filesystem is encoded. > > - * The values for this field are filesystem specific, exccept that > > - * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' > > - * in include/linux/exportfs.h for currently registered values. > > - */ > > -struct nfs_fhbase_new { > > - union { > > - struct { > > - __u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ > > - __u8 fb_auth_type_aux; > > - __u8 fb_fsid_type_aux; > > - __u8 fb_fileid_type_aux; > > - __u32 fb_auth[1]; > > - /* __u32 fb_fsid[0]; floating */ > > - /* __u32 fb_fileid[0]; floating */ > > - }; > > - struct { > > - __u8 fb_version; /* == 1, even => nfs_fhbase_old */ > > - __u8 fb_auth_type; > > - __u8 fb_fsid_type; > > - __u8 fb_fileid_type; > > - __u32 fb_auth_flex[]; /* flexible-array member */ > > - }; > > - }; > > -}; > > - > > -struct knfsd_fh { > > - unsigned int fh_size; /* significant for NFSv3. > > - * Points to the current size while building > > - * a new file handle > > - */ > > - union { > > - struct nfs_fhbase_old fh_old; > > - __u32 fh_pad[NFS4_FHSIZE/4]; > > - struct nfs_fhbase_new fh_new; > > - } fh_base; > > -}; > > - > > -#define ofh_dcookie fh_base.fh_old.fb_dcookie > > -#define ofh_ino fh_base.fh_old.fb_ino > > -#define ofh_dirino fh_base.fh_old.fb_dirino > > -#define ofh_dev fh_base.fh_old.fb_dev > > -#define ofh_xdev fh_base.fh_old.fb_xdev > > -#define ofh_xino fh_base.fh_old.fb_xino > > -#define ofh_generation fh_base.fh_old.fb_generation > > - > > -#define fh_version fh_base.fh_new.fb_version > > -#define fh_fsid_type fh_base.fh_new.fb_fsid_type > > -#define fh_auth_type fh_base.fh_new.fb_auth_type > > -#define fh_fileid_type fh_base.fh_new.fb_fileid_type > > -#define fh_fsid fh_base.fh_new.fb_auth_flex > > - > > -/* Do not use, provided for userspace compatiblity. */ > > -#define fh_auth fh_base.fh_new.fb_auth > > - > > -#endif /* _UAPI_LINUX_NFSD_FH_H */ > > -- > > 2.32.0 > >
diff --git a/fs/nfsd/nfsfh.h b/fs/nfsd/nfsfh.h index 6106697adc04..988e4dfdfbd9 100644 --- a/fs/nfsd/nfsfh.h +++ b/fs/nfsd/nfsfh.h @@ -10,9 +10,105 @@ #include <linux/crc32.h> #include <linux/sunrpc/svc.h> -#include <uapi/linux/nfsd/nfsfh.h> #include <linux/iversion.h> #include <linux/exportfs.h> +#include <linux/nfs4.h> + + +/* + * This is the old "dentry style" Linux NFSv2 file handle. + * + * The xino and xdev fields are currently used to transport the + * ino/dev of the exported inode. + */ +struct nfs_fhbase_old { + u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ + u32 fb_ino; /* our inode number */ + u32 fb_dirino; /* dir inode number, 0 for directories */ + u32 fb_dev; /* our device */ + u32 fb_xdev; + u32 fb_xino; + u32 fb_generation; +}; + +/* + * This is the new flexible, extensible style NFSv2/v3/v4 file handle. + * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 + * + * The file handle starts with a sequence of four-byte words. + * The first word contains a version number (1) and three descriptor bytes + * that tell how the remaining 3 variable length fields should be handled. + * These three bytes are auth_type, fsid_type and fileid_type. + * + * All four-byte values are in host-byte-order. + * + * The auth_type field is deprecated and must be set to 0. + * + * The fsid_type identifies how the filesystem (or export point) is + * encoded. + * Current values: + * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number + * NOTE: we cannot use the kdev_t device id value, because kdev_t.h + * says we mustn't. We must break it up and reassemble. + * 1 - 4 byte user specified identifier + * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED + * 3 - 4 byte device id, encoded for user-space, 4 byte inode number + * 4 - 4 byte inode number and 4 byte uuid + * 5 - 8 byte uuid + * 6 - 16 byte uuid + * 7 - 8 byte inode number and 16 byte uuid + * + * The fileid_type identified how the file within the filesystem is encoded. + * The values for this field are filesystem specific, exccept that + * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' + * in include/linux/exportfs.h for currently registered values. + */ +struct nfs_fhbase_new { + union { + struct { + u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ + u8 fb_auth_type_aux; + u8 fb_fsid_type_aux; + u8 fb_fileid_type_aux; + u32 fb_auth[1]; + /* u32 fb_fsid[0]; floating */ + /* u32 fb_fileid[0]; floating */ + }; + struct { + u8 fb_version; /* == 1, even => nfs_fhbase_old */ + u8 fb_auth_type; + u8 fb_fsid_type; + u8 fb_fileid_type; + u32 fb_auth_flex[]; /* flexible-array member */ + }; + }; +}; + +struct knfsd_fh { + unsigned int fh_size; /* significant for NFSv3. + * Points to the current size while building + * a new file handle + */ + union { + struct nfs_fhbase_old fh_old; + u32 fh_pad[NFS4_FHSIZE/4]; + struct nfs_fhbase_new fh_new; + } fh_base; +}; + +#define ofh_dcookie fh_base.fh_old.fb_dcookie +#define ofh_ino fh_base.fh_old.fb_ino +#define ofh_dirino fh_base.fh_old.fb_dirino +#define ofh_dev fh_base.fh_old.fb_dev +#define ofh_xdev fh_base.fh_old.fb_xdev +#define ofh_xino fh_base.fh_old.fb_xino +#define ofh_generation fh_base.fh_old.fb_generation + +#define fh_version fh_base.fh_new.fb_version +#define fh_fsid_type fh_base.fh_new.fb_fsid_type +#define fh_auth_type fh_base.fh_new.fb_auth_type +#define fh_fileid_type fh_base.fh_new.fb_fileid_type +#define fh_fsid fh_base.fh_new.fb_auth_flex static inline __u32 ino_t_to_u32(ino_t ino) { diff --git a/include/uapi/linux/nfsd/nfsfh.h b/include/uapi/linux/nfsd/nfsfh.h deleted file mode 100644 index 427294dd56a1..000000000000 --- a/include/uapi/linux/nfsd/nfsfh.h +++ /dev/null @@ -1,116 +0,0 @@ -/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ -/* - * This file describes the layout of the file handles as passed - * over the wire. - * - * Copyright (C) 1995, 1996, 1997 Olaf Kirch <okir@monad.swb.de> - */ - -#ifndef _UAPI_LINUX_NFSD_FH_H -#define _UAPI_LINUX_NFSD_FH_H - -#include <linux/types.h> -#include <linux/nfs.h> -#include <linux/nfs2.h> -#include <linux/nfs3.h> -#include <linux/nfs4.h> - -/* - * This is the old "dentry style" Linux NFSv2 file handle. - * - * The xino and xdev fields are currently used to transport the - * ino/dev of the exported inode. - */ -struct nfs_fhbase_old { - __u32 fb_dcookie; /* dentry cookie - always 0xfeebbaca */ - __u32 fb_ino; /* our inode number */ - __u32 fb_dirino; /* dir inode number, 0 for directories */ - __u32 fb_dev; /* our device */ - __u32 fb_xdev; - __u32 fb_xino; - __u32 fb_generation; -}; - -/* - * This is the new flexible, extensible style NFSv2/v3/v4 file handle. - * by Neil Brown <neilb@cse.unsw.edu.au> - March 2000 - * - * The file handle starts with a sequence of four-byte words. - * The first word contains a version number (1) and three descriptor bytes - * that tell how the remaining 3 variable length fields should be handled. - * These three bytes are auth_type, fsid_type and fileid_type. - * - * All four-byte values are in host-byte-order. - * - * The auth_type field is deprecated and must be set to 0. - * - * The fsid_type identifies how the filesystem (or export point) is - * encoded. - * Current values: - * 0 - 4 byte device id (ms-2-bytes major, ls-2-bytes minor), 4byte inode number - * NOTE: we cannot use the kdev_t device id value, because kdev_t.h - * says we mustn't. We must break it up and reassemble. - * 1 - 4 byte user specified identifier - * 2 - 4 byte major, 4 byte minor, 4 byte inode number - DEPRECATED - * 3 - 4 byte device id, encoded for user-space, 4 byte inode number - * 4 - 4 byte inode number and 4 byte uuid - * 5 - 8 byte uuid - * 6 - 16 byte uuid - * 7 - 8 byte inode number and 16 byte uuid - * - * The fileid_type identified how the file within the filesystem is encoded. - * The values for this field are filesystem specific, exccept that - * filesystems must not use the values '0' or '0xff'. 'See enum fid_type' - * in include/linux/exportfs.h for currently registered values. - */ -struct nfs_fhbase_new { - union { - struct { - __u8 fb_version_aux; /* == 1, even => nfs_fhbase_old */ - __u8 fb_auth_type_aux; - __u8 fb_fsid_type_aux; - __u8 fb_fileid_type_aux; - __u32 fb_auth[1]; - /* __u32 fb_fsid[0]; floating */ - /* __u32 fb_fileid[0]; floating */ - }; - struct { - __u8 fb_version; /* == 1, even => nfs_fhbase_old */ - __u8 fb_auth_type; - __u8 fb_fsid_type; - __u8 fb_fileid_type; - __u32 fb_auth_flex[]; /* flexible-array member */ - }; - }; -}; - -struct knfsd_fh { - unsigned int fh_size; /* significant for NFSv3. - * Points to the current size while building - * a new file handle - */ - union { - struct nfs_fhbase_old fh_old; - __u32 fh_pad[NFS4_FHSIZE/4]; - struct nfs_fhbase_new fh_new; - } fh_base; -}; - -#define ofh_dcookie fh_base.fh_old.fb_dcookie -#define ofh_ino fh_base.fh_old.fb_ino -#define ofh_dirino fh_base.fh_old.fb_dirino -#define ofh_dev fh_base.fh_old.fb_dev -#define ofh_xdev fh_base.fh_old.fb_xdev -#define ofh_xino fh_base.fh_old.fb_xino -#define ofh_generation fh_base.fh_old.fb_generation - -#define fh_version fh_base.fh_new.fb_version -#define fh_fsid_type fh_base.fh_new.fb_fsid_type -#define fh_auth_type fh_base.fh_new.fb_auth_type -#define fh_fileid_type fh_base.fh_new.fb_fileid_type -#define fh_fsid fh_base.fh_new.fb_auth_flex - -/* Do not use, provided for userspace compatiblity. */ -#define fh_auth fh_base.fh_new.fb_auth - -#endif /* _UAPI_LINUX_NFSD_FH_H */
A small part of the declaration concerning filehandle format are currently in the "uapi" include directory: include/uapi/linux/nfsd/nfsfh.h There is a lot more to the filehandle format, including "enum fid_type" and "enum nfsd_fsid" which are not exported via "uapi". This small part of the filehandle definition is of minimal use outside of the kernel, and I can find no evidence that an other code is using it. Certainly nfs-utils and wireshark (The most likely candidates) do not use these declarations. So move it out of "uapi" by copying the content from include/uapi/linux/nfsd/nfsfh.h into fs/nfsd/nfsfh.h A few unnecessary "#include" directives are not copied, and neither is the #define of fh_auth, which is annotated as being for userspace only. The copyright claims in the uapi file are identical to those in the nfsd file, so there is no need to copy those. The "__u32" style integer types are only needed in "uapi". In kernel-only code we can use the more familiar "u32" style. Signed-off-by: NeilBrown <neilb@suse.de> --- fs/nfsd/nfsfh.h | 98 ++++++++++++++++++++++++++- include/uapi/linux/nfsd/nfsfh.h | 116 -------------------------------- 2 files changed, 97 insertions(+), 117 deletions(-) delete mode 100644 include/uapi/linux/nfsd/nfsfh.h