source/include/rpc_misc.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
   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 2 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, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 #include "ntdomain.h"
  24 #include "rpc_dce.h"
  25
  26 #ifndef _RPC_MISC_H /* _RPC_MISC_H */
  27 #define _RPC_MISC_H
  28
  29
  30
  31 /* well-known RIDs - Relative IDs */
  32
  33 /* RIDs - Well-known users ... */
  34 #define DOMAIN_USER_RID_ADMIN          (0x000001F4L)
  35 #define DOMAIN_USER_RID_GUEST          (0x000001F5L)
  36 #define DOMAIN_USER_RID_KRBTGT         (0x000001F6L)
  37
  38 /* RIDs - well-known groups ... */
  39 #define DOMAIN_GROUP_RID_ADMINS        (0x00000200L)
  40 #define DOMAIN_GROUP_RID_USERS         (0x00000201L)
  41 #define DOMAIN_GROUP_RID_GUESTS        (0x00000202L)
  42 #define DOMAIN_GROUP_RID_COMPUTERS     (0x00000203L)
  43
  44 #define DOMAIN_GROUP_RID_CONTROLLERS   (0x00000204L)
  45 #define DOMAIN_GROUP_RID_CERT_ADMINS   (0x00000205L)
  46 #define DOMAIN_GROUP_RID_SCHEMA_ADMINS (0x00000206L)
  47 #define DOMAIN_GROUP_RID_ENTERPRISE_ADMINS (0x00000207L)
  48
  49 /* is the following the right number? I bet it is  --simo
  50 #define DOMAIN_GROUP_RID_POLICY_ADMINS (0x00000208L)
  51 */
  52
  53 /* RIDs - well-known aliases ... */
  54 #define BUILTIN_ALIAS_RID_ADMINS        (0x00000220L)
  55 #define BUILTIN_ALIAS_RID_USERS         (0x00000221L)
  56 #define BUILTIN_ALIAS_RID_GUESTS        (0x00000222L)
  57 #define BUILTIN_ALIAS_RID_POWER_USERS   (0x00000223L)
  58
  59 #define BUILTIN_ALIAS_RID_ACCOUNT_OPS   (0x00000224L)
  60 #define BUILTIN_ALIAS_RID_SYSTEM_OPS    (0x00000225L)
  61 #define BUILTIN_ALIAS_RID_PRINT_OPS     (0x00000226L)
  62 #define BUILTIN_ALIAS_RID_BACKUP_OPS    (0x00000227L)
  63
  64 #define BUILTIN_ALIAS_RID_REPLICATOR    (0x00000228L)
  65 #define BUILTIN_ALIAS_RID_RAS_SERVERS   (0x00000229L)
  66
  67 /*
  68  * Masks for mappings between unix uid and gid types and
  69  * NT RIDS.
  70  */
  71
  72
  73 #define BASE_RID (0x000003E8L)
  74
  75 /* Take the bottom bit. */
  76 #define RID_TYPE_MASK 1
  77 #define RID_MULTIPLIER 2
  78
  79 /* The two common types. */
  80 #define USER_RID_TYPE 0
  81 #define GROUP_RID_TYPE 1
  82
  83 /* ENUM_HND */
  84 typedef struct enum_hnd_info
  85 {
  86         uint32 ptr_hnd;          /* pointer to enumeration handle */
  87         uint32 handle;           /* enumeration handle */
  88
  89 } ENUM_HND;
  90
  91 /* LOOKUP_LEVEL - switch value */
  92 typedef struct lookup_level_info
  93 {
  94   uint16 value;
  95
  96 } LOOKUP_LEVEL;
  97
  98 /* DOM_SID2 - security id */
  99 typedef struct sid_info_2
 100 {
 101         uint32 num_auths; /* length, bytes, including length of len :-) */
 102
 103         DOM_SID sid;
 104
 105 } DOM_SID2;
 106
 107 /* STRHDR - string header */
 108 typedef struct header_info
 109 {
 110   uint16 str_str_len;
 111   uint16 str_max_len;
 112   uint32 buffer; /* non-zero */
 113
 114 } STRHDR;
 115
 116 /* UNIHDR - unicode string header */
 117 typedef struct unihdr_info
 118 {
 119   uint16 uni_str_len;
 120   uint16 uni_max_len;
 121   uint32 buffer; /* usually has a value of 4 */
 122
 123 } UNIHDR;
 124
 125 /* UNIHDR2 - unicode string header and undocumented buffer */
 126 typedef struct unihdr2_info
 127 {
 128   UNIHDR unihdr;
 129   uint32 buffer; /* 32 bit buffer pointer */
 130
 131 } UNIHDR2;
 132
 133 /* clueless as to what maximum length should be */
 134 #define MAX_UNISTRLEN 256
 135 #define MAX_STRINGLEN 256
 136 #define MAX_BUFFERLEN 512
 137
 138 /* UNISTR - unicode string size and buffer */
 139 typedef struct unistr_info
 140 {
 141   /* unicode characters. ***MUST*** be little-endian. ***MUST*** be null-terminated */
 142   uint16 *buffer;
 143 } UNISTR;
 144
 145 /* BUFHDR - buffer header */
 146 typedef struct bufhdr_info
 147 {
 148   uint32 buf_max_len;
 149   uint32 buf_len;
 150
 151 } BUFHDR;
 152
 153 /* BUFFER2 - unicode string, size (in uint8 ascii chars) and buffer */
 154 /* pathetic.  some stupid team of \PIPE\winreg writers got the concept */
 155 /* of a unicode string different from the other \PIPE\ writers */
 156 typedef struct buffer2_info
 157 {
 158   uint32 buf_max_len;
 159   uint32 undoc;
 160   uint32 buf_len;
 161   /* unicode characters. ***MUST*** be little-endian. **NOT** necessarily null-terminated */
 162   uint16 *buffer;
 163
 164 } BUFFER2;
 165
 166 /* BUFFER3 */
 167 typedef struct buffer3_info
 168 {
 169   uint32 buf_max_len;
 170   uint8  *buffer; /* Data */
 171   uint32 buf_len;
 172
 173 } BUFFER3;
 174
 175 /* BUFFER5 */
 176 typedef struct buffer5_info
 177 {
 178   uint32 buf_len;
 179   uint16 *buffer; /* data */
 180 } BUFFER5;
 181
 182 /* UNISTR2 - unicode string size (in uint16 unicode chars) and buffer */
 183 typedef struct unistr2_info
 184 {
 185   uint32 uni_max_len;
 186   uint32 undoc;
 187   uint32 uni_str_len;
 188   /* unicode characters. ***MUST*** be little-endian.
 189      **must** be null-terminated and the uni_str_len should include
 190      the NULL character */
 191   uint16 *buffer;
 192
 193 } UNISTR2;
 194
 195 /* STRING2 - string size (in uint8 chars) and buffer */
 196 typedef struct string2_info
 197 {
 198   uint32 str_max_len;
 199   uint32 undoc;
 200   uint32 str_str_len;
 201   uint8  *buffer; /* uint8 characters. **NOT** necessarily null-terminated */
 202
 203 } STRING2;
 204
 205 /* UNISTR3 - XXXX not sure about this structure */
 206 typedef struct unistr3_info
 207 {
 208         uint32 uni_str_len;
 209         UNISTR str;
 210
 211 } UNISTR3;
 212
 213 /* an element in a unicode string array */
 214 typedef struct
 215 {
 216         uint16 length;
 217         uint16 size;
 218         uint32 ref_id;
 219         UNISTR2 string;
 220 } UNISTR2_ARRAY_EL;
 221
 222 /* an array of unicode strings */
 223 typedef struct
 224 {
 225         uint32 ref_id;
 226         uint32 count;
 227         UNISTR2_ARRAY_EL *strings;
 228 } UNISTR2_ARRAY;
 229
 230 /* DOM_RID2 - domain RID structure for ntlsa pipe */
 231 typedef struct domrid2_info
 232 {
 233         uint8 type; /* value is SID_NAME_USE enum */
 234         uint32 rid;
 235         uint32 rid_idx; /* referenced domain index */
 236
 237 } DOM_RID2;
 238
 239 /* DOM_RID3 - domain RID structure for samr pipe */
 240 typedef struct domrid3_info
 241 {
 242         uint32 rid;        /* domain-relative (to a SID) id */
 243         uint32 type1;      /* value is 0x1 */
 244         uint32 ptr_type;   /* undocumented pointer */
 245         uint32 type2;      /* value is 0x1 */
 246         uint32 unk; /* value is 0x2 */
 247
 248 } DOM_RID3;
 249
 250 /* DOM_RID4 - rid + user attributes */
 251 typedef struct domrid4_info
 252 {
 253   uint32 unknown;
 254   uint16 attr;
 255   uint32 rid;  /* user RID */
 256
 257 } DOM_RID4;
 258
 259 /* DOM_CLNT_SRV - client / server names */
 260 typedef struct clnt_srv_info
 261 {
 262   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
 263   UNISTR2 uni_logon_srv; /* logon server name */
 264   uint32  undoc_buffer2; /* undocumented 32 bit buffer pointer */
 265   UNISTR2 uni_comp_name; /* client machine name */
 266
 267 } DOM_CLNT_SRV;
 268
 269 /* DOM_LOG_INFO - login info */
 270 typedef struct log_info
 271 {
 272   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
 273   UNISTR2 uni_logon_srv; /* logon server name */
 274   UNISTR2 uni_acct_name; /* account name */
 275   uint16  sec_chan;      /* secure channel type */
 276   UNISTR2 uni_comp_name; /* client machine name */
 277
 278 } DOM_LOG_INFO;
 279
 280 /* DOM_CHAL - challenge info */
 281 typedef struct chal_info
 282 {
 283     uchar data[8]; /* credentials */
 284 } DOM_CHAL;
 285
 286 /* DOM_CREDs - timestamped client or server credentials */
 287 typedef struct cred_info
 288 {
 289     DOM_CHAL challenge; /* credentials */
 290     UTIME timestamp;    /* credential time-stamp */
 291 } DOM_CRED;
 292
 293 /* DOM_CLNT_INFO - client info */
 294 typedef struct clnt_info
 295 {
 296   DOM_LOG_INFO login;
 297   DOM_CRED     cred;
 298
 299 } DOM_CLNT_INFO;
 300
 301 /* DOM_CLNT_INFO2 - client info */
 302 typedef struct clnt_info2
 303 {
 304   DOM_CLNT_SRV login;
 305   uint32        ptr_cred;
 306   DOM_CRED      cred;
 307
 308 } DOM_CLNT_INFO2;
 309
 310 /* DOM_LOGON_ID - logon id */
 311 typedef struct logon_info
 312 {
 313   uint32 low;
 314   uint32 high;
 315
 316 } DOM_LOGON_ID;
 317
 318 /* OWF INFO */
 319 typedef struct owf_info
 320 {
 321   uint8 data[16];
 322
 323 } OWF_INFO;
 324
 325
 326 /* DOM_GID - group id + user attributes */
 327 typedef struct gid_info
 328 {
 329   uint32 g_rid;  /* a group RID */
 330   uint32 attr;
 331
 332 } DOM_GID;
 333
 334 /* POLICY_HND */
 335 typedef struct lsa_policy_info
 336 {
 337         uint32 data1;
 338         uint32 data2;
 339         uint16 data3;
 340         uint16 data4;
 341         uint8 data5[8];
 342
 343 #ifdef __INSURE__
 344
 345         /* To prevent the leakage of policy handles mallocate a bit of
 346            memory when a policy handle is created and free it when the
 347            handle is closed.  This should cause Insure to flag an error
 348            when policy handles are overwritten or fall out of scope without
 349            being freed. */
 350
 351         char *marker;
 352 #endif
 353
 354 } POLICY_HND;
 355
 356 /*
 357  * A client connection's state, pipe name,
 358  * user credentials, etc...
 359  */
 360 typedef struct _cli_auth_fns cli_auth_fns;
 361 struct user_creds;
 362 struct cli_connection {
 363
 364         char                    *srv_name;
 365         char                    *pipe_name;
 366         struct user_creds       usr_creds;
 367
 368         struct cli_state        *pCli_state;
 369
 370         cli_auth_fns            *auth;
 371
 372         void                    *auth_info;
 373         void                    *auth_creds;
 374 };
 375
 376
 377 /*
 378  * Associate a POLICY_HND with a cli_connection
 379  */
 380 typedef struct rpc_hnd_node {
 381
 382         POLICY_HND              hnd;
 383         struct cli_connection   *cli;
 384
 385 } RPC_HND_NODE;
 386
 387 typedef struct uint64_s
 388 {
 389         uint32 low;
 390         uint32 high;
 391 } UINT64_S;
 392
 393 /* BUFHDR2 - another buffer header, with info level */
 394 typedef struct bufhdr2_info
 395 {
 396         uint32 info_level;
 397         uint32 length;          /* uint8 chars */
 398         uint32 buffer;
 399
 400 }
 401 BUFHDR2;
 402
 403 /* BUFFER4 - simple length and buffer */
 404 typedef struct buffer4_info
 405 {
 406         uint32 buf_len;
 407         uint8 buffer[MAX_BUFFERLEN];
 408
 409 }
 410 BUFFER4;
 411
 412
 413 #endif /* _RPC_MISC_H */