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