fs/nfs/callback.h

   1 /*
   2  * linux/fs/nfs/callback.h
   3  *
   4  * Copyright (C) 2004 Trond Myklebust
   5  *
   6  * NFSv4 callback definitions
   7  */
   8 #ifndef __LINUX_FS_NFS_CALLBACK_H
   9 #define __LINUX_FS_NFS_CALLBACK_H
  10
  11 #define NFS4_CALLBACK 0x40000000
  12 #define NFS4_CALLBACK_XDRSIZE 2048
  13 #define NFS4_CALLBACK_BUFSIZE (1024 + NFS4_CALLBACK_XDRSIZE)
  14
  15 enum nfs4_callback_procnum {
  16         CB_NULL = 0,
  17         CB_COMPOUND = 1,
  18 };
  19
  20 enum nfs4_callback_opnum {
  21         OP_CB_GETATTR = 3,
  22         OP_CB_RECALL  = 4,
  23 /* Callback operations new to NFSv4.1 */
  24         OP_CB_LAYOUTRECALL  = 5,
  25         OP_CB_NOTIFY        = 6,
  26         OP_CB_PUSH_DELEG    = 7,
  27         OP_CB_RECALL_ANY    = 8,
  28         OP_CB_RECALLABLE_OBJ_AVAIL = 9,
  29         OP_CB_RECALL_SLOT   = 10,
  30         OP_CB_SEQUENCE      = 11,
  31         OP_CB_WANTS_CANCELLED = 12,
  32         OP_CB_NOTIFY_LOCK   = 13,
  33         OP_CB_NOTIFY_DEVICEID = 14,
  34         OP_CB_ILLEGAL = 10044,
  35 };
  36
  37 struct cb_process_state {
  38         __be32                  drc_status;
  39         struct nfs_client       *clp;
  40         struct nfs4_sessionid   *svc_sid; /* v4.1 callback service sessionid */
  41 };
  42
  43 struct cb_compound_hdr_arg {
  44         unsigned int taglen;
  45         const char *tag;
  46         unsigned int minorversion;
  47         unsigned int cb_ident; /* v4.0 callback identifier */
  48         unsigned nops;
  49 };
  50
  51 struct cb_compound_hdr_res {
  52         __be32 *status;
  53         unsigned int taglen;
  54         const char *tag;
  55         __be32 *nops;
  56 };
  57
  58 struct cb_getattrargs {
  59         struct sockaddr *addr;
  60         struct nfs_fh fh;
  61         uint32_t bitmap[2];
  62 };
  63
  64 struct cb_getattrres {
  65         __be32 status;
  66         uint32_t bitmap[2];
  67         uint64_t size;
  68         uint64_t change_attr;
  69         struct timespec ctime;
  70         struct timespec mtime;
  71 };
  72
  73 struct cb_recallargs {
  74         struct sockaddr *addr;
  75         struct nfs_fh fh;
  76         nfs4_stateid stateid;
  77         uint32_t truncate;
  78 };
  79
  80 #if defined(CONFIG_NFS_V4_1)
  81
  82 struct referring_call {
  83         uint32_t                        rc_sequenceid;
  84         uint32_t                        rc_slotid;
  85 };
  86
  87 struct referring_call_list {
  88         struct nfs4_sessionid           rcl_sessionid;
  89         uint32_t                        rcl_nrefcalls;
  90         struct referring_call           *rcl_refcalls;
  91 };
  92
  93 struct cb_sequenceargs {
  94         struct sockaddr                 *csa_addr;
  95         struct nfs4_sessionid           csa_sessionid;
  96         uint32_t                        csa_sequenceid;
  97         uint32_t                        csa_slotid;
  98         uint32_t                        csa_highestslotid;
  99         uint32_t                        csa_cachethis;
 100         uint32_t                        csa_nrclists;
 101         struct referring_call_list      *csa_rclists;
 102 };
 103
 104 struct cb_sequenceres {
 105         __be32                          csr_status;
 106         struct nfs4_sessionid           csr_sessionid;
 107         uint32_t                        csr_sequenceid;
 108         uint32_t                        csr_slotid;
 109         uint32_t                        csr_highestslotid;
 110         uint32_t                        csr_target_highestslotid;
 111 };
 112
 113 extern __be32 nfs4_callback_sequence(struct cb_sequenceargs *args,
 114                                        struct cb_sequenceres *res,
 115                                        struct cb_process_state *cps);
 116
 117 extern int nfs41_validate_delegation_stateid(struct nfs_delegation *delegation,
 118                                              const nfs4_stateid *stateid);
 119
 120 #define RCA4_TYPE_MASK_RDATA_DLG        0
 121 #define RCA4_TYPE_MASK_WDATA_DLG        1
 122
 123 struct cb_recallanyargs {
 124         struct sockaddr *craa_addr;
 125         uint32_t        craa_objs_to_keep;
 126         uint32_t        craa_type_mask;
 127 };
 128
 129 extern __be32 nfs4_callback_recallany(struct cb_recallanyargs *args,
 130                                         void *dummy,
 131                                         struct cb_process_state *cps);
 132
 133 struct cb_recallslotargs {
 134         struct sockaddr *crsa_addr;
 135         uint32_t        crsa_target_max_slots;
 136 };
 137 extern __be32 nfs4_callback_recallslot(struct cb_recallslotargs *args,
 138                                          void *dummy,
 139                                          struct cb_process_state *cps);
 140
 141 extern void nfs4_check_drain_bc_complete(struct nfs4_session *ses);
 142 extern void nfs4_cb_take_slot(struct nfs_client *clp);
 143 #endif /* CONFIG_NFS_V4_1 */
 144
 145 extern __be32 nfs4_callback_getattr(struct cb_getattrargs *args,
 146                                     struct cb_getattrres *res,
 147                                     struct cb_process_state *cps);
 148 extern __be32 nfs4_callback_recall(struct cb_recallargs *args, void *dummy,
 149                                    struct cb_process_state *cps);
 150 #ifdef CONFIG_NFS_V4
 151 extern int nfs_callback_up(u32 minorversion, struct rpc_xprt *xprt);
 152 extern void nfs_callback_down(int minorversion);
 153 extern int nfs4_validate_delegation_stateid(struct nfs_delegation *delegation,
 154                                             const nfs4_stateid *stateid);
 155 extern int nfs4_set_callback_sessionid(struct nfs_client *clp);
 156 #endif /* CONFIG_NFS_V4 */
 157 /*
 158  * nfs41: Callbacks are expected to not cause substantial latency,
 159  * so we limit their concurrency to 1 by setting up the maximum number
 160  * of slots for the backchannel.
 161  */
 162 #define NFS41_BC_MIN_CALLBACKS 1
 163 #define NFS41_BC_MAX_CALLBACKS 1
 164
 165 extern unsigned int nfs_callback_set_tcpport;
 166 extern unsigned short nfs_callback_tcpport;
 167 extern unsigned short nfs_callback_tcpport6;
 168
 169 #endif /* __LINUX_FS_NFS_CALLBACK_H */