dce/rpc
[samba.git] / source3 / include / rpc_dce.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 _DCE_RPC_H /* _DCE_RPC_H */
25 #define _DCE_RPC_H 
26
27 #include "rpc_misc.h" /* this only pulls in STRHDR */
28
29
30 /* DCE/RPC packet types */
31
32 enum RPC_PKT_TYPE
33 {
34         RPC_REQUEST = 0x00,
35         RPC_RESPONSE = 0x02,
36         RPC_BIND     = 0x0B,
37         RPC_BINDACK  = 0x0C,
38         RPC_BINDRESP = 0x10 /* not the real name!  this is undocumented! */
39 };
40
41 /* DCE/RPC flags */
42 #define RPC_FLG_FIRST 0x01
43 #define RPC_FLG_LAST  0x02
44
45 /* NTLMSSP message types */
46 enum NTLM_MESSAGE_TYPE
47 {
48         NTLMSSP_NEGOTIATE = 1,
49         NTLMSSP_CHALLENGE = 2,
50         NTLMSSP_AUTH      = 3,
51         NTLMSSP_UNKNOWN   = 4,
52 };
53
54 /* NTLMSSP negotiation flags */
55 #define NTLMSSP_NEGOTIATE_UNICODE          0x00000001
56 #define NTLMSSP_NEGOTIATE_OEM              0x00000002
57 #define NTLMSSP_REQUEST_TARGET             0x00000004
58 #define NTLMSSP_NEGOTIATE_SIGN             0x00000010
59 #define NTLMSSP_NEGOTIATE_SEAL             0x00000020
60 #define NTLMSSP_NEGOTIATE_LM_KEY           0x00000080
61 #define NTLMSSP_NEGOTIATE_NTLM             0x00000200
62 #define NTLMSSP_NEGOTIATE_ALWAYS_SIGN      0x00008000
63 #define NTLMSSP_NEGOTIATE_NTLM2            0x00080000
64 #define NTLMSSP_NEGOTIATE_TARGET_INFO      0x00800000
65 #define NTLMSSP_NEGOTIATE_128              0x20000000
66 #define NTLMSSP_NEGOTIATE_KEY_EXCH         0x40000000
67
68 /* RPC_IFACE */
69 typedef struct rpc_iface_info
70 {
71   uint8 data[16];    /* 16 bytes of rpc interface identification */
72   uint32 version;    /* the interface version number */
73
74 } RPC_IFACE;
75
76 struct pipe_id_info
77 {
78         /* the names appear not to matter: the syntaxes _do_ matter */
79
80         char *client_pipe;
81         RPC_IFACE abstr_syntax; /* this one is the abstract syntax id */
82
83         char *server_pipe;  /* this one is the secondary syntax name */
84         RPC_IFACE trans_syntax; /* this one is the primary syntax id */
85 };
86
87 /* RPC_HDR - dce rpc header */
88 typedef struct rpc_hdr_info
89 {
90   uint8  major; /* 5 - RPC major version */
91   uint8  minor; /* 0 - RPC minor version */
92   uint8  pkt_type; /* RPC_PKT_TYPE - RPC response packet */
93   uint8  flags; /* DCE/RPC flags */
94   uint32 pack_type; /* 0x1000 0000 - packed data representation */
95   uint16 frag_len; /* fragment length - data size (bytes) inc header and tail. */
96   uint16 auth_len; /* 0 - authentication length  */
97   uint32 call_id; /* call identifier.  matches 12th uint32 of incoming RPC data. */
98
99 } RPC_HDR;
100
101 /* RPC_HDR_REQ - ms request rpc header */
102 typedef struct rpc_hdr_req_info
103 {
104   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
105   uint16 context_id;   /* 0 - presentation context identifier */
106   uint16  opnum;        /* opnum */
107
108 } RPC_HDR_REQ;
109
110 /* RPC_HDR_RESP - ms response rpc header */
111 typedef struct rpc_hdr_resp_info
112 {
113   uint32 alloc_hint;   /* allocation hint - data size (bytes) minus header and tail. */
114   uint16 context_id;   /* 0 - presentation context identifier */
115   uint8  cancel_count; /* 0 - cancel count */
116   uint8  reserved;     /* 0 - reserved. */
117
118 } RPC_HDR_RESP;
119
120 /* this seems to be the same string name depending on the name of the pipe,
121  * but is more likely to be linked to the interface name
122  * "srvsvc", "\\PIPE\\ntsvcs"
123  * "samr", "\\PIPE\\lsass"
124  * "wkssvc", "\\PIPE\\wksvcs"
125  * "NETLOGON", "\\PIPE\\NETLOGON"
126  */
127 /* RPC_ADDR_STR */
128 typedef struct rpc_addr_info
129 {
130   uint16 len;   /* length of the string including null terminator */
131   fstring str; /* the string above in single byte, null terminated form */
132
133 } RPC_ADDR_STR;
134
135 /* RPC_HDR_BBA */
136 typedef struct rpc_hdr_bba_info
137 {
138   uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
139   uint16 max_rsize;       /* max receive fragment size (0x1630) */
140   uint32 assoc_gid;       /* associated group id (0x0) */
141
142 } RPC_HDR_BBA;
143
144 /* RPC_HDR_AUTHA */
145 typedef struct rpc_hdr_autha_info
146 {
147         uint16 max_tsize;       /* maximum transmission fragment size (0x1630) */
148         uint16 max_rsize;       /* max receive fragment size (0x1630) */
149
150         uint8 auth_type; /* 0x0a */
151         uint8 auth_level; /* 0x06 */
152         uint8 stub_type_len; /* don't know */
153         uint8 padding; /* padding */
154
155         uint32 unknown; /* 0x0014a0c0 */
156
157 } RPC_HDR_AUTHA;
158
159 /* RPC_HDR_AUTH */
160 typedef struct rpc_hdr_auth_info
161 {
162         uint8 auth_type; /* 0x0a */
163         uint8 auth_level; /* 0x06 */
164         uint8 stub_type_len; /* don't know */
165         uint8 padding; /* padding */
166
167         uint32 unknown; /* 0x0014a0c0 */
168
169 } RPC_HDR_AUTH;
170
171 /* RPC_BIND_REQ - ms req bind */
172 typedef struct rpc_bind_req_info
173 {
174   RPC_HDR_BBA bba;
175
176   uint32 num_elements;    /* the number of elements (0x1) */
177   uint16 context_id;      /* presentation context identifier (0x0) */
178   uint8 num_syntaxes;     /* the number of syntaxes (has always been 1?)(0x1) */
179
180   RPC_IFACE abstract;     /* num and vers. of interface client is using */
181   RPC_IFACE transfer;     /* num and vers. of interface to use for replies */
182   
183 } RPC_HDR_RB;
184
185 /* RPC_RESULTS - can only cope with one reason, right now... */
186 typedef struct rpc_results_info
187 {
188 /* uint8[] # 4-byte alignment padding, against SMB header */
189
190   uint8 num_results; /* the number of results (0x01) */
191
192 /* uint8[] # 4-byte alignment padding, against SMB header */
193
194   uint16 result; /* result (0x00 = accept) */
195   uint16 reason; /* reason (0x00 = no reason specified) */
196
197 } RPC_RESULTS;
198
199 /* RPC_HDR_BA */
200 typedef struct rpc_hdr_ba_info
201 {
202   RPC_HDR_BBA bba;
203
204   RPC_ADDR_STR addr    ;  /* the secondary address string, as described earlier */
205   RPC_RESULTS  res     ; /* results and reasons */
206   RPC_IFACE    transfer; /* the transfer syntax from the request */
207
208 } RPC_HDR_BA;
209
210 /* RPC_AUTH_VERIFIER */
211 typedef struct rpc_auth_verif_info
212 {
213         fstring signature; /* "NTLMSSP" */
214         uint32  msg_type; /* NTLMSSP_MESSAGE_TYPE (1,2,3) */
215
216 } RPC_AUTH_VERIFIER;
217
218 /* this is TEMPORARILY coded up as a specific structure */
219 /* this structure comes after the bind request */
220 /* RPC_AUTH_NTLMSSP_NEG */
221 typedef struct rpc_auth_ntlmssp_neg_info
222 {
223         uint32  neg_flgs; /* 0x0000 b2b3 */
224
225         STRHDR hdr_myname; /* offset is against START of this structure */
226         STRHDR hdr_domain; /* offset is against START of this structure */
227
228         fstring myname; /* calling workstation's name */
229         fstring domain; /* calling workstations's domain */
230
231 } RPC_AUTH_NTLMSSP_NEG;
232
233 /* this is TEMPORARILY coded up as a specific structure */
234 /* this structure comes after the bind acknowledgement */
235 /* RPC_AUTH_NTLMSSP_CHAL */
236 typedef struct rpc_auth_ntlmssp_chal_info
237 {
238         uint32 unknown_1; /* 0x0000 0000 */
239         uint32 unknown_2; /* 0x0000 0028 */
240         uint32 neg_flags; /* 0x0000 82b1 */
241
242         uint8 challenge[8]; /* ntlm challenge */
243         uint8 reserved [8]; /* zeros */
244
245 } RPC_AUTH_NTLMSSP_CHAL;
246
247
248 /* RPC_AUTH_NTLMSSP_RESP */
249 typedef struct rpc_auth_ntlmssp_resp_info
250 {
251         STRHDR hdr_lm_resp; /* 24 byte response */
252         STRHDR hdr_nt_resp; /* 24 byte response */
253         STRHDR hdr_domain;
254         STRHDR hdr_usr;
255         STRHDR hdr_wks;
256         STRHDR hdr_sess_key; /* NULL unless negotiated */
257         uint32 neg_flags; /* 0x0000 82b1 */
258
259         fstring sess_key;
260         fstring wks;
261         fstring user;
262         fstring domain;
263         fstring nt_resp;
264         fstring lm_resp;
265
266 } RPC_AUTH_NTLMSSP_RESP;
267
268
269 /* attached to the end of encrypted rpc requests and responses */
270 /* RPC_AUTH_NTLMSSP_CHK */
271 typedef struct rpc_auth_ntlmssp_chk_info
272 {
273         uint32 ver; /* 0x0000 0001 */
274         uint8  crc32[8]; /* checksum using 0xEDB8 8320 as a polynomial */
275         uint32 seq_num;
276
277 } RPC_AUTH_NTLMSSP_CHK;
278
279 #endif /* _DCE_RPC_H */
280