source3/include/client.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    SMB parameters and setup
   4    Copyright (C) Andrew Tridgell 1992-1998
   5    Copyright (C) Luke Kenneth Casson Leighton 1996-1998
   6    Copyright (C) Jeremy Allison 1998
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20 */
  21
  22 #ifndef _CLIENT_H
  23 #define _CLIENT_H
  24
  25 #include "../librpc/ndr/libndr.h"
  26
  27 /* the client asks for a smaller buffer to save ram and also to get more
  28    overlap on the wire. This size gives us a nice read/write size, which
  29    will be a multiple of the page size on almost any system */
  30 #define CLI_BUFFER_SIZE (0xFFFF)
  31 #define CLI_SAMBA_MAX_LARGE_READX_SIZE (127*1024) /* Works for Samba servers */
  32 #define CLI_SAMBA_MAX_LARGE_WRITEX_SIZE (127*1024) /* Works for Samba servers */
  33 #define CLI_WINDOWS_MAX_LARGE_READX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
  34 #define CLI_WINDOWS_MAX_LARGE_WRITEX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
  35 #define CLI_SAMBA_MAX_POSIX_LARGE_READX_SIZE (0xFFFF00) /* 24-bit len. */
  36 #define CLI_SAMBA_MAX_POSIX_LARGE_WRITEX_SIZE (0xFFFF00) /* 24-bit len. */
  37
  38 /*
  39  * These definitions depend on smb.h
  40  */
  41
  42 struct print_job_info {
  43         uint16 id;
  44         uint16 priority;
  45         size_t size;
  46         fstring user;
  47         fstring name;
  48         time_t t;
  49 };
  50
  51 /**
  52  * rpc_cli_transport defines a transport mechanism to ship rpc requests
  53  * asynchronously to a server and receive replies
  54  */
  55
  56 struct rpc_cli_transport {
  57
  58         enum dcerpc_transport_t transport;
  59
  60         /**
  61          * Trigger an async read from the server. May return a short read.
  62          */
  63         struct tevent_req *(*read_send)(TALLOC_CTX *mem_ctx,
  64                                         struct event_context *ev,
  65                                         uint8_t *data, size_t size,
  66                                         void *priv);
  67         /**
  68          * Get the result from the read_send operation.
  69          */
  70         NTSTATUS (*read_recv)(struct tevent_req *req, ssize_t *preceived);
  71
  72         /**
  73          * Trigger an async write to the server. May return a short write.
  74          */
  75         struct tevent_req *(*write_send)(TALLOC_CTX *mem_ctx,
  76                                          struct event_context *ev,
  77                                          const uint8_t *data, size_t size,
  78                                          void *priv);
  79         /**
  80          * Get the result from the read_send operation.
  81          */
  82         NTSTATUS (*write_recv)(struct tevent_req *req, ssize_t *psent);
  83
  84         /**
  85          * This is an optimization for the SMB transport. It models the
  86          * TransactNamedPipe API call: Send and receive data in one round
  87          * trip. The transport implementation is free to set this to NULL,
  88          * cli_pipe.c will fall back to the explicit write/read routines.
  89          */
  90         struct tevent_req *(*trans_send)(TALLOC_CTX *mem_ctx,
  91                                          struct event_context *ev,
  92                                          uint8_t *data, size_t data_len,
  93                                          uint32_t max_rdata_len,
  94                                          void *priv);
  95         /**
  96          * Get the result from the trans_send operation.
  97          */
  98         NTSTATUS (*trans_recv)(struct tevent_req *req, TALLOC_CTX *mem_ctx,
  99                                uint8_t **prdata, uint32_t *prdata_len);
 100
 101         bool (*is_connected)(void *priv);
 102         unsigned int (*set_timeout)(void *priv, unsigned int timeout);
 103
 104         void *priv;
 105 };
 106
 107 struct dcerpc_binding_handle;
 108
 109 struct rpc_pipe_client {
 110         struct rpc_pipe_client *prev, *next;
 111
 112         struct rpc_cli_transport *transport;
 113         struct dcerpc_binding_handle *binding_handle;
 114
 115         struct ndr_syntax_id abstract_syntax;
 116         struct ndr_syntax_id transfer_syntax;
 117
 118         char *desthost;
 119         char *srv_name_slash;
 120
 121         uint16 max_xmit_frag;
 122         uint16 max_recv_frag;
 123
 124         struct pipe_auth_data *auth;
 125
 126         /* The following is only non-null on a netlogon client pipe. */
 127         struct netlogon_creds_CredentialState *dc;
 128 };
 129
 130 struct cli_state_seqnum {
 131         struct cli_state_seqnum *prev, *next;
 132         uint16_t mid;
 133         uint32_t seqnum;
 134         bool persistent;
 135 };
 136
 137 struct cli_state {
 138         /**
 139          * A list of subsidiary connections for DFS.
 140          */
 141         struct cli_state *prev, *next;
 142         int port;
 143         int fd;
 144         /* Last read or write error. */
 145         enum smb_read_errors smb_rw_error;
 146         uint16 cnum;
 147         uint16 pid;
 148         uint16 mid;
 149         uint16 vuid;
 150         int protocol;
 151         int sec_mode;
 152         int rap_error;
 153         int privileges;
 154
 155         fstring desthost;
 156
 157         /* The credentials used to open the cli_state connection. */
 158         char *domain;
 159         char *user_name;
 160         char *password; /* Can be null to force use of zero NTLMSSP session key. */
 161
 162         /*
 163          * The following strings are the
 164          * ones returned by the server if
 165          * the protocol > NT1.
 166          */
 167         fstring server_type;
 168         fstring server_os;
 169         fstring server_domain;
 170
 171         fstring share;
 172         fstring dev;
 173         struct nmb_name called;
 174         struct nmb_name calling;
 175         struct sockaddr_storage dest_ss;
 176
 177         DATA_BLOB secblob; /* cryptkey or negTokenInit */
 178         uint32 sesskey;
 179         int serverzone;
 180         uint32 servertime;
 181         int readbraw_supported;
 182         int writebraw_supported;
 183         int timeout; /* in milliseconds. */
 184         size_t max_xmit;
 185         size_t max_mux;
 186         char *outbuf;
 187         struct cli_state_seqnum *seqnum;
 188         char *inbuf;
 189         unsigned int bufsize;
 190         int initialised;
 191         int win95;
 192         bool is_samba;
 193         uint32 capabilities;
 194         /* What the server offered. */
 195         uint32_t server_posix_capabilities;
 196         /* What the client requested. */
 197         uint32_t requested_posix_capabilities;
 198         bool dfsroot;
 199
 200         struct smb_signing_state *signing_state;
 201
 202         struct smb_trans_enc_state *trans_enc_state; /* Setup if we're encrypting SMB's. */
 203
 204         /* the session key for this CLI, outside
 205            any per-pipe authenticaion */
 206         DATA_BLOB user_session_key;
 207
 208         /* The list of pipes currently open on this connection. */
 209         struct rpc_pipe_client *pipe_list;
 210
 211         bool use_kerberos;
 212         bool fallback_after_kerberos;
 213         bool use_spnego;
 214         bool use_ccache;
 215         bool got_kerberos_mechanism; /* Server supports krb5 in SPNEGO. */
 216
 217         bool use_oplocks; /* should we use oplocks? */
 218         bool use_level_II_oplocks; /* should we use level II oplocks? */
 219
 220         /* a oplock break request handler */
 221         NTSTATUS (*oplock_handler)(struct cli_state *cli, uint16_t fnum, unsigned char level);
 222
 223         bool force_dos_errors;
 224         bool case_sensitive; /* False by default. */
 225
 226         /* Where (if anywhere) this is mounted under DFS. */
 227         char *dfs_mountpoint;
 228
 229         struct tevent_queue *outgoing;
 230         struct tevent_req **pending;
 231 };
 232
 233 struct file_info {
 234         uint64_t size;
 235         uint16 mode;
 236         uid_t uid;
 237         gid_t gid;
 238         /* these times are normally kept in GMT */
 239         struct timespec mtime_ts;
 240         struct timespec atime_ts;
 241         struct timespec ctime_ts;
 242         char *name;
 243         char short_name[13*3]; /* the *3 is to cope with multi-byte */
 244 };
 245
 246 #define CLI_FULL_CONNECTION_DONT_SPNEGO 0x0001
 247 #define CLI_FULL_CONNECTION_USE_KERBEROS 0x0002
 248 #define CLI_FULL_CONNECTION_ANONYMOUS_FALLBACK 0x0004
 249 #define CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS 0x0008
 250 #define CLI_FULL_CONNECTION_OPLOCKS 0x0010
 251 #define CLI_FULL_CONNECTION_LEVEL_II_OPLOCKS 0x0020
 252 #define CLI_FULL_CONNECTION_USE_CCACHE 0x0040
 253
 254 #endif /* _CLIENT_H */