fs/nfs/callback.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * linux/fs/nfs/callback.h
   4  *
   5  * Copyright (C) 2004 Trond Myklebust
   6  *
   7  * NFSv4 callback definitions
   8  */
   9 #ifndef __LINUX_FS_NFS_CALLBACK_H
  10 #define __LINUX_FS_NFS_CALLBACK_H
  11 #include <linux/sunrpc/svc.h>
  12
  13 #define NFS4_CALLBACK 0x40000000
  14 #define NFS4_CALLBACK_XDRSIZE 2048
  15 #define NFS4_CALLBACK_BUFSIZE (1024 + NFS4_CALLBACK_XDRSIZE)
  16
  17 enum nfs4_callback_procnum {
  18         CB_NULL = 0,
  19         CB_COMPOUND = 1,
  20 };
  21
  22 enum nfs4_callback_opnum {
  23         OP_CB_GETATTR = 3,
  24         OP_CB_RECALL  = 4,
  25 /* Callback operations new to NFSv4.1 */
  26         OP_CB_LAYOUTRECALL  = 5,
  27         OP_CB_NOTIFY        = 6,
  28         OP_CB_PUSH_DELEG    = 7,
  29         OP_CB_RECALL_ANY    = 8,
  30         OP_CB_RECALLABLE_OBJ_AVAIL = 9,
  31         OP_CB_RECALL_SLOT   = 10,
  32         OP_CB_SEQUENCE      = 11,
  33         OP_CB_WANTS_CANCELLED = 12,
  34         OP_CB_NOTIFY_LOCK   = 13,
  35         OP_CB_NOTIFY_DEVICEID = 14,
  36 /* Callback operations new to NFSv4.2 */
  37         OP_CB_OFFLOAD = 15,
  38         OP_CB_ILLEGAL = 10044,
  39 };
  40
  41 struct nfs4_slot;
  42 struct cb_process_state {
  43         __be32                  drc_status;
  44         struct nfs_client       *clp;
  45         struct nfs4_slot        *slot;
  46         u32                     minorversion;
  47         struct net              *net;
  48 };
  49
  50 struct cb_compound_hdr_arg {
  51         unsigned int taglen;
  52         const char *tag;
  53         unsigned int minorversion;
  54         unsigned int cb_ident; /* v4.0 callback identifier */
  55         unsigned nops;
  56 };
  57
  58 struct cb_compound_hdr_res {
  59         __be32 *status;
  60         unsigned int taglen;
  61         const char *tag;
  62         __be32 *nops;
  63 };
  64
  65 struct cb_getattrargs {
  66         struct nfs_fh fh;
  67         uint32_t bitmap[2];
  68 };
  69
  70 struct cb_getattrres {
  71         __be32 status;
  72         uint32_t bitmap[2];
  73         uint64_t size;
  74         uint64_t change_attr;
  75         struct timespec ctime;
  76         struct timespec mtime;
  77 };
  78
  79 struct cb_recallargs {
  80         struct nfs_fh fh;
  81         nfs4_stateid stateid;
  82         uint32_t truncate;
  83 };
  84
  85 #if defined(CONFIG_NFS_V4_1)
  86
  87 struct referring_call {
  88         uint32_t                        rc_sequenceid;
  89         uint32_t                        rc_slotid;
  90 };
  91
  92 struct referring_call_list {
  93         struct nfs4_sessionid           rcl_sessionid;
  94         uint32_t                        rcl_nrefcalls;
  95         struct referring_call           *rcl_refcalls;
  96 };
  97
  98 struct cb_sequenceargs {
  99         struct sockaddr                 *csa_addr;
 100         struct nfs4_sessionid           csa_sessionid;
 101         uint32_t                        csa_sequenceid;
 102         uint32_t                        csa_slotid;
 103         uint32_t                        csa_highestslotid;
 104         uint32_t                        csa_cachethis;
 105         uint32_t                        csa_nrclists;
 106         struct referring_call_list      *csa_rclists;
 107 };
 108
 109 struct cb_sequenceres {
 110         __be32                          csr_status;
 111         struct nfs4_sessionid           csr_sessionid;
 112         uint32_t                        csr_sequenceid;
 113         uint32_t                        csr_slotid;
 114         uint32_t                        csr_highestslotid;
 115         uint32_t                        csr_target_highestslotid;
 116 };
 117
 118 extern __be32 nfs4_callback_sequence(void *argp, void *resp,
 119                                        struct cb_process_state *cps);
 120
 121 #define RCA4_TYPE_MASK_RDATA_DLG        0
 122 #define RCA4_TYPE_MASK_WDATA_DLG        1
 123 #define RCA4_TYPE_MASK_DIR_DLG         2
 124 #define RCA4_TYPE_MASK_FILE_LAYOUT     3
 125 #define RCA4_TYPE_MASK_BLK_LAYOUT      4
 126 #define RCA4_TYPE_MASK_OBJ_LAYOUT_MIN  8
 127 #define RCA4_TYPE_MASK_OBJ_LAYOUT_MAX  9
 128 #define RCA4_TYPE_MASK_OTHER_LAYOUT_MIN 12
 129 #define RCA4_TYPE_MASK_OTHER_LAYOUT_MAX 15
 130 #define RCA4_TYPE_MASK_ALL 0xf31f
 131
 132 struct cb_recallanyargs {
 133         uint32_t        craa_objs_to_keep;
 134         uint32_t        craa_type_mask;
 135 };
 136
 137 extern __be32 nfs4_callback_recallany(void *argp, void *resp,
 138                                         struct cb_process_state *cps);
 139
 140 struct cb_recallslotargs {
 141         uint32_t        crsa_target_highest_slotid;
 142 };
 143 extern __be32 nfs4_callback_recallslot(void *argp, void *resp,
 144                                          struct cb_process_state *cps);
 145
 146 struct cb_layoutrecallargs {
 147         uint32_t                cbl_recall_type;
 148         uint32_t                cbl_layout_type;
 149         uint32_t                cbl_layoutchanged;
 150         union {
 151                 struct {
 152                         struct nfs_fh           cbl_fh;
 153                         struct pnfs_layout_range cbl_range;
 154                         nfs4_stateid            cbl_stateid;
 155                 };
 156                 struct nfs_fsid         cbl_fsid;
 157         };
 158 };
 159
 160 extern __be32 nfs4_callback_layoutrecall(void *argp, void *resp,
 161                 struct cb_process_state *cps);
 162
 163 struct cb_devicenotifyitem {
 164         uint32_t                cbd_notify_type;
 165         uint32_t                cbd_layout_type;
 166         struct nfs4_deviceid    cbd_dev_id;
 167         uint32_t                cbd_immediate;
 168 };
 169
 170 struct cb_devicenotifyargs {
 171         int                              ndevs;
 172         struct cb_devicenotifyitem       *devs;
 173 };
 174
 175 extern __be32 nfs4_callback_devicenotify(void *argp, void *resp,
 176                 struct cb_process_state *cps);
 177
 178 struct cb_notify_lock_args {
 179         struct nfs_fh                   cbnl_fh;
 180         struct nfs_lowner               cbnl_owner;
 181         bool                            cbnl_valid;
 182 };
 183
 184 extern __be32 nfs4_callback_notify_lock(void *argp, void *resp,
 185                                          struct cb_process_state *cps);
 186 #endif /* CONFIG_NFS_V4_1 */
 187 extern int check_gss_callback_principal(struct nfs_client *, struct svc_rqst *);
 188 extern __be32 nfs4_callback_getattr(void *argp, void *resp,
 189                                     struct cb_process_state *cps);
 190 extern __be32 nfs4_callback_recall(void *argp, void *resp,
 191                                    struct cb_process_state *cps);
 192 #if IS_ENABLED(CONFIG_NFS_V4)
 193 extern int nfs_callback_up(u32 minorversion, struct rpc_xprt *xprt);
 194 extern void nfs_callback_down(int minorversion, struct net *net);
 195 #endif /* CONFIG_NFS_V4 */
 196 /*
 197  * nfs41: Callbacks are expected to not cause substantial latency,
 198  * so we limit their concurrency to 1 by setting up the maximum number
 199  * of slots for the backchannel.
 200  */
 201 #define NFS41_BC_MIN_CALLBACKS 1
 202 #define NFS41_BC_MAX_CALLBACKS 1
 203
 204 #define NFS4_MIN_NR_CALLBACK_THREADS 1
 205
 206 extern unsigned int nfs_callback_set_tcpport;
 207 extern unsigned short nfs_callback_nr_threads;
 208
 209 #endif /* __LINUX_FS_NFS_CALLBACK_H */