2 * linux/fs/nfs/callback.h
4 * Copyright (C) 2004 Trond Myklebust
6 * NFSv4 callback definitions
8 #ifndef __LINUX_FS_NFS_CALLBACK_H
9 #define __LINUX_FS_NFS_CALLBACK_H
10 #include <linux/sunrpc/svc.h>
12 #define NFS4_CALLBACK 0x40000000
13 #define NFS4_CALLBACK_XDRSIZE 2048
14 #define NFS4_CALLBACK_BUFSIZE (1024 + NFS4_CALLBACK_XDRSIZE)
16 enum nfs4_callback_procnum {
21 enum nfs4_callback_opnum {
24 /* Callback operations new to NFSv4.1 */
25 OP_CB_LAYOUTRECALL = 5,
29 OP_CB_RECALLABLE_OBJ_AVAIL = 9,
30 OP_CB_RECALL_SLOT = 10,
32 OP_CB_WANTS_CANCELLED = 12,
33 OP_CB_NOTIFY_LOCK = 13,
34 OP_CB_NOTIFY_DEVICEID = 14,
35 /* Callback operations new to NFSv4.2 */
37 OP_CB_ILLEGAL = 10044,
40 struct cb_process_state {
42 struct nfs_client *clp;
48 struct cb_compound_hdr_arg {
51 unsigned int minorversion;
52 unsigned int cb_ident; /* v4.0 callback identifier */
56 struct cb_compound_hdr_res {
63 struct cb_getattrargs {
68 struct cb_getattrres {
73 struct timespec ctime;
74 struct timespec mtime;
77 struct cb_recallargs {
83 #if defined(CONFIG_NFS_V4_1)
85 struct referring_call {
86 uint32_t rc_sequenceid;
90 struct referring_call_list {
91 struct nfs4_sessionid rcl_sessionid;
92 uint32_t rcl_nrefcalls;
93 struct referring_call *rcl_refcalls;
96 struct cb_sequenceargs {
97 struct sockaddr *csa_addr;
98 struct nfs4_sessionid csa_sessionid;
99 uint32_t csa_sequenceid;
101 uint32_t csa_highestslotid;
102 uint32_t csa_cachethis;
103 uint32_t csa_nrclists;
104 struct referring_call_list *csa_rclists;
107 struct cb_sequenceres {
109 struct nfs4_sessionid csr_sessionid;
110 uint32_t csr_sequenceid;
112 uint32_t csr_highestslotid;
113 uint32_t csr_target_highestslotid;
116 extern __be32 nfs4_callback_sequence(struct cb_sequenceargs *args,
117 struct cb_sequenceres *res,
118 struct cb_process_state *cps);
120 extern int nfs41_validate_delegation_stateid(struct nfs_delegation *delegation,
121 const nfs4_stateid *stateid);
123 #define RCA4_TYPE_MASK_RDATA_DLG 0
124 #define RCA4_TYPE_MASK_WDATA_DLG 1
125 #define RCA4_TYPE_MASK_DIR_DLG 2
126 #define RCA4_TYPE_MASK_FILE_LAYOUT 3
127 #define RCA4_TYPE_MASK_BLK_LAYOUT 4
128 #define RCA4_TYPE_MASK_OBJ_LAYOUT_MIN 8
129 #define RCA4_TYPE_MASK_OBJ_LAYOUT_MAX 9
130 #define RCA4_TYPE_MASK_OTHER_LAYOUT_MIN 12
131 #define RCA4_TYPE_MASK_OTHER_LAYOUT_MAX 15
132 #define RCA4_TYPE_MASK_ALL 0xf31f
134 struct cb_recallanyargs {
135 uint32_t craa_objs_to_keep;
136 uint32_t craa_type_mask;
139 extern __be32 nfs4_callback_recallany(struct cb_recallanyargs *args,
141 struct cb_process_state *cps);
143 struct cb_recallslotargs {
144 uint32_t crsa_target_highest_slotid;
146 extern __be32 nfs4_callback_recallslot(struct cb_recallslotargs *args,
148 struct cb_process_state *cps);
150 struct cb_layoutrecallargs {
151 uint32_t cbl_recall_type;
152 uint32_t cbl_layout_type;
153 uint32_t cbl_layoutchanged;
156 struct nfs_fh cbl_fh;
157 struct pnfs_layout_range cbl_range;
158 nfs4_stateid cbl_stateid;
160 struct nfs_fsid cbl_fsid;
164 extern __be32 nfs4_callback_layoutrecall(
165 struct cb_layoutrecallargs *args,
166 void *dummy, struct cb_process_state *cps);
168 struct cb_devicenotifyitem {
169 uint32_t cbd_notify_type;
170 uint32_t cbd_layout_type;
171 struct nfs4_deviceid cbd_dev_id;
172 uint32_t cbd_immediate;
175 struct cb_devicenotifyargs {
177 struct cb_devicenotifyitem *devs;
180 extern __be32 nfs4_callback_devicenotify(
181 struct cb_devicenotifyargs *args,
182 void *dummy, struct cb_process_state *cps);
184 #endif /* CONFIG_NFS_V4_1 */
185 extern int check_gss_callback_principal(struct nfs_client *, struct svc_rqst *);
186 extern __be32 nfs4_callback_getattr(struct cb_getattrargs *args,
187 struct cb_getattrres *res,
188 struct cb_process_state *cps);
189 extern __be32 nfs4_callback_recall(struct cb_recallargs *args, void *dummy,
190 struct cb_process_state *cps);
191 #if IS_ENABLED(CONFIG_NFS_V4)
192 extern int nfs_callback_up(u32 minorversion, struct rpc_xprt *xprt);
193 extern void nfs_callback_down(int minorversion, struct net *net);
194 extern int nfs4_validate_delegation_stateid(struct nfs_delegation *delegation,
195 const nfs4_stateid *stateid);
196 extern int nfs4_set_callback_sessionid(struct nfs_client *clp);
197 #endif /* CONFIG_NFS_V4 */
199 * nfs41: Callbacks are expected to not cause substantial latency,
200 * so we limit their concurrency to 1 by setting up the maximum number
201 * of slots for the backchannel.
203 #define NFS41_BC_MIN_CALLBACKS 1
204 #define NFS41_BC_MAX_CALLBACKS 1
206 extern unsigned int nfs_callback_set_tcpport;
208 #endif /* __LINUX_FS_NFS_CALLBACK_H */