1
2
3
4
5
6
7
8
9
10#ifndef __LINUX_FS_NFS_NFS4_FS_H
11#define __LINUX_FS_NFS_NFS4_FS_H
12
13#if defined(CONFIG_NFS_V4_2)
14#define NFS4_MAX_MINOR_VERSION 2
15#elif defined(CONFIG_NFS_V4_1)
16#define NFS4_MAX_MINOR_VERSION 1
17#else
18#define NFS4_MAX_MINOR_VERSION 0
19#endif
20
21#if IS_ENABLED(CONFIG_NFS_V4)
22
23#define NFS4_MAX_LOOP_ON_RECOVER (10)
24
25#include <linux/seqlock.h>
26
27struct idmap;
28
29enum nfs4_client_state {
30 NFS4CLNT_MANAGER_RUNNING = 0,
31 NFS4CLNT_CHECK_LEASE,
32 NFS4CLNT_LEASE_EXPIRED,
33 NFS4CLNT_RECLAIM_REBOOT,
34 NFS4CLNT_RECLAIM_NOGRACE,
35 NFS4CLNT_DELEGRETURN,
36 NFS4CLNT_SESSION_RESET,
37 NFS4CLNT_LEASE_CONFIRM,
38 NFS4CLNT_SERVER_SCOPE_MISMATCH,
39 NFS4CLNT_PURGE_STATE,
40 NFS4CLNT_BIND_CONN_TO_SESSION,
41 NFS4CLNT_MOVED,
42 NFS4CLNT_LEASE_MOVED,
43 NFS4CLNT_DELEGATION_EXPIRED,
44 NFS4CLNT_RUN_MANAGER,
45 NFS4CLNT_DELEGRETURN_RUNNING,
46};
47
48#define NFS4_RENEW_TIMEOUT 0x01
49#define NFS4_RENEW_DELEGATION_CB 0x02
50
51struct nfs_seqid_counter;
52struct nfs4_minor_version_ops {
53 u32 minor_version;
54 unsigned init_caps;
55
56 int (*init_client)(struct nfs_client *);
57 void (*shutdown_client)(struct nfs_client *);
58 bool (*match_stateid)(const nfs4_stateid *,
59 const nfs4_stateid *);
60 int (*find_root_sec)(struct nfs_server *, struct nfs_fh *,
61 struct nfs_fsinfo *);
62 void (*free_lock_state)(struct nfs_server *,
63 struct nfs4_lock_state *);
64 int (*test_and_free_expired)(struct nfs_server *,
65 nfs4_stateid *, const struct cred *);
66 struct nfs_seqid *
67 (*alloc_seqid)(struct nfs_seqid_counter *, gfp_t);
68 void (*session_trunk)(struct rpc_clnt *clnt,
69 struct rpc_xprt *xprt, void *data);
70 const struct rpc_call_ops *call_sync_ops;
71 const struct nfs4_state_recovery_ops *reboot_recovery_ops;
72 const struct nfs4_state_recovery_ops *nograce_recovery_ops;
73 const struct nfs4_state_maintenance_ops *state_renewal_ops;
74 const struct nfs4_mig_recovery_ops *mig_recovery_ops;
75};
76
77#define NFS_SEQID_CONFIRMED 1
78struct nfs_seqid_counter {
79 ktime_t create_time;
80 int owner_id;
81 int flags;
82 u32 counter;
83 spinlock_t lock;
84 struct list_head list;
85 struct rpc_wait_queue wait;
86};
87
88struct nfs_seqid {
89 struct nfs_seqid_counter *sequence;
90 struct list_head list;
91 struct rpc_task *task;
92};
93
94static inline void nfs_confirm_seqid(struct nfs_seqid_counter *seqid, int status)
95{
96 if (seqid_mutating_err(-status))
97 seqid->flags |= NFS_SEQID_CONFIRMED;
98}
99
100
101
102
103
104
105struct nfs4_state_owner {
106 struct nfs_server *so_server;
107 struct list_head so_lru;
108 unsigned long so_expires;
109 struct rb_node so_server_node;
110
111 const struct cred *so_cred;
112
113 spinlock_t so_lock;
114 atomic_t so_count;
115 unsigned long so_flags;
116 struct list_head so_states;
117 struct nfs_seqid_counter so_seqid;
118 seqcount_t so_reclaim_seqcount;
119 struct mutex so_delegreturn_mutex;
120};
121
122enum {
123 NFS_OWNER_RECLAIM_REBOOT,
124 NFS_OWNER_RECLAIM_NOGRACE
125};
126
127#define NFS_LOCK_NEW 0
128#define NFS_LOCK_RECLAIM 1
129#define NFS_LOCK_EXPIRED 2
130
131
132
133
134
135
136
137
138
139
140
141
142
143struct nfs4_lock_state {
144 struct list_head ls_locks;
145 struct nfs4_state * ls_state;
146#define NFS_LOCK_INITIALIZED 0
147#define NFS_LOCK_LOST 1
148 unsigned long ls_flags;
149 struct nfs_seqid_counter ls_seqid;
150 nfs4_stateid ls_stateid;
151 refcount_t ls_count;
152 fl_owner_t ls_owner;
153};
154
155
156enum {
157 LK_STATE_IN_USE,
158 NFS_DELEGATED_STATE,
159 NFS_OPEN_STATE,
160 NFS_O_RDONLY_STATE,
161 NFS_O_WRONLY_STATE,
162 NFS_O_RDWR_STATE,
163 NFS_STATE_RECLAIM_REBOOT,
164 NFS_STATE_RECLAIM_NOGRACE,
165 NFS_STATE_POSIX_LOCKS,
166 NFS_STATE_RECOVERY_FAILED,
167 NFS_STATE_MAY_NOTIFY_LOCK,
168 NFS_STATE_CHANGE_WAIT,
169#ifdef CONFIG_NFS_V4_2
170 NFS_CLNT_DST_SSC_COPY_STATE,
171#endif
172};
173
174struct nfs4_state {
175 struct list_head open_states;
176 struct list_head inode_states;
177 struct list_head lock_states;
178
179 struct nfs4_state_owner *owner;
180 struct inode *inode;
181
182 unsigned long flags;
183 spinlock_t state_lock;
184
185 seqlock_t seqlock;
186 nfs4_stateid stateid;
187 nfs4_stateid open_stateid;
188
189
190 unsigned int n_rdonly;
191 unsigned int n_wronly;
192 unsigned int n_rdwr;
193 fmode_t state;
194 refcount_t count;
195
196 wait_queue_head_t waitq;
197 struct rcu_head rcu_head;
198};
199
200
201struct nfs4_exception {
202 struct nfs4_state *state;
203 struct inode *inode;
204 nfs4_stateid *stateid;
205 long timeout;
206 unsigned char delay : 1,
207 recovering : 1,
208 retry : 1;
209};
210
211struct nfs4_state_recovery_ops {
212 int owner_flag_bit;
213 int state_flag_bit;
214 int (*recover_open)(struct nfs4_state_owner *, struct nfs4_state *);
215 int (*recover_lock)(struct nfs4_state *, struct file_lock *);
216 int (*establish_clid)(struct nfs_client *, const struct cred *);
217 int (*reclaim_complete)(struct nfs_client *, const struct cred *);
218 int (*detect_trunking)(struct nfs_client *, struct nfs_client **,
219 const struct cred *);
220};
221
222struct nfs4_opendata {
223 struct kref kref;
224 struct nfs_openargs o_arg;
225 struct nfs_openres o_res;
226 struct nfs_open_confirmargs c_arg;
227 struct nfs_open_confirmres c_res;
228 struct nfs4_string owner_name;
229 struct nfs4_string group_name;
230 struct nfs4_label *a_label;
231 struct nfs_fattr f_attr;
232 struct nfs4_label *f_label;
233 struct dentry *dir;
234 struct dentry *dentry;
235 struct nfs4_state_owner *owner;
236 struct nfs4_state *state;
237 struct iattr attrs;
238 struct nfs4_layoutget *lgp;
239 unsigned long timestamp;
240 bool rpc_done;
241 bool file_created;
242 bool is_recover;
243 bool cancelled;
244 int rpc_status;
245};
246
247struct nfs4_add_xprt_data {
248 struct nfs_client *clp;
249 const struct cred *cred;
250};
251
252struct nfs4_state_maintenance_ops {
253 int (*sched_state_renewal)(struct nfs_client *, const struct cred *, unsigned);
254 const struct cred * (*get_state_renewal_cred)(struct nfs_client *);
255 int (*renew_lease)(struct nfs_client *, const struct cred *);
256};
257
258struct nfs4_mig_recovery_ops {
259 int (*get_locations)(struct inode *, struct nfs4_fs_locations *,
260 struct page *, const struct cred *);
261 int (*fsid_present)(struct inode *, const struct cred *);
262};
263
264extern const struct dentry_operations nfs4_dentry_operations;
265
266
267int nfs_atomic_open(struct inode *, struct dentry *, struct file *,
268 unsigned, umode_t, int *);
269
270
271extern struct file_system_type nfs4_fs_type;
272
273
274struct rpc_clnt *nfs4_negotiate_security(struct rpc_clnt *, struct inode *,
275 const struct qstr *);
276struct vfsmount *nfs4_submount(struct nfs_server *, struct dentry *,
277 struct nfs_fh *, struct nfs_fattr *);
278int nfs4_replace_transport(struct nfs_server *server,
279 const struct nfs4_fs_locations *locations);
280
281
282extern int nfs4_handle_exception(struct nfs_server *, int, struct nfs4_exception *);
283extern int nfs4_async_handle_error(struct rpc_task *task,
284 struct nfs_server *server,
285 struct nfs4_state *state, long *timeout);
286extern int nfs4_call_sync(struct rpc_clnt *, struct nfs_server *,
287 struct rpc_message *, struct nfs4_sequence_args *,
288 struct nfs4_sequence_res *, int);
289extern void nfs4_init_sequence(struct nfs4_sequence_args *, struct nfs4_sequence_res *, int, int);
290extern int nfs4_proc_setclientid(struct nfs_client *, u32, unsigned short, const struct cred *, struct nfs4_setclientid_res *);
291extern int nfs4_proc_setclientid_confirm(struct nfs_client *, struct nfs4_setclientid_res *arg, const struct cred *);
292extern int nfs4_proc_get_rootfh(struct nfs_server *, struct nfs_fh *, struct nfs_fsinfo *, bool);
293extern int nfs4_proc_bind_conn_to_session(struct nfs_client *, const struct cred *cred);
294extern int nfs4_proc_exchange_id(struct nfs_client *clp, const struct cred *cred);
295extern int nfs4_destroy_clientid(struct nfs_client *clp);
296extern int nfs4_init_clientid(struct nfs_client *, const struct cred *);
297extern int nfs41_init_clientid(struct nfs_client *, const struct cred *);
298extern int nfs4_do_close(struct nfs4_state *state, gfp_t gfp_mask, int wait);
299extern int nfs4_server_capabilities(struct nfs_server *server, struct nfs_fh *fhandle);
300extern int nfs4_proc_fs_locations(struct rpc_clnt *, struct inode *, const struct qstr *,
301 struct nfs4_fs_locations *, struct page *);
302extern int nfs4_proc_get_locations(struct inode *, struct nfs4_fs_locations *,
303 struct page *page, const struct cred *);
304extern int nfs4_proc_fsid_present(struct inode *, const struct cred *);
305extern struct rpc_clnt *nfs4_proc_lookup_mountpoint(struct inode *, const struct qstr *,
306 struct nfs_fh *, struct nfs_fattr *);
307extern int nfs4_proc_secinfo(struct inode *, const struct qstr *, struct nfs4_secinfo_flavors *);
308extern const struct xattr_handler *nfs4_xattr_handlers[];
309extern int nfs4_set_rw_stateid(nfs4_stateid *stateid,
310 const struct nfs_open_context *ctx,
311 const struct nfs_lock_context *l_ctx,
312 fmode_t fmode);
313
314#if defined(CONFIG_NFS_V4_1)
315extern int nfs41_sequence_done(struct rpc_task *, struct nfs4_sequence_res *);
316extern int nfs4_proc_create_session(struct nfs_client *, const struct cred *);
317extern int nfs4_proc_destroy_session(struct nfs4_session *, const struct cred *);
318extern int nfs4_proc_get_lease_time(struct nfs_client *clp,
319 struct nfs_fsinfo *fsinfo);
320extern int nfs4_proc_layoutcommit(struct nfs4_layoutcommit_data *data,
321 bool sync);
322extern int nfs4_detect_session_trunking(struct nfs_client *clp,
323 struct nfs41_exchange_id_res *res, struct rpc_xprt *xprt);
324
325static inline bool
326is_ds_only_client(struct nfs_client *clp)
327{
328 return (clp->cl_exchange_flags & EXCHGID4_FLAG_MASK_PNFS) ==
329 EXCHGID4_FLAG_USE_PNFS_DS;
330}
331
332static inline bool
333is_ds_client(struct nfs_client *clp)
334{
335 return clp->cl_exchange_flags & EXCHGID4_FLAG_USE_PNFS_DS;
336}
337
338static inline bool
339_nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_mode,
340 struct rpc_clnt **clntp, struct rpc_message *msg)
341{
342 rpc_authflavor_t flavor;
343
344 if (sp4_mode == NFS_SP4_MACH_CRED_CLEANUP ||
345 sp4_mode == NFS_SP4_MACH_CRED_PNFS_CLEANUP) {
346
347
348
349
350
351
352 if ((*clntp)->cl_auth->au_flavor == RPC_AUTH_UNIX)
353 return false;
354 }
355 if (test_bit(sp4_mode, &clp->cl_sp4_flags)) {
356 msg->rpc_cred = rpc_machine_cred();
357
358 flavor = clp->cl_rpcclient->cl_auth->au_flavor;
359 WARN_ON_ONCE(flavor != RPC_AUTH_GSS_KRB5I &&
360 flavor != RPC_AUTH_GSS_KRB5P);
361 *clntp = clp->cl_rpcclient;
362
363 return true;
364 }
365 return false;
366}
367
368
369
370
371
372
373
374static inline void
375nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_mode,
376 struct rpc_clnt **clntp, struct rpc_message *msg)
377{
378 _nfs4_state_protect(clp, sp4_mode, clntp, msg);
379}
380
381
382
383
384
385
386static inline void
387nfs4_state_protect_write(struct nfs_client *clp, struct rpc_clnt **clntp,
388 struct rpc_message *msg, struct nfs_pgio_header *hdr)
389{
390 if (_nfs4_state_protect(clp, NFS_SP4_MACH_CRED_WRITE, clntp, msg) &&
391 !test_bit(NFS_SP4_MACH_CRED_COMMIT, &clp->cl_sp4_flags))
392 hdr->args.stable = NFS_FILE_SYNC;
393}
394#else
395static inline bool
396is_ds_only_client(struct nfs_client *clp)
397{
398 return false;
399}
400
401static inline bool
402is_ds_client(struct nfs_client *clp)
403{
404 return false;
405}
406
407static inline void
408nfs4_state_protect(struct nfs_client *clp, unsigned long sp4_flags,
409 struct rpc_clnt **clntp, struct rpc_message *msg)
410{
411}
412
413static inline void
414nfs4_state_protect_write(struct nfs_client *clp, struct rpc_clnt **clntp,
415 struct rpc_message *msg, struct nfs_pgio_header *hdr)
416{
417}
418#endif
419
420extern const struct nfs4_minor_version_ops *nfs_v4_minor_ops[];
421
422extern const u32 nfs4_fattr_bitmap[3];
423extern const u32 nfs4_statfs_bitmap[3];
424extern const u32 nfs4_pathconf_bitmap[3];
425extern const u32 nfs4_fsinfo_bitmap[3];
426extern const u32 nfs4_fs_locations_bitmap[3];
427
428void nfs40_shutdown_client(struct nfs_client *);
429void nfs41_shutdown_client(struct nfs_client *);
430int nfs40_init_client(struct nfs_client *);
431int nfs41_init_client(struct nfs_client *);
432void nfs4_free_client(struct nfs_client *);
433
434struct nfs_client *nfs4_alloc_client(const struct nfs_client_initdata *);
435
436
437extern void nfs4_schedule_state_renewal(struct nfs_client *);
438extern void nfs4_renewd_prepare_shutdown(struct nfs_server *);
439extern void nfs4_kill_renewd(struct nfs_client *);
440extern void nfs4_renew_state(struct work_struct *);
441extern void nfs4_set_lease_period(struct nfs_client *clp,
442 unsigned long lease,
443 unsigned long lastrenewed);
444
445
446
447const struct cred *nfs4_get_clid_cred(struct nfs_client *clp);
448const struct cred *nfs4_get_machine_cred(struct nfs_client *clp);
449const struct cred *nfs4_get_renew_cred(struct nfs_client *clp);
450int nfs4_discover_server_trunking(struct nfs_client *clp,
451 struct nfs_client **);
452int nfs40_discover_server_trunking(struct nfs_client *clp,
453 struct nfs_client **, const struct cred *);
454#if defined(CONFIG_NFS_V4_1)
455int nfs41_discover_server_trunking(struct nfs_client *clp,
456 struct nfs_client **, const struct cred *);
457extern void nfs4_schedule_session_recovery(struct nfs4_session *, int);
458extern void nfs41_notify_server(struct nfs_client *);
459#else
460static inline void nfs4_schedule_session_recovery(struct nfs4_session *session, int err)
461{
462}
463#endif
464
465extern struct nfs4_state_owner *nfs4_get_state_owner(struct nfs_server *, const struct cred *, gfp_t);
466extern void nfs4_put_state_owner(struct nfs4_state_owner *);
467extern void nfs4_purge_state_owners(struct nfs_server *, struct list_head *);
468extern void nfs4_free_state_owners(struct list_head *head);
469extern struct nfs4_state * nfs4_get_open_state(struct inode *, struct nfs4_state_owner *);
470extern void nfs4_put_open_state(struct nfs4_state *);
471extern void nfs4_close_state(struct nfs4_state *, fmode_t);
472extern void nfs4_close_sync(struct nfs4_state *, fmode_t);
473extern void nfs4_state_set_mode_locked(struct nfs4_state *, fmode_t);
474extern void nfs_inode_find_state_and_recover(struct inode *inode,
475 const nfs4_stateid *stateid);
476extern int nfs4_state_mark_reclaim_nograce(struct nfs_client *, struct nfs4_state *);
477extern void nfs4_schedule_lease_recovery(struct nfs_client *);
478extern int nfs4_wait_clnt_recover(struct nfs_client *clp);
479extern int nfs4_client_recover_expired_lease(struct nfs_client *clp);
480extern void nfs4_schedule_state_manager(struct nfs_client *);
481extern void nfs4_schedule_path_down_recovery(struct nfs_client *clp);
482extern int nfs4_schedule_stateid_recovery(const struct nfs_server *, struct nfs4_state *);
483extern int nfs4_schedule_migration_recovery(const struct nfs_server *);
484extern void nfs4_schedule_lease_moved_recovery(struct nfs_client *);
485extern void nfs41_handle_sequence_flag_errors(struct nfs_client *clp, u32 flags, bool);
486extern void nfs41_handle_server_scope(struct nfs_client *,
487 struct nfs41_server_scope **);
488extern void nfs4_put_lock_state(struct nfs4_lock_state *lsp);
489extern int nfs4_set_lock_state(struct nfs4_state *state, struct file_lock *fl);
490extern int nfs4_select_rw_stateid(struct nfs4_state *, fmode_t,
491 const struct nfs_lock_context *, nfs4_stateid *,
492 const struct cred **);
493extern bool nfs4_refresh_open_stateid(nfs4_stateid *dst,
494 struct nfs4_state *state);
495extern bool nfs4_copy_open_stateid(nfs4_stateid *dst,
496 struct nfs4_state *state);
497
498extern struct nfs_seqid *nfs_alloc_seqid(struct nfs_seqid_counter *counter, gfp_t gfp_mask);
499extern int nfs_wait_on_sequence(struct nfs_seqid *seqid, struct rpc_task *task);
500extern void nfs_increment_open_seqid(int status, struct nfs_seqid *seqid);
501extern void nfs_increment_lock_seqid(int status, struct nfs_seqid *seqid);
502extern void nfs_release_seqid(struct nfs_seqid *seqid);
503extern void nfs_free_seqid(struct nfs_seqid *seqid);
504extern int nfs4_setup_sequence(struct nfs_client *client,
505 struct nfs4_sequence_args *args,
506 struct nfs4_sequence_res *res,
507 struct rpc_task *task);
508extern int nfs4_sequence_done(struct rpc_task *task,
509 struct nfs4_sequence_res *res);
510
511extern void nfs4_free_lock_state(struct nfs_server *server, struct nfs4_lock_state *lsp);
512extern int nfs4_proc_commit(struct file *dst, __u64 offset, __u32 count, struct nfs_commitres *res);
513extern const nfs4_stateid zero_stateid;
514extern const nfs4_stateid invalid_stateid;
515
516
517struct nfs_mount_info;
518extern struct nfs_subversion nfs_v4;
519struct dentry *nfs4_try_mount(int, const char *, struct nfs_mount_info *, struct nfs_subversion *);
520extern bool nfs4_disable_idmapping;
521extern unsigned short max_session_slots;
522extern unsigned short max_session_cb_slots;
523extern unsigned short send_implementation_id;
524extern bool recover_lost_locks;
525
526#define NFS4_CLIENT_ID_UNIQ_LEN (64)
527extern char nfs4_client_id_uniquifier[NFS4_CLIENT_ID_UNIQ_LEN];
528
529
530#ifdef CONFIG_SYSCTL
531int nfs4_register_sysctl(void);
532void nfs4_unregister_sysctl(void);
533#else
534static inline int nfs4_register_sysctl(void)
535{
536 return 0;
537}
538
539static inline void nfs4_unregister_sysctl(void)
540{
541}
542#endif
543
544
545extern const struct rpc_procinfo nfs4_procedures[];
546
547struct nfs4_mount_data;
548
549
550extern const struct svc_version nfs4_callback_version1;
551extern const struct svc_version nfs4_callback_version4;
552
553static inline void nfs4_stateid_copy(nfs4_stateid *dst, const nfs4_stateid *src)
554{
555 memcpy(dst->data, src->data, sizeof(dst->data));
556 dst->type = src->type;
557}
558
559static inline bool nfs4_stateid_match(const nfs4_stateid *dst, const nfs4_stateid *src)
560{
561 if (dst->type != src->type)
562 return false;
563 return memcmp(dst->data, src->data, sizeof(dst->data)) == 0;
564}
565
566static inline bool nfs4_stateid_match_other(const nfs4_stateid *dst, const nfs4_stateid *src)
567{
568 return memcmp(dst->other, src->other, NFS4_STATEID_OTHER_SIZE) == 0;
569}
570
571static inline bool nfs4_stateid_is_newer(const nfs4_stateid *s1, const nfs4_stateid *s2)
572{
573 return (s32)(be32_to_cpu(s1->seqid) - be32_to_cpu(s2->seqid)) > 0;
574}
575
576static inline bool nfs4_valid_open_stateid(const struct nfs4_state *state)
577{
578 return test_bit(NFS_STATE_RECOVERY_FAILED, &state->flags) == 0;
579}
580
581static inline bool nfs4_state_match_open_stateid_other(const struct nfs4_state *state,
582 const nfs4_stateid *stateid)
583{
584 return test_bit(NFS_OPEN_STATE, &state->flags) &&
585 nfs4_stateid_match_other(&state->open_stateid, stateid);
586}
587
588#else
589
590#define nfs4_close_state(a, b) do { } while (0)
591#define nfs4_close_sync(a, b) do { } while (0)
592#define nfs4_state_protect(a, b, c, d) do { } while (0)
593#define nfs4_state_protect_write(a, b, c, d) do { } while (0)
594
595#endif
596#endif
597