source4/ntvfs/ntvfs.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    NTVFS structures and defines
   4    Copyright (C) Andrew Tridgell                        2003
   5    Copyright (C) Stefan Metzmacher                      2004
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 */
  20
  21 #ifndef _NTVFS_H_
  22 #define _NTVFS_H_
  23
  24 #include "libcli/raw/interfaces.h"
  25 #include "param/share.h"
  26 #include "librpc/gen_ndr/security.h"
  27 #include "librpc/gen_ndr/server_id.h"
  28
  29 /* modules can use the following to determine if the interface has changed */
  30 /* version 1 -> 0 - make module stacking easier -- metze */
  31 #define NTVFS_INTERFACE_VERSION 0
  32
  33 struct ntvfs_module_context;
  34 struct ntvfs_request;
  35
  36 /* each backend has to be one one of the following 3 basic types. In
  37    earlier versions of Samba backends needed to handle all types, now
  38    we implement them separately.
  39    The values 1..3 match the SMB2 SMB2_SHARE_TYPE_* values
  40  */
  41 enum ntvfs_type {NTVFS_DISK=1, NTVFS_IPC=2, NTVFS_PRINT=3};
  42
  43 /* the ntvfs operations structure - contains function pointers to
  44    the backend implementations of each operation */
  45 struct ntvfs_ops {
  46         const char *name;
  47         enum ntvfs_type type;
  48
  49         /* initial setup */
  50         NTSTATUS (*connect)(struct ntvfs_module_context *ntvfs,
  51                             struct ntvfs_request *req,
  52                             const char *sharename);
  53         NTSTATUS (*disconnect)(struct ntvfs_module_context *ntvfs);
  54
  55         /* async_setup - called when a backend is processing a async request */
  56         NTSTATUS (*async_setup)(struct ntvfs_module_context *ntvfs,
  57                                 struct ntvfs_request *req,
  58                                 void *private_data);
  59
  60         /* filesystem operations */
  61         NTSTATUS (*fsinfo)(struct ntvfs_module_context *ntvfs,
  62                            struct ntvfs_request *req,
  63                            union smb_fsinfo *fs);
  64
  65         /* path operations */
  66         NTSTATUS (*unlink)(struct ntvfs_module_context *ntvfs,
  67                            struct ntvfs_request *req,
  68                            union smb_unlink *unl);
  69         NTSTATUS (*chkpath)(struct ntvfs_module_context *ntvfs,
  70                             struct ntvfs_request *req,
  71                             union smb_chkpath *cp);
  72         NTSTATUS (*qpathinfo)(struct ntvfs_module_context *ntvfs,
  73                               struct ntvfs_request *req,
  74                               union smb_fileinfo *st);
  75         NTSTATUS (*setpathinfo)(struct ntvfs_module_context *ntvfs,
  76                                 struct ntvfs_request *req,
  77                                 union smb_setfileinfo *st);
  78         NTSTATUS (*mkdir)(struct ntvfs_module_context *ntvfs,
  79                           struct ntvfs_request *req,
  80                           union smb_mkdir *md);
  81         NTSTATUS (*rmdir)(struct ntvfs_module_context *ntvfs,
  82                           struct ntvfs_request *req,
  83                           struct smb_rmdir *rd);
  84         NTSTATUS (*rename)(struct ntvfs_module_context *ntvfs,
  85                            struct ntvfs_request *req,
  86                            union smb_rename *ren);
  87         NTSTATUS (*copy)(struct ntvfs_module_context *ntvfs,
  88                          struct ntvfs_request *req,
  89                          struct smb_copy *cp);
  90         NTSTATUS (*open)(struct ntvfs_module_context *ntvfs,
  91                          struct ntvfs_request *req,
  92                          union smb_open *oi);
  93
  94         /* directory search */
  95         NTSTATUS (*search_first)(struct ntvfs_module_context *ntvfs,
  96                                  struct ntvfs_request *req,
  97                                  union smb_search_first *io, void *private_data,
  98                                  bool (*callback)(void *private_data, const union smb_search_data *file));
  99         NTSTATUS (*search_next)(struct ntvfs_module_context *ntvfs,
 100                                 struct ntvfs_request *req,
 101                                 union smb_search_next *io, void *private_data,
 102                                 bool (*callback)(void *private_data, const union smb_search_data *file));
 103         NTSTATUS (*search_close)(struct ntvfs_module_context *ntvfs,
 104                                  struct ntvfs_request *req,
 105                                  union smb_search_close *io);
 106
 107         /* operations on open files */
 108         NTSTATUS (*ioctl)(struct ntvfs_module_context *ntvfs,
 109                           struct ntvfs_request *req,
 110                           union smb_ioctl *io);
 111         NTSTATUS (*read)(struct ntvfs_module_context *ntvfs,
 112                          struct ntvfs_request *req,
 113                          union smb_read *io);
 114         NTSTATUS (*write)(struct ntvfs_module_context *ntvfs,
 115                           struct ntvfs_request *req,
 116                           union smb_write *io);
 117         NTSTATUS (*seek)(struct ntvfs_module_context *ntvfs,
 118                          struct ntvfs_request *req,
 119                          union smb_seek *io);
 120         NTSTATUS (*flush)(struct ntvfs_module_context *ntvfs,
 121                           struct ntvfs_request *req,
 122                           union smb_flush *flush);
 123         NTSTATUS (*lock)(struct ntvfs_module_context *ntvfs,
 124                          struct ntvfs_request *req,
 125                          union smb_lock *lck);
 126         NTSTATUS (*qfileinfo)(struct ntvfs_module_context *ntvfs,
 127                               struct ntvfs_request *req,
 128                               union smb_fileinfo *info);
 129         NTSTATUS (*setfileinfo)(struct ntvfs_module_context *ntvfs,
 130                                 struct ntvfs_request *req,
 131                                 union smb_setfileinfo *info);
 132         NTSTATUS (*close)(struct ntvfs_module_context *ntvfs,
 133                           struct ntvfs_request *req,
 134                           union smb_close *io);
 135
 136         /* trans interface - used by IPC backend for pipes and RAP calls */
 137         NTSTATUS (*trans)(struct ntvfs_module_context *ntvfs,
 138                           struct ntvfs_request *req,
 139                           struct smb_trans2 *trans);
 140
 141         /* trans2 interface - only used by CIFS backend to prover complete passthru for testing */
 142         NTSTATUS (*trans2)(struct ntvfs_module_context *ntvfs,
 143                            struct ntvfs_request *req,
 144                            struct smb_trans2 *trans2);
 145
 146         /* change notify request */
 147         NTSTATUS (*notify)(struct ntvfs_module_context *ntvfs,
 148                            struct ntvfs_request *req,
 149                            union smb_notify *info);
 150
 151         /* cancel - cancels any pending async request */
 152         NTSTATUS (*cancel)(struct ntvfs_module_context *ntvfs,
 153                            struct ntvfs_request *req);
 154
 155         /* printing specific operations */
 156         NTSTATUS (*lpq)(struct ntvfs_module_context *ntvfs,
 157                         struct ntvfs_request *req,
 158                         union smb_lpq *lpq);
 159
 160         /* logoff - called when a vuid is closed */
 161         NTSTATUS (*logoff)(struct ntvfs_module_context *ntvfs,
 162                            struct ntvfs_request *req);
 163         NTSTATUS (*exit)(struct ntvfs_module_context *ntvfs,
 164                          struct ntvfs_request *req);
 165 };
 166
 167 struct ntvfs_module_context {
 168         struct ntvfs_module_context *prev, *next;
 169         struct ntvfs_context *ctx;
 170         int depth;
 171         const struct ntvfs_ops *ops;
 172         void *private_data;
 173 };
 174
 175 struct ntvfs_context {
 176         enum ntvfs_type type;
 177
 178         /* the reported filesystem type */
 179         char *fs_type;
 180
 181         /* the reported device type */
 182         char *dev_type;
 183
 184         enum protocol_types protocol;
 185
 186         /*
 187          * client capabilities
 188          * this field doesn't use protocol specific
 189          * values!
 190          */
 191 #define NTVFS_CLIENT_CAP_LEVEL_II_OPLOCKS       0x0000000000000001LLU
 192         uint64_t client_caps;
 193
 194         /*
 195          * linked list of module contexts
 196          */
 197         struct ntvfs_module_context *modules;
 198
 199         struct share_config *config;
 200
 201         struct server_id server_id;
 202         struct loadparm_context *lp_ctx;
 203         struct tevent_context *event_ctx;
 204         struct messaging_context *msg_ctx;
 205
 206         struct {
 207                 void *private_data;
 208                 NTSTATUS (*handler)(void *private_data, struct ntvfs_handle *handle, uint8_t level);
 209         } oplock;
 210
 211         struct {
 212                 void *private_data;
 213                 struct socket_address *(*get_my_addr)(void *private_data, TALLOC_CTX *mem_ctx);
 214                 struct socket_address *(*get_peer_addr)(void *private_data, TALLOC_CTX *mem_ctx);
 215         } client;
 216
 217         struct {
 218                 void *private_data;
 219                 NTSTATUS (*create_new)(void *private_data, struct ntvfs_request *req, struct ntvfs_handle **h);
 220                 NTSTATUS (*make_valid)(void *private_data, struct ntvfs_handle *h);
 221                 void (*destroy)(void *private_data, struct ntvfs_handle *h);
 222                 struct ntvfs_handle *(*search_by_wire_key)(void *private_data,  struct ntvfs_request *req, const DATA_BLOB *key);
 223                 DATA_BLOB (*get_wire_key)(void *private_data, struct ntvfs_handle *handle, TALLOC_CTX *mem_ctx);
 224         } handles;
 225 };
 226
 227 /* a set of flags to control handling of request structures */
 228 #define NTVFS_ASYNC_STATE_ASYNC     (1<<1) /* the backend will answer this one later */
 229 #define NTVFS_ASYNC_STATE_MAY_ASYNC (1<<2) /* the backend is allowed to answer async */
 230 #define NTVFS_ASYNC_STATE_CLOSE     (1<<3) /* the backend session should be closed */
 231
 232 /* the ntvfs_async_state structure allows backend functions to
 233    delay replying to requests. To use this, the front end must
 234    set send_fn to a function to be called by the backend
 235    when the reply is finally ready to be sent. The backend
 236    must set status to the status it wants in the
 237    reply. The backend must set the NTVFS_ASYNC_STATE_ASYNC
 238    control_flag on the request to indicate that it wishes to
 239    delay the reply
 240
 241    If NTVFS_ASYNC_STATE_MAY_ASYNC is not set then the backend cannot
 242    ask for a delayed reply for this request
 243
 244    note that the private_data pointer is private to the layer which alloced this struct
 245 */
 246 struct ntvfs_async_state {
 247         struct ntvfs_async_state *prev, *next;
 248         /* the async handling infos */
 249         unsigned int state;
 250         void *private_data;
 251         void (*send_fn)(struct ntvfs_request *);
 252         NTSTATUS status;
 253
 254         /* the passthru module's per session private data */
 255         struct ntvfs_module_context *ntvfs;
 256 };
 257
 258 struct ntvfs_request {
 259         /* the ntvfs_context this requests belongs to */
 260         struct ntvfs_context *ctx;
 261
 262         /* ntvfs per request async states */
 263         struct ntvfs_async_state *async_states;
 264
 265         /* the session_info, with security_token and maybe delegated credentials */
 266         struct auth_session_info *session_info;
 267
 268         /* the smb pid is needed for locking contexts */
 269         uint32_t smbpid;
 270
 271         /*
 272          * client capabilities
 273          * this field doesn't use protocol specific
 274          * values!
 275          * see NTVFS_CLIENT_CAP_*
 276          */
 277         uint64_t client_caps;
 278
 279         /* some statictics for the management tools */
 280         struct {
 281                 /* the system time when the request arrived */
 282                 struct timeval request_time;
 283         } statistics;
 284
 285         struct {
 286                 void *private_data;
 287         } frontend_data;
 288 };
 289
 290 struct ntvfs_handle {
 291         struct ntvfs_context *ctx;
 292
 293         struct auth_session_info *session_info;
 294
 295         uint16_t smbpid;
 296
 297         struct ntvfs_handle_data {
 298                 struct ntvfs_handle_data *prev, *next;
 299                 struct ntvfs_module_context *owner;
 300                 void *private_data;/* this must be a valid talloc pointer */
 301         } *backend_data;
 302
 303         struct {
 304                 void *private_data;
 305         } frontend_data;
 306 };
 307
 308 /* this structure is used by backends to determine the size of some critical types */
 309 struct ntvfs_critical_sizes {
 310         int interface_version;
 311         int sizeof_ntvfs_critical_sizes;
 312         int sizeof_ntvfs_context;
 313         int sizeof_ntvfs_module_context;
 314         int sizeof_ntvfs_ops;
 315         int sizeof_ntvfs_async_state;
 316         int sizeof_ntvfs_request;
 317         int sizeof_ntvfs_handle;
 318         int sizeof_ntvfs_handle_data;
 319 };
 320
 321 #define NTVFS_CURRENT_CRITICAL_SIZES(c) \
 322     struct ntvfs_critical_sizes c = { \
 323         .interface_version              = NTVFS_INTERFACE_VERSION, \
 324         .sizeof_ntvfs_critical_sizes    = sizeof(struct ntvfs_critical_sizes), \
 325         .sizeof_ntvfs_context           = sizeof(struct ntvfs_context), \
 326         .sizeof_ntvfs_module_context    = sizeof(struct ntvfs_module_context), \
 327         .sizeof_ntvfs_ops               = sizeof(struct ntvfs_ops), \
 328         .sizeof_ntvfs_async_state       = sizeof(struct ntvfs_async_state), \
 329         .sizeof_ntvfs_request           = sizeof(struct ntvfs_request), \
 330         .sizeof_ntvfs_handle            = sizeof(struct ntvfs_handle), \
 331         .sizeof_ntvfs_handle_data       = sizeof(struct ntvfs_handle_data), \
 332     }
 333
 334 struct messaging_context;
 335 #include "librpc/gen_ndr/security.h"
 336 #include "librpc/gen_ndr/notify.h"
 337 #include "ntvfs/ntvfs_proto.h"
 338
 339 #endif /* _NTVFS_H_ */