2 * Unix SMB/CIFS implementation.
3 * RPC Pipe client / server routines
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 1999.
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 3 of the License, or
12 * (at your option) any later version.
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.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, see <http://www.gnu.org/licenses/>.
26 #define DBGC_CLASS DBGC_RPC_PARSE
28 /*******************************************************************
29 interface/version dce/rpc pipe identification
30 ********************************************************************/
32 #define TRANS_SYNT_V2 \
35 0x8a885d04, 0x1ceb, 0x11c9, \
38 0x2b, 0x10, 0x48, 0x60 } \
42 #define SYNT_NETLOGON_V2 \
45 0x8a885d04, 0x1ceb, 0x11c9, \
48 0x2b, 0x10, 0x48, 0x60 } \
52 #define SYNT_WKSSVC_V1 \
55 0x6bffd098, 0xa112, 0x3610, \
58 0xf8, 0x7e, 0x34, 0x5a } \
62 #define SYNT_SRVSVC_V3 \
65 0x4b324fc8, 0x1670, 0x01d3, \
68 0xbf, 0x6e, 0xe1, 0x88 } \
72 #define SYNT_LSARPC_V0 \
75 0x12345778, 0x1234, 0xabcd, \
78 0x45, 0x67, 0x89, 0xab } \
82 #define SYNT_LSARPC_V0_DS \
85 0x3919286a, 0xb10c, 0x11d0, \
88 0x4f, 0xd9, 0x2e, 0xf5 } \
92 #define SYNT_SAMR_V1 \
95 0x12345778, 0x1234, 0xabcd, \
98 0x45, 0x67, 0x89, 0xac } \
102 #define SYNT_NETLOGON_V1 \
105 0x12345678, 0x1234, 0xabcd, \
108 0x45, 0x67, 0xcf, 0xfb } \
112 #define SYNT_WINREG_V1 \
115 0x338cd001, 0x2244, 0x31f1, \
118 0x38, 0x00, 0x10, 0x03 } \
122 #define SYNT_SPOOLSS_V1 \
125 0x12345678, 0x1234, 0xabcd, \
128 0x45, 0x67, 0x89, 0xab } \
132 #define SYNT_NONE_V0 \
138 0x00, 0x00, 0x00, 0x00 } \
142 #define SYNT_NETDFS_V3 \
145 0x4fc742e0, 0x4a10, 0x11cf, \
148 0x00, 0x4a, 0xe6, 0x73 } \
152 #define SYNT_ECHO_V1 \
155 0x60a15ec5, 0x4de8, 0x11d7, \
158 0x56, 0xa2, 0x01, 0x82 } \
162 #define SYNT_SHUTDOWN_V1 \
165 0x894de0c0, 0x0d55, 0x11d3, \
168 0x4f, 0xa3, 0x21, 0xa1 } \
172 #define SYNT_SVCCTL_V2 \
175 0x367abb81, 0x9844, 0x35f1, \
178 0x38, 0x00, 0x10, 0x03 } \
183 #define SYNT_EVENTLOG_V0 \
186 0x82273fdc, 0xe32a, 0x18c3, \
189 0x29, 0xdc, 0x23, 0xea } \
193 #define SYNT_NTSVCS_V1 \
196 0x8d9f4e40, 0xa03d, 0x11ce, \
199 0x3e, 0x30, 0x05, 0x1b } \
204 * IMPORTANT!! If you update this structure, make sure to
205 * update the index #defines in smb.h.
208 const struct pipe_id_info pipe_names [] =
210 /* client pipe , abstract syntax , server pipe , transfer syntax */
211 { PIPE_LSARPC , SYNT_LSARPC_V0 , PIPE_LSASS , TRANS_SYNT_V2 },
212 { PIPE_LSARPC , SYNT_LSARPC_V0_DS , PIPE_LSASS , TRANS_SYNT_V2 },
213 { PIPE_SAMR , SYNT_SAMR_V1 , PIPE_LSASS , TRANS_SYNT_V2 },
214 { PIPE_NETLOGON, SYNT_NETLOGON_V1 , PIPE_LSASS , TRANS_SYNT_V2 },
215 { PIPE_SRVSVC , SYNT_SRVSVC_V3 , PIPE_NTSVCS , TRANS_SYNT_V2 },
216 { PIPE_WKSSVC , SYNT_WKSSVC_V1 , PIPE_NTSVCS , TRANS_SYNT_V2 },
217 { PIPE_WINREG , SYNT_WINREG_V1 , PIPE_WINREG , TRANS_SYNT_V2 },
218 { PIPE_SPOOLSS , SYNT_SPOOLSS_V1 , PIPE_SPOOLSS , TRANS_SYNT_V2 },
219 { PIPE_NETDFS , SYNT_NETDFS_V3 , PIPE_NETDFS , TRANS_SYNT_V2 },
220 { PIPE_ECHO , SYNT_ECHO_V1 , PIPE_ECHO , TRANS_SYNT_V2 },
221 { PIPE_SHUTDOWN, SYNT_SHUTDOWN_V1 , PIPE_SHUTDOWN , TRANS_SYNT_V2 },
222 { PIPE_SVCCTL , SYNT_SVCCTL_V2 , PIPE_NTSVCS , TRANS_SYNT_V2 },
223 { PIPE_EVENTLOG, SYNT_EVENTLOG_V0 , PIPE_EVENTLOG , TRANS_SYNT_V2 },
224 { PIPE_NTSVCS , SYNT_NTSVCS_V1 , PIPE_NTSVCS , TRANS_SYNT_V2 },
225 { NULL , SYNT_NONE_V0 , NULL , SYNT_NONE_V0 }
228 /****************************************************************************
229 Return the pipe name from the index.
230 ****************************************************************************/
232 const char *cli_get_pipe_name(int pipe_idx)
234 return &pipe_names[pipe_idx].client_pipe[5];
237 /*******************************************************************
238 Inits an RPC_HDR structure.
239 ********************************************************************/
241 void init_rpc_hdr(RPC_HDR *hdr, enum RPC_PKT_TYPE pkt_type, uint8 flags,
242 uint32 call_id, int data_len, int auth_len)
244 hdr->major = 5; /* RPC version 5 */
245 hdr->minor = 0; /* minor version 0 */
246 hdr->pkt_type = pkt_type; /* RPC packet type */
247 hdr->flags = flags; /* dce/rpc flags */
248 hdr->pack_type[0] = 0x10; /* little-endian data representation */
249 hdr->pack_type[1] = 0; /* packed data representation */
250 hdr->pack_type[2] = 0; /* packed data representation */
251 hdr->pack_type[3] = 0; /* packed data representation */
252 hdr->frag_len = data_len; /* fragment length, fill in later */
253 hdr->auth_len = auth_len; /* authentication length */
254 hdr->call_id = call_id; /* call identifier - match incoming RPC */
257 /*******************************************************************
258 Reads or writes an RPC_HDR structure.
259 ********************************************************************/
261 bool smb_io_rpc_hdr(const char *desc, RPC_HDR *rpc, prs_struct *ps, int depth)
266 prs_debug(ps, depth, desc, "smb_io_rpc_hdr");
269 if(!prs_uint8 ("major ", ps, depth, &rpc->major))
272 if(!prs_uint8 ("minor ", ps, depth, &rpc->minor))
274 if(!prs_uint8 ("pkt_type ", ps, depth, &rpc->pkt_type))
276 if(!prs_uint8 ("flags ", ps, depth, &rpc->flags))
279 /* We always marshall in little endian format. */
281 rpc->pack_type[0] = 0x10;
283 if(!prs_uint8("pack_type0", ps, depth, &rpc->pack_type[0]))
285 if(!prs_uint8("pack_type1", ps, depth, &rpc->pack_type[1]))
287 if(!prs_uint8("pack_type2", ps, depth, &rpc->pack_type[2]))
289 if(!prs_uint8("pack_type3", ps, depth, &rpc->pack_type[3]))
293 * If reading and pack_type[0] == 0 then the data is in big-endian
294 * format. Set the flag in the prs_struct to specify reverse-endainness.
297 if (UNMARSHALLING(ps) && rpc->pack_type[0] == 0) {
298 DEBUG(10,("smb_io_rpc_hdr: PDU data format is big-endian. Setting flag.\n"));
299 prs_set_endian_data(ps, RPC_BIG_ENDIAN);
302 if(!prs_uint16("frag_len ", ps, depth, &rpc->frag_len))
304 if(!prs_uint16("auth_len ", ps, depth, &rpc->auth_len))
306 if(!prs_uint32("call_id ", ps, depth, &rpc->call_id))
311 /*******************************************************************
312 Reads or writes an RPC_IFACE structure.
313 ********************************************************************/
315 static bool smb_io_rpc_iface(const char *desc, RPC_IFACE *ifc, prs_struct *ps, int depth)
320 prs_debug(ps, depth, desc, "smb_io_rpc_iface");
326 if (!smb_io_uuid( "uuid", &ifc->uuid, ps, depth))
329 if(!prs_uint32 ("version", ps, depth, &ifc->if_version))
335 /*******************************************************************
336 Inits an RPC_ADDR_STR structure.
337 ********************************************************************/
339 static void init_rpc_addr_str(RPC_ADDR_STR *str, const char *name)
341 str->len = strlen(name) + 1;
342 fstrcpy(str->str, name);
345 /*******************************************************************
346 Reads or writes an RPC_ADDR_STR structure.
347 ********************************************************************/
349 static bool smb_io_rpc_addr_str(const char *desc, RPC_ADDR_STR *str, prs_struct *ps, int depth)
354 prs_debug(ps, depth, desc, "smb_io_rpc_addr_str");
359 if(!prs_uint16 ( "len", ps, depth, &str->len))
361 if(!prs_uint8s (True, "str", ps, depth, (uchar*)str->str, MIN(str->len, sizeof(str->str)) ))
366 /*******************************************************************
367 Inits an RPC_HDR_BBA structure.
368 ********************************************************************/
370 static void init_rpc_hdr_bba(RPC_HDR_BBA *bba, uint16 max_tsize, uint16 max_rsize, uint32 assoc_gid)
372 bba->max_tsize = max_tsize; /* maximum transmission fragment size (0x1630) */
373 bba->max_rsize = max_rsize; /* max receive fragment size (0x1630) */
374 bba->assoc_gid = assoc_gid; /* associated group id (0x0) */
377 /*******************************************************************
378 Reads or writes an RPC_HDR_BBA structure.
379 ********************************************************************/
381 static bool smb_io_rpc_hdr_bba(const char *desc, RPC_HDR_BBA *rpc, prs_struct *ps, int depth)
386 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_bba");
389 if(!prs_uint16("max_tsize", ps, depth, &rpc->max_tsize))
391 if(!prs_uint16("max_rsize", ps, depth, &rpc->max_rsize))
393 if(!prs_uint32("assoc_gid", ps, depth, &rpc->assoc_gid))
398 /*******************************************************************
399 Inits an RPC_CONTEXT structure.
400 Note the transfer pointer must remain valid until this is marshalled.
401 ********************************************************************/
403 void init_rpc_context(RPC_CONTEXT *rpc_ctx, uint16 context_id, RPC_IFACE *abstract, RPC_IFACE *transfer)
405 rpc_ctx->context_id = context_id ; /* presentation context identifier (0x0) */
406 rpc_ctx->num_transfer_syntaxes = 1 ; /* the number of syntaxes (has always been 1?)(0x1) */
408 /* num and vers. of interface client is using */
409 rpc_ctx->abstract = *abstract;
411 /* vers. of interface to use for replies */
412 rpc_ctx->transfer = transfer;
415 /*******************************************************************
416 Inits an RPC_HDR_RB structure.
417 Note the context pointer must remain valid until this is marshalled.
418 ********************************************************************/
420 void init_rpc_hdr_rb(RPC_HDR_RB *rpc,
421 uint16 max_tsize, uint16 max_rsize, uint32 assoc_gid,
422 RPC_CONTEXT *context)
424 init_rpc_hdr_bba(&rpc->bba, max_tsize, max_rsize, assoc_gid);
426 rpc->num_contexts = 1;
427 rpc->rpc_context = context;
430 /*******************************************************************
431 Reads or writes an RPC_CONTEXT structure.
432 ********************************************************************/
434 bool smb_io_rpc_context(const char *desc, RPC_CONTEXT *rpc_ctx, prs_struct *ps, int depth)
443 if(!prs_uint16("context_id ", ps, depth, &rpc_ctx->context_id ))
445 if(!prs_uint8 ("num_transfer_syntaxes", ps, depth, &rpc_ctx->num_transfer_syntaxes))
448 /* num_transfer_syntaxes must not be zero. */
449 if (rpc_ctx->num_transfer_syntaxes == 0)
452 if(!smb_io_rpc_iface("", &rpc_ctx->abstract, ps, depth))
455 if (UNMARSHALLING(ps)) {
456 if (!(rpc_ctx->transfer = PRS_ALLOC_MEM(ps, RPC_IFACE, rpc_ctx->num_transfer_syntaxes))) {
461 for (i = 0; i < rpc_ctx->num_transfer_syntaxes; i++ ) {
462 if (!smb_io_rpc_iface("", &rpc_ctx->transfer[i], ps, depth))
468 /*******************************************************************
469 Reads or writes an RPC_HDR_RB structure.
470 ********************************************************************/
472 bool smb_io_rpc_hdr_rb(const char *desc, RPC_HDR_RB *rpc, prs_struct *ps, int depth)
479 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_rb");
482 if(!smb_io_rpc_hdr_bba("", &rpc->bba, ps, depth))
485 if(!prs_uint8("num_contexts", ps, depth, &rpc->num_contexts))
488 /* 3 pad bytes following - will be mopped up by the prs_align in smb_io_rpc_context(). */
490 /* num_contexts must not be zero. */
491 if (rpc->num_contexts == 0)
494 if (UNMARSHALLING(ps)) {
495 if (!(rpc->rpc_context = PRS_ALLOC_MEM(ps, RPC_CONTEXT, rpc->num_contexts))) {
500 for (i = 0; i < rpc->num_contexts; i++ ) {
501 if (!smb_io_rpc_context("", &rpc->rpc_context[i], ps, depth))
508 /*******************************************************************
509 Inits an RPC_RESULTS structure.
511 lkclXXXX only one reason at the moment!
512 ********************************************************************/
514 static void init_rpc_results(RPC_RESULTS *res,
515 uint8 num_results, uint16 result, uint16 reason)
517 res->num_results = num_results; /* the number of results (0x01) */
518 res->result = result ; /* result (0x00 = accept) */
519 res->reason = reason ; /* reason (0x00 = no reason specified) */
522 /*******************************************************************
523 Reads or writes an RPC_RESULTS structure.
525 lkclXXXX only one reason at the moment!
526 ********************************************************************/
528 static bool smb_io_rpc_results(const char *desc, RPC_RESULTS *res, prs_struct *ps, int depth)
533 prs_debug(ps, depth, desc, "smb_io_rpc_results");
539 if(!prs_uint8 ("num_results", ps, depth, &res->num_results))
545 if(!prs_uint16("result ", ps, depth, &res->result))
547 if(!prs_uint16("reason ", ps, depth, &res->reason))
552 /*******************************************************************
553 Init an RPC_HDR_BA structure.
555 lkclXXXX only one reason at the moment!
557 ********************************************************************/
559 void init_rpc_hdr_ba(RPC_HDR_BA *rpc,
560 uint16 max_tsize, uint16 max_rsize, uint32 assoc_gid,
561 const char *pipe_addr,
562 uint8 num_results, uint16 result, uint16 reason,
565 init_rpc_hdr_bba (&rpc->bba, max_tsize, max_rsize, assoc_gid);
566 init_rpc_addr_str(&rpc->addr, pipe_addr);
567 init_rpc_results (&rpc->res, num_results, result, reason);
569 /* the transfer syntax from the request */
570 memcpy(&rpc->transfer, transfer, sizeof(rpc->transfer));
573 /*******************************************************************
574 Reads or writes an RPC_HDR_BA structure.
575 ********************************************************************/
577 bool smb_io_rpc_hdr_ba(const char *desc, RPC_HDR_BA *rpc, prs_struct *ps, int depth)
582 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_ba");
585 if(!smb_io_rpc_hdr_bba("", &rpc->bba, ps, depth))
587 if(!smb_io_rpc_addr_str("", &rpc->addr, ps, depth))
589 if(!smb_io_rpc_results("", &rpc->res, ps, depth))
591 if(!smb_io_rpc_iface("", &rpc->transfer, ps, depth))
596 /*******************************************************************
597 Init an RPC_HDR_REQ structure.
598 ********************************************************************/
600 void init_rpc_hdr_req(RPC_HDR_REQ *hdr, uint32 alloc_hint, uint16 opnum)
602 hdr->alloc_hint = alloc_hint; /* allocation hint */
603 hdr->context_id = 0; /* presentation context identifier */
604 hdr->opnum = opnum; /* opnum */
607 /*******************************************************************
608 Reads or writes an RPC_HDR_REQ structure.
609 ********************************************************************/
611 bool smb_io_rpc_hdr_req(const char *desc, RPC_HDR_REQ *rpc, prs_struct *ps, int depth)
616 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_req");
619 if(!prs_uint32("alloc_hint", ps, depth, &rpc->alloc_hint))
621 if(!prs_uint16("context_id", ps, depth, &rpc->context_id))
623 if(!prs_uint16("opnum ", ps, depth, &rpc->opnum))
628 /*******************************************************************
629 Reads or writes an RPC_HDR_RESP structure.
630 ********************************************************************/
632 bool smb_io_rpc_hdr_resp(const char *desc, RPC_HDR_RESP *rpc, prs_struct *ps, int depth)
637 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_resp");
640 if(!prs_uint32("alloc_hint", ps, depth, &rpc->alloc_hint))
642 if(!prs_uint16("context_id", ps, depth, &rpc->context_id))
644 if(!prs_uint8 ("cancel_ct ", ps, depth, &rpc->cancel_count))
646 if(!prs_uint8 ("reserved ", ps, depth, &rpc->reserved))
651 /*******************************************************************
652 Reads or writes an RPC_HDR_FAULT structure.
653 ********************************************************************/
655 bool smb_io_rpc_hdr_fault(const char *desc, RPC_HDR_FAULT *rpc, prs_struct *ps, int depth)
660 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_fault");
663 if(!prs_dcerpc_status("status ", ps, depth, &rpc->status))
665 if(!prs_uint32("reserved", ps, depth, &rpc->reserved))
671 /*******************************************************************
672 Inits an RPC_HDR_AUTH structure.
673 ********************************************************************/
675 void init_rpc_hdr_auth(RPC_HDR_AUTH *rai,
676 uint8 auth_type, uint8 auth_level,
678 uint32 auth_context_id)
680 rai->auth_type = auth_type;
681 rai->auth_level = auth_level;
682 rai->auth_pad_len = auth_pad_len;
683 rai->auth_reserved = 0;
684 rai->auth_context_id = auth_context_id;
687 /*******************************************************************
688 Reads or writes an RPC_HDR_AUTH structure.
689 ********************************************************************/
691 bool smb_io_rpc_hdr_auth(const char *desc, RPC_HDR_AUTH *rai, prs_struct *ps, int depth)
696 prs_debug(ps, depth, desc, "smb_io_rpc_hdr_auth");
702 if(!prs_uint8 ("auth_type ", ps, depth, &rai->auth_type))
704 if(!prs_uint8 ("auth_level ", ps, depth, &rai->auth_level))
706 if(!prs_uint8 ("auth_pad_len ", ps, depth, &rai->auth_pad_len))
708 if(!prs_uint8 ("auth_reserved", ps, depth, &rai->auth_reserved))
710 if(!prs_uint32("auth_context_id", ps, depth, &rai->auth_context_id))
716 /*******************************************************************
717 Checks an RPC_AUTH_VERIFIER structure.
718 ********************************************************************/
720 bool rpc_auth_verifier_chk(RPC_AUTH_VERIFIER *rav,
721 const char *signature, uint32 msg_type)
723 return (strequal(rav->signature, signature) && rav->msg_type == msg_type);
726 /*******************************************************************
727 Inits an RPC_AUTH_VERIFIER structure.
728 ********************************************************************/
730 void init_rpc_auth_verifier(RPC_AUTH_VERIFIER *rav,
731 const char *signature, uint32 msg_type)
733 fstrcpy(rav->signature, signature); /* "NTLMSSP" */
734 rav->msg_type = msg_type; /* NTLMSSP_MESSAGE_TYPE */
737 /*******************************************************************
738 Reads or writes an RPC_AUTH_VERIFIER structure.
739 ********************************************************************/
741 bool smb_io_rpc_auth_verifier(const char *desc, RPC_AUTH_VERIFIER *rav, prs_struct *ps, int depth)
746 prs_debug(ps, depth, desc, "smb_io_rpc_auth_verifier");
750 if(!prs_string("signature", ps, depth, rav->signature,
751 sizeof(rav->signature)))
753 if(!prs_uint32("msg_type ", ps, depth, &rav->msg_type)) /* NTLMSSP_MESSAGE_TYPE */
759 /*******************************************************************
760 This parses an RPC_AUTH_VERIFIER for schannel. I think
761 ********************************************************************/
763 bool smb_io_rpc_schannel_verifier(const char *desc, RPC_AUTH_VERIFIER *rav, prs_struct *ps, int depth)
768 prs_debug(ps, depth, desc, "smb_io_rpc_schannel_verifier");
771 if(!prs_string("signature", ps, depth, rav->signature, sizeof(rav->signature)))
773 if(!prs_uint32("msg_type ", ps, depth, &rav->msg_type))
779 /*******************************************************************
780 creates an RPC_AUTH_SCHANNEL_NEG structure.
781 ********************************************************************/
783 void init_rpc_auth_schannel_neg(RPC_AUTH_SCHANNEL_NEG *neg,
784 const char *domain, const char *myname)
788 fstrcpy(neg->domain, domain);
789 fstrcpy(neg->myname, myname);
792 /*******************************************************************
793 Reads or writes an RPC_AUTH_SCHANNEL_NEG structure.
794 ********************************************************************/
796 bool smb_io_rpc_auth_schannel_neg(const char *desc, RPC_AUTH_SCHANNEL_NEG *neg,
797 prs_struct *ps, int depth)
802 prs_debug(ps, depth, desc, "smb_io_rpc_auth_schannel_neg");
808 if(!prs_uint32("type1", ps, depth, &neg->type1))
810 if(!prs_uint32("type2", ps, depth, &neg->type2))
812 if(!prs_string("domain ", ps, depth, neg->domain, sizeof(neg->domain)))
814 if(!prs_string("myname ", ps, depth, neg->myname, sizeof(neg->myname)))
820 /*******************************************************************
821 reads or writes an RPC_AUTH_SCHANNEL_CHK structure.
822 ********************************************************************/
824 bool smb_io_rpc_auth_schannel_chk(const char *desc, int auth_len,
825 RPC_AUTH_SCHANNEL_CHK * chk,
826 prs_struct *ps, int depth)
831 prs_debug(ps, depth, desc, "smb_io_rpc_auth_schannel_chk");
834 if ( !prs_uint8s(False, "sig ", ps, depth, chk->sig, sizeof(chk->sig)) )
837 if ( !prs_uint8s(False, "seq_num", ps, depth, chk->seq_num, sizeof(chk->seq_num)) )
840 if ( !prs_uint8s(False, "packet_digest", ps, depth, chk->packet_digest, sizeof(chk->packet_digest)) )
843 if ( auth_len == RPC_AUTH_SCHANNEL_SIGN_OR_SEAL_CHK_LEN ) {
844 if ( !prs_uint8s(False, "confounder", ps, depth, chk->confounder, sizeof(chk->confounder)) )