chgpasswd.c: Added comments to #ifdefs
[samba.git] / source3 / include / rpc_misc.h
1 /* 
2    Unix SMB/Netbios implementation.
3    Version 1.9.
4    SMB parameters and setup
5    Copyright (C) Andrew Tridgell 1992-1997
6    Copyright (C) Luke Kenneth Casson Leighton 1996-1997
7    Copyright (C) Paul Ashton 1997
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 _RPC_MISC_H /* _RPC_MISC_H */
25 #define _RPC_MISC_H 
26
27
28 #include "rpc_dce.h"
29
30 /* pipe string names */
31 #define PIPE_SRVSVC   "\\PIPE\\srvsvc"
32 #define PIPE_SAMR     "\\PIPE\\samr"
33 #define PIPE_WINREG   "\\PIPE\\winreg"
34 #define PIPE_WKSSVC   "\\PIPE\\wkssvc"
35 #define PIPE_NETLOGON "\\PIPE\\NETLOGON"
36 #define PIPE_NTLSA    "\\PIPE\\ntlsa"
37 #define PIPE_NTSVCS   "\\PIPE\\ntsvcs"
38 #define PIPE_LSASS    "\\PIPE\\lsass"
39 #define PIPE_LSARPC   "\\PIPE\\lsarpc"
40
41 /* well-known RIDs - Relative IDs */
42
43 /* RIDs - Well-known users ... */
44 #define DOMAIN_USER_RID_ADMIN          (0x000001F4L)
45 #define DOMAIN_USER_RID_GUEST          (0x000001F5L)
46
47 /* RIDs - well-known groups ... */
48 #define DOMAIN_GROUP_RID_ADMINS        (0x00000200L)
49 #define DOMAIN_GROUP_RID_USERS         (0x00000201L)
50 #define DOMAIN_GROUP_RID_GUESTS        (0x00000202L)
51
52 /* RIDs - well-known aliases ... */
53 #define DOMAIN_ALIAS_RID_ADMINS        (0x00000220L)
54 #define DOMAIN_ALIAS_RID_USERS         (0x00000221L)
55 #define DOMAIN_ALIAS_RID_GUESTS        (0x00000222L)
56 #define DOMAIN_ALIAS_RID_POWER_USERS   (0x00000223L)
57
58 #define DOMAIN_ALIAS_RID_ACCOUNT_OPS   (0x00000224L)
59 #define DOMAIN_ALIAS_RID_SYSTEM_OPS    (0x00000225L)
60 #define DOMAIN_ALIAS_RID_PRINT_OPS     (0x00000226L)
61 #define DOMAIN_ALIAS_RID_BACKUP_OPS    (0x00000227L)
62
63 #define DOMAIN_ALIAS_RID_REPLICATOR    (0x00000228L)
64
65 /* ENUM_HND */
66 typedef struct enum_hnd_info
67 {
68         uint32 ptr_hnd;          /* pointer to enumeration handle */
69         uint32 handle;           /* enumeration handle */
70
71 } ENUM_HND;
72
73 /* LOOKUP_LEVEL - switch value */
74 typedef struct lookup_level_info
75 {
76   uint16 value;
77
78 } LOOKUP_LEVEL;
79
80 #define MAXSUBAUTHS 15 /* max sub authorities in a SID */
81
82 /* DOM_SID - security id */
83 typedef struct sid_info
84 {
85   uint8  sid_rev_num;             /* SID revision number */
86   uint8  num_auths;               /* number of sub-authorities */
87   uint8  id_auth[6];              /* Identifier Authority */
88   /*
89    * Note that the values in these uint32's are in *native* byteorder,
90    * not neccessarily little-endian...... JRA.
91    */
92   uint32 sub_auths[MAXSUBAUTHS];  /* pointer to sub-authorities. */
93
94 } DOM_SID;
95
96 /* DOM_SID2 - security id */
97 typedef struct sid_info_2
98 {
99         uint32 num_auths; /* length, bytes, including length of len :-) */
100
101         DOM_SID sid;
102
103 } DOM_SID2;
104
105 /* STRHDR - string header */
106 typedef struct header_info
107 {
108   uint16 str_max_len;
109   uint16 str_str_len;
110   uint32 buffer; /* non-zero */
111
112 } STRHDR;
113
114 /* UNIHDR - unicode string header */
115 typedef struct unihdr_info
116 {
117   uint16 uni_max_len;
118   uint16 uni_str_len;
119   uint32 buffer; /* usually has a value of 4 */
120
121 } UNIHDR;
122
123 /* UNIHDR2 - unicode string header and undocumented buffer */
124 typedef struct unihdr2_info
125 {
126   UNIHDR unihdr;
127   uint32 buffer; /* 32 bit buffer pointer */
128
129 } UNIHDR2;
130
131 /* clueless as to what maximum length should be */
132 #define MAX_UNISTRLEN 256
133 #define MAX_STRINGLEN 256
134
135 /* UNISTR - unicode string size and buffer */
136 typedef struct unistr_info
137 {
138   uint16 buffer[MAX_UNISTRLEN]; /* unicode characters. ***MUST*** be null-terminated */
139
140 } UNISTR;
141
142 /* UNINOTSTR2 - unicode string, size (in uint8 ascii chars) and buffer */
143 /* pathetic.  some stupid team of \PIPE\winreg writers got the concept */
144 /* of a unicode string different from the other \PIPE\ writers */
145 typedef struct uninotstr2_info
146 {
147   uint32 uni_max_len;
148   uint32 undoc;
149   uint32 uni_buf_len;
150   uint16 buffer[MAX_UNISTRLEN]; /* unicode characters. **NOT** necessarily null-terminated */
151
152 } UNINOTSTR2;
153
154 /* UNISTR2 - unicode string size (in uint16 unicode chars) and buffer */
155 typedef struct unistr2_info
156 {
157   uint32 uni_max_len;
158   uint32 undoc;
159   uint32 uni_str_len;
160   uint16 buffer[MAX_UNISTRLEN]; /* unicode characters. **NOT** necessarily null-terminated */
161
162 } UNISTR2;
163
164 /* STRING2 - string size (in uint8 chars) and buffer */
165 typedef struct string2_info
166 {
167   uint32 str_max_len;
168   uint32 undoc;
169   uint32 str_str_len;
170   uint8  buffer[MAX_STRINGLEN]; /* uint8 characters. **NOT** necessarily null-terminated */
171
172 } STRING2;
173
174
175 /* DOM_RID2 - domain RID structure for ntlsa pipe */
176 typedef struct domrid2_info
177 {
178   uint32 type; /* value is 5 */
179   uint32 undoc; /* value is non-zero */
180   uint32 rid;
181   uint32 rid_idx; /* don't know what this is */
182
183 } DOM_RID2;
184
185 /* DOM_RID3 - domain RID structure for samr pipe */
186 typedef struct domrid3_info
187 {
188   uint32 rid;        /* domain-relative (to a SID) id */
189   uint32 type1;      /* value is 0x1 */
190   uint32 ptr_type;   /* undocumented pointer */
191   uint32 type2;      /* value is 0x1 */
192
193 } DOM_RID3;
194
195 /* DOM_RID4 - rid + user attributes */
196 typedef struct domrid4_info
197 {
198   uint32 unknown;      
199   uint16 attr;
200   uint32 rid;  /* user RID */
201
202 } DOM_RID4;
203
204 /* DOM_CLNT_SRV - client / server names */
205 typedef struct clnt_srv_info
206 {
207   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
208   UNISTR2 uni_logon_srv; /* logon server name */
209   uint32  undoc_buffer2; /* undocumented 32 bit buffer pointer */
210   UNISTR2 uni_comp_name; /* client machine name */
211
212 } DOM_CLNT_SRV;
213
214 /* DOM_LOG_INFO - login info */
215 typedef struct log_info
216 {
217   uint32  undoc_buffer; /* undocumented 32 bit buffer pointer */
218   UNISTR2 uni_logon_srv; /* logon server name */
219   UNISTR2 uni_acct_name; /* account name */
220   uint16  sec_chan;      /* secure channel type */
221   UNISTR2 uni_comp_name; /* client machine name */
222
223 } DOM_LOG_INFO;
224
225 /* DOM_CLNT_INFO - client info */
226 typedef struct clnt_info
227 {
228   DOM_LOG_INFO login;
229   DOM_CRED     cred;
230
231 } DOM_CLNT_INFO;
232
233 /* DOM_CLNT_INFO2 - client info */
234 typedef struct clnt_info2
235 {
236   DOM_CLNT_SRV login;
237   uint32        ptr_cred;
238   DOM_CRED      cred;
239
240 } DOM_CLNT_INFO2;
241
242 /* DOM_LOGON_ID - logon id */
243 typedef struct logon_info
244 {
245   uint32 low;
246   uint32 high;
247
248 } DOM_LOGON_ID;
249
250 /* OWF INFO */
251 typedef struct owf_info
252 {
253   uint8 data[16];
254
255 } OWF_INFO;
256
257
258 /* DOM_GID - group id + user attributes */
259 typedef struct gid_info
260 {
261   uint32 g_rid;  /* a group RID */
262   uint32 attr;
263
264 } DOM_GID;
265
266 #define POL_HND_SIZE 20
267
268 /* POLICY_HND */
269 typedef struct lsa_policy_info
270 {
271   uint8 data[POL_HND_SIZE]; /* policy handle */
272
273 } POLICY_HND;
274
275 #endif /* _RPC_MISC_H */
276