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
 214 /* DOM_RID2 - domain RID structure for ntlsa pipe */
 215 typedef struct domrid2_info
 216 {
 217         uint8 type; /* value is SID_NAME_USE enum */
 218         uint32 rid;
 219         uint32 rid_idx; /* referenced domain index */
 220
 221 } DOM_RID2;
 222
 223 /* DOM_RID3 - domain RID structure for samr pipe */
 224 typedef struct domrid3_info
 225 {
 226         uint32 rid;        /* domain-relative (to a SID) id */
 227         uint32 type1;      /* value is 0x1 */
 228         uint32 ptr_type;   /* undocumented pointer */
 229         uint32 type2;      /* value is 0x1 */
 230         uint32 unk; /* value is 0x2 */
 231
 232 } DOM_RID3;
 233
 234 /* DOM_RID4 - rid + user attributes */
 235 typedef struct domrid4_info
 236 {
 237   uint32 unknown;
 238   uint16 attr;
 239   uint32 rid;  /* user RID */
 240
 241 } DOM_RID4;
 242
 243 /* DOM_CLNT_SRV - client / server names */
 244 typedef struct clnt_srv_info
 245 {
 246   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
 247   UNISTR2 uni_logon_srv; /* logon server name */
 248   uint32  undoc_buffer2; /* undocumented 32 bit buffer pointer */
 249   UNISTR2 uni_comp_name; /* client machine name */
 250
 251 } DOM_CLNT_SRV;
 252
 253 /* DOM_LOG_INFO - login info */
 254 typedef struct log_info
 255 {
 256   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
 257   UNISTR2 uni_logon_srv; /* logon server name */
 258   UNISTR2 uni_acct_name; /* account name */
 259   uint16  sec_chan;      /* secure channel type */
 260   UNISTR2 uni_comp_name; /* client machine name */
 261
 262 } DOM_LOG_INFO;
 263
 264 /* DOM_CHAL - challenge info */
 265 typedef struct chal_info
 266 {
 267     uchar data[8]; /* credentials */
 268 } DOM_CHAL;
 269
 270 /* DOM_CREDs - timestamped client or server credentials */
 271 typedef struct cred_info
 272 {
 273     DOM_CHAL challenge; /* credentials */
 274     UTIME timestamp;    /* credential time-stamp */
 275 } DOM_CRED;
 276
 277 /* DOM_CLNT_INFO - client info */
 278 typedef struct clnt_info
 279 {
 280   DOM_LOG_INFO login;
 281   DOM_CRED     cred;
 282
 283 } DOM_CLNT_INFO;
 284
 285 /* DOM_CLNT_INFO2 - client info */
 286 typedef struct clnt_info2
 287 {
 288   DOM_CLNT_SRV login;
 289   uint32        ptr_cred;
 290   DOM_CRED      cred;
 291
 292 } DOM_CLNT_INFO2;
 293
 294 /* DOM_LOGON_ID - logon id */
 295 typedef struct logon_info
 296 {
 297   uint32 low;
 298   uint32 high;
 299
 300 } DOM_LOGON_ID;
 301
 302 /* OWF INFO */
 303 typedef struct owf_info
 304 {
 305   uint8 data[16];
 306
 307 } OWF_INFO;
 308
 309
 310 /* DOM_GID - group id + user attributes */
 311 typedef struct gid_info
 312 {
 313   uint32 g_rid;  /* a group RID */
 314   uint32 attr;
 315
 316 } DOM_GID;
 317
 318 /* POLICY_HND */
 319 typedef struct lsa_policy_info
 320 {
 321         uint32 data1;
 322         uint32 data2;
 323         uint16 data3;
 324         uint16 data4;
 325         uint8 data5[8];
 326 } POLICY_HND;
 327
 328 /*
 329  * A client connection's state, pipe name,
 330  * user credentials, etc...
 331  */
 332 typedef struct _cli_auth_fns cli_auth_fns;
 333 struct user_creds;
 334 struct cli_connection {
 335
 336         char                    *srv_name;
 337         char                    *pipe_name;
 338         struct user_creds       usr_creds;
 339
 340         struct cli_state        *pCli_state;
 341
 342         cli_auth_fns            *auth;
 343
 344         void                    *auth_info;
 345         void                    *auth_creds;
 346 };
 347
 348
 349 /*
 350  * Associate a POLICY_HND with a cli_connection
 351  */
 352 typedef struct rpc_hnd_node {
 353
 354         POLICY_HND              hnd;
 355         struct cli_connection   *cli;
 356
 357 } RPC_HND_NODE;
 358
 359 typedef struct uint64_s
 360 {
 361         uint32 low;
 362         uint32 high;
 363 } UINT64_S;
 364
 365 /* BUFHDR2 - another buffer header, with info level */
 366 typedef struct bufhdr2_info
 367 {
 368         uint32 info_level;
 369         uint32 length;          /* uint8 chars */
 370         uint32 buffer;
 371
 372 }
 373 BUFHDR2;
 374
 375 /* BUFFER4 - simple length and buffer */
 376 typedef struct buffer4_info
 377 {
 378         uint32 buf_len;
 379         uint8 buffer[MAX_BUFFERLEN];
 380
 381 }
 382 BUFFER4;
 383
 384
 385 #endif /* _RPC_MISC_H */