state.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493
  1. /*
  2. * Copyright (c) 2001 The Regents of the University of Michigan.
  3. * All rights reserved.
  4. *
  5. * Kendrick Smith <kmsmith@umich.edu>
  6. * Andy Adamson <andros@umich.edu>
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. * 2. Redistributions in binary form must reproduce the above copyright
  15. * notice, this list of conditions and the following disclaimer in the
  16. * documentation and/or other materials provided with the distribution.
  17. * 3. Neither the name of the University nor the names of its
  18. * contributors may be used to endorse or promote products derived
  19. * from this software without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
  22. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  23. * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  24. * DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  26. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  27. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
  28. * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  29. * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  30. * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  31. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. */
  34. #ifndef _NFSD4_STATE_H
  35. #define _NFSD4_STATE_H
  36. #include <linux/sunrpc/svc_xprt.h>
  37. #include <linux/nfsd/nfsfh.h>
  38. #include "nfsfh.h"
  39. typedef struct {
  40. u32 cl_boot;
  41. u32 cl_id;
  42. } clientid_t;
  43. typedef struct {
  44. u32 so_boot;
  45. u32 so_stateownerid;
  46. u32 so_fileid;
  47. } stateid_opaque_t;
  48. typedef struct {
  49. u32 si_generation;
  50. stateid_opaque_t si_opaque;
  51. } stateid_t;
  52. #define si_boot si_opaque.so_boot
  53. #define si_stateownerid si_opaque.so_stateownerid
  54. #define si_fileid si_opaque.so_fileid
  55. #define STATEID_FMT "(%08x/%08x/%08x/%08x)"
  56. #define STATEID_VAL(s) \
  57. (s)->si_boot, \
  58. (s)->si_stateownerid, \
  59. (s)->si_fileid, \
  60. (s)->si_generation
  61. struct nfsd4_callback {
  62. void *cb_op;
  63. struct nfs4_client *cb_clp;
  64. struct list_head cb_per_client;
  65. u32 cb_minorversion;
  66. struct rpc_message cb_msg;
  67. const struct rpc_call_ops *cb_ops;
  68. struct work_struct cb_work;
  69. bool cb_done;
  70. };
  71. struct nfs4_delegation {
  72. struct list_head dl_perfile;
  73. struct list_head dl_perclnt;
  74. struct list_head dl_recall_lru; /* delegation recalled */
  75. atomic_t dl_count; /* ref count */
  76. struct nfs4_client *dl_client;
  77. struct nfs4_file *dl_file;
  78. u32 dl_type;
  79. time_t dl_time;
  80. /* For recall: */
  81. stateid_t dl_stateid;
  82. struct knfsd_fh dl_fh;
  83. int dl_retries;
  84. struct nfsd4_callback dl_recall;
  85. };
  86. /* client delegation callback info */
  87. struct nfs4_cb_conn {
  88. /* SETCLIENTID info */
  89. struct sockaddr_storage cb_addr;
  90. struct sockaddr_storage cb_saddr;
  91. size_t cb_addrlen;
  92. u32 cb_prog; /* used only in 4.0 case;
  93. per-session otherwise */
  94. u32 cb_ident; /* minorversion 0 only */
  95. struct svc_xprt *cb_xprt; /* minorversion 1 only */
  96. };
  97. /* Maximum number of slots per session. 160 is useful for long haul TCP */
  98. #define NFSD_MAX_SLOTS_PER_SESSION 160
  99. /* Maximum number of operations per session compound */
  100. #define NFSD_MAX_OPS_PER_COMPOUND 16
  101. /* Maximum session per slot cache size */
  102. #define NFSD_SLOT_CACHE_SIZE 1024
  103. /* Maximum number of NFSD_SLOT_CACHE_SIZE slots per session */
  104. #define NFSD_CACHE_SIZE_SLOTS_PER_SESSION 32
  105. #define NFSD_MAX_MEM_PER_SESSION \
  106. (NFSD_CACHE_SIZE_SLOTS_PER_SESSION * NFSD_SLOT_CACHE_SIZE)
  107. struct nfsd4_slot {
  108. bool sl_inuse;
  109. bool sl_cachethis;
  110. u16 sl_opcnt;
  111. u32 sl_seqid;
  112. __be32 sl_status;
  113. u32 sl_datalen;
  114. char sl_data[];
  115. };
  116. struct nfsd4_channel_attrs {
  117. u32 headerpadsz;
  118. u32 maxreq_sz;
  119. u32 maxresp_sz;
  120. u32 maxresp_cached;
  121. u32 maxops;
  122. u32 maxreqs;
  123. u32 nr_rdma_attrs;
  124. u32 rdma_attrs;
  125. };
  126. struct nfsd4_create_session {
  127. clientid_t clientid;
  128. struct nfs4_sessionid sessionid;
  129. u32 seqid;
  130. u32 flags;
  131. struct nfsd4_channel_attrs fore_channel;
  132. struct nfsd4_channel_attrs back_channel;
  133. u32 callback_prog;
  134. u32 uid;
  135. u32 gid;
  136. };
  137. struct nfsd4_bind_conn_to_session {
  138. struct nfs4_sessionid sessionid;
  139. u32 dir;
  140. };
  141. /* The single slot clientid cache structure */
  142. struct nfsd4_clid_slot {
  143. u32 sl_seqid;
  144. __be32 sl_status;
  145. struct nfsd4_create_session sl_cr_ses;
  146. };
  147. struct nfsd4_conn {
  148. struct list_head cn_persession;
  149. struct svc_xprt *cn_xprt;
  150. struct svc_xpt_user cn_xpt_user;
  151. struct nfsd4_session *cn_session;
  152. /* CDFC4_FORE, CDFC4_BACK: */
  153. unsigned char cn_flags;
  154. };
  155. struct nfsd4_session {
  156. struct kref se_ref;
  157. struct list_head se_hash; /* hash by sessionid */
  158. struct list_head se_perclnt;
  159. u32 se_flags;
  160. struct nfs4_client *se_client;
  161. struct nfs4_sessionid se_sessionid;
  162. struct nfsd4_channel_attrs se_fchannel;
  163. struct nfsd4_channel_attrs se_bchannel;
  164. struct list_head se_conns;
  165. u32 se_cb_prog;
  166. u32 se_cb_seq_nr;
  167. struct nfsd4_slot *se_slots[]; /* forward channel slots */
  168. };
  169. static inline void
  170. nfsd4_put_session(struct nfsd4_session *ses)
  171. {
  172. extern void free_session(struct kref *kref);
  173. kref_put(&ses->se_ref, free_session);
  174. }
  175. static inline void
  176. nfsd4_get_session(struct nfsd4_session *ses)
  177. {
  178. kref_get(&ses->se_ref);
  179. }
  180. /* formatted contents of nfs4_sessionid */
  181. struct nfsd4_sessionid {
  182. clientid_t clientid;
  183. u32 sequence;
  184. u32 reserved;
  185. };
  186. #define HEXDIR_LEN 33 /* hex version of 16 byte md5 of cl_name plus '\0' */
  187. /*
  188. * struct nfs4_client - one per client. Clientids live here.
  189. * o Each nfs4_client is hashed by clientid.
  190. *
  191. * o Each nfs4_clients is also hashed by name
  192. * (the opaque quantity initially sent by the client to identify itself).
  193. *
  194. * o cl_perclient list is used to ensure no dangling stateowner references
  195. * when we expire the nfs4_client
  196. */
  197. struct nfs4_client {
  198. struct list_head cl_idhash; /* hash by cl_clientid.id */
  199. struct list_head cl_strhash; /* hash by cl_name */
  200. struct list_head cl_openowners;
  201. struct list_head cl_delegations;
  202. struct list_head cl_lru; /* tail queue */
  203. struct xdr_netobj cl_name; /* id generated by client */
  204. char cl_recdir[HEXDIR_LEN]; /* recovery dir */
  205. nfs4_verifier cl_verifier; /* generated by client */
  206. time_t cl_time; /* time of last lease renewal */
  207. struct sockaddr_storage cl_addr; /* client ipaddress */
  208. u32 cl_flavor; /* setclientid pseudoflavor */
  209. char *cl_principal; /* setclientid principal name */
  210. struct svc_cred cl_cred; /* setclientid principal */
  211. clientid_t cl_clientid; /* generated by server */
  212. nfs4_verifier cl_confirm; /* generated by server */
  213. u32 cl_firststate; /* recovery dir creation */
  214. u32 cl_minorversion;
  215. /* for v4.0 and v4.1 callbacks: */
  216. struct nfs4_cb_conn cl_cb_conn;
  217. #define NFSD4_CLIENT_CB_UPDATE 1
  218. #define NFSD4_CLIENT_KILL 2
  219. unsigned long cl_cb_flags;
  220. struct rpc_clnt *cl_cb_client;
  221. u32 cl_cb_ident;
  222. #define NFSD4_CB_UP 0
  223. #define NFSD4_CB_UNKNOWN 1
  224. #define NFSD4_CB_DOWN 2
  225. int cl_cb_state;
  226. struct nfsd4_callback cl_cb_null;
  227. struct nfsd4_session *cl_cb_session;
  228. struct list_head cl_callbacks; /* list of in-progress callbacks */
  229. /* for all client information that callback code might need: */
  230. spinlock_t cl_lock;
  231. /* for nfs41 */
  232. struct list_head cl_sessions;
  233. struct nfsd4_clid_slot cl_cs_slot; /* create_session slot */
  234. u32 cl_exchange_flags;
  235. /* number of rpc's in progress over an associated session: */
  236. atomic_t cl_refcount;
  237. /* for nfs41 callbacks */
  238. /* We currently support a single back channel with a single slot */
  239. unsigned long cl_cb_slot_busy;
  240. struct rpc_wait_queue cl_cb_waitq; /* backchannel callers may */
  241. /* wait here for slots */
  242. };
  243. static inline void
  244. mark_client_expired(struct nfs4_client *clp)
  245. {
  246. clp->cl_time = 0;
  247. }
  248. static inline bool
  249. is_client_expired(struct nfs4_client *clp)
  250. {
  251. return clp->cl_time == 0;
  252. }
  253. /* struct nfs4_client_reset
  254. * one per old client. Populates reset_str_hashtbl. Filled from conf_id_hashtbl
  255. * upon lease reset, or from upcall to state_daemon (to read in state
  256. * from non-volitile storage) upon reboot.
  257. */
  258. struct nfs4_client_reclaim {
  259. struct list_head cr_strhash; /* hash by cr_name */
  260. char cr_recdir[HEXDIR_LEN]; /* recover dir */
  261. };
  262. static inline void
  263. update_stateid(stateid_t *stateid)
  264. {
  265. stateid->si_generation++;
  266. }
  267. /* A reasonable value for REPLAY_ISIZE was estimated as follows:
  268. * The OPEN response, typically the largest, requires
  269. * 4(status) + 8(stateid) + 20(changeinfo) + 4(rflags) + 8(verifier) +
  270. * 4(deleg. type) + 8(deleg. stateid) + 4(deleg. recall flag) +
  271. * 20(deleg. space limit) + ~32(deleg. ace) = 112 bytes
  272. */
  273. #define NFSD4_REPLAY_ISIZE 112
  274. /*
  275. * Replay buffer, where the result of the last seqid-mutating operation
  276. * is cached.
  277. */
  278. struct nfs4_replay {
  279. __be32 rp_status;
  280. unsigned int rp_buflen;
  281. char *rp_buf;
  282. unsigned intrp_allocated;
  283. struct knfsd_fh rp_openfh;
  284. char rp_ibuf[NFSD4_REPLAY_ISIZE];
  285. };
  286. /*
  287. * nfs4_stateowner can either be an open_owner, or a lock_owner
  288. *
  289. * so_idhash: stateid_hashtbl[] for open owner, lockstateid_hashtbl[]
  290. * for lock_owner
  291. * so_strhash: ownerstr_hashtbl[] for open_owner, lock_ownerstr_hashtbl[]
  292. * for lock_owner
  293. * so_perclient: nfs4_client->cl_perclient entry - used when nfs4_client
  294. * struct is reaped.
  295. * so_perfilestate: heads the list of nfs4_stateid (either open or lock)
  296. * and is used to ensure no dangling nfs4_stateid references when we
  297. * release a stateowner.
  298. * so_perlockowner: (open) nfs4_stateid->st_perlockowner entry - used when
  299. * close is called to reap associated byte-range locks
  300. * so_close_lru: (open) stateowner is placed on this list instead of being
  301. * reaped (when so_perfilestate is empty) to hold the last close replay.
  302. * reaped by laundramat thread after lease period.
  303. */
  304. struct nfs4_stateowner {
  305. struct kref so_ref;
  306. struct list_head so_idhash; /* hash by so_id */
  307. struct list_head so_strhash; /* hash by op_name */
  308. struct list_head so_perclient;
  309. struct list_head so_stateids;
  310. struct list_head so_perstateid; /* for lockowners only */
  311. struct list_head so_close_lru; /* tail queue */
  312. time_t so_time; /* time of placement on so_close_lru */
  313. int so_is_open_owner; /* 1=openowner,0=lockowner */
  314. u32 so_id;
  315. struct nfs4_client * so_client;
  316. /* after increment in ENCODE_SEQID_OP_TAIL, represents the next
  317. * sequence id expected from the client: */
  318. u32 so_seqid;
  319. struct xdr_netobj so_owner; /* open owner name */
  320. int so_confirmed; /* successful OPEN_CONFIRM? */
  321. struct nfs4_replay so_replay;
  322. };
  323. /*
  324. * nfs4_file: a file opened by some number of (open) nfs4_stateowners.
  325. * o fi_perfile list is used to search for conflicting
  326. * share_acces, share_deny on the file.
  327. */
  328. struct nfs4_file {
  329. atomic_t fi_ref;
  330. struct list_head fi_hash; /* hash by "struct inode *" */
  331. struct list_head fi_stateids;
  332. struct list_head fi_delegations;
  333. /* One each for O_RDONLY, O_WRONLY, O_RDWR: */
  334. struct file * fi_fds[3];
  335. /*
  336. * Each open or lock stateid contributes 1 to either
  337. * fi_access[O_RDONLY], fi_access[O_WRONLY], or both, depending
  338. * on open or lock mode:
  339. */
  340. atomic_t fi_access[2];
  341. struct file *fi_deleg_file;
  342. struct file_lock *fi_lease;
  343. atomic_t fi_delegees;
  344. struct inode *fi_inode;
  345. u32 fi_id; /* used with stateowner->so_id
  346. * for stateid_hashtbl hash */
  347. bool fi_had_conflict;
  348. };
  349. /* XXX: for first cut may fall back on returning file that doesn't work
  350. * at all? */
  351. static inline struct file *find_writeable_file(struct nfs4_file *f)
  352. {
  353. if (f->fi_fds[O_WRONLY])
  354. return f->fi_fds[O_WRONLY];
  355. return f->fi_fds[O_RDWR];
  356. }
  357. static inline struct file *find_readable_file(struct nfs4_file *f)
  358. {
  359. if (f->fi_fds[O_RDONLY])
  360. return f->fi_fds[O_RDONLY];
  361. return f->fi_fds[O_RDWR];
  362. }
  363. static inline struct file *find_any_file(struct nfs4_file *f)
  364. {
  365. if (f->fi_fds[O_RDWR])
  366. return f->fi_fds[O_RDWR];
  367. else if (f->fi_fds[O_WRONLY])
  368. return f->fi_fds[O_WRONLY];
  369. else
  370. return f->fi_fds[O_RDONLY];
  371. }
  372. /*
  373. * nfs4_stateid can either be an open stateid or (eventually) a lock stateid
  374. *
  375. * (open)nfs4_stateid: one per (open)nfs4_stateowner, nfs4_file
  376. *
  377. * st_hash: stateid_hashtbl[] entry or lockstateid_hashtbl entry
  378. * st_perfile: file_hashtbl[] entry.
  379. * st_perfile_state: nfs4_stateowner->so_perfilestate
  380. * st_perlockowner: (open stateid) list of lock nfs4_stateowners
  381. * st_access_bmap: used only for open stateid
  382. * st_deny_bmap: used only for open stateid
  383. * st_openstp: open stateid lock stateid was derived from
  384. *
  385. * XXX: open stateids and lock stateids have diverged sufficiently that
  386. * we should consider defining separate structs for the two cases.
  387. */
  388. struct nfs4_stateid {
  389. struct list_head st_hash;
  390. struct list_head st_perfile;
  391. struct list_head st_perstateowner;
  392. struct list_head st_lockowners;
  393. struct nfs4_stateowner * st_stateowner;
  394. struct nfs4_file * st_file;
  395. stateid_t st_stateid;
  396. unsigned long st_access_bmap;
  397. unsigned long st_deny_bmap;
  398. struct nfs4_stateid * st_openstp;
  399. };
  400. /* flags for preprocess_seqid_op() */
  401. #define HAS_SESSION 0x00000001
  402. #define CONFIRM 0x00000002
  403. #define OPEN_STATE 0x00000004
  404. #define LOCK_STATE 0x00000008
  405. #define RD_STATE 0x00000010
  406. #define WR_STATE 0x00000020
  407. #define CLOSE_STATE 0x00000040
  408. struct nfsd4_compound_state;
  409. extern __be32 nfs4_preprocess_stateid_op(struct nfsd4_compound_state *cstate,
  410. stateid_t *stateid, int flags, struct file **filp);
  411. extern void nfs4_lock_state(void);
  412. extern void nfs4_unlock_state(void);
  413. extern int nfs4_in_grace(void);
  414. extern __be32 nfs4_check_open_reclaim(clientid_t *clid);
  415. extern void nfs4_free_stateowner(struct kref *kref);
  416. extern int set_callback_cred(void);
  417. extern void nfsd4_probe_callback(struct nfs4_client *clp);
  418. extern void nfsd4_probe_callback_sync(struct nfs4_client *clp);
  419. extern void nfsd4_change_callback(struct nfs4_client *clp, struct nfs4_cb_conn *);
  420. extern void nfsd4_do_callback_rpc(struct work_struct *);
  421. extern void nfsd4_cb_recall(struct nfs4_delegation *dp);
  422. extern int nfsd4_create_callback_queue(void);
  423. extern void nfsd4_destroy_callback_queue(void);
  424. extern void nfsd4_shutdown_callback(struct nfs4_client *);
  425. extern void nfs4_put_delegation(struct nfs4_delegation *dp);
  426. extern __be32 nfs4_make_rec_clidname(char *clidname, struct xdr_netobj *clname);
  427. extern void nfsd4_init_recdir(char *recdir_name);
  428. extern int nfsd4_recdir_load(void);
  429. extern void nfsd4_shutdown_recdir(void);
  430. extern int nfs4_client_to_reclaim(const char *name);
  431. extern int nfs4_has_reclaimed_state(const char *name, bool use_exchange_id);
  432. extern void nfsd4_recdir_purge_old(void);
  433. extern int nfsd4_create_clid_dir(struct nfs4_client *clp);
  434. extern void nfsd4_remove_clid_dir(struct nfs4_client *clp);
  435. extern void release_session_client(struct nfsd4_session *);
  436. static inline void
  437. nfs4_put_stateowner(struct nfs4_stateowner *so)
  438. {
  439. kref_put(&so->so_ref, nfs4_free_stateowner);
  440. }
  441. static inline void
  442. nfs4_get_stateowner(struct nfs4_stateowner *so)
  443. {
  444. kref_get(&so->so_ref);
  445. }
  446. #endif /* NFSD4_STATE_H */