2 Unix SMB/CIFS implementation.
4 Copyright (C) Tim Potter 2000-2001,
5 Copyright (C) Andrew Tridgell 1992-1997,2000,
6 Copyright (C) Luke Kenneth Casson Leighton 1996-1997,2000,
7 Copyright (C) Paul Ashton 1997,2000,
8 Copyright (C) Elrond 2000,
9 Copyright (C) Rafal Szczesniak 2002
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 /** @defgroup lsa LSA - Local Security Architecture
37 * RPC client routines for the LSA RPC pipe. LSA means "local
38 * security authority", which is half of a password database.
41 /** Open a LSA policy handle
43 * @param cli Handle on an initialised SMB connection */
45 NTSTATUS
cli_lsa_open_policy(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
46 BOOL sec_qos
, uint32 des_access
, POLICY_HND
*pol
)
48 prs_struct qbuf
, rbuf
;
57 /* Initialise parse structures */
59 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
60 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
62 /* Initialise input parameters */
65 init_lsa_sec_qos(&qos
, 2, 1, 0);
66 init_q_open_pol(&q
, '\\', 0, des_access
, &qos
);
68 init_q_open_pol(&q
, '\\', 0, des_access
, NULL
);
71 /* Marshall data and send request */
73 if (!lsa_io_q_open_pol("", &q
, &qbuf
, 0) ||
74 !rpc_api_pipe_req(cli
, LSA_OPENPOLICY
, &qbuf
, &rbuf
)) {
75 result
= NT_STATUS_UNSUCCESSFUL
;
79 /* Unmarshall response */
81 if (!lsa_io_r_open_pol("", &r
, &rbuf
, 0)) {
82 result
= NT_STATUS_UNSUCCESSFUL
;
86 /* Return output parameters */
88 if (NT_STATUS_IS_OK(result
= r
.status
)) {
91 pol
->marker
= malloc(1);
102 /** Open a LSA policy handle
104 * @param cli Handle on an initialised SMB connection
107 NTSTATUS
cli_lsa_open_policy2(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
108 BOOL sec_qos
, uint32 des_access
, POLICY_HND
*pol
)
110 prs_struct qbuf
, rbuf
;
119 /* Initialise parse structures */
121 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
122 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
124 /* Initialise input parameters */
127 init_lsa_sec_qos(&qos
, 2, 1, 0);
128 init_q_open_pol2(&q
, cli
->srv_name_slash
, 0, des_access
,
131 init_q_open_pol2(&q
, cli
->srv_name_slash
, 0, des_access
,
135 /* Marshall data and send request */
137 if (!lsa_io_q_open_pol2("", &q
, &qbuf
, 0) ||
138 !rpc_api_pipe_req(cli
, LSA_OPENPOLICY2
, &qbuf
, &rbuf
)) {
139 result
= NT_STATUS_UNSUCCESSFUL
;
143 /* Unmarshall response */
145 if (!lsa_io_r_open_pol2("", &r
, &rbuf
, 0)) {
146 result
= NT_STATUS_UNSUCCESSFUL
;
150 /* Return output parameters */
152 if (NT_STATUS_IS_OK(result
= r
.status
)) {
155 pol
->marker
= (char *)malloc(1);
166 /** Close a LSA policy handle */
168 NTSTATUS
cli_lsa_close(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
171 prs_struct qbuf
, rbuf
;
179 /* Initialise parse structures */
181 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
182 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
184 /* Marshall data and send request */
186 init_lsa_q_close(&q
, pol
);
188 if (!lsa_io_q_close("", &q
, &qbuf
, 0) ||
189 !rpc_api_pipe_req(cli
, LSA_CLOSE
, &qbuf
, &rbuf
)) {
190 result
= NT_STATUS_UNSUCCESSFUL
;
194 /* Unmarshall response */
196 if (!lsa_io_r_close("", &r
, &rbuf
, 0)) {
197 result
= NT_STATUS_UNSUCCESSFUL
;
201 /* Return output parameters */
203 if (NT_STATUS_IS_OK(result
= r
.status
)) {
205 SAFE_FREE(pol
->marker
);
217 /** Lookup a list of sids */
219 NTSTATUS
cli_lsa_lookup_sids(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
220 POLICY_HND
*pol
, int num_sids
, DOM_SID
*sids
,
221 char ***domains
, char ***names
, uint32
**types
)
223 prs_struct qbuf
, rbuf
;
227 LSA_TRANS_NAME_ENUM t_names
;
234 /* Initialise parse structures */
236 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
237 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
239 /* Marshall data and send request */
241 init_q_lookup_sids(mem_ctx
, &q
, pol
, num_sids
, sids
, 1);
243 if (!lsa_io_q_lookup_sids("", &q
, &qbuf
, 0) ||
244 !rpc_api_pipe_req(cli
, LSA_LOOKUPSIDS
, &qbuf
, &rbuf
)) {
245 result
= NT_STATUS_UNSUCCESSFUL
;
249 /* Unmarshall response */
252 ZERO_STRUCT(t_names
);
257 if (!lsa_io_r_lookup_sids("", &r
, &rbuf
, 0)) {
258 result
= NT_STATUS_UNSUCCESSFUL
;
264 if (!NT_STATUS_IS_OK(result
) &&
265 NT_STATUS_V(result
) != NT_STATUS_V(STATUS_SOME_UNMAPPED
)) {
267 /* An actual error occured */
272 /* Return output parameters */
274 if (r
.mapped_count
== 0) {
275 result
= NT_STATUS_NONE_MAPPED
;
279 if (!((*domains
) = (char **)talloc(mem_ctx
, sizeof(char *) *
281 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
282 result
= NT_STATUS_UNSUCCESSFUL
;
286 if (!((*names
) = (char **)talloc(mem_ctx
, sizeof(char *) *
288 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
289 result
= NT_STATUS_UNSUCCESSFUL
;
293 if (!((*types
) = (uint32
*)talloc(mem_ctx
, sizeof(uint32
) *
295 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
296 result
= NT_STATUS_UNSUCCESSFUL
;
300 for (i
= 0; i
< num_sids
; i
++) {
301 fstring name
, dom_name
;
302 uint32 dom_idx
= t_names
.name
[i
].domain_idx
;
304 /* Translate optimised name through domain index array */
306 if (dom_idx
!= 0xffffffff) {
308 rpcstr_pull_unistr2_fstring(
309 dom_name
, &ref
.ref_dom
[dom_idx
].uni_dom_name
);
310 rpcstr_pull_unistr2_fstring(
311 name
, &t_names
.uni_name
[i
]);
313 (*names
)[i
] = talloc_strdup(mem_ctx
, name
);
314 (*domains
)[i
] = talloc_strdup(mem_ctx
, dom_name
);
315 (*types
)[i
] = t_names
.name
[i
].sid_name_use
;
317 if (((*names
)[i
] == NULL
) || ((*domains
)[i
] == NULL
)) {
318 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
319 result
= NT_STATUS_UNSUCCESSFUL
;
325 (*domains
)[i
] = NULL
;
326 (*types
)[i
] = SID_NAME_UNKNOWN
;
337 /** Lookup a list of names */
339 NTSTATUS
cli_lsa_lookup_names(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
340 POLICY_HND
*pol
, int num_names
,
341 const char **names
, DOM_SID
**sids
,
344 prs_struct qbuf
, rbuf
;
345 LSA_Q_LOOKUP_NAMES q
;
346 LSA_R_LOOKUP_NAMES r
;
354 /* Initialise parse structures */
356 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
357 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
359 /* Marshall data and send request */
361 init_q_lookup_names(mem_ctx
, &q
, pol
, num_names
, names
);
363 if (!lsa_io_q_lookup_names("", &q
, &qbuf
, 0) ||
364 !rpc_api_pipe_req(cli
, LSA_LOOKUPNAMES
, &qbuf
, &rbuf
)) {
365 result
= NT_STATUS_UNSUCCESSFUL
;
369 /* Unmarshall response */
374 if (!lsa_io_r_lookup_names("", &r
, &rbuf
, 0)) {
375 result
= NT_STATUS_UNSUCCESSFUL
;
381 if (!NT_STATUS_IS_OK(result
) && NT_STATUS_V(result
) !=
382 NT_STATUS_V(STATUS_SOME_UNMAPPED
)) {
384 /* An actual error occured */
389 /* Return output parameters */
391 if (r
.mapped_count
== 0) {
392 result
= NT_STATUS_NONE_MAPPED
;
396 if (!((*sids
= (DOM_SID
*)talloc(mem_ctx
, sizeof(DOM_SID
) *
398 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
399 result
= NT_STATUS_UNSUCCESSFUL
;
403 if (!((*types
= (uint32
*)talloc(mem_ctx
, sizeof(uint32
) *
405 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
406 result
= NT_STATUS_UNSUCCESSFUL
;
410 for (i
= 0; i
< num_names
; i
++) {
411 DOM_RID2
*t_rids
= r
.dom_rid
;
412 uint32 dom_idx
= t_rids
[i
].rid_idx
;
413 uint32 dom_rid
= t_rids
[i
].rid
;
414 DOM_SID
*sid
= &(*sids
)[i
];
416 /* Translate optimised sid through domain index array */
418 if (dom_idx
!= 0xffffffff) {
420 sid_copy(sid
, &ref
.ref_dom
[dom_idx
].ref_dom
.sid
);
422 if (dom_rid
!= 0xffffffff) {
423 sid_append_rid(sid
, dom_rid
);
426 (*types
)[i
] = t_rids
[i
].type
;
429 (*types
)[i
] = SID_NAME_UNKNOWN
;
440 /** Query info policy
442 * @param domain_sid - returned remote server's domain sid */
444 NTSTATUS
cli_lsa_query_info_policy(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
445 POLICY_HND
*pol
, uint16 info_class
,
446 fstring domain_name
, DOM_SID
*domain_sid
)
448 prs_struct qbuf
, rbuf
;
456 /* Initialise parse structures */
458 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
459 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
461 /* Marshall data and send request */
463 init_q_query(&q
, pol
, info_class
);
465 if (!lsa_io_q_query("", &q
, &qbuf
, 0) ||
466 !rpc_api_pipe_req(cli
, LSA_QUERYINFOPOLICY
, &qbuf
, &rbuf
)) {
467 result
= NT_STATUS_UNSUCCESSFUL
;
471 /* Unmarshall response */
473 if (!lsa_io_r_query("", &r
, &rbuf
, 0)) {
474 result
= NT_STATUS_UNSUCCESSFUL
;
478 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
482 /* Return output parameters */
484 ZERO_STRUCTP(domain_sid
);
485 domain_name
[0] = '\0';
487 switch (info_class
) {
490 if (r
.dom
.id3
.buffer_dom_name
!= 0) {
491 unistr2_to_ascii(domain_name
,
494 sizeof (fstring
) - 1);
497 if (r
.dom
.id3
.buffer_dom_sid
!= 0) {
498 *domain_sid
= r
.dom
.id3
.dom_sid
.sid
;
505 if (r
.dom
.id5
.buffer_dom_name
!= 0) {
506 unistr2_to_ascii(domain_name
, &r
.dom
.id5
.
508 sizeof (fstring
) - 1);
511 if (r
.dom
.id5
.buffer_dom_sid
!= 0) {
512 *domain_sid
= r
.dom
.id5
.dom_sid
.sid
;
518 DEBUG(3, ("unknown info class %d\n", info_class
));
529 /** Query info policy2
531 * @param domain_name - returned remote server's domain name
532 * @param dns_name - returned remote server's dns domain name
533 * @param forest_name - returned remote server's forest name
534 * @param domain_guid - returned remote server's domain guid
535 * @param domain_sid - returned remote server's domain sid */
537 NTSTATUS
cli_lsa_query_info_policy2(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
538 POLICY_HND
*pol
, uint16 info_class
,
539 fstring domain_name
, fstring dns_name
,
540 fstring forest_name
, GUID
*domain_guid
,
543 prs_struct qbuf
, rbuf
;
546 NTSTATUS result
= NT_STATUS_UNSUCCESSFUL
;
548 if (info_class
!= 12)
554 /* Initialise parse structures */
556 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
557 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
559 /* Marshall data and send request */
561 init_q_query2(&q
, pol
, info_class
);
563 if (!lsa_io_q_query_info2("", &q
, &qbuf
, 0) ||
564 !rpc_api_pipe_req(cli
, LSA_QUERYINFO2
, &qbuf
, &rbuf
)) {
565 result
= NT_STATUS_UNSUCCESSFUL
;
569 /* Unmarshall response */
571 if (!lsa_io_r_query_info2("", &r
, &rbuf
, 0)) {
572 result
= NT_STATUS_UNSUCCESSFUL
;
576 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
580 /* Return output parameters */
582 ZERO_STRUCTP(domain_sid
);
583 ZERO_STRUCTP(domain_guid
);
584 domain_name
[0] = '\0';
586 if (r
.info
.dns_dom_info
.hdr_nb_dom_name
.buffer
) {
587 unistr2_to_ascii(domain_name
,
588 &r
.info
.dns_dom_info
.uni_nb_dom_name
,
589 sizeof(fstring
) - 1);
591 if (r
.info
.dns_dom_info
.hdr_dns_dom_name
.buffer
) {
592 unistr2_to_ascii(dns_name
,
593 &r
.info
.dns_dom_info
.uni_dns_dom_name
,
594 sizeof(fstring
) - 1);
596 if (r
.info
.dns_dom_info
.hdr_forest_name
.buffer
) {
597 unistr2_to_ascii(forest_name
,
598 &r
.info
.dns_dom_info
.uni_forest_name
,
599 sizeof(fstring
) - 1);
602 memcpy(domain_guid
, &r
.info
.dns_dom_info
.dom_guid
, sizeof(GUID
));
604 if (r
.info
.dns_dom_info
.ptr_dom_sid
!= 0) {
605 *domain_sid
= r
.info
.dns_dom_info
.dom_sid
.sid
;
616 * Enumerate list of trusted domains
618 * @param cli client state (cli_state) structure of the connection
619 * @param mem_ctx memory context
620 * @param pol opened lsa policy handle
621 * @param enum_ctx enumeration context ie. index of first returned domain entry
622 * @param pref_num_domains preferred max number of entries returned in one response
623 * @param num_domains total number of trusted domains returned by response
624 * @param domain_names returned trusted domain names
625 * @param domain_sids returned trusted domain sids
627 * @return nt status code of response
630 NTSTATUS
cli_lsa_enum_trust_dom(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
631 POLICY_HND
*pol
, uint32
*enum_ctx
,
633 char ***domain_names
, DOM_SID
**domain_sids
)
635 prs_struct qbuf
, rbuf
;
636 LSA_Q_ENUM_TRUST_DOM q
;
637 LSA_R_ENUM_TRUST_DOM r
;
644 /* Initialise parse structures */
646 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
647 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
649 /* Marshall data and send request */
651 /* 64k is enough for about 2000 trusted domains */
652 init_q_enum_trust_dom(&q
, pol
, *enum_ctx
, 0x10000);
654 if (!lsa_io_q_enum_trust_dom("", &q
, &qbuf
, 0) ||
655 !rpc_api_pipe_req(cli
, LSA_ENUMTRUSTDOM
, &qbuf
, &rbuf
)) {
656 result
= NT_STATUS_UNSUCCESSFUL
;
660 /* Unmarshall response */
662 if (!lsa_io_r_enum_trust_dom("", &r
, &rbuf
, 0)) {
663 result
= NT_STATUS_UNSUCCESSFUL
;
669 if (!NT_STATUS_IS_OK(result
) &&
670 !NT_STATUS_EQUAL(result
, NT_STATUS_NO_MORE_ENTRIES
) &&
671 !NT_STATUS_EQUAL(result
, STATUS_MORE_ENTRIES
)) {
673 /* An actual error ocured */
678 /* Return output parameters */
682 /* Allocate memory for trusted domain names and sids */
684 *domain_names
= (char **)talloc(mem_ctx
, sizeof(char *) *
687 if (!*domain_names
) {
688 DEBUG(0, ("cli_lsa_enum_trust_dom(): out of memory\n"));
689 result
= NT_STATUS_NO_MEMORY
;
693 *domain_sids
= (DOM_SID
*)talloc(mem_ctx
, sizeof(DOM_SID
) *
696 DEBUG(0, ("cli_lsa_enum_trust_dom(): out of memory\n"));
697 result
= NT_STATUS_NO_MEMORY
;
701 /* Copy across names and sids */
703 for (i
= 0; i
< r
.num_domains
; i
++) {
706 unistr2_to_ascii(tmp
, &r
.uni_domain_name
[i
],
708 (*domain_names
)[i
] = talloc_strdup(mem_ctx
, tmp
);
709 sid_copy(&(*domain_sids
)[i
], &r
.domain_sid
[i
].sid
);
713 *num_domains
= r
.num_domains
;
714 *enum_ctx
= r
.enum_context
;
724 /** Enumerate privileges*/
726 NTSTATUS
cli_lsa_enum_privilege(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
727 POLICY_HND
*pol
, uint32
*enum_context
, uint32 pref_max_length
,
728 uint32
*count
, char ***privs_name
, uint32
**privs_high
, uint32
**privs_low
)
730 prs_struct qbuf
, rbuf
;
739 /* Initialise parse structures */
741 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
742 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
744 /* Marshall data and send request */
746 init_q_enum_privs(&q
, pol
, *enum_context
, pref_max_length
);
748 if (!lsa_io_q_enum_privs("", &q
, &qbuf
, 0) ||
749 !rpc_api_pipe_req(cli
, LSA_ENUM_PRIVS
, &qbuf
, &rbuf
)) {
750 result
= NT_STATUS_UNSUCCESSFUL
;
754 /* Unmarshall response */
756 if (!lsa_io_r_enum_privs("", &r
, &rbuf
, 0)) {
757 result
= NT_STATUS_UNSUCCESSFUL
;
761 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
765 /* Return output parameters */
767 *enum_context
= r
.enum_context
;
770 if (!((*privs_name
= (char **)talloc(mem_ctx
, sizeof(char *) * r
.count
)))) {
771 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
772 result
= NT_STATUS_UNSUCCESSFUL
;
776 if (!((*privs_high
= (uint32
*)talloc(mem_ctx
, sizeof(uint32
) * r
.count
)))) {
777 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
778 result
= NT_STATUS_UNSUCCESSFUL
;
782 if (!((*privs_low
= (uint32
*)talloc(mem_ctx
, sizeof(uint32
) * r
.count
)))) {
783 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
784 result
= NT_STATUS_UNSUCCESSFUL
;
788 for (i
= 0; i
< r
.count
; i
++) {
791 rpcstr_pull_unistr2_fstring( name
, &r
.privs
[i
].name
);
793 (*privs_name
)[i
] = talloc_strdup(mem_ctx
, name
);
795 (*privs_high
)[i
] = r
.privs
[i
].luid_high
;
796 (*privs_low
)[i
] = r
.privs
[i
].luid_low
;
806 /** Get privilege name */
808 NTSTATUS
cli_lsa_get_dispname(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
809 POLICY_HND
*pol
, const char *name
,
810 uint16 lang_id
, uint16 lang_id_sys
,
811 fstring description
, uint16
*lang_id_desc
)
813 prs_struct qbuf
, rbuf
;
814 LSA_Q_PRIV_GET_DISPNAME q
;
815 LSA_R_PRIV_GET_DISPNAME r
;
821 /* Initialise parse structures */
823 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
824 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
826 /* Marshall data and send request */
828 init_lsa_priv_get_dispname(&q
, pol
, name
, lang_id
, lang_id_sys
);
830 if (!lsa_io_q_priv_get_dispname("", &q
, &qbuf
, 0) ||
831 !rpc_api_pipe_req(cli
, LSA_PRIV_GET_DISPNAME
, &qbuf
, &rbuf
)) {
832 result
= NT_STATUS_UNSUCCESSFUL
;
836 /* Unmarshall response */
838 if (!lsa_io_r_priv_get_dispname("", &r
, &rbuf
, 0)) {
839 result
= NT_STATUS_UNSUCCESSFUL
;
843 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
847 /* Return output parameters */
849 rpcstr_pull_unistr2_fstring(description
, &r
.desc
);
850 *lang_id_desc
= r
.lang_id
;
859 /** Enumerate list of SIDs */
861 NTSTATUS
cli_lsa_enum_sids(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
862 POLICY_HND
*pol
, uint32
*enum_ctx
, uint32 pref_max_length
,
863 uint32
*num_sids
, DOM_SID
**sids
)
865 prs_struct qbuf
, rbuf
;
866 LSA_Q_ENUM_ACCOUNTS q
;
867 LSA_R_ENUM_ACCOUNTS r
;
874 /* Initialise parse structures */
876 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
877 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
879 /* Marshall data and send request */
881 init_lsa_q_enum_accounts(&q
, pol
, *enum_ctx
, pref_max_length
);
883 if (!lsa_io_q_enum_accounts("", &q
, &qbuf
, 0) ||
884 !rpc_api_pipe_req(cli
, LSA_ENUM_ACCOUNTS
, &qbuf
, &rbuf
)) {
885 result
= NT_STATUS_UNSUCCESSFUL
;
889 /* Unmarshall response */
891 if (!lsa_io_r_enum_accounts("", &r
, &rbuf
, 0)) {
892 result
= NT_STATUS_UNSUCCESSFUL
;
898 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
902 if (r
.sids
.num_entries
==0)
905 /* Return output parameters */
907 *sids
= (DOM_SID
*)talloc(mem_ctx
, sizeof(DOM_SID
) * r
.sids
.num_entries
);
909 DEBUG(0, ("(cli_lsa_enum_sids): out of memory\n"));
910 result
= NT_STATUS_UNSUCCESSFUL
;
914 /* Copy across names and sids */
916 for (i
= 0; i
< r
.sids
.num_entries
; i
++) {
917 sid_copy(&(*sids
)[i
], &r
.sids
.sid
[i
].sid
);
920 *num_sids
= r
.sids
.num_entries
;
921 *enum_ctx
= r
.enum_context
;
930 /** Open a LSA user handle
932 * @param cli Handle on an initialised SMB connection */
934 NTSTATUS
cli_lsa_open_account(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
935 POLICY_HND
*dom_pol
, DOM_SID
*sid
, uint32 des_access
,
936 POLICY_HND
*user_pol
)
938 prs_struct qbuf
, rbuf
;
946 /* Initialise parse structures */
948 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
949 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
951 /* Initialise input parameters */
953 init_lsa_q_open_account(&q
, dom_pol
, sid
, des_access
);
955 /* Marshall data and send request */
957 if (!lsa_io_q_open_account("", &q
, &qbuf
, 0) ||
958 !rpc_api_pipe_req(cli
, LSA_OPENACCOUNT
, &qbuf
, &rbuf
)) {
959 result
= NT_STATUS_UNSUCCESSFUL
;
963 /* Unmarshall response */
965 if (!lsa_io_r_open_account("", &r
, &rbuf
, 0)) {
966 result
= NT_STATUS_UNSUCCESSFUL
;
970 /* Return output parameters */
972 if (NT_STATUS_IS_OK(result
= r
.status
)) {
983 /** Enumerate user privileges
985 * @param cli Handle on an initialised SMB connection */
987 NTSTATUS
cli_lsa_enum_privsaccount(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
988 POLICY_HND
*pol
, uint32
*count
, LUID_ATTR
**set
)
990 prs_struct qbuf
, rbuf
;
991 LSA_Q_ENUMPRIVSACCOUNT q
;
992 LSA_R_ENUMPRIVSACCOUNT r
;
999 /* Initialise parse structures */
1001 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1002 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1004 /* Initialise input parameters */
1006 init_lsa_q_enum_privsaccount(&q
, pol
);
1008 /* Marshall data and send request */
1010 if (!lsa_io_q_enum_privsaccount("", &q
, &qbuf
, 0) ||
1011 !rpc_api_pipe_req(cli
, LSA_ENUMPRIVSACCOUNT
, &qbuf
, &rbuf
)) {
1012 result
= NT_STATUS_UNSUCCESSFUL
;
1016 /* Unmarshall response */
1018 if (!lsa_io_r_enum_privsaccount("", &r
, &rbuf
, 0)) {
1019 result
= NT_STATUS_UNSUCCESSFUL
;
1023 /* Return output parameters */
1025 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1032 if (!((*set
= (LUID_ATTR
*)talloc(mem_ctx
, sizeof(LUID_ATTR
) * r
.count
)))) {
1033 DEBUG(0, ("(cli_lsa_enum_privsaccount): out of memory\n"));
1034 result
= NT_STATUS_UNSUCCESSFUL
;
1038 for (i
=0; i
<r
.count
; i
++) {
1039 (*set
)[i
].luid
.low
= r
.set
->set
[i
].luid
.low
;
1040 (*set
)[i
].luid
.high
= r
.set
->set
[i
].luid
.high
;
1041 (*set
)[i
].attr
= r
.set
->set
[i
].attr
;
1046 prs_mem_free(&qbuf
);
1047 prs_mem_free(&rbuf
);
1052 /** Get a privilege value given its name */
1054 NTSTATUS
cli_lsa_lookupprivvalue(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
1055 POLICY_HND
*pol
, const char *name
, LUID
*luid
)
1057 prs_struct qbuf
, rbuf
;
1058 LSA_Q_LOOKUPPRIVVALUE q
;
1059 LSA_R_LOOKUPPRIVVALUE r
;
1065 /* Initialise parse structures */
1067 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1068 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1070 /* Marshall data and send request */
1072 init_lsa_q_lookupprivvalue(&q
, pol
, name
);
1074 if (!lsa_io_q_lookupprivvalue("", &q
, &qbuf
, 0) ||
1075 !rpc_api_pipe_req(cli
, LSA_LOOKUPPRIVVALUE
, &qbuf
, &rbuf
)) {
1076 result
= NT_STATUS_UNSUCCESSFUL
;
1080 /* Unmarshall response */
1082 if (!lsa_io_r_lookupprivvalue("", &r
, &rbuf
, 0)) {
1083 result
= NT_STATUS_UNSUCCESSFUL
;
1087 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1091 /* Return output parameters */
1093 (*luid
).low
=r
.luid
.low
;
1094 (*luid
).high
=r
.luid
.high
;
1097 prs_mem_free(&qbuf
);
1098 prs_mem_free(&rbuf
);
1103 /** Query LSA security object */
1105 NTSTATUS
cli_lsa_query_secobj(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
1106 POLICY_HND
*pol
, uint32 sec_info
,
1107 SEC_DESC_BUF
**psdb
)
1109 prs_struct qbuf
, rbuf
;
1110 LSA_Q_QUERY_SEC_OBJ q
;
1111 LSA_R_QUERY_SEC_OBJ r
;
1117 /* Initialise parse structures */
1119 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1120 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1122 /* Marshall data and send request */
1124 init_q_query_sec_obj(&q
, pol
, sec_info
);
1126 if (!lsa_io_q_query_sec_obj("", &q
, &qbuf
, 0) ||
1127 !rpc_api_pipe_req(cli
, LSA_QUERYSECOBJ
, &qbuf
, &rbuf
)) {
1128 result
= NT_STATUS_UNSUCCESSFUL
;
1132 /* Unmarshall response */
1134 if (!lsa_io_r_query_sec_obj("", &r
, &rbuf
, 0)) {
1135 result
= NT_STATUS_UNSUCCESSFUL
;
1139 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1143 /* Return output parameters */
1149 prs_mem_free(&qbuf
);
1150 prs_mem_free(&rbuf
);
1156 /* Enumerate account rights This is similar to enum_privileges but
1157 takes a SID directly, avoiding the open_account call.
1160 NTSTATUS
cli_lsa_enum_account_rights(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
1161 POLICY_HND
*pol
, DOM_SID sid
,
1162 uint32
*count
, char ***privs_name
)
1164 prs_struct qbuf
, rbuf
;
1165 LSA_Q_ENUM_ACCT_RIGHTS q
;
1166 LSA_R_ENUM_ACCT_RIGHTS r
;
1173 /* Initialise parse structures */
1175 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1176 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1178 /* Marshall data and send request */
1179 init_q_enum_acct_rights(&q
, pol
, 2, &sid
);
1181 if (!lsa_io_q_enum_acct_rights("", &q
, &qbuf
, 0) ||
1182 !rpc_api_pipe_req(cli
, LSA_ENUMACCTRIGHTS
, &qbuf
, &rbuf
)) {
1183 result
= NT_STATUS_UNSUCCESSFUL
;
1187 if (!lsa_io_r_enum_acct_rights("", &r
, &rbuf
, 0)) {
1188 result
= NT_STATUS_UNSUCCESSFUL
;
1192 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1201 *privs_name
= (char **)talloc(mem_ctx
, (*count
) * sizeof(char **));
1202 for (i
=0;i
<*count
;i
++) {
1203 pull_ucs2_talloc(mem_ctx
, &(*privs_name
)[i
], r
.rights
.strings
[i
].string
.buffer
);
1213 /* add account rights to an account. */
1215 NTSTATUS
cli_lsa_add_account_rights(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
1216 POLICY_HND
*pol
, DOM_SID sid
,
1217 uint32 count
, const char **privs_name
)
1219 prs_struct qbuf
, rbuf
;
1220 LSA_Q_ADD_ACCT_RIGHTS q
;
1221 LSA_R_ADD_ACCT_RIGHTS r
;
1226 /* Initialise parse structures */
1227 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1228 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1230 /* Marshall data and send request */
1231 init_q_add_acct_rights(&q
, pol
, &sid
, count
, privs_name
);
1233 if (!lsa_io_q_add_acct_rights("", &q
, &qbuf
, 0) ||
1234 !rpc_api_pipe_req(cli
, LSA_ADDACCTRIGHTS
, &qbuf
, &rbuf
)) {
1235 result
= NT_STATUS_UNSUCCESSFUL
;
1239 /* Unmarshall response */
1241 if (!lsa_io_r_add_acct_rights("", &r
, &rbuf
, 0)) {
1242 result
= NT_STATUS_UNSUCCESSFUL
;
1246 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1255 /* remove account rights for an account. */
1257 NTSTATUS
cli_lsa_remove_account_rights(struct cli_state
*cli
, TALLOC_CTX
*mem_ctx
,
1258 POLICY_HND
*pol
, DOM_SID sid
, BOOL removeall
,
1259 uint32 count
, const char **privs_name
)
1261 prs_struct qbuf
, rbuf
;
1262 LSA_Q_REMOVE_ACCT_RIGHTS q
;
1263 LSA_R_REMOVE_ACCT_RIGHTS r
;
1268 /* Initialise parse structures */
1269 prs_init(&qbuf
, MAX_PDU_FRAG_LEN
, mem_ctx
, MARSHALL
);
1270 prs_init(&rbuf
, 0, mem_ctx
, UNMARSHALL
);
1272 /* Marshall data and send request */
1273 init_q_remove_acct_rights(&q
, pol
, &sid
, removeall
?1:0, count
, privs_name
);
1275 if (!lsa_io_q_remove_acct_rights("", &q
, &qbuf
, 0) ||
1276 !rpc_api_pipe_req(cli
, LSA_REMOVEACCTRIGHTS
, &qbuf
, &rbuf
)) {
1277 result
= NT_STATUS_UNSUCCESSFUL
;
1281 /* Unmarshall response */
1283 if (!lsa_io_r_remove_acct_rights("", &r
, &rbuf
, 0)) {
1284 result
= NT_STATUS_UNSUCCESSFUL
;
1288 if (!NT_STATUS_IS_OK(result
= r
.status
)) {
1299 /** An example of how to use the routines in this file. Fetch a DOMAIN
1300 sid. Does complete cli setup / teardown anonymously. */
1302 BOOL
fetch_domain_sid( char *domain
, char *remote_machine
, DOM_SID
*psid
)
1304 extern pstring global_myname
;
1305 struct cli_state cli
;
1311 if(cli_initialise(&cli
) == False
) {
1312 DEBUG(0,("fetch_domain_sid: unable to initialize client connection.\n"));
1316 if(!resolve_name( remote_machine
, &cli
.dest_ip
, 0x20)) {
1317 DEBUG(0,("fetch_domain_sid: Can't resolve address for %s\n", remote_machine
));
1321 if (!cli_connect(&cli
, remote_machine
, &cli
.dest_ip
)) {
1322 DEBUG(0,("fetch_domain_sid: unable to connect to SMB server on \
1323 machine %s. Error was : %s.\n", remote_machine
, cli_errstr(&cli
) ));
1327 if (!attempt_netbios_session_request(&cli
, global_myname
, remote_machine
, &cli
.dest_ip
)) {
1328 DEBUG(0,("fetch_domain_sid: machine %s rejected the NetBIOS session request.\n",
1333 cli
.protocol
= PROTOCOL_NT1
;
1335 if (!cli_negprot(&cli
)) {
1336 DEBUG(0,("fetch_domain_sid: machine %s rejected the negotiate protocol. \
1337 Error was : %s.\n", remote_machine
, cli_errstr(&cli
) ));
1341 if (cli
.protocol
!= PROTOCOL_NT1
) {
1342 DEBUG(0,("fetch_domain_sid: machine %s didn't negotiate NT protocol.\n",
1348 * Do an anonymous session setup.
1351 if (!cli_session_setup(&cli
, "", "", 0, "", 0, "")) {
1352 DEBUG(0,("fetch_domain_sid: machine %s rejected the session setup. \
1353 Error was : %s.\n", remote_machine
, cli_errstr(&cli
) ));
1357 if (!(cli
.sec_mode
& NEGOTIATE_SECURITY_USER_LEVEL
)) {
1358 DEBUG(0,("fetch_domain_sid: machine %s isn't in user level security mode\n",
1363 if (!cli_send_tconX(&cli
, "IPC$", "IPC", "", 1)) {
1364 DEBUG(0,("fetch_domain_sid: machine %s rejected the tconX on the IPC$ share. \
1365 Error was : %s.\n", remote_machine
, cli_errstr(&cli
) ));
1369 /* Fetch domain sid */
1371 if (!cli_nt_session_open(&cli
, PI_LSARPC
)) {
1372 DEBUG(0, ("fetch_domain_sid: Error connecting to SAM pipe\n"));
1376 result
= cli_lsa_open_policy(&cli
, cli
.mem_ctx
, True
, SEC_RIGHTS_QUERY_VALUE
, &lsa_pol
);
1377 if (!NT_STATUS_IS_OK(result
)) {
1378 DEBUG(0, ("fetch_domain_sid: Error opening lsa policy handle. %s\n",
1379 nt_errstr(result
) ));
1383 result
= cli_lsa_query_info_policy(&cli
, cli
.mem_ctx
, &lsa_pol
, 5, domain
, psid
);
1384 if (!NT_STATUS_IS_OK(result
)) {
1385 DEBUG(0, ("fetch_domain_sid: Error querying lsa policy handle. %s\n",
1386 nt_errstr(result
) ));