nfsd.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331
  1. /*
  2. * linux/include/linux/nfsd/nfsd.h
  3. *
  4. * Hodge-podge collection of knfsd-related stuff.
  5. * I will sort this out later.
  6. *
  7. * Copyright (C) 1995-1997 Olaf Kirch <okir@monad.swb.de>
  8. */
  9. #ifndef LINUX_NFSD_NFSD_H
  10. #define LINUX_NFSD_NFSD_H
  11. #include <linux/config.h>
  12. #include <linux/types.h>
  13. #include <linux/unistd.h>
  14. #include <linux/dirent.h>
  15. #include <linux/fs.h>
  16. #include <linux/posix_acl.h>
  17. #include <linux/mount.h>
  18. #include <linux/nfsd/debug.h>
  19. #include <linux/nfsd/nfsfh.h>
  20. #include <linux/nfsd/export.h>
  21. #include <linux/nfsd/auth.h>
  22. #include <linux/nfsd/stats.h>
  23. #include <linux/nfsd/interface.h>
  24. /*
  25. * nfsd version
  26. */
  27. #define NFSD_VERSION "0.5"
  28. #define NFSD_SUPPORTED_MINOR_VERSION 0
  29. #ifdef __KERNEL__
  30. /*
  31. * Special flags for nfsd_permission. These must be different from MAY_READ,
  32. * MAY_WRITE, and MAY_EXEC.
  33. */
  34. #define MAY_NOP 0
  35. #define MAY_SATTR 8
  36. #define MAY_TRUNC 16
  37. #define MAY_LOCK 32
  38. #define MAY_OWNER_OVERRIDE 64
  39. #define MAY_LOCAL_ACCESS 128 /* IRIX doing local access check on device special file*/
  40. #if (MAY_SATTR | MAY_TRUNC | MAY_LOCK | MAY_OWNER_OVERRIDE | MAY_LOCAL_ACCESS) & (MAY_READ | MAY_WRITE | MAY_EXEC)
  41. # error "please use a different value for MAY_SATTR or MAY_TRUNC or MAY_LOCK or MAY_LOCAL_ACCESS or MAY_OWNER_OVERRIDE."
  42. #endif
  43. #define MAY_CREATE (MAY_EXEC|MAY_WRITE)
  44. #define MAY_REMOVE (MAY_EXEC|MAY_WRITE|MAY_TRUNC)
  45. /*
  46. * Callback function for readdir
  47. */
  48. struct readdir_cd {
  49. int err; /* 0, nfserr, or nfserr_eof */
  50. };
  51. typedef int (*encode_dent_fn)(struct readdir_cd *, const char *,
  52. int, loff_t, ino_t, unsigned int);
  53. typedef int (*nfsd_dirop_t)(struct inode *, struct dentry *, int, int);
  54. extern struct svc_program nfsd_program;
  55. extern struct svc_version nfsd_version2, nfsd_version3,
  56. nfsd_version4;
  57. /*
  58. * Function prototypes.
  59. */
  60. int nfsd_svc(unsigned short port, int nrservs);
  61. int nfsd_dispatch(struct svc_rqst *rqstp, u32 *statp);
  62. /* nfsd/vfs.c */
  63. int fh_lock_parent(struct svc_fh *, struct dentry *);
  64. int nfsd_racache_init(int);
  65. void nfsd_racache_shutdown(void);
  66. int nfsd_cross_mnt(struct svc_rqst *rqstp, struct dentry **dpp,
  67. struct svc_export **expp);
  68. int nfsd_lookup(struct svc_rqst *, struct svc_fh *,
  69. const char *, int, struct svc_fh *);
  70. int nfsd_setattr(struct svc_rqst *, struct svc_fh *,
  71. struct iattr *, int, time_t);
  72. #ifdef CONFIG_NFSD_V4
  73. int nfsd4_set_nfs4_acl(struct svc_rqst *, struct svc_fh *,
  74. struct nfs4_acl *);
  75. int nfsd4_get_nfs4_acl(struct svc_rqst *, struct dentry *, struct nfs4_acl **);
  76. #endif /* CONFIG_NFSD_V4 */
  77. int nfsd_create(struct svc_rqst *, struct svc_fh *,
  78. char *name, int len, struct iattr *attrs,
  79. int type, dev_t rdev, struct svc_fh *res);
  80. #ifdef CONFIG_NFSD_V3
  81. int nfsd_access(struct svc_rqst *, struct svc_fh *, u32 *, u32 *);
  82. int nfsd_create_v3(struct svc_rqst *, struct svc_fh *,
  83. char *name, int len, struct iattr *attrs,
  84. struct svc_fh *res, int createmode,
  85. u32 *verifier, int *truncp);
  86. int nfsd_commit(struct svc_rqst *, struct svc_fh *,
  87. loff_t, unsigned long);
  88. #endif /* CONFIG_NFSD_V3 */
  89. int nfsd_open(struct svc_rqst *, struct svc_fh *, int,
  90. int, struct file **);
  91. void nfsd_close(struct file *);
  92. int nfsd_read(struct svc_rqst *, struct svc_fh *, struct file *,
  93. loff_t, struct kvec *, int, unsigned long *);
  94. int nfsd_write(struct svc_rqst *, struct svc_fh *,struct file *,
  95. loff_t, struct kvec *,int, unsigned long, int *);
  96. int nfsd_readlink(struct svc_rqst *, struct svc_fh *,
  97. char *, int *);
  98. int nfsd_symlink(struct svc_rqst *, struct svc_fh *,
  99. char *name, int len, char *path, int plen,
  100. struct svc_fh *res, struct iattr *);
  101. int nfsd_link(struct svc_rqst *, struct svc_fh *,
  102. char *, int, struct svc_fh *);
  103. int nfsd_rename(struct svc_rqst *,
  104. struct svc_fh *, char *, int,
  105. struct svc_fh *, char *, int);
  106. int nfsd_remove(struct svc_rqst *,
  107. struct svc_fh *, char *, int);
  108. int nfsd_unlink(struct svc_rqst *, struct svc_fh *, int type,
  109. char *name, int len);
  110. int nfsd_truncate(struct svc_rqst *, struct svc_fh *,
  111. unsigned long size);
  112. int nfsd_readdir(struct svc_rqst *, struct svc_fh *,
  113. loff_t *, struct readdir_cd *, encode_dent_fn);
  114. int nfsd_statfs(struct svc_rqst *, struct svc_fh *,
  115. struct kstatfs *);
  116. int nfsd_notify_change(struct inode *, struct iattr *);
  117. int nfsd_permission(struct svc_export *, struct dentry *, int);
  118. #if defined(CONFIG_NFSD_V2_ACL) || defined(CONFIG_NFSD_V3_ACL)
  119. #ifdef CONFIG_NFSD_V2_ACL
  120. extern struct svc_version nfsd_acl_version2;
  121. #else
  122. #define nfsd_acl_version2 NULL
  123. #endif
  124. #ifdef CONFIG_NFSD_V3_ACL
  125. extern struct svc_version nfsd_acl_version3;
  126. #else
  127. #define nfsd_acl_version3 NULL
  128. #endif
  129. struct posix_acl *nfsd_get_posix_acl(struct svc_fh *, int);
  130. int nfsd_set_posix_acl(struct svc_fh *, int, struct posix_acl *);
  131. #endif
  132. /*
  133. * NFSv4 State
  134. */
  135. #ifdef CONFIG_NFSD_V4
  136. void nfs4_state_init(void);
  137. int nfs4_state_start(void);
  138. void nfs4_state_shutdown(void);
  139. time_t nfs4_lease_time(void);
  140. void nfs4_reset_lease(time_t leasetime);
  141. int nfs4_reset_recoverydir(char *recdir);
  142. #else
  143. static inline void nfs4_state_init(void){};
  144. static inline int nfs4_state_start(void){return 0;}
  145. static inline void nfs4_state_shutdown(void){}
  146. static inline time_t nfs4_lease_time(void){return 0;}
  147. static inline void nfs4_reset_lease(time_t leasetime){}
  148. static inline int nfs4_reset_recoverydir(char *recdir) {return 0;}
  149. #endif
  150. /*
  151. * lockd binding
  152. */
  153. void nfsd_lockd_init(void);
  154. void nfsd_lockd_shutdown(void);
  155. /*
  156. * These macros provide pre-xdr'ed values for faster operation.
  157. */
  158. #define nfs_ok __constant_htonl(NFS_OK)
  159. #define nfserr_perm __constant_htonl(NFSERR_PERM)
  160. #define nfserr_noent __constant_htonl(NFSERR_NOENT)
  161. #define nfserr_io __constant_htonl(NFSERR_IO)
  162. #define nfserr_nxio __constant_htonl(NFSERR_NXIO)
  163. #define nfserr_eagain __constant_htonl(NFSERR_EAGAIN)
  164. #define nfserr_acces __constant_htonl(NFSERR_ACCES)
  165. #define nfserr_exist __constant_htonl(NFSERR_EXIST)
  166. #define nfserr_xdev __constant_htonl(NFSERR_XDEV)
  167. #define nfserr_nodev __constant_htonl(NFSERR_NODEV)
  168. #define nfserr_notdir __constant_htonl(NFSERR_NOTDIR)
  169. #define nfserr_isdir __constant_htonl(NFSERR_ISDIR)
  170. #define nfserr_inval __constant_htonl(NFSERR_INVAL)
  171. #define nfserr_fbig __constant_htonl(NFSERR_FBIG)
  172. #define nfserr_nospc __constant_htonl(NFSERR_NOSPC)
  173. #define nfserr_rofs __constant_htonl(NFSERR_ROFS)
  174. #define nfserr_mlink __constant_htonl(NFSERR_MLINK)
  175. #define nfserr_opnotsupp __constant_htonl(NFSERR_OPNOTSUPP)
  176. #define nfserr_nametoolong __constant_htonl(NFSERR_NAMETOOLONG)
  177. #define nfserr_notempty __constant_htonl(NFSERR_NOTEMPTY)
  178. #define nfserr_dquot __constant_htonl(NFSERR_DQUOT)
  179. #define nfserr_stale __constant_htonl(NFSERR_STALE)
  180. #define nfserr_remote __constant_htonl(NFSERR_REMOTE)
  181. #define nfserr_wflush __constant_htonl(NFSERR_WFLUSH)
  182. #define nfserr_badhandle __constant_htonl(NFSERR_BADHANDLE)
  183. #define nfserr_notsync __constant_htonl(NFSERR_NOT_SYNC)
  184. #define nfserr_badcookie __constant_htonl(NFSERR_BAD_COOKIE)
  185. #define nfserr_notsupp __constant_htonl(NFSERR_NOTSUPP)
  186. #define nfserr_toosmall __constant_htonl(NFSERR_TOOSMALL)
  187. #define nfserr_serverfault __constant_htonl(NFSERR_SERVERFAULT)
  188. #define nfserr_badtype __constant_htonl(NFSERR_BADTYPE)
  189. #define nfserr_jukebox __constant_htonl(NFSERR_JUKEBOX)
  190. #define nfserr_denied __constant_htonl(NFSERR_DENIED)
  191. #define nfserr_deadlock __constant_htonl(NFSERR_DEADLOCK)
  192. #define nfserr_expired __constant_htonl(NFSERR_EXPIRED)
  193. #define nfserr_bad_cookie __constant_htonl(NFSERR_BAD_COOKIE)
  194. #define nfserr_same __constant_htonl(NFSERR_SAME)
  195. #define nfserr_clid_inuse __constant_htonl(NFSERR_CLID_INUSE)
  196. #define nfserr_stale_clientid __constant_htonl(NFSERR_STALE_CLIENTID)
  197. #define nfserr_resource __constant_htonl(NFSERR_RESOURCE)
  198. #define nfserr_nofilehandle __constant_htonl(NFSERR_NOFILEHANDLE)
  199. #define nfserr_minor_vers_mismatch __constant_htonl(NFSERR_MINOR_VERS_MISMATCH)
  200. #define nfserr_share_denied __constant_htonl(NFSERR_SHARE_DENIED)
  201. #define nfserr_stale_stateid __constant_htonl(NFSERR_STALE_STATEID)
  202. #define nfserr_old_stateid __constant_htonl(NFSERR_OLD_STATEID)
  203. #define nfserr_bad_stateid __constant_htonl(NFSERR_BAD_STATEID)
  204. #define nfserr_bad_seqid __constant_htonl(NFSERR_BAD_SEQID)
  205. #define nfserr_symlink __constant_htonl(NFSERR_SYMLINK)
  206. #define nfserr_not_same __constant_htonl(NFSERR_NOT_SAME)
  207. #define nfserr_restorefh __constant_htonl(NFSERR_RESTOREFH)
  208. #define nfserr_attrnotsupp __constant_htonl(NFSERR_ATTRNOTSUPP)
  209. #define nfserr_bad_xdr __constant_htonl(NFSERR_BAD_XDR)
  210. #define nfserr_openmode __constant_htonl(NFSERR_OPENMODE)
  211. #define nfserr_locks_held __constant_htonl(NFSERR_LOCKS_HELD)
  212. #define nfserr_op_illegal __constant_htonl(NFSERR_OP_ILLEGAL)
  213. #define nfserr_grace __constant_htonl(NFSERR_GRACE)
  214. #define nfserr_no_grace __constant_htonl(NFSERR_NO_GRACE)
  215. #define nfserr_reclaim_bad __constant_htonl(NFSERR_RECLAIM_BAD)
  216. #define nfserr_badname __constant_htonl(NFSERR_BADNAME)
  217. #define nfserr_cb_path_down __constant_htonl(NFSERR_CB_PATH_DOWN)
  218. /* error codes for internal use */
  219. /* if a request fails due to kmalloc failure, it gets dropped.
  220. * Client should resend eventually
  221. */
  222. #define nfserr_dropit __constant_htonl(30000)
  223. /* end-of-file indicator in readdir */
  224. #define nfserr_eof __constant_htonl(30001)
  225. /* Check for dir entries '.' and '..' */
  226. #define isdotent(n, l) (l < 3 && n[0] == '.' && (l == 1 || n[1] == '.'))
  227. /*
  228. * Time of server startup
  229. */
  230. extern struct timeval nfssvc_boot;
  231. static inline int is_fsid(struct svc_fh *fh, struct knfsd_fh *reffh)
  232. {
  233. if (fh->fh_export->ex_flags & NFSEXP_FSID) {
  234. struct vfsmount *mnt = fh->fh_export->ex_mnt;
  235. if (!old_valid_dev(mnt->mnt_sb->s_dev) ||
  236. (reffh->fh_version == 1 && reffh->fh_fsid_type == 1))
  237. return 1;
  238. }
  239. return 0;
  240. }
  241. #ifdef CONFIG_NFSD_V4
  242. /* before processing a COMPOUND operation, we have to check that there
  243. * is enough space in the buffer for XDR encode to succeed. otherwise,
  244. * we might process an operation with side effects, and be unable to
  245. * tell the client that the operation succeeded.
  246. *
  247. * COMPOUND_SLACK_SPACE - this is the minimum amount of buffer space
  248. * needed to encode an "ordinary" _successful_ operation. (GETATTR,
  249. * READ, READDIR, and READLINK have their own buffer checks.) if we
  250. * fall below this level, we fail the next operation with NFS4ERR_RESOURCE.
  251. *
  252. * COMPOUND_ERR_SLACK_SPACE - this is the minimum amount of buffer space
  253. * needed to encode an operation which has failed with NFS4ERR_RESOURCE.
  254. * care is taken to ensure that we never fall below this level for any
  255. * reason.
  256. */
  257. #define COMPOUND_SLACK_SPACE 140 /* OP_GETFH */
  258. #define COMPOUND_ERR_SLACK_SPACE 12 /* OP_SETATTR */
  259. #define NFSD_LEASE_TIME (nfs4_lease_time())
  260. #define NFSD_LAUNDROMAT_MINTIMEOUT 10 /* seconds */
  261. /*
  262. * The following attributes are currently not supported by the NFSv4 server:
  263. * ARCHIVE (deprecated anyway)
  264. * FS_LOCATIONS (will be supported eventually)
  265. * HIDDEN (unlikely to be supported any time soon)
  266. * MIMETYPE (unlikely to be supported any time soon)
  267. * QUOTA_* (will be supported in a forthcoming patch)
  268. * SYSTEM (unlikely to be supported any time soon)
  269. * TIME_BACKUP (unlikely to be supported any time soon)
  270. * TIME_CREATE (unlikely to be supported any time soon)
  271. */
  272. #define NFSD_SUPPORTED_ATTRS_WORD0 \
  273. (FATTR4_WORD0_SUPPORTED_ATTRS | FATTR4_WORD0_TYPE | FATTR4_WORD0_FH_EXPIRE_TYPE \
  274. | FATTR4_WORD0_CHANGE | FATTR4_WORD0_SIZE | FATTR4_WORD0_LINK_SUPPORT \
  275. | FATTR4_WORD0_SYMLINK_SUPPORT | FATTR4_WORD0_NAMED_ATTR | FATTR4_WORD0_FSID \
  276. | FATTR4_WORD0_UNIQUE_HANDLES | FATTR4_WORD0_LEASE_TIME | FATTR4_WORD0_RDATTR_ERROR \
  277. | FATTR4_WORD0_ACLSUPPORT | FATTR4_WORD0_CANSETTIME | FATTR4_WORD0_CASE_INSENSITIVE \
  278. | FATTR4_WORD0_CASE_PRESERVING | FATTR4_WORD0_CHOWN_RESTRICTED \
  279. | FATTR4_WORD0_FILEHANDLE | FATTR4_WORD0_FILEID | FATTR4_WORD0_FILES_AVAIL \
  280. | FATTR4_WORD0_FILES_FREE | FATTR4_WORD0_FILES_TOTAL | FATTR4_WORD0_HOMOGENEOUS \
  281. | FATTR4_WORD0_MAXFILESIZE | FATTR4_WORD0_MAXLINK | FATTR4_WORD0_MAXNAME \
  282. | FATTR4_WORD0_MAXREAD | FATTR4_WORD0_MAXWRITE | FATTR4_WORD0_ACL)
  283. #define NFSD_SUPPORTED_ATTRS_WORD1 \
  284. (FATTR4_WORD1_MODE | FATTR4_WORD1_NO_TRUNC | FATTR4_WORD1_NUMLINKS \
  285. | FATTR4_WORD1_OWNER | FATTR4_WORD1_OWNER_GROUP | FATTR4_WORD1_RAWDEV \
  286. | FATTR4_WORD1_SPACE_AVAIL | FATTR4_WORD1_SPACE_FREE | FATTR4_WORD1_SPACE_TOTAL \
  287. | FATTR4_WORD1_SPACE_USED | FATTR4_WORD1_TIME_ACCESS | FATTR4_WORD1_TIME_ACCESS_SET \
  288. | FATTR4_WORD1_TIME_DELTA | FATTR4_WORD1_TIME_METADATA \
  289. | FATTR4_WORD1_TIME_MODIFY | FATTR4_WORD1_TIME_MODIFY_SET | FATTR4_WORD1_MOUNTED_ON_FILEID)
  290. /* These will return ERR_INVAL if specified in GETATTR or READDIR. */
  291. #define NFSD_WRITEONLY_ATTRS_WORD1 \
  292. (FATTR4_WORD1_TIME_ACCESS_SET | FATTR4_WORD1_TIME_MODIFY_SET)
  293. /* These are the only attrs allowed in CREATE/OPEN/SETATTR. */
  294. #define NFSD_WRITEABLE_ATTRS_WORD0 \
  295. (FATTR4_WORD0_SIZE | FATTR4_WORD0_ACL )
  296. #define NFSD_WRITEABLE_ATTRS_WORD1 \
  297. (FATTR4_WORD1_MODE | FATTR4_WORD1_OWNER | FATTR4_WORD1_OWNER_GROUP \
  298. | FATTR4_WORD1_TIME_ACCESS_SET | FATTR4_WORD1_TIME_METADATA | FATTR4_WORD1_TIME_MODIFY_SET)
  299. #endif /* CONFIG_NFSD_V4 */
  300. #endif /* __KERNEL__ */
  301. #endif /* LINUX_NFSD_NFSD_H */