state.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490
  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/idr.h>
  37. #include <linux/sunrpc/svc_xprt.h>
  38. #include <linux/nfsd/nfsfh.h>
  39. #include "nfsfh.h"
  40. typedef struct {
  41. u32 cl_boot;
  42. u32 cl_id;
  43. } clientid_t;
  44. typedef struct {
  45. clientid_t so_clid;
  46. u32 so_id;
  47. } stateid_opaque_t;
  48. typedef struct {
  49. u32 si_generation;
  50. stateid_opaque_t si_opaque;
  51. } stateid_t;
  52. #define STATEID_FMT "(%08x/%08x/%08x/%08x)"
  53. #define STATEID_VAL(s) \
  54. (s)->si_opaque.so_clid.cl_boot, \
  55. (s)->si_opaque.so_clid.cl_id, \
  56. (s)->si_opaque.so_id, \
  57. (s)->si_generation
  58. struct nfsd4_callback {
  59. void *cb_op;
  60. struct nfs4_client *cb_clp;
  61. struct list_head cb_per_client;
  62. u32 cb_minorversion;
  63. struct rpc_message cb_msg;
  64. const struct rpc_call_ops *cb_ops;
  65. struct work_struct cb_work;
  66. bool cb_done;
  67. };
  68. struct nfs4_stid {
  69. #define NFS4_OPEN_STID 1
  70. #define NFS4_LOCK_STID 2
  71. #define NFS4_DELEG_STID 4
  72. /* For an open stateid kept around *only* to process close replays: */
  73. #define NFS4_CLOSED_STID 8
  74. unsigned char sc_type;
  75. stateid_t sc_stateid;
  76. struct nfs4_client *sc_client;
  77. };
  78. struct nfs4_delegation {
  79. struct nfs4_stid dl_stid; /* must be first field */
  80. struct list_head dl_perfile;
  81. struct list_head dl_perclnt;
  82. struct list_head dl_recall_lru; /* delegation recalled */
  83. atomic_t dl_count; /* ref count */
  84. struct nfs4_file *dl_file;
  85. u32 dl_type;
  86. time_t dl_time;
  87. /* For recall: */
  88. struct knfsd_fh dl_fh;
  89. int dl_retries;
  90. struct nfsd4_callback dl_recall;
  91. };
  92. /* client delegation callback info */
  93. struct nfs4_cb_conn {
  94. /* SETCLIENTID info */
  95. struct sockaddr_storage cb_addr;
  96. struct sockaddr_storage cb_saddr;
  97. size_t cb_addrlen;
  98. u32 cb_prog; /* used only in 4.0 case;
  99. per-session otherwise */
  100. u32 cb_ident; /* minorversion 0 only */
  101. struct svc_xprt *cb_xprt; /* minorversion 1 only */
  102. };
  103. static inline struct nfs4_delegation *delegstateid(struct nfs4_stid *s)
  104. {
  105. return container_of(s, struct nfs4_delegation, dl_stid);
  106. }
  107. /* Maximum number of slots per session. 160 is useful for long haul TCP */
  108. #define NFSD_MAX_SLOTS_PER_SESSION 160
  109. /* Maximum number of operations per session compound */
  110. #define NFSD_MAX_OPS_PER_COMPOUND 16
  111. /* Maximum session per slot cache size */
  112. #define NFSD_SLOT_CACHE_SIZE 1024
  113. /* Maximum number of NFSD_SLOT_CACHE_SIZE slots per session */
  114. #define NFSD_CACHE_SIZE_SLOTS_PER_SESSION 32
  115. #define NFSD_MAX_MEM_PER_SESSION \
  116. (NFSD_CACHE_SIZE_SLOTS_PER_SESSION * NFSD_SLOT_CACHE_SIZE)
  117. struct nfsd4_slot {
  118. u32 sl_seqid;
  119. __be32 sl_status;
  120. u32 sl_datalen;
  121. u16 sl_opcnt;
  122. #define NFSD4_SLOT_INUSE (1 << 0)
  123. #define NFSD4_SLOT_CACHETHIS (1 << 1)
  124. #define NFSD4_SLOT_INITIALIZED (1 << 2)
  125. u8 sl_flags;
  126. char sl_data[];
  127. };
  128. struct nfsd4_channel_attrs {
  129. u32 headerpadsz;
  130. u32 maxreq_sz;
  131. u32 maxresp_sz;
  132. u32 maxresp_cached;
  133. u32 maxops;
  134. u32 maxreqs;
  135. u32 nr_rdma_attrs;
  136. u32 rdma_attrs;
  137. };
  138. struct nfsd4_create_session {
  139. clientid_t clientid;
  140. struct nfs4_sessionid sessionid;
  141. u32 seqid;
  142. u32 flags;
  143. struct nfsd4_channel_attrs fore_channel;
  144. struct nfsd4_channel_attrs back_channel;
  145. u32 callback_prog;
  146. u32 uid;
  147. u32 gid;
  148. };
  149. struct nfsd4_bind_conn_to_session {
  150. struct nfs4_sessionid sessionid;
  151. u32 dir;
  152. };
  153. /* The single slot clientid cache structure */
  154. struct nfsd4_clid_slot {
  155. u32 sl_seqid;
  156. __be32 sl_status;
  157. struct nfsd4_create_session sl_cr_ses;
  158. };
  159. struct nfsd4_conn {
  160. struct list_head cn_persession;
  161. struct svc_xprt *cn_xprt;
  162. struct svc_xpt_user cn_xpt_user;
  163. struct nfsd4_session *cn_session;
  164. /* CDFC4_FORE, CDFC4_BACK: */
  165. unsigned char cn_flags;
  166. };
  167. struct nfsd4_session {
  168. struct kref se_ref;
  169. struct list_head se_hash; /* hash by sessionid */
  170. struct list_head se_perclnt;
  171. u32 se_flags;
  172. struct nfs4_client *se_client;
  173. struct nfs4_sessionid se_sessionid;
  174. struct nfsd4_channel_attrs se_fchannel;
  175. struct nfsd4_channel_attrs se_bchannel;
  176. struct list_head se_conns;
  177. u32 se_cb_prog;
  178. u32 se_cb_seq_nr;
  179. struct nfsd4_slot *se_slots[]; /* forward channel slots */
  180. };
  181. extern void nfsd4_put_session(struct nfsd4_session *ses);
  182. /* formatted contents of nfs4_sessionid */
  183. struct nfsd4_sessionid {
  184. clientid_t clientid;
  185. u32 sequence;
  186. u32 reserved;
  187. };
  188. #define HEXDIR_LEN 33 /* hex version of 16 byte md5 of cl_name plus '\0' */
  189. /*
  190. * struct nfs4_client - one per client. Clientids live here.
  191. * o Each nfs4_client is hashed by clientid.
  192. *
  193. * o Each nfs4_clients is also hashed by name
  194. * (the opaque quantity initially sent by the client to identify itself).
  195. *
  196. * o cl_perclient list is used to ensure no dangling stateowner references
  197. * when we expire the nfs4_client
  198. */
  199. struct nfs4_client {
  200. struct list_head cl_idhash; /* hash by cl_clientid.id */
  201. struct list_head cl_strhash; /* hash by cl_name */
  202. struct list_head cl_openowners;
  203. struct idr cl_stateids; /* stateid lookup */
  204. struct list_head cl_delegations;
  205. struct list_head cl_lru; /* tail queue */
  206. struct xdr_netobj cl_name; /* id generated by client */
  207. char cl_recdir[HEXDIR_LEN]; /* recovery dir */
  208. nfs4_verifier cl_verifier; /* generated by client */
  209. time_t cl_time; /* time of last lease renewal */
  210. struct sockaddr_storage cl_addr; /* client ipaddress */
  211. u32 cl_flavor; /* setclientid pseudoflavor */
  212. char *cl_principal; /* setclientid principal name */
  213. struct svc_cred cl_cred; /* setclientid principal */
  214. clientid_t cl_clientid; /* generated by server */
  215. nfs4_verifier cl_confirm; /* generated by server */
  216. u32 cl_minorversion;
  217. /* for v4.0 and v4.1 callbacks: */
  218. struct nfs4_cb_conn cl_cb_conn;
  219. #define NFSD4_CLIENT_CB_UPDATE (0)
  220. #define NFSD4_CLIENT_CB_KILL (1)
  221. #define NFSD4_CLIENT_STABLE (2) /* client on stable storage */
  222. #define NFSD4_CLIENT_RECLAIM_COMPLETE (3) /* reclaim_complete done */
  223. #define NFSD4_CLIENT_CB_FLAG_MASK (1 << NFSD4_CLIENT_CB_UPDATE | \
  224. 1 << NFSD4_CLIENT_CB_KILL)
  225. unsigned long cl_flags;
  226. struct rpc_clnt *cl_cb_client;
  227. u32 cl_cb_ident;
  228. #define NFSD4_CB_UP 0
  229. #define NFSD4_CB_UNKNOWN 1
  230. #define NFSD4_CB_DOWN 2
  231. #define NFSD4_CB_FAULT 3
  232. int cl_cb_state;
  233. struct nfsd4_callback cl_cb_null;
  234. struct nfsd4_session *cl_cb_session;
  235. struct list_head cl_callbacks; /* list of in-progress callbacks */
  236. /* for all client information that callback code might need: */
  237. spinlock_t cl_lock;
  238. /* for nfs41 */
  239. struct list_head cl_sessions;
  240. struct nfsd4_clid_slot cl_cs_slot; /* create_session slot */
  241. u32 cl_exchange_flags;
  242. /* number of rpc's in progress over an associated session: */
  243. atomic_t cl_refcount;
  244. /* for nfs41 callbacks */
  245. /* We currently support a single back channel with a single slot */
  246. unsigned long cl_cb_slot_busy;
  247. struct rpc_wait_queue cl_cb_waitq; /* backchannel callers may */
  248. /* wait here for slots */
  249. };
  250. static inline void
  251. mark_client_expired(struct nfs4_client *clp)
  252. {
  253. clp->cl_time = 0;
  254. }
  255. static inline bool
  256. is_client_expired(struct nfs4_client *clp)
  257. {
  258. return clp->cl_time == 0;
  259. }
  260. /* struct nfs4_client_reset
  261. * one per old client. Populates reset_str_hashtbl. Filled from conf_id_hashtbl
  262. * upon lease reset, or from upcall to state_daemon (to read in state
  263. * from non-volitile storage) upon reboot.
  264. */
  265. struct nfs4_client_reclaim {
  266. struct list_head cr_strhash; /* hash by cr_name */
  267. char cr_recdir[HEXDIR_LEN]; /* recover dir */
  268. };
  269. static inline void
  270. update_stateid(stateid_t *stateid)
  271. {
  272. stateid->si_generation++;
  273. /* Wraparound recommendation from 3530bis-13 9.1.3.2: */
  274. if (stateid->si_generation == 0)
  275. stateid->si_generation = 1;
  276. }
  277. /* A reasonable value for REPLAY_ISIZE was estimated as follows:
  278. * The OPEN response, typically the largest, requires
  279. * 4(status) + 8(stateid) + 20(changeinfo) + 4(rflags) + 8(verifier) +
  280. * 4(deleg. type) + 8(deleg. stateid) + 4(deleg. recall flag) +
  281. * 20(deleg. space limit) + ~32(deleg. ace) = 112 bytes
  282. */
  283. #define NFSD4_REPLAY_ISIZE 112
  284. /*
  285. * Replay buffer, where the result of the last seqid-mutating operation
  286. * is cached.
  287. */
  288. struct nfs4_replay {
  289. __be32 rp_status;
  290. unsigned int rp_buflen;
  291. char *rp_buf;
  292. struct knfsd_fh rp_openfh;
  293. char rp_ibuf[NFSD4_REPLAY_ISIZE];
  294. };
  295. struct nfs4_stateowner {
  296. struct list_head so_strhash; /* hash by op_name */
  297. struct list_head so_stateids;
  298. struct nfs4_client * so_client;
  299. /* after increment in ENCODE_SEQID_OP_TAIL, represents the next
  300. * sequence id expected from the client: */
  301. u32 so_seqid;
  302. struct xdr_netobj so_owner; /* open owner name */
  303. struct nfs4_replay so_replay;
  304. bool so_is_open_owner;
  305. };
  306. struct nfs4_openowner {
  307. struct nfs4_stateowner oo_owner; /* must be first field */
  308. struct list_head oo_perclient;
  309. /*
  310. * We keep around openowners a little while after last close,
  311. * which saves clients from having to confirm, and allows us to
  312. * handle close replays if they come soon enough. The close_lru
  313. * is a list of such openowners, to be reaped by the laundromat
  314. * thread eventually if they remain unused:
  315. */
  316. struct list_head oo_close_lru;
  317. struct nfs4_ol_stateid *oo_last_closed_stid;
  318. time_t oo_time; /* time of placement on so_close_lru */
  319. #define NFS4_OO_CONFIRMED 1
  320. #define NFS4_OO_PURGE_CLOSE 2
  321. #define NFS4_OO_NEW 4
  322. unsigned char oo_flags;
  323. };
  324. struct nfs4_lockowner {
  325. struct nfs4_stateowner lo_owner; /* must be first element */
  326. struct list_head lo_owner_ino_hash; /* hash by owner,file */
  327. struct list_head lo_perstateid; /* for lockowners only */
  328. struct list_head lo_list; /* for temporary uses */
  329. };
  330. static inline struct nfs4_openowner * openowner(struct nfs4_stateowner *so)
  331. {
  332. return container_of(so, struct nfs4_openowner, oo_owner);
  333. }
  334. static inline struct nfs4_lockowner * lockowner(struct nfs4_stateowner *so)
  335. {
  336. return container_of(so, struct nfs4_lockowner, lo_owner);
  337. }
  338. /*
  339. * nfs4_file: a file opened by some number of (open) nfs4_stateowners.
  340. * o fi_perfile list is used to search for conflicting
  341. * share_acces, share_deny on the file.
  342. */
  343. struct nfs4_file {
  344. atomic_t fi_ref;
  345. struct list_head fi_hash; /* hash by "struct inode *" */
  346. struct list_head fi_stateids;
  347. struct list_head fi_delegations;
  348. /* One each for O_RDONLY, O_WRONLY, O_RDWR: */
  349. struct file * fi_fds[3];
  350. /*
  351. * Each open or lock stateid contributes 0-4 to the counts
  352. * below depending on which bits are set in st_access_bitmap:
  353. * 1 to fi_access[O_RDONLY] if NFS4_SHARE_ACCES_READ is set
  354. * + 1 to fi_access[O_WRONLY] if NFS4_SHARE_ACCESS_WRITE is set
  355. * + 1 to both of the above if NFS4_SHARE_ACCESS_BOTH is set.
  356. */
  357. atomic_t fi_access[2];
  358. struct file *fi_deleg_file;
  359. struct file_lock *fi_lease;
  360. atomic_t fi_delegees;
  361. struct inode *fi_inode;
  362. bool fi_had_conflict;
  363. };
  364. /* XXX: for first cut may fall back on returning file that doesn't work
  365. * at all? */
  366. static inline struct file *find_writeable_file(struct nfs4_file *f)
  367. {
  368. if (f->fi_fds[O_WRONLY])
  369. return f->fi_fds[O_WRONLY];
  370. return f->fi_fds[O_RDWR];
  371. }
  372. static inline struct file *find_readable_file(struct nfs4_file *f)
  373. {
  374. if (f->fi_fds[O_RDONLY])
  375. return f->fi_fds[O_RDONLY];
  376. return f->fi_fds[O_RDWR];
  377. }
  378. static inline struct file *find_any_file(struct nfs4_file *f)
  379. {
  380. if (f->fi_fds[O_RDWR])
  381. return f->fi_fds[O_RDWR];
  382. else if (f->fi_fds[O_WRONLY])
  383. return f->fi_fds[O_WRONLY];
  384. else
  385. return f->fi_fds[O_RDONLY];
  386. }
  387. /* "ol" stands for "Open or Lock". Better suggestions welcome. */
  388. struct nfs4_ol_stateid {
  389. struct nfs4_stid st_stid; /* must be first field */
  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. unsigned long st_access_bmap;
  396. unsigned long st_deny_bmap;
  397. struct nfs4_ol_stateid * st_openstp;
  398. };
  399. static inline struct nfs4_ol_stateid *openlockstateid(struct nfs4_stid *s)
  400. {
  401. return container_of(s, struct nfs4_ol_stateid, st_stid);
  402. }
  403. /* flags for preprocess_seqid_op() */
  404. #define RD_STATE 0x00000010
  405. #define WR_STATE 0x00000020
  406. struct nfsd4_compound_state;
  407. extern __be32 nfs4_preprocess_stateid_op(struct nfsd4_compound_state *cstate,
  408. stateid_t *stateid, int flags, struct file **filp);
  409. extern void nfs4_lock_state(void);
  410. extern void nfs4_unlock_state(void);
  411. extern int nfs4_in_grace(void);
  412. extern void nfs4_release_reclaim(void);
  413. extern struct nfs4_client_reclaim *nfsd4_find_reclaim_client(struct nfs4_client *crp);
  414. extern __be32 nfs4_check_open_reclaim(clientid_t *clid);
  415. extern void nfs4_free_openowner(struct nfs4_openowner *);
  416. extern void nfs4_free_lockowner(struct nfs4_lockowner *);
  417. extern int set_callback_cred(void);
  418. extern void nfsd4_probe_callback(struct nfs4_client *clp);
  419. extern void nfsd4_probe_callback_sync(struct nfs4_client *clp);
  420. extern void nfsd4_change_callback(struct nfs4_client *clp, struct nfs4_cb_conn *);
  421. extern void nfsd4_do_callback_rpc(struct work_struct *);
  422. extern void nfsd4_cb_recall(struct nfs4_delegation *dp);
  423. extern int nfsd4_create_callback_queue(void);
  424. extern void nfsd4_destroy_callback_queue(void);
  425. extern void nfsd4_shutdown_callback(struct nfs4_client *);
  426. extern void nfs4_put_delegation(struct nfs4_delegation *dp);
  427. extern __be32 nfs4_make_rec_clidname(char *clidname, struct xdr_netobj *clname);
  428. extern int nfs4_client_to_reclaim(const char *name);
  429. extern int nfs4_has_reclaimed_state(const char *name, bool use_exchange_id);
  430. extern void release_session_client(struct nfsd4_session *);
  431. extern __be32 nfs4_validate_stateid(struct nfs4_client *, stateid_t *);
  432. extern void nfsd4_purge_closed_stateid(struct nfs4_stateowner *);
  433. /* nfs4recover operations */
  434. extern int nfsd4_client_tracking_init(struct net *net);
  435. extern void nfsd4_client_tracking_exit(struct net *net);
  436. extern void nfsd4_client_record_create(struct nfs4_client *clp);
  437. extern void nfsd4_client_record_remove(struct nfs4_client *clp);
  438. extern int nfsd4_client_record_check(struct nfs4_client *clp);
  439. extern void nfsd4_record_grace_done(struct net *net, time_t boot_time);
  440. #endif /* NFSD4_STATE_H */