/**************************************************************************** * fs/nfs/nfs_proto.h * * Copyright (C) 2012, 2018 Gregory Nutt. All rights reserved. * Copyright (C) 2012 Jose Pablo Rojas Vargas. All rights reserved. * Author: Jose Pablo Rojas Vargas * Gregory Nutt * * Leveraged from OpenBSD: * * 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. 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. * ****************************************************************************/ #ifndef __FS_NFS_NFS_PROTO_H #define __FS_NFS_NFS_PROTO_H /**************************************************************************** * Included Files ****************************************************************************/ /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* 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" */ #define NFS_PORT 2049 #define NFS_PROG 100003 #define NFS_VER2 2 #define NFS_VER3 3 #define NFS_VER4 4 #define NFS_MAXDGRAMDATA 32768 #define MAXBSIZE 64000 #define NFS_MAXDATA MAXBSIZE #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_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 */ /* Sizes in bytes of various NFS RPC components */ #define NFSX_UNSIGNED 4 /* Specific to NFS Version 3 */ #define NFSX_V3FH (sizeof(struct fhandle)) /* 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 + 7 * 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 /* 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 #define NFSPROC_NOOP 22 #define NFS_NPROCS 23 /* 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 /* Mode bit values */ #define NFSMODE_IXOTH (1 << 0) /* Execute permission for others on a file */ #define NFSMODE_IWOTH (1 << 1) /* Write permission for others */ #define NFSMODE_IROTH (1 << 2) /* Read permission for others */ #define NFSMODE_IXGRP (1 << 3) /* Execute permission for group on a file */ #define NFSMODE_IWGRP (1 << 4) /* Write permission for group */ #define NFSMODE_IRGRP (1 << 5) /* Read permission for group */ #define NFSMODE_IXUSR (1 << 6) /* Execute permission for owner on a file */ #define NFSMODE_IWUSR (1 << 7) /* Write permission for owner */ #define NFSMODE_IRUSR (1 << 8) /* Read permission for owner */ #define NFSMODE_SAVETEXT (1 << 9) /* Save swapped text */ #define NFSMODE_ISGID (1 << 10) /* Set group ID on execution */ #define NFSMODE_ISUID (1 << 11) /* Set user ID on execution */ /* File identifier */ #define MAXFIDSZ 16 /**************************************************************************** * Public Types ****************************************************************************/ /* File types */ typedef enum { NFNON = 0, /* Unknown type */ NFREG = 1, /* Regular file */ NFDIR = 2, /* Directory */ NFBLK = 3, /* Block special device file */ NFCHR = 4, /* Character special device file */ NFLNK = 5, /* Symbolic link */ NFSOCK = 6, /* Socket */ NFFIFO = 7 /* Named FIFO */ } nfstype; /* File Handle variable is up to 64 bytes for version 3. This structures a * variable sized and are provided only for setting aside maximum memory * allocations for a file handle. */ struct nfsfh { uint8_t fh_bytes[NFSX_V3FHMAX]; }; typedef struct nfsfh nfsfh_t; #define SIZEOF_nfsfh_t(n) (n) struct nfsv3_time { uint32_t nfsv3_sec; uint32_t 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 { uint32_t nfsuquad[2]; }; typedef struct nfs_uquad nfsuint64; /* NFS Version 3 special file number. */ struct nfsv3_spec { uint32_t specdata1; uint32_t 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) */ struct nfs_fattr { uint32_t fa_type; uint32_t fa_mode; uint32_t fa_nlink; uint32_t fa_uid; uint32_t fa_gid; nfsuint64 fa_size; nfsuint64 fa_used; nfsv3spec fa_rdev; nfsuint64 fa_fsid; nfsuint64 fa_fileid; nfstime3 fa_atime; nfstime3 fa_mtime; nfstime3 fa_ctime; }; /* NFS Version 3 sattr structure for the new node creation case. This is the * maximum size of the attributes; the actual size may vary if values are not * include. */ struct nfsv3_sattr { uint32_t sa_modefollows; /* TRUE: Mode value follows */ uint32_t sa_mode; /* Mode value */ uint32_t sa_uidfollows; /* TRUE: Uid value follows */ uint32_t sa_uid; /* Uid value */ uint32_t sa_gidfollows; /* TRUE: Mode value follows */ uint32_t sa_gid; /* Mode value */ uint32_t sa_sizefollows; /* TRUE: Size value follows */ nfsuint64 sa_size; /* Size value */ uint32_t sa_atimetype; /* Don't change, use server timer, or use client time */ nfstime3 sa_atime; /* Client time */ uint32_t sa_mtimetype; /* Don't change, use server timer, or use client time */ nfstime3 sa_mtime; /* Client time */ }; struct nfs_statfs { uint32_t obj_attributes_follow; nfsuint64 sf_tbytes; nfsuint64 sf_fbytes; nfsuint64 sf_abytes; nfsuint64 sf_tfiles; nfsuint64 sf_ffiles; nfsuint64 sf_afiles; uint32_t sf_invarsec; }; struct nfsv3_fsinfo { uint32_t obj_attributes_follow; struct nfs_fattr obj_attributes; uint32_t fs_rtmax; uint32_t fs_rtpref; uint32_t fs_rtmult; uint32_t fs_wtmax; uint32_t fs_wtpref; uint32_t fs_wtmult; uint32_t fs_dtpref; nfsuint64 fs_maxfilesize; nfstime3 fs_timedelta; uint32_t fs_properties; }; /* NFS procedures args */ struct wcc_attr { nfsuint64 size; nfstime3 mtime; nfstime3 ctime; }; struct wcc_data { uint32_t wcc_attr_follows; /* True if data follows */ struct wcc_attr before; uint32_t nfs_attr_follow; /* True if attributes present */ struct nfs_fattr after; }; struct file_handle { uint32_t length; nfsfh_t handle; }; #define SIZEOF_file_handle(n) (sizeof(uint32_t) + SIZEOF_nfsfh_t(n)) struct diropargs3 { struct file_handle fhandle; /* Variable length */ uint32_t length; /* Size of name[] */ uint32_t name[(NAME_MAX + 3) >> 2]; /* Variable length */ }; struct CREATE3args { struct diropargs3 where; uint32_t create_mode; struct nfsv3_sattr how; }; struct CREATE3resok { uint32_t handle_follows; /* True, handle follows */ struct file_handle fhandle; /* Variable length */ uint32_t attributes_follows; /* True, attributes follows */ struct nfs_fattr attributes; /* File attributes */ struct wcc_data dir_wcc; }; struct SETATTR3args { struct file_handle fhandle; /* Variable length */ struct nfsv3_sattr new_attributes; /* Variable length */ uint32_t guard; /* Guard value */ }; struct SETATTR3resok { struct wcc_data wcc_data; }; /* The actual size of the lookup argument is variable. * These structures are, therefore, only useful in setting * aside maximum memory usage for the LOOKUP arguments. */ struct LOOKUP3filename { uint32_t namelen; /* Size of name[] */ uint32_t name[(NAME_MAX + 3) >> 2]; /* Variable length */ }; struct LOOKUP3args { struct file_handle dirhandle; /* Variable length */ struct LOOKUP3filename name; /* Variable length */ }; /* Actual size of LOOKUP3args */ #define SIZEOF_LOOKUP3filename(b) (sizeof(uint32_t) + (((b) + 3) & ~3)) #define SIZEOF_LOOKUP3args(a,b) (SIZEOF_file_handle(a) + SIZEOF_LOOKUP3filename(b)) struct LOOKUP3resok { struct file_handle fhandle; uint32_t obj_attributes_follow; struct nfs_fattr obj_attributes; uint32_t dir_attributes_follow; struct nfs_fattr dir_attributes; }; struct READ3args { struct file_handle fhandle; /* Variable length */ nfsuint64 offset; uint32_t count; }; struct nfs_rdhdr_s { uint32_t attributes_follow; struct nfs_fattr attributes; /* Will not be present if attributes_follow == 0 */ uint32_t count; /* Number of bytes read */ uint32_t eof; /* Non-zero if at the end of file */ uint32_t length; /* Length of data (same as count?) */ }; struct READ3resok { struct nfs_rdhdr_s hdr; uint8_t data[1]; /* Actual data size depends on count */ }; #define SIZEOF_READ3resok(n) (sizeof(struct nfs_rdhdr_s) + (n)) struct nfs_wrhdr_s { struct file_handle fhandle; /* Variable length */ nfsuint64 offset; uint32_t count; uint32_t stable; uint32_t length; }; struct WRITE3args { struct nfs_wrhdr_s hdr; uint8_t data[1]; /* Actual data size depends on count */ }; #define SIZEOF_WRITE3args(n) (sizeof(struct nfs_wrhdr_s) + (n)) struct WRITE3resok { struct wcc_data file_wcc; uint32_t count; uint32_t committed; uint8_t verf[NFSX_V3WRITEVERF]; }; struct REMOVE3args { struct diropargs3 object; }; struct REMOVE3resok { struct wcc_data dir_wcc; }; struct RENAME3args { struct diropargs3 from; struct diropargs3 to; }; struct RENAME3resok { struct wcc_data fromdir_wcc; struct wcc_data todir_wcc; }; struct MKDIR3args { struct diropargs3 where; struct nfsv3_sattr how; }; struct MKDIR3resok { uint32_t handle_follows; /* True, handle follows */ struct file_handle fhandle; /* Variable length */ uint32_t attributes_follows; /* True, attributes follows */ struct nfs_fattr attributes; /* Directory attributes */ struct wcc_data dir_wcc; }; struct RMDIR3args { struct diropargs3 object; }; struct RMDIR3resok { struct wcc_data dir_wcc; }; struct READDIR3args { struct file_handle dir; /* Variable length */ nfsuint64 cookie; uint8_t cookieverf[NFSX_V3COOKIEVERF]; uint32_t count; }; /* The READDIR reply is variable length and consists of multiple entries, * each of form: * * EOF - OR - * * File ID (8 bytes) * Name length (4 bytes) * Name string (variable size but in multiples of 4 bytes) * Cookie (8 bytes) * next entry (4 bytes) */ struct READDIR3resok { uint32_t attributes_follow; struct nfs_fattr dir_attributes; uint8_t cookieverf[NFSX_V3COOKIEVERF]; uint32_t value_follows; uint32_t reply[1]; /* Variable length reply begins here */ }; #define SIZEOF_READDIR3resok(n) \ (sizeof(uint32_t) + sizeof(struct nfs_fattr) + \ NFSX_V3COOKIEVERF + sizeof(uint32_t) + (n)) struct FS3args { struct file_handle fsroot; }; #endif /* __FS_NFS_NFS_PROTO_H */