v9fs.h 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. /*
  2. * V9FS definitions.
  3. *
  4. * Copyright (C) 2004-2008 by Eric Van Hensbergen <ericvh@gmail.com>
  5. * Copyright (C) 2002 by Ron Minnich <rminnich@lanl.gov>
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License version 2
  9. * as published by the Free Software Foundation.
  10. *
  11. * This program is distributed in the hope that it will be useful,
  12. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. * GNU General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU General Public License
  17. * along with this program; if not, write to:
  18. * Free Software Foundation
  19. * 51 Franklin Street, Fifth Floor
  20. * Boston, MA 02111-1301 USA
  21. *
  22. */
  23. #include <linux/backing-dev.h>
  24. /**
  25. * enum p9_session_flags - option flags for each 9P session
  26. * @V9FS_PROTO_2000U: whether or not to use 9P2000.u extensions
  27. * @V9FS_PROTO_2000L: whether or not to use 9P2000.l extensions
  28. * @V9FS_ACCESS_SINGLE: only the mounting user can access the hierarchy
  29. * @V9FS_ACCESS_USER: a new attach will be issued for every user (default)
  30. * @V9FS_ACCESS_ANY: use a single attach for all users
  31. * @V9FS_ACCESS_MASK: bit mask of different ACCESS options
  32. *
  33. * Session flags reflect options selected by users at mount time
  34. */
  35. enum p9_session_flags {
  36. V9FS_PROTO_2000U = 0x01,
  37. V9FS_PROTO_2000L = 0x02,
  38. V9FS_ACCESS_SINGLE = 0x04,
  39. V9FS_ACCESS_USER = 0x08,
  40. V9FS_ACCESS_ANY = 0x0C,
  41. V9FS_ACCESS_MASK = 0x0C,
  42. };
  43. /* possible values of ->cache */
  44. /**
  45. * enum p9_cache_modes - user specified cache preferences
  46. * @CACHE_NONE: do not cache data, dentries, or directory contents (default)
  47. * @CACHE_LOOSE: cache data, dentries, and directory contents w/no consistency
  48. *
  49. * eventually support loose, tight, time, session, default always none
  50. */
  51. enum p9_cache_modes {
  52. CACHE_NONE,
  53. CACHE_LOOSE,
  54. CACHE_FSCACHE,
  55. };
  56. /**
  57. * struct v9fs_session_info - per-instance session information
  58. * @flags: session options of type &p9_session_flags
  59. * @nodev: set to 1 to disable device mapping
  60. * @debug: debug level
  61. * @afid: authentication handle
  62. * @cache: cache mode of type &p9_cache_modes
  63. * @cachetag: the tag of the cache associated with this session
  64. * @fscache: session cookie associated with FS-Cache
  65. * @options: copy of options string given by user
  66. * @uname: string user name to mount hierarchy as
  67. * @aname: mount specifier for remote hierarchy
  68. * @maxdata: maximum data to be sent/recvd per protocol message
  69. * @dfltuid: default numeric userid to mount hierarchy as
  70. * @dfltgid: default numeric groupid to mount hierarchy as
  71. * @uid: if %V9FS_ACCESS_SINGLE, the numeric uid which mounted the hierarchy
  72. * @clnt: reference to 9P network client instantiated for this session
  73. * @slist: reference to list of registered 9p sessions
  74. *
  75. * This structure holds state for each session instance established during
  76. * a sys_mount() .
  77. *
  78. * Bugs: there seems to be a lot of state which could be condensed and/or
  79. * removed.
  80. */
  81. struct v9fs_session_info {
  82. /* options */
  83. unsigned char flags;
  84. unsigned char nodev;
  85. unsigned short debug;
  86. unsigned int afid;
  87. unsigned int cache;
  88. #ifdef CONFIG_9P_FSCACHE
  89. char *cachetag;
  90. struct fscache_cookie *fscache;
  91. #endif
  92. char *uname; /* user name to mount as */
  93. char *aname; /* name of remote hierarchy being mounted */
  94. unsigned int maxdata; /* max data for client interface */
  95. unsigned int dfltuid; /* default uid/muid for legacy support */
  96. unsigned int dfltgid; /* default gid for legacy support */
  97. u32 uid; /* if ACCESS_SINGLE, the uid that has access */
  98. struct p9_client *clnt; /* 9p client */
  99. struct list_head slist; /* list of sessions registered with v9fs */
  100. struct backing_dev_info bdi;
  101. struct rw_semaphore rename_sem;
  102. };
  103. struct p9_fid *v9fs_session_init(struct v9fs_session_info *, const char *,
  104. char *);
  105. void v9fs_session_close(struct v9fs_session_info *v9ses);
  106. void v9fs_session_cancel(struct v9fs_session_info *v9ses);
  107. void v9fs_session_begin_cancel(struct v9fs_session_info *v9ses);
  108. #define V9FS_MAGIC 0x01021997
  109. /* other default globals */
  110. #define V9FS_PORT 564
  111. #define V9FS_DEFUSER "nobody"
  112. #define V9FS_DEFANAME ""
  113. #define V9FS_DEFUID (-2)
  114. #define V9FS_DEFGID (-2)
  115. static inline struct v9fs_session_info *v9fs_inode2v9ses(struct inode *inode)
  116. {
  117. return (inode->i_sb->s_fs_info);
  118. }
  119. static inline int v9fs_proto_dotu(struct v9fs_session_info *v9ses)
  120. {
  121. return v9ses->flags & V9FS_PROTO_2000U;
  122. }
  123. static inline int v9fs_proto_dotl(struct v9fs_session_info *v9ses)
  124. {
  125. return v9ses->flags & V9FS_PROTO_2000L;
  126. }