source3/include/ntdomain.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    SMB parameters and setup
   4    Copyright (C) Andrew Tridgell 1992-1997
   5    Copyright (C) Luke Kenneth Casson Leighton 1996-1997
   6    Copyright (C) Paul Ashton 1997
   7    Copyright (C) Jeremy Allison 2000-2004
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 */
  23
  24 #ifndef _NT_DOMAIN_H /* _NT_DOMAIN_H */
  25 #define _NT_DOMAIN_H
  26
  27 /*
  28  * A bunch of stuff that was put into smb.h
  29  * in the NTDOM branch - it didn't belong there.
  30  */
  31
  32 typedef struct _prs_struct {
  33         BOOL io; /* parsing in or out of data stream */
  34         /*
  35          * If the (incoming) data is big-endian. On output we are
  36          * always little-endian.
  37          */
  38         BOOL bigendian_data;
  39         uint8 align; /* data alignment */
  40         BOOL is_dynamic; /* Do we own this memory or not ? */
  41         uint32 data_offset; /* Current working offset into data. */
  42         uint32 buffer_size; /* Current allocated size of the buffer. */
  43         uint32 grow_size; /* size requested via prs_grow() calls */
  44         char *data_p; /* The buffer itself. */
  45         TALLOC_CTX *mem_ctx; /* When unmarshalling, use this.... */
  46         const char *sess_key; /* If we have to do encrypt/decrypt on the fly. */
  47 } prs_struct;
  48
  49 /*
  50  * Defines for io member of prs_struct.
  51  */
  52
  53 #define MARSHALL 0
  54 #define UNMARSHALL 1
  55
  56 #define MARSHALLING(ps) (!(ps)->io)
  57 #define UNMARSHALLING(ps) ((ps)->io)
  58
  59 #define RPC_BIG_ENDIAN          1
  60 #define RPC_LITTLE_ENDIAN       0
  61
  62 #define RPC_PARSE_ALIGN 4
  63
  64 typedef struct _output_data {
  65         /*
  66          * Raw RPC output data. This does not include RPC headers or footers.
  67          */
  68         prs_struct rdata;
  69
  70         /* The amount of data sent from the current rdata struct. */
  71         uint32 data_sent_length;
  72
  73         /*
  74          * The current PDU being returned. This inclues
  75          * headers, data and authentication footer.
  76          */
  77         unsigned char current_pdu[RPC_MAX_PDU_FRAG_LEN];
  78
  79         /* The amount of data in the current_pdu buffer. */
  80         uint32 current_pdu_len;
  81
  82         /* The amount of data sent from the current PDU. */
  83         uint32 current_pdu_sent;
  84 } output_data;
  85
  86 typedef struct _input_data {
  87         /*
  88          * This is the current incoming pdu. The data here
  89          * is collected via multiple writes until a complete
  90          * pdu is seen, then the data is copied into the in_data
  91          * structure. The maximum size of this is 0x1630 (RPC_MAX_PDU_FRAG_LEN).
  92          */
  93         unsigned char current_in_pdu[RPC_MAX_PDU_FRAG_LEN];
  94
  95         /*
  96          * The amount of data needed to complete the in_pdu.
  97          * If this is zero, then we are at the start of a new
  98          * pdu.
  99          */
 100         uint32 pdu_needed_len;
 101
 102         /*
 103          * The amount of data received so far in the in_pdu.
 104          * If this is zero, then we are at the start of a new
 105          * pdu.
 106          */
 107         uint32 pdu_received_len;
 108
 109         /*
 110          * This is the collection of input data with all
 111          * the rpc headers and auth footers removed.
 112          * The maximum length of this (1Mb) is strictly enforced.
 113          */
 114         prs_struct data;
 115 } input_data;
 116
 117 /*
 118  * Handle database - stored per pipe.
 119  */
 120
 121 struct policy {
 122         struct policy *next, *prev;
 123
 124         POLICY_HND pol_hnd;
 125
 126         void *data_ptr;
 127         void (*free_fn)(void *);
 128 };
 129
 130 struct handle_list {
 131         struct policy *Policy;  /* List of policies. */
 132         size_t count;                   /* Current number of handles. */
 133         size_t pipe_ref_count;  /* Number of pipe handles referring to this list. */
 134 };
 135
 136 /* Domain controller authentication protocol info */
 137 struct dcinfo {
 138         uint32 sequence; /* "timestamp" from client. */
 139         DOM_CHAL seed_chal;
 140         DOM_CHAL clnt_chal; /* Client credential */
 141         DOM_CHAL srv_chal;  /* Server credential */
 142
 143         uchar  sess_key[8]; /* Session key */
 144         uchar  mach_pw[16];   /* md4(machine password) */
 145
 146         fstring mach_acct;  /* Machine name we've authenticated. */
 147
 148         fstring remote_machine;  /* Machine name we've authenticated. */
 149         fstring domain;
 150
 151         BOOL challenge_sent;
 152         BOOL got_session_key;
 153         BOOL authenticated;
 154 };
 155
 156 typedef struct pipe_rpc_fns {
 157
 158         struct pipe_rpc_fns *next, *prev;
 159
 160         /* RPC function table associated with the current rpc_bind (associated by context) */
 161
 162         struct api_struct *cmds;
 163         int n_cmds;
 164         uint32 context_id;
 165
 166 } PIPE_RPC_FNS;
 167
 168 /*
 169  * Different auth types we support.
 170  * Can't keep in sync with wire values as spnego wraps different auth methods.
 171  */
 172
 173 enum pipe_auth_type { PIPE_AUTH_TYPE_NONE = 0, PIPE_AUTH_TYPE_NTLMSSP, PIPE_AUTH_TYPE_SCHANNEL,
 174                         PIPE_AUTH_TYPE_SPNEGO_NTLMSSP, PIPE_AUTH_TYPE_KRB5, PIPE_AUTH_TYPE_SPNEGO_KRB5 };
 175
 176 /* Possible auth levels - keep these in sync with the wire values. */
 177 enum pipe_auth_level { PIPE_AUTH_LEVEL_NONE = 0,
 178                         PIPE_AUTH_LEVEL_CONNECT = 1,    /* We treat as NONE. */
 179                         PIPE_AUTH_LEVEL_INTEGRITY = 5,  /* Sign. */
 180                         PIPE_AUTH_LEVEL_PRIVACY = 6     /* Seal. */
 181 };
 182
 183 /* auth state for krb5. */
 184 struct kerberos_auth_struct {
 185         const char *service_principal;
 186         DATA_BLOB session_key;
 187 };
 188
 189 /* auth state for schannel. */
 190 struct schannel_auth_struct {
 191         uchar sess_key[16];
 192         uint32 seq_num;
 193 };
 194
 195 /* auth state for all bind types. */
 196
 197 struct pipe_auth_data {
 198         enum pipe_auth_type auth_type; /* switch for union below. */
 199         enum pipe_auth_level auth_level;
 200         union {
 201                 struct schannel_auth_struct *schannel_auth;
 202                 AUTH_NTLMSSP_STATE *auth_ntlmssp_state;
 203 /*              struct kerberos_auth_struct *kerberos_auth; TO BE ADDED... */
 204         } a_u;
 205         void (*auth_data_free_func)(struct pipe_auth_data *);
 206 };
 207
 208 /*
 209  * DCE/RPC-specific samba-internal-specific handling of data on
 210  * NamedPipes.
 211  */
 212
 213 typedef struct pipes_struct {
 214         struct pipes_struct *next, *prev;
 215
 216         connection_struct *conn;
 217         uint16 vuid; /* points to the unauthenticated user that opened this pipe. */
 218
 219         fstring name;
 220         fstring pipe_srv_name;
 221
 222         /* linked list of rpc dispatch tables associated
 223            with the open rpc contexts */
 224
 225         PIPE_RPC_FNS *contexts;
 226
 227         RPC_HDR hdr; /* Incoming RPC header. */
 228         RPC_HDR_REQ hdr_req; /* Incoming request header. */
 229
 230         /* This context is used for pipe state storage and is freed when the pipe is closed. */
 231         TALLOC_CTX *pipe_state_mem_ctx;
 232
 233         struct pipe_auth_data auth;
 234
 235         struct dcinfo *dc; /* Keeps the creds data from netlogon. */
 236
 237         /*
 238          * Windows user info.
 239          */
 240         fstring user_name;
 241         fstring domain;
 242         fstring wks;
 243
 244         /*
 245          * Unix user name and credentials used when a pipe is authenticated.
 246          */
 247
 248         fstring pipe_user_name;
 249         struct current_user pipe_user;
 250         DATA_BLOB session_key;
 251
 252         /*
 253          * Set to true when an RPC bind has been done on this pipe.
 254          */
 255
 256         BOOL pipe_bound;
 257
 258         /*
 259          * Set to true when we should return fault PDU's for everything.
 260          */
 261
 262         BOOL fault_state;
 263
 264         /*
 265          * Set to true when we should return fault PDU's for a bad handle.
 266          */
 267
 268         BOOL bad_handle_fault_state;
 269
 270         /*
 271          * Set to RPC_BIG_ENDIAN when dealing with big-endian PDU's
 272          */
 273
 274         BOOL endian;
 275
 276         /*
 277          * Struct to deal with multiple pdu inputs.
 278          */
 279
 280         input_data in_data;
 281
 282         /*
 283          * Struct to deal with multiple pdu outputs.
 284          */
 285
 286         output_data out_data;
 287
 288         /* This context is used for PUD data and is freed between each pdu.
 289                 Don't use for pipe state storage. */
 290         TALLOC_CTX *mem_ctx;
 291
 292         /* handle database to use on this pipe. */
 293         struct handle_list *pipe_handles;
 294
 295 } pipes_struct;
 296
 297 typedef struct smb_np_struct {
 298         struct smb_np_struct *next, *prev;
 299         int pnum;
 300         connection_struct *conn;
 301         uint16 vuid; /* points to the unauthenticated user that opened this pipe. */
 302         BOOL open; /* open connection */
 303         uint16 device_state;
 304         uint16 priority;
 305         fstring name;
 306
 307         /* When replying to an SMBtrans, this is the maximum amount of
 308            data that can be sent in the initial reply. */
 309         int max_trans_reply;
 310
 311         /*
 312          * NamedPipe state information.
 313          *
 314          * (e.g. typecast a np_struct, above).
 315          */
 316         void *np_state;
 317
 318         /*
 319          * NamedPipe functions, to be called to perform
 320          * Named Pipe transactions on request from an
 321          * SMB client.
 322          */
 323
 324         /* call to create a named pipe connection.
 325          * returns: state information representing the connection.
 326          *          is stored in np_state, above.
 327          */
 328         void *   (*namedpipe_create)(char *pipe_name,
 329                                           connection_struct *conn, uint16 vuid);
 330
 331         /* call to perform a write / read namedpipe transaction.
 332          * TransactNamedPipe is weird: it returns whether there
 333          * is more data outstanding to be read, and the
 334          * caller is expected to take note and follow up with
 335          * read requests.
 336          */
 337         ssize_t  (*namedpipe_transact)(void *np_state,
 338                                        char *data, int len,
 339                                        char *rdata, int rlen,
 340                                        BOOL *pipe_outstanding);
 341
 342         /* call to perform a write namedpipe operation
 343          */
 344         ssize_t  (*namedpipe_write)(void * np_state,
 345                                     char *data, size_t n);
 346
 347         /* call to perform a read namedpipe operation.
 348          *
 349          * NOTE: the only reason that the pipe_outstanding
 350          * argument is here is because samba does not use
 351          * the namedpipe_transact function yet: instead,
 352          * it performs the same as what namedpipe_transact
 353          * does - a write, followed by a read.
 354          *
 355          * when samba is modified to use namedpipe_transact,
 356          * the pipe_outstanding argument may be removed.
 357          */
 358         ssize_t  (*namedpipe_read)(void * np_state,
 359                                    char *data, size_t max_len,
 360                                    BOOL *pipe_outstanding);
 361
 362         /* call to close a namedpipe.
 363          * function is expected to perform all cleanups
 364          * necessary, free all memory etc.
 365          *
 366          * returns True if cleanup was successful (not that
 367          * we particularly care).
 368          */
 369         BOOL     (*namedpipe_close)(void * np_state);
 370
 371 } smb_np_struct;
 372
 373 struct api_struct {
 374         const char *name;
 375         uint8 opnum;
 376         BOOL (*fn) (pipes_struct *);
 377 };
 378
 379 typedef struct {
 380         uint32 rid;
 381         const char *name;
 382 } rid_name;
 383
 384 /*
 385  * higher order functions for use with msrpc client code
 386  */
 387
 388 #define PRINT_INFO_FN(fn)\
 389         void (*fn)(const char*, uint32, uint32, void  *const *const)
 390 #define JOB_INFO_FN(fn)\
 391         void (*fn)(const char*, const char*, uint32, uint32, void *const *const)
 392
 393 /* end higher order functions */
 394
 395 typedef struct {
 396         uint32 size;
 397         prs_struct prs;
 398         uint32 struct_start;
 399         uint32 string_at_end;
 400 } RPC_BUFFER;
 401
 402 #endif /* _NT_DOMAIN_H */