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 (*types)[i] = SID_NAME_UNKNOWN;
336 /** Lookup a list of names */
338 NTSTATUS cli_lsa_lookup_names(struct cli_state *cli, TALLOC_CTX *mem_ctx,
339 POLICY_HND *pol, int num_names,
340 const char **names, DOM_SID **sids,
343 prs_struct qbuf, rbuf;
344 LSA_Q_LOOKUP_NAMES q;
345 LSA_R_LOOKUP_NAMES r;
353 /* Initialise parse structures */
355 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
356 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
358 /* Marshall data and send request */
360 init_q_lookup_names(mem_ctx, &q, pol, num_names, names);
362 if (!lsa_io_q_lookup_names("", &q, &qbuf, 0) ||
363 !rpc_api_pipe_req(cli, LSA_LOOKUPNAMES, &qbuf, &rbuf)) {
364 result = NT_STATUS_UNSUCCESSFUL;
368 /* Unmarshall response */
373 if (!lsa_io_r_lookup_names("", &r, &rbuf, 0)) {
374 result = NT_STATUS_UNSUCCESSFUL;
380 if (!NT_STATUS_IS_OK(result) && NT_STATUS_V(result) !=
381 NT_STATUS_V(STATUS_SOME_UNMAPPED)) {
383 /* An actual error occured */
388 /* Return output parameters */
390 if (r.mapped_count == 0) {
391 result = NT_STATUS_NONE_MAPPED;
395 if (!((*sids = (DOM_SID *)talloc(mem_ctx, sizeof(DOM_SID) *
397 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
398 result = NT_STATUS_UNSUCCESSFUL;
402 if (!((*types = (uint32 *)talloc(mem_ctx, sizeof(uint32) *
404 DEBUG(0, ("cli_lsa_lookup_sids(): out of memory\n"));
405 result = NT_STATUS_UNSUCCESSFUL;
409 for (i = 0; i < num_names; i++) {
410 DOM_RID2 *t_rids = r.dom_rid;
411 uint32 dom_idx = t_rids[i].rid_idx;
412 uint32 dom_rid = t_rids[i].rid;
413 DOM_SID *sid = &(*sids)[i];
415 /* Translate optimised sid through domain index array */
417 if (dom_idx != 0xffffffff) {
419 sid_copy(sid, &ref.ref_dom[dom_idx].ref_dom.sid);
421 if (dom_rid != 0xffffffff) {
422 sid_append_rid(sid, dom_rid);
425 (*types)[i] = t_rids[i].type;
428 (*types)[i] = SID_NAME_UNKNOWN;
439 /** Query info policy
441 * @param domain_sid - returned remote server's domain sid */
443 NTSTATUS cli_lsa_query_info_policy(struct cli_state *cli, TALLOC_CTX *mem_ctx,
444 POLICY_HND *pol, uint16 info_class,
445 fstring domain_name, DOM_SID *domain_sid)
447 prs_struct qbuf, rbuf;
455 /* Initialise parse structures */
457 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
458 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
460 /* Marshall data and send request */
462 init_q_query(&q, pol, info_class);
464 if (!lsa_io_q_query("", &q, &qbuf, 0) ||
465 !rpc_api_pipe_req(cli, LSA_QUERYINFOPOLICY, &qbuf, &rbuf)) {
466 result = NT_STATUS_UNSUCCESSFUL;
470 /* Unmarshall response */
472 if (!lsa_io_r_query("", &r, &rbuf, 0)) {
473 result = NT_STATUS_UNSUCCESSFUL;
477 if (!NT_STATUS_IS_OK(result = r.status)) {
481 /* Return output parameters */
483 ZERO_STRUCTP(domain_sid);
484 domain_name[0] = '\0';
486 switch (info_class) {
489 if (r.dom.id3.buffer_dom_name != 0) {
490 unistr2_to_ascii(domain_name,
493 sizeof (fstring) - 1);
496 if (r.dom.id3.buffer_dom_sid != 0) {
497 *domain_sid = r.dom.id3.dom_sid.sid;
504 if (r.dom.id5.buffer_dom_name != 0) {
505 unistr2_to_ascii(domain_name, &r.dom.id5.
507 sizeof (fstring) - 1);
510 if (r.dom.id5.buffer_dom_sid != 0) {
511 *domain_sid = r.dom.id5.dom_sid.sid;
517 DEBUG(3, ("unknown info class %d\n", info_class));
528 /** Query info policy2
530 * @param domain_name - returned remote server's domain name
531 * @param dns_name - returned remote server's dns domain name
532 * @param forest_name - returned remote server's forest name
533 * @param domain_guid - returned remote server's domain guid
534 * @param domain_sid - returned remote server's domain sid */
536 NTSTATUS cli_lsa_query_info_policy2(struct cli_state *cli, TALLOC_CTX *mem_ctx,
537 POLICY_HND *pol, uint16 info_class,
538 fstring domain_name, fstring dns_name,
539 fstring forest_name, GUID *domain_guid,
542 prs_struct qbuf, rbuf;
545 NTSTATUS result = NT_STATUS_UNSUCCESSFUL;
547 if (info_class != 12)
553 /* Initialise parse structures */
555 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
556 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
558 /* Marshall data and send request */
560 init_q_query2(&q, pol, info_class);
562 if (!lsa_io_q_query_info2("", &q, &qbuf, 0) ||
563 !rpc_api_pipe_req(cli, LSA_QUERYINFO2, &qbuf, &rbuf)) {
564 result = NT_STATUS_UNSUCCESSFUL;
568 /* Unmarshall response */
570 if (!lsa_io_r_query_info2("", &r, &rbuf, 0)) {
571 result = NT_STATUS_UNSUCCESSFUL;
575 if (!NT_STATUS_IS_OK(result = r.status)) {
579 /* Return output parameters */
581 ZERO_STRUCTP(domain_sid);
582 ZERO_STRUCTP(domain_guid);
583 domain_name[0] = '\0';
585 if (r.info.dns_dom_info.hdr_nb_dom_name.buffer) {
586 unistr2_to_ascii(domain_name,
587 &r.info.dns_dom_info.uni_nb_dom_name,
588 sizeof(fstring) - 1);
590 if (r.info.dns_dom_info.hdr_dns_dom_name.buffer) {
591 unistr2_to_ascii(dns_name,
592 &r.info.dns_dom_info.uni_dns_dom_name,
593 sizeof(fstring) - 1);
595 if (r.info.dns_dom_info.hdr_forest_name.buffer) {
596 unistr2_to_ascii(forest_name,
597 &r.info.dns_dom_info.uni_forest_name,
598 sizeof(fstring) - 1);
601 memcpy(domain_guid, &r.info.dns_dom_info.dom_guid, sizeof(GUID));
603 if (r.info.dns_dom_info.ptr_dom_sid != 0) {
604 *domain_sid = r.info.dns_dom_info.dom_sid.sid;
615 * Enumerate list of trusted domains
617 * @param cli client state (cli_state) structure of the connection
618 * @param mem_ctx memory context
619 * @param pol opened lsa policy handle
620 * @param enum_ctx enumeration context ie. index of first returned domain entry
621 * @param pref_num_domains preferred max number of entries returned in one response
622 * @param num_domains total number of trusted domains returned by response
623 * @param domain_names returned trusted domain names
624 * @param domain_sids returned trusted domain sids
626 * @return nt status code of response
629 NTSTATUS cli_lsa_enum_trust_dom(struct cli_state *cli, TALLOC_CTX *mem_ctx,
630 POLICY_HND *pol, uint32 *enum_ctx,
632 char ***domain_names, DOM_SID **domain_sids)
634 prs_struct qbuf, rbuf;
635 LSA_Q_ENUM_TRUST_DOM q;
636 LSA_R_ENUM_TRUST_DOM r;
643 /* Initialise parse structures */
645 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
646 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
648 /* Marshall data and send request */
650 /* 64k is enough for about 2000 trusted domains */
651 init_q_enum_trust_dom(&q, pol, *enum_ctx, 0x10000);
653 if (!lsa_io_q_enum_trust_dom("", &q, &qbuf, 0) ||
654 !rpc_api_pipe_req(cli, LSA_ENUMTRUSTDOM, &qbuf, &rbuf)) {
655 result = NT_STATUS_UNSUCCESSFUL;
659 /* Unmarshall response */
661 if (!lsa_io_r_enum_trust_dom("", &r, &rbuf, 0)) {
662 result = NT_STATUS_UNSUCCESSFUL;
668 if (!NT_STATUS_IS_OK(result) &&
669 !NT_STATUS_EQUAL(result, NT_STATUS_NO_MORE_ENTRIES) &&
670 !NT_STATUS_EQUAL(result, STATUS_MORE_ENTRIES)) {
672 /* An actual error ocured */
677 /* Return output parameters */
681 /* Allocate memory for trusted domain names and sids */
683 *domain_names = (char **)talloc(mem_ctx, sizeof(char *) *
686 if (!*domain_names) {
687 DEBUG(0, ("cli_lsa_enum_trust_dom(): out of memory\n"));
688 result = NT_STATUS_NO_MEMORY;
692 *domain_sids = (DOM_SID *)talloc(mem_ctx, sizeof(DOM_SID) *
695 DEBUG(0, ("cli_lsa_enum_trust_dom(): out of memory\n"));
696 result = NT_STATUS_NO_MEMORY;
700 /* Copy across names and sids */
702 for (i = 0; i < r.num_domains; i++) {
705 unistr2_to_ascii(tmp, &r.uni_domain_name[i],
707 (*domain_names)[i] = talloc_strdup(mem_ctx, tmp);
708 sid_copy(&(*domain_sids)[i], &r.domain_sid[i].sid);
712 *num_domains = r.num_domains;
713 *enum_ctx = r.enum_context;
723 /** Enumerate privileges*/
725 NTSTATUS cli_lsa_enum_privilege(struct cli_state *cli, TALLOC_CTX *mem_ctx,
726 POLICY_HND *pol, uint32 *enum_context, uint32 pref_max_length,
727 uint32 *count, char ***privs_name, uint32 **privs_high, uint32 **privs_low)
729 prs_struct qbuf, rbuf;
738 /* Initialise parse structures */
740 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
741 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
743 /* Marshall data and send request */
745 init_q_enum_privs(&q, pol, *enum_context, pref_max_length);
747 if (!lsa_io_q_enum_privs("", &q, &qbuf, 0) ||
748 !rpc_api_pipe_req(cli, LSA_ENUM_PRIVS, &qbuf, &rbuf)) {
749 result = NT_STATUS_UNSUCCESSFUL;
753 /* Unmarshall response */
755 if (!lsa_io_r_enum_privs("", &r, &rbuf, 0)) {
756 result = NT_STATUS_UNSUCCESSFUL;
760 if (!NT_STATUS_IS_OK(result = r.status)) {
764 /* Return output parameters */
766 *enum_context = r.enum_context;
769 if (!((*privs_name = (char **)talloc(mem_ctx, sizeof(char *) * r.count)))) {
770 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
771 result = NT_STATUS_UNSUCCESSFUL;
775 if (!((*privs_high = (uint32 *)talloc(mem_ctx, sizeof(uint32) * r.count)))) {
776 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
777 result = NT_STATUS_UNSUCCESSFUL;
781 if (!((*privs_low = (uint32 *)talloc(mem_ctx, sizeof(uint32) * r.count)))) {
782 DEBUG(0, ("(cli_lsa_enum_privilege): out of memory\n"));
783 result = NT_STATUS_UNSUCCESSFUL;
787 for (i = 0; i < r.count; i++) {
790 rpcstr_pull_unistr2_fstring( name, &r.privs[i].name);
792 (*privs_name)[i] = talloc_strdup(mem_ctx, name);
794 (*privs_high)[i] = r.privs[i].luid_high;
795 (*privs_low)[i] = r.privs[i].luid_low;
805 /** Get privilege name */
807 NTSTATUS cli_lsa_get_dispname(struct cli_state *cli, TALLOC_CTX *mem_ctx,
808 POLICY_HND *pol, char *name, uint16 lang_id, uint16 lang_id_sys,
809 fstring description, uint16 *lang_id_desc)
811 prs_struct qbuf, rbuf;
812 LSA_Q_PRIV_GET_DISPNAME q;
813 LSA_R_PRIV_GET_DISPNAME r;
819 /* Initialise parse structures */
821 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
822 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
824 /* Marshall data and send request */
826 init_lsa_priv_get_dispname(&q, pol, name, lang_id, lang_id_sys);
828 if (!lsa_io_q_priv_get_dispname("", &q, &qbuf, 0) ||
829 !rpc_api_pipe_req(cli, LSA_PRIV_GET_DISPNAME, &qbuf, &rbuf)) {
830 result = NT_STATUS_UNSUCCESSFUL;
834 /* Unmarshall response */
836 if (!lsa_io_r_priv_get_dispname("", &r, &rbuf, 0)) {
837 result = NT_STATUS_UNSUCCESSFUL;
841 if (!NT_STATUS_IS_OK(result = r.status)) {
845 /* Return output parameters */
847 rpcstr_pull_unistr2_fstring(description , &r.desc);
848 *lang_id_desc = r.lang_id;
857 /** Enumerate list of SIDs */
859 NTSTATUS cli_lsa_enum_sids(struct cli_state *cli, TALLOC_CTX *mem_ctx,
860 POLICY_HND *pol, uint32 *enum_ctx, uint32 pref_max_length,
861 uint32 *num_sids, DOM_SID **sids)
863 prs_struct qbuf, rbuf;
864 LSA_Q_ENUM_ACCOUNTS q;
865 LSA_R_ENUM_ACCOUNTS r;
872 /* Initialise parse structures */
874 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
875 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
877 /* Marshall data and send request */
879 init_lsa_q_enum_accounts(&q, pol, *enum_ctx, pref_max_length);
881 if (!lsa_io_q_enum_accounts("", &q, &qbuf, 0) ||
882 !rpc_api_pipe_req(cli, LSA_ENUM_ACCOUNTS, &qbuf, &rbuf)) {
883 result = NT_STATUS_UNSUCCESSFUL;
887 /* Unmarshall response */
889 if (!lsa_io_r_enum_accounts("", &r, &rbuf, 0)) {
890 result = NT_STATUS_UNSUCCESSFUL;
896 if (!NT_STATUS_IS_OK(result = r.status)) {
900 if (r.sids.num_entries==0)
903 /* Return output parameters */
905 *sids = (DOM_SID *)talloc(mem_ctx, sizeof(DOM_SID) * r.sids.num_entries);
907 DEBUG(0, ("(cli_lsa_enum_sids): out of memory\n"));
908 result = NT_STATUS_UNSUCCESSFUL;
912 /* Copy across names and sids */
914 for (i = 0; i < r.sids.num_entries; i++) {
915 sid_copy(&(*sids)[i], &r.sids.sid[i].sid);
918 *num_sids= r.sids.num_entries;
919 *enum_ctx = r.enum_context;
928 /** Open a LSA user handle
930 * @param cli Handle on an initialised SMB connection */
932 NTSTATUS cli_lsa_open_account(struct cli_state *cli, TALLOC_CTX *mem_ctx,
933 POLICY_HND *dom_pol, DOM_SID *sid, uint32 des_access,
934 POLICY_HND *user_pol)
936 prs_struct qbuf, rbuf;
944 /* Initialise parse structures */
946 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
947 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
949 /* Initialise input parameters */
951 init_lsa_q_open_account(&q, dom_pol, sid, des_access);
953 /* Marshall data and send request */
955 if (!lsa_io_q_open_account("", &q, &qbuf, 0) ||
956 !rpc_api_pipe_req(cli, LSA_OPENACCOUNT, &qbuf, &rbuf)) {
957 result = NT_STATUS_UNSUCCESSFUL;
961 /* Unmarshall response */
963 if (!lsa_io_r_open_account("", &r, &rbuf, 0)) {
964 result = NT_STATUS_UNSUCCESSFUL;
968 /* Return output parameters */
970 if (NT_STATUS_IS_OK(result = r.status)) {
981 /** Enumerate user privileges
983 * @param cli Handle on an initialised SMB connection */
985 NTSTATUS cli_lsa_enum_privsaccount(struct cli_state *cli, TALLOC_CTX *mem_ctx,
986 POLICY_HND *pol, uint32 *count, LUID_ATTR **set)
988 prs_struct qbuf, rbuf;
989 LSA_Q_ENUMPRIVSACCOUNT q;
990 LSA_R_ENUMPRIVSACCOUNT r;
997 /* Initialise parse structures */
999 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1000 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1002 /* Initialise input parameters */
1004 init_lsa_q_enum_privsaccount(&q, pol);
1006 /* Marshall data and send request */
1008 if (!lsa_io_q_enum_privsaccount("", &q, &qbuf, 0) ||
1009 !rpc_api_pipe_req(cli, LSA_ENUMPRIVSACCOUNT, &qbuf, &rbuf)) {
1010 result = NT_STATUS_UNSUCCESSFUL;
1014 /* Unmarshall response */
1016 if (!lsa_io_r_enum_privsaccount("", &r, &rbuf, 0)) {
1017 result = NT_STATUS_UNSUCCESSFUL;
1021 /* Return output parameters */
1023 if (!NT_STATUS_IS_OK(result = r.status)) {
1030 if (!((*set = (LUID_ATTR *)talloc(mem_ctx, sizeof(LUID_ATTR) * r.count)))) {
1031 DEBUG(0, ("(cli_lsa_enum_privsaccount): out of memory\n"));
1032 result = NT_STATUS_UNSUCCESSFUL;
1036 for (i=0; i<r.count; i++) {
1037 (*set)[i].luid.low = r.set.set[i].luid.low;
1038 (*set)[i].luid.high = r.set.set[i].luid.high;
1039 (*set)[i].attr = r.set.set[i].attr;
1044 prs_mem_free(&qbuf);
1045 prs_mem_free(&rbuf);
1050 /** Get a privilege value given its name */
1052 NTSTATUS cli_lsa_lookupprivvalue(struct cli_state *cli, TALLOC_CTX *mem_ctx,
1053 POLICY_HND *pol, char *name, LUID *luid)
1055 prs_struct qbuf, rbuf;
1056 LSA_Q_LOOKUPPRIVVALUE q;
1057 LSA_R_LOOKUPPRIVVALUE r;
1063 /* Initialise parse structures */
1065 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1066 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1068 /* Marshall data and send request */
1070 init_lsa_q_lookupprivvalue(&q, pol, name);
1072 if (!lsa_io_q_lookupprivvalue("", &q, &qbuf, 0) ||
1073 !rpc_api_pipe_req(cli, LSA_LOOKUPPRIVVALUE, &qbuf, &rbuf)) {
1074 result = NT_STATUS_UNSUCCESSFUL;
1078 /* Unmarshall response */
1080 if (!lsa_io_r_lookupprivvalue("", &r, &rbuf, 0)) {
1081 result = NT_STATUS_UNSUCCESSFUL;
1085 if (!NT_STATUS_IS_OK(result = r.status)) {
1089 /* Return output parameters */
1091 (*luid).low=r.luid.low;
1092 (*luid).high=r.luid.high;
1095 prs_mem_free(&qbuf);
1096 prs_mem_free(&rbuf);
1101 /** Query LSA security object */
1103 NTSTATUS cli_lsa_query_secobj(struct cli_state *cli, TALLOC_CTX *mem_ctx,
1104 POLICY_HND *pol, uint32 sec_info,
1105 SEC_DESC_BUF **psdb)
1107 prs_struct qbuf, rbuf;
1108 LSA_Q_QUERY_SEC_OBJ q;
1109 LSA_R_QUERY_SEC_OBJ r;
1115 /* Initialise parse structures */
1117 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1118 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1120 /* Marshall data and send request */
1122 init_q_query_sec_obj(&q, pol, sec_info);
1124 if (!lsa_io_q_query_sec_obj("", &q, &qbuf, 0) ||
1125 !rpc_api_pipe_req(cli, LSA_QUERYSECOBJ, &qbuf, &rbuf)) {
1126 result = NT_STATUS_UNSUCCESSFUL;
1130 /* Unmarshall response */
1132 if (!lsa_io_r_query_sec_obj("", &r, &rbuf, 0)) {
1133 result = NT_STATUS_UNSUCCESSFUL;
1137 if (!NT_STATUS_IS_OK(result = r.status)) {
1141 /* Return output parameters */
1147 prs_mem_free(&qbuf);
1148 prs_mem_free(&rbuf);
1154 /* Enumerate account rights This is similar to enum_privileges but
1155 takes a SID directly, avoiding the open_account call.
1158 NTSTATUS cli_lsa_enum_account_rights(struct cli_state *cli, TALLOC_CTX *mem_ctx,
1159 POLICY_HND *pol, DOM_SID sid,
1160 uint32 *count, char ***privs_name)
1162 prs_struct qbuf, rbuf;
1163 LSA_Q_ENUM_ACCT_RIGHTS q;
1164 LSA_R_ENUM_ACCT_RIGHTS r;
1171 /* Initialise parse structures */
1173 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1174 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1176 /* Marshall data and send request */
1177 init_q_enum_acct_rights(&q, pol, 2, &sid);
1179 if (!lsa_io_q_enum_acct_rights("", &q, &qbuf, 0) ||
1180 !rpc_api_pipe_req(cli, LSA_ENUMACCTRIGHTS, &qbuf, &rbuf)) {
1181 result = NT_STATUS_UNSUCCESSFUL;
1185 if (!lsa_io_r_enum_acct_rights("", &r, &rbuf, 0)) {
1186 result = NT_STATUS_UNSUCCESSFUL;
1190 if (!NT_STATUS_IS_OK(result = r.status)) {
1199 *privs_name = (char **)talloc(mem_ctx, (*count) * sizeof(char **));
1200 for (i=0;i<*count;i++) {
1201 pull_ucs2_talloc(mem_ctx, &(*privs_name)[i], r.rights.strings[i].string.buffer);
1211 /* add account rights to an account. */
1213 NTSTATUS cli_lsa_add_account_rights(struct cli_state *cli, TALLOC_CTX *mem_ctx,
1214 POLICY_HND *pol, DOM_SID sid,
1215 uint32 count, const char **privs_name)
1217 prs_struct qbuf, rbuf;
1218 LSA_Q_ADD_ACCT_RIGHTS q;
1219 LSA_R_ADD_ACCT_RIGHTS r;
1224 /* Initialise parse structures */
1225 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1226 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1228 /* Marshall data and send request */
1229 init_q_add_acct_rights(&q, pol, &sid, count, privs_name);
1231 if (!lsa_io_q_add_acct_rights("", &q, &qbuf, 0) ||
1232 !rpc_api_pipe_req(cli, LSA_ADDACCTRIGHTS, &qbuf, &rbuf)) {
1233 result = NT_STATUS_UNSUCCESSFUL;
1237 /* Unmarshall response */
1239 if (!lsa_io_r_add_acct_rights("", &r, &rbuf, 0)) {
1240 result = NT_STATUS_UNSUCCESSFUL;
1244 if (!NT_STATUS_IS_OK(result = r.status)) {
1253 /* remove account rights for an account. */
1255 NTSTATUS cli_lsa_remove_account_rights(struct cli_state *cli, TALLOC_CTX *mem_ctx,
1256 POLICY_HND *pol, DOM_SID sid, BOOL removeall,
1257 uint32 count, const char **privs_name)
1259 prs_struct qbuf, rbuf;
1260 LSA_Q_REMOVE_ACCT_RIGHTS q;
1261 LSA_R_REMOVE_ACCT_RIGHTS r;
1266 /* Initialise parse structures */
1267 prs_init(&qbuf, MAX_PDU_FRAG_LEN, mem_ctx, MARSHALL);
1268 prs_init(&rbuf, 0, mem_ctx, UNMARSHALL);
1270 /* Marshall data and send request */
1271 init_q_remove_acct_rights(&q, pol, &sid, removeall?1:0, count, privs_name);
1273 if (!lsa_io_q_remove_acct_rights("", &q, &qbuf, 0) ||
1274 !rpc_api_pipe_req(cli, LSA_REMOVEACCTRIGHTS, &qbuf, &rbuf)) {
1275 result = NT_STATUS_UNSUCCESSFUL;
1279 /* Unmarshall response */
1281 if (!lsa_io_r_remove_acct_rights("", &r, &rbuf, 0)) {
1282 result = NT_STATUS_UNSUCCESSFUL;
1286 if (!NT_STATUS_IS_OK(result = r.status)) {
1297 /** An example of how to use the routines in this file. Fetch a DOMAIN
1298 sid. Does complete cli setup / teardown anonymously. */
1300 BOOL fetch_domain_sid( char *domain, char *remote_machine, DOM_SID *psid)
1302 extern pstring global_myname;
1303 struct cli_state cli;
1309 if(cli_initialise(&cli) == False) {
1310 DEBUG(0,("fetch_domain_sid: unable to initialize client connection.\n"));
1314 if(!resolve_name( remote_machine, &cli.dest_ip, 0x20)) {
1315 DEBUG(0,("fetch_domain_sid: Can't resolve address for %s\n", remote_machine));
1319 if (!cli_connect(&cli, remote_machine, &cli.dest_ip)) {
1320 DEBUG(0,("fetch_domain_sid: unable to connect to SMB server on \
1321 machine %s. Error was : %s.\n", remote_machine, cli_errstr(&cli) ));
1325 if (!attempt_netbios_session_request(&cli, global_myname, remote_machine, &cli.dest_ip)) {
1326 DEBUG(0,("fetch_domain_sid: machine %s rejected the NetBIOS session request.\n",
1331 cli.protocol = PROTOCOL_NT1;
1333 if (!cli_negprot(&cli)) {
1334 DEBUG(0,("fetch_domain_sid: machine %s rejected the negotiate protocol. \
1335 Error was : %s.\n", remote_machine, cli_errstr(&cli) ));
1339 if (cli.protocol != PROTOCOL_NT1) {
1340 DEBUG(0,("fetch_domain_sid: machine %s didn't negotiate NT protocol.\n",
1346 * Do an anonymous session setup.
1349 if (!cli_session_setup(&cli, "", "", 0, "", 0, "")) {
1350 DEBUG(0,("fetch_domain_sid: machine %s rejected the session setup. \
1351 Error was : %s.\n", remote_machine, cli_errstr(&cli) ));
1355 if (!(cli.sec_mode & NEGOTIATE_SECURITY_USER_LEVEL)) {
1356 DEBUG(0,("fetch_domain_sid: machine %s isn't in user level security mode\n",
1361 if (!cli_send_tconX(&cli, "IPC$", "IPC", "", 1)) {
1362 DEBUG(0,("fetch_domain_sid: machine %s rejected the tconX on the IPC$ share. \
1363 Error was : %s.\n", remote_machine, cli_errstr(&cli) ));
1367 /* Fetch domain sid */
1369 if (!cli_nt_session_open(&cli, PI_LSARPC)) {
1370 DEBUG(0, ("fetch_domain_sid: Error connecting to SAM pipe\n"));
1374 result = cli_lsa_open_policy(&cli, cli.mem_ctx, True, SEC_RIGHTS_QUERY_VALUE, &lsa_pol);
1375 if (!NT_STATUS_IS_OK(result)) {
1376 DEBUG(0, ("fetch_domain_sid: Error opening lsa policy handle. %s\n",
1377 nt_errstr(result) ));
1381 result = cli_lsa_query_info_policy(&cli, cli.mem_ctx, &lsa_pol, 5, domain, psid);
1382 if (!NT_STATUS_IS_OK(result)) {
1383 DEBUG(0, ("fetch_domain_sid: Error querying lsa policy handle. %s\n",
1384 nt_errstr(result) ));