vfs.h 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * Copyright (C) 1995-1997 Olaf Kirch <okir@monad.swb.de>
  4. */
  5. #ifndef LINUX_NFSD_VFS_H
  6. #define LINUX_NFSD_VFS_H
  7. #include "nfsfh.h"
  8. #include "nfsd.h"
  9. /*
  10. * Flags for nfsd_permission
  11. */
  12. #define NFSD_MAY_NOP 0
  13. #define NFSD_MAY_EXEC 0x001 /* == MAY_EXEC */
  14. #define NFSD_MAY_WRITE 0x002 /* == MAY_WRITE */
  15. #define NFSD_MAY_READ 0x004 /* == MAY_READ */
  16. #define NFSD_MAY_SATTR 0x008
  17. #define NFSD_MAY_TRUNC 0x010
  18. #define NFSD_MAY_LOCK 0x020
  19. #define NFSD_MAY_MASK 0x03f
  20. /* extra hints to permission and open routines: */
  21. #define NFSD_MAY_OWNER_OVERRIDE 0x040
  22. #define NFSD_MAY_LOCAL_ACCESS 0x080 /* for device special files */
  23. #define NFSD_MAY_BYPASS_GSS_ON_ROOT 0x100
  24. #define NFSD_MAY_NOT_BREAK_LEASE 0x200
  25. #define NFSD_MAY_BYPASS_GSS 0x400
  26. #define NFSD_MAY_READ_IF_EXEC 0x800
  27. #define NFSD_MAY_64BIT_COOKIE 0x1000 /* 64 bit readdir cookies for >= NFSv3 */
  28. #define NFSD_MAY_CREATE (NFSD_MAY_EXEC|NFSD_MAY_WRITE)
  29. #define NFSD_MAY_REMOVE (NFSD_MAY_EXEC|NFSD_MAY_WRITE|NFSD_MAY_TRUNC)
  30. /*
  31. * Callback function for readdir
  32. */
  33. typedef int (*nfsd_filldir_t)(void *, const char *, int, loff_t, u64, unsigned);
  34. /* nfsd/vfs.c */
  35. int nfsd_racache_init(int);
  36. void nfsd_racache_shutdown(void);
  37. int nfsd_cross_mnt(struct svc_rqst *rqstp, struct dentry **dpp,
  38. struct svc_export **expp);
  39. __be32 nfsd_lookup(struct svc_rqst *, struct svc_fh *,
  40. const char *, unsigned int, struct svc_fh *);
  41. __be32 nfsd_lookup_dentry(struct svc_rqst *, struct svc_fh *,
  42. const char *, unsigned int,
  43. struct svc_export **, struct dentry **);
  44. __be32 nfsd_setattr(struct svc_rqst *, struct svc_fh *,
  45. struct iattr *, int, time_t);
  46. int nfsd_mountpoint(struct dentry *, struct svc_export *);
  47. #ifdef CONFIG_NFSD_V4
  48. __be32 nfsd4_set_nfs4_label(struct svc_rqst *, struct svc_fh *,
  49. struct xdr_netobj *);
  50. __be32 nfsd4_vfs_fallocate(struct svc_rqst *, struct svc_fh *,
  51. struct file *, loff_t, loff_t, int);
  52. __be32 nfsd4_clone_file_range(struct file *, u64, struct file *,
  53. u64, u64);
  54. #endif /* CONFIG_NFSD_V4 */
  55. __be32 nfsd_create_locked(struct svc_rqst *, struct svc_fh *,
  56. char *name, int len, struct iattr *attrs,
  57. int type, dev_t rdev, struct svc_fh *res);
  58. __be32 nfsd_create(struct svc_rqst *, struct svc_fh *,
  59. char *name, int len, struct iattr *attrs,
  60. int type, dev_t rdev, struct svc_fh *res);
  61. #ifdef CONFIG_NFSD_V3
  62. __be32 nfsd_access(struct svc_rqst *, struct svc_fh *, u32 *, u32 *);
  63. __be32 do_nfsd_create(struct svc_rqst *, struct svc_fh *,
  64. char *name, int len, struct iattr *attrs,
  65. struct svc_fh *res, int createmode,
  66. u32 *verifier, bool *truncp, bool *created);
  67. __be32 nfsd_commit(struct svc_rqst *, struct svc_fh *,
  68. loff_t, unsigned long);
  69. #endif /* CONFIG_NFSD_V3 */
  70. __be32 nfsd_open(struct svc_rqst *, struct svc_fh *, umode_t,
  71. int, struct file **);
  72. struct raparms;
  73. __be32 nfsd_splice_read(struct svc_rqst *rqstp, struct svc_fh *fhp,
  74. struct file *file, loff_t offset,
  75. unsigned long *count);
  76. __be32 nfsd_readv(struct svc_rqst *rqstp, struct svc_fh *fhp,
  77. struct file *file, loff_t offset,
  78. struct kvec *vec, int vlen,
  79. unsigned long *count);
  80. __be32 nfsd_read(struct svc_rqst *, struct svc_fh *,
  81. loff_t, struct kvec *, int, unsigned long *);
  82. __be32 nfsd_write(struct svc_rqst *, struct svc_fh *, loff_t,
  83. struct kvec *, int, unsigned long *, int);
  84. __be32 nfsd_vfs_write(struct svc_rqst *rqstp, struct svc_fh *fhp,
  85. struct file *file, loff_t offset,
  86. struct kvec *vec, int vlen, unsigned long *cnt,
  87. int stable);
  88. __be32 nfsd_readlink(struct svc_rqst *, struct svc_fh *,
  89. char *, int *);
  90. __be32 nfsd_symlink(struct svc_rqst *, struct svc_fh *,
  91. char *name, int len, char *path,
  92. struct svc_fh *res);
  93. __be32 nfsd_link(struct svc_rqst *, struct svc_fh *,
  94. char *, int, struct svc_fh *);
  95. ssize_t nfsd_copy_file_range(struct file *, u64,
  96. struct file *, u64, u64);
  97. __be32 nfsd_rename(struct svc_rqst *,
  98. struct svc_fh *, char *, int,
  99. struct svc_fh *, char *, int);
  100. __be32 nfsd_unlink(struct svc_rqst *, struct svc_fh *, int type,
  101. char *name, int len);
  102. __be32 nfsd_readdir(struct svc_rqst *, struct svc_fh *,
  103. loff_t *, struct readdir_cd *, nfsd_filldir_t);
  104. __be32 nfsd_statfs(struct svc_rqst *, struct svc_fh *,
  105. struct kstatfs *, int access);
  106. __be32 nfsd_permission(struct svc_rqst *, struct svc_export *,
  107. struct dentry *, int);
  108. struct raparms *nfsd_init_raparms(struct file *file);
  109. void nfsd_put_raparams(struct file *file, struct raparms *ra);
  110. static inline int fh_want_write(struct svc_fh *fh)
  111. {
  112. int ret;
  113. if (fh->fh_want_write)
  114. return 0;
  115. ret = mnt_want_write(fh->fh_export->ex_path.mnt);
  116. if (!ret)
  117. fh->fh_want_write = true;
  118. return ret;
  119. }
  120. static inline void fh_drop_write(struct svc_fh *fh)
  121. {
  122. if (fh->fh_want_write) {
  123. fh->fh_want_write = false;
  124. mnt_drop_write(fh->fh_export->ex_path.mnt);
  125. }
  126. }
  127. static inline __be32 fh_getattr(struct svc_fh *fh, struct kstat *stat)
  128. {
  129. struct path p = {.mnt = fh->fh_export->ex_path.mnt,
  130. .dentry = fh->fh_dentry};
  131. return nfserrno(vfs_getattr(&p, stat, STATX_BASIC_STATS,
  132. AT_STATX_SYNC_AS_STAT));
  133. }
  134. static inline int nfsd_create_is_exclusive(int createmode)
  135. {
  136. return createmode == NFS3_CREATE_EXCLUSIVE
  137. || createmode == NFS4_CREATE_EXCLUSIVE4_1;
  138. }
  139. static inline bool nfsd_eof_on_read(long requested, long read,
  140. loff_t offset, loff_t size)
  141. {
  142. /* We assume a short read means eof: */
  143. if (requested > read)
  144. return true;
  145. /*
  146. * A non-short read might also reach end of file. The spec
  147. * still requires us to set eof in that case.
  148. *
  149. * Further operations may have modified the file size since
  150. * the read, so the following check is not atomic with the read.
  151. * We've only seen that cause a problem for a client in the case
  152. * where the read returned a count of 0 without setting eof.
  153. * That case was fixed by the addition of the above check.
  154. */
  155. return (offset + read >= size);
  156. }
  157. #endif /* LINUX_NFSD_VFS_H */