s3: Fix Coverity ID 2202, NULL_RETURNS
[Samba.git] / source3 / utils / smbcacls.c
blob2f5ae857b402cce2f48eaba0c05533d93cb71de1
1 /*
2 Unix SMB/CIFS implementation.
3 ACL get/set utility
5 Copyright (C) Andrew Tridgell 2000
6 Copyright (C) Tim Potter 2000
7 Copyright (C) Jeremy Allison 2000
8 Copyright (C) Jelmer Vernooij 2003
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "includes.h"
25 #include "popt_common.h"
26 #include "rpc_client/cli_pipe.h"
27 #include "../librpc/gen_ndr/ndr_lsa.h"
28 #include "rpc_client/cli_lsarpc.h"
29 #include "../libcli/security/security.h"
30 #include "libsmb/clirap.h"
32 static int test_args;
34 #define CREATE_ACCESS_READ READ_CONTROL_ACCESS
36 /* numeric is set when the user wants numeric SIDs and ACEs rather
37 than going via LSA calls to resolve them */
38 static int numeric;
40 static int sddl;
42 enum acl_mode {SMB_ACL_SET, SMB_ACL_DELETE, SMB_ACL_MODIFY, SMB_ACL_ADD };
43 enum chown_mode {REQUEST_NONE, REQUEST_CHOWN, REQUEST_CHGRP, REQUEST_INHERIT};
44 enum exit_values {EXIT_OK, EXIT_FAILED, EXIT_PARSE_ERROR};
46 struct perm_value {
47 const char *perm;
48 uint32 mask;
51 /* These values discovered by inspection */
53 static const struct perm_value special_values[] = {
54 { "R", 0x00120089 },
55 { "W", 0x00120116 },
56 { "X", 0x001200a0 },
57 { "D", 0x00010000 },
58 { "P", 0x00040000 },
59 { "O", 0x00080000 },
60 { NULL, 0 },
63 static const struct perm_value standard_values[] = {
64 { "READ", 0x001200a9 },
65 { "CHANGE", 0x001301bf },
66 { "FULL", 0x001f01ff },
67 { NULL, 0 },
70 /* Open cli connection and policy handle */
72 static NTSTATUS cli_lsa_lookup_sid(struct cli_state *cli,
73 const struct dom_sid *sid,
74 TALLOC_CTX *mem_ctx,
75 enum lsa_SidType *type,
76 char **domain, char **name)
78 uint16 orig_cnum = cli->cnum;
79 struct rpc_pipe_client *p = NULL;
80 struct policy_handle handle;
81 NTSTATUS status;
82 TALLOC_CTX *frame = talloc_stackframe();
83 enum lsa_SidType *types;
84 char **domains;
85 char **names;
87 status = cli_tcon_andx(cli, "IPC$", "?????", "", 0);
88 if (!NT_STATUS_IS_OK(status)) {
89 return status;
92 status = cli_rpc_pipe_open_noauth(cli, &ndr_table_lsarpc.syntax_id,
93 &p);
94 if (!NT_STATUS_IS_OK(status)) {
95 goto fail;
98 status = rpccli_lsa_open_policy(p, talloc_tos(), True,
99 GENERIC_EXECUTE_ACCESS, &handle);
100 if (!NT_STATUS_IS_OK(status)) {
101 goto fail;
104 status = rpccli_lsa_lookup_sids(p, talloc_tos(), &handle, 1, sid,
105 &domains, &names, &types);
106 if (!NT_STATUS_IS_OK(status)) {
107 goto fail;
110 *type = types[0];
111 *domain = talloc_move(mem_ctx, &domains[0]);
112 *name = talloc_move(mem_ctx, &names[0]);
114 status = NT_STATUS_OK;
115 fail:
116 TALLOC_FREE(p);
117 cli_tdis(cli);
118 cli->cnum = orig_cnum;
119 TALLOC_FREE(frame);
120 return status;
123 static NTSTATUS cli_lsa_lookup_name(struct cli_state *cli,
124 const char *name,
125 enum lsa_SidType *type,
126 struct dom_sid *sid)
128 uint16 orig_cnum = cli->cnum;
129 struct rpc_pipe_client *p;
130 struct policy_handle handle;
131 NTSTATUS status;
132 TALLOC_CTX *frame = talloc_stackframe();
133 struct dom_sid *sids;
134 enum lsa_SidType *types;
136 status = cli_tcon_andx(cli, "IPC$", "?????", "", 0);
137 if (!NT_STATUS_IS_OK(status)) {
138 return status;
141 status = cli_rpc_pipe_open_noauth(cli, &ndr_table_lsarpc.syntax_id,
142 &p);
143 if (!NT_STATUS_IS_OK(status)) {
144 goto fail;
147 status = rpccli_lsa_open_policy(p, talloc_tos(), True,
148 GENERIC_EXECUTE_ACCESS, &handle);
149 if (!NT_STATUS_IS_OK(status)) {
150 goto fail;
153 status = rpccli_lsa_lookup_names(p, talloc_tos(), &handle, 1, &name,
154 NULL, 1, &sids, &types);
155 if (!NT_STATUS_IS_OK(status)) {
156 goto fail;
159 *type = types[0];
160 *sid = sids[0];
162 status = NT_STATUS_OK;
163 fail:
164 TALLOC_FREE(p);
165 cli_tdis(cli);
166 cli->cnum = orig_cnum;
167 TALLOC_FREE(frame);
168 return status;
171 /* convert a SID to a string, either numeric or username/group */
172 static void SidToString(struct cli_state *cli, fstring str, const struct dom_sid *sid)
174 char *domain = NULL;
175 char *name = NULL;
176 enum lsa_SidType type;
177 NTSTATUS status;
179 sid_to_fstring(str, sid);
181 if (numeric) {
182 return;
185 status = cli_lsa_lookup_sid(cli, sid, talloc_tos(), &type,
186 &domain, &name);
188 if (!NT_STATUS_IS_OK(status)) {
189 return;
192 if (*domain) {
193 slprintf(str, sizeof(fstring) - 1, "%s%s%s",
194 domain, lp_winbind_separator(), name);
195 } else {
196 fstrcpy(str, name);
200 /* convert a string to a SID, either numeric or username/group */
201 static bool StringToSid(struct cli_state *cli, struct dom_sid *sid, const char *str)
203 enum lsa_SidType type;
205 if (string_to_sid(sid, str)) {
206 return true;
209 return NT_STATUS_IS_OK(cli_lsa_lookup_name(cli, str, &type, sid));
212 static void print_ace_flags(FILE *f, uint8_t flags)
214 char *str = talloc_strdup(NULL, "");
216 if (!str) {
217 goto out;
220 if (flags & SEC_ACE_FLAG_OBJECT_INHERIT) {
221 str = talloc_asprintf(str, "%s%s",
222 str, "OI|");
223 if (!str) {
224 goto out;
227 if (flags & SEC_ACE_FLAG_CONTAINER_INHERIT) {
228 str = talloc_asprintf(str, "%s%s",
229 str, "CI|");
230 if (!str) {
231 goto out;
234 if (flags & SEC_ACE_FLAG_NO_PROPAGATE_INHERIT) {
235 str = talloc_asprintf(str, "%s%s",
236 str, "NP|");
237 if (!str) {
238 goto out;
241 if (flags & SEC_ACE_FLAG_INHERIT_ONLY) {
242 str = talloc_asprintf(str, "%s%s",
243 str, "IO|");
244 if (!str) {
245 goto out;
248 if (flags & SEC_ACE_FLAG_INHERITED_ACE) {
249 str = talloc_asprintf(str, "%s%s",
250 str, "I|");
251 if (!str) {
252 goto out;
255 /* Ignore define SEC_ACE_FLAG_SUCCESSFUL_ACCESS ( 0x40 )
256 and SEC_ACE_FLAG_FAILED_ACCESS ( 0x80 ) as they're
257 audit ace flags. */
259 if (str[strlen(str)-1] == '|') {
260 str[strlen(str)-1] = '\0';
261 fprintf(f, "/%s/", str);
262 } else {
263 fprintf(f, "/0x%x/", flags);
265 TALLOC_FREE(str);
266 return;
268 out:
269 fprintf(f, "/0x%x/", flags);
272 /* print an ACE on a FILE, using either numeric or ascii representation */
273 static void print_ace(struct cli_state *cli, FILE *f, struct security_ace *ace)
275 const struct perm_value *v;
276 fstring sidstr;
277 int do_print = 0;
278 uint32 got_mask;
280 SidToString(cli, sidstr, &ace->trustee);
282 fprintf(f, "%s:", sidstr);
284 if (numeric) {
285 fprintf(f, "%d/0x%x/0x%08x",
286 ace->type, ace->flags, ace->access_mask);
287 return;
290 /* Ace type */
292 if (ace->type == SEC_ACE_TYPE_ACCESS_ALLOWED) {
293 fprintf(f, "ALLOWED");
294 } else if (ace->type == SEC_ACE_TYPE_ACCESS_DENIED) {
295 fprintf(f, "DENIED");
296 } else {
297 fprintf(f, "%d", ace->type);
300 print_ace_flags(f, ace->flags);
302 /* Standard permissions */
304 for (v = standard_values; v->perm; v++) {
305 if (ace->access_mask == v->mask) {
306 fprintf(f, "%s", v->perm);
307 return;
311 /* Special permissions. Print out a hex value if we have
312 leftover bits in the mask. */
314 got_mask = ace->access_mask;
316 again:
317 for (v = special_values; v->perm; v++) {
318 if ((ace->access_mask & v->mask) == v->mask) {
319 if (do_print) {
320 fprintf(f, "%s", v->perm);
322 got_mask &= ~v->mask;
326 if (!do_print) {
327 if (got_mask != 0) {
328 fprintf(f, "0x%08x", ace->access_mask);
329 } else {
330 do_print = 1;
331 goto again;
336 static bool parse_ace_flags(const char *str, unsigned int *pflags)
338 const char *p = str;
339 *pflags = 0;
341 while (*p) {
342 if (strnequal(p, "OI", 2)) {
343 *pflags |= SEC_ACE_FLAG_OBJECT_INHERIT;
344 p += 2;
345 } else if (strnequal(p, "CI", 2)) {
346 *pflags |= SEC_ACE_FLAG_CONTAINER_INHERIT;
347 p += 2;
348 } else if (strnequal(p, "NP", 2)) {
349 *pflags |= SEC_ACE_FLAG_NO_PROPAGATE_INHERIT;
350 p += 2;
351 } else if (strnequal(p, "IO", 2)) {
352 *pflags |= SEC_ACE_FLAG_INHERIT_ONLY;
353 p += 2;
354 } else if (*p == 'I') {
355 *pflags |= SEC_ACE_FLAG_INHERITED_ACE;
356 p += 1;
357 } else if (*p) {
358 return false;
361 if (*p != '|' && *p != '\0') {
362 return false;
365 return true;
368 /* parse an ACE in the same format as print_ace() */
369 static bool parse_ace(struct cli_state *cli, struct security_ace *ace,
370 const char *orig_str)
372 char *p;
373 const char *cp;
374 char *tok;
375 unsigned int atype = 0;
376 unsigned int aflags = 0;
377 unsigned int amask = 0;
378 struct dom_sid sid;
379 uint32_t mask;
380 const struct perm_value *v;
381 char *str = SMB_STRDUP(orig_str);
382 TALLOC_CTX *frame = talloc_stackframe();
384 if (!str) {
385 TALLOC_FREE(frame);
386 return False;
389 ZERO_STRUCTP(ace);
390 p = strchr_m(str,':');
391 if (!p) {
392 printf("ACE '%s': missing ':'.\n", orig_str);
393 SAFE_FREE(str);
394 TALLOC_FREE(frame);
395 return False;
397 *p = '\0';
398 p++;
399 /* Try to parse numeric form */
401 if (sscanf(p, "%i/%i/%i", &atype, &aflags, &amask) == 3 &&
402 StringToSid(cli, &sid, str)) {
403 goto done;
406 /* Try to parse text form */
408 if (!StringToSid(cli, &sid, str)) {
409 printf("ACE '%s': failed to convert '%s' to SID\n",
410 orig_str, str);
411 SAFE_FREE(str);
412 TALLOC_FREE(frame);
413 return False;
416 cp = p;
417 if (!next_token_talloc(frame, &cp, &tok, "/")) {
418 printf("ACE '%s': failed to find '/' character.\n",
419 orig_str);
420 SAFE_FREE(str);
421 TALLOC_FREE(frame);
422 return False;
425 if (strncmp(tok, "ALLOWED", strlen("ALLOWED")) == 0) {
426 atype = SEC_ACE_TYPE_ACCESS_ALLOWED;
427 } else if (strncmp(tok, "DENIED", strlen("DENIED")) == 0) {
428 atype = SEC_ACE_TYPE_ACCESS_DENIED;
429 } else {
430 printf("ACE '%s': missing 'ALLOWED' or 'DENIED' entry at '%s'\n",
431 orig_str, tok);
432 SAFE_FREE(str);
433 TALLOC_FREE(frame);
434 return False;
437 /* Only numeric form accepted for flags at present */
439 if (!next_token_talloc(frame, &cp, &tok, "/")) {
440 printf("ACE '%s': bad flags entry at '%s'\n",
441 orig_str, tok);
442 SAFE_FREE(str);
443 TALLOC_FREE(frame);
444 return False;
447 if (tok[0] < '0' || tok[0] > '9') {
448 if (!parse_ace_flags(tok, &aflags)) {
449 printf("ACE '%s': bad named flags entry at '%s'\n",
450 orig_str, tok);
451 SAFE_FREE(str);
452 TALLOC_FREE(frame);
453 return False;
455 } else if (strnequal(tok, "0x", 2)) {
456 if (!sscanf(tok, "%x", &aflags)) {
457 printf("ACE '%s': bad hex flags entry at '%s'\n",
458 orig_str, tok);
459 SAFE_FREE(str);
460 TALLOC_FREE(frame);
461 return False;
463 } else {
464 if (!sscanf(tok, "%i", &aflags)) {
465 printf("ACE '%s': bad integer flags entry at '%s'\n",
466 orig_str, tok);
467 SAFE_FREE(str);
468 TALLOC_FREE(frame);
469 return False;
473 if (!next_token_talloc(frame, &cp, &tok, "/")) {
474 printf("ACE '%s': missing / at '%s'\n",
475 orig_str, tok);
476 SAFE_FREE(str);
477 TALLOC_FREE(frame);
478 return False;
481 if (strncmp(tok, "0x", 2) == 0) {
482 if (sscanf(tok, "%i", &amask) != 1) {
483 printf("ACE '%s': bad hex number at '%s'\n",
484 orig_str, tok);
485 SAFE_FREE(str);
486 TALLOC_FREE(frame);
487 return False;
489 goto done;
492 for (v = standard_values; v->perm; v++) {
493 if (strcmp(tok, v->perm) == 0) {
494 amask = v->mask;
495 goto done;
499 p = tok;
501 while(*p) {
502 bool found = False;
504 for (v = special_values; v->perm; v++) {
505 if (v->perm[0] == *p) {
506 amask |= v->mask;
507 found = True;
511 if (!found) {
512 printf("ACE '%s': bad permission value at '%s'\n",
513 orig_str, p);
514 SAFE_FREE(str);
515 TALLOC_FREE(frame);
516 return False;
518 p++;
521 if (*p) {
522 TALLOC_FREE(frame);
523 SAFE_FREE(str);
524 return False;
527 done:
528 mask = amask;
529 init_sec_ace(ace, &sid, atype, mask, aflags);
530 TALLOC_FREE(frame);
531 SAFE_FREE(str);
532 return True;
535 /* add an ACE to a list of ACEs in a struct security_acl */
536 static bool add_ace(struct security_acl **the_acl, struct security_ace *ace)
538 struct security_acl *new_ace;
539 struct security_ace *aces;
540 if (! *the_acl) {
541 return (((*the_acl) = make_sec_acl(talloc_tos(), 3, 1, ace))
542 != NULL);
545 if (!(aces = SMB_CALLOC_ARRAY(struct security_ace, 1+(*the_acl)->num_aces))) {
546 return False;
548 memcpy(aces, (*the_acl)->aces, (*the_acl)->num_aces * sizeof(struct
549 security_ace));
550 memcpy(aces+(*the_acl)->num_aces, ace, sizeof(struct security_ace));
551 new_ace = make_sec_acl(talloc_tos(),(*the_acl)->revision,1+(*the_acl)->num_aces, aces);
552 SAFE_FREE(aces);
553 (*the_acl) = new_ace;
554 return True;
557 /* parse a ascii version of a security descriptor */
558 static struct security_descriptor *sec_desc_parse(TALLOC_CTX *ctx, struct cli_state *cli, char *str)
560 const char *p = str;
561 char *tok;
562 struct security_descriptor *ret = NULL;
563 size_t sd_size;
564 struct dom_sid *grp_sid=NULL, *owner_sid=NULL;
565 struct security_acl *dacl=NULL;
566 int revision=1;
568 while (next_token_talloc(ctx, &p, &tok, "\t,\r\n")) {
569 if (strncmp(tok,"REVISION:", 9) == 0) {
570 revision = strtol(tok+9, NULL, 16);
571 continue;
574 if (strncmp(tok,"OWNER:", 6) == 0) {
575 if (owner_sid) {
576 printf("Only specify owner once\n");
577 goto done;
579 owner_sid = SMB_CALLOC_ARRAY(struct dom_sid, 1);
580 if (!owner_sid ||
581 !StringToSid(cli, owner_sid, tok+6)) {
582 printf("Failed to parse owner sid\n");
583 goto done;
585 continue;
588 if (strncmp(tok,"GROUP:", 6) == 0) {
589 if (grp_sid) {
590 printf("Only specify group once\n");
591 goto done;
593 grp_sid = SMB_CALLOC_ARRAY(struct dom_sid, 1);
594 if (!grp_sid ||
595 !StringToSid(cli, grp_sid, tok+6)) {
596 printf("Failed to parse group sid\n");
597 goto done;
599 continue;
602 if (strncmp(tok,"ACL:", 4) == 0) {
603 struct security_ace ace;
604 if (!parse_ace(cli, &ace, tok+4)) {
605 goto done;
607 if(!add_ace(&dacl, &ace)) {
608 printf("Failed to add ACL %s\n", tok);
609 goto done;
611 continue;
614 printf("Failed to parse token '%s' in security descriptor,\n", tok);
615 goto done;
618 ret = make_sec_desc(ctx,revision, SEC_DESC_SELF_RELATIVE, owner_sid, grp_sid,
619 NULL, dacl, &sd_size);
621 done:
622 SAFE_FREE(grp_sid);
623 SAFE_FREE(owner_sid);
625 return ret;
629 /* print a ascii version of a security descriptor on a FILE handle */
630 static void sec_desc_print(struct cli_state *cli, FILE *f, struct security_descriptor *sd)
632 fstring sidstr;
633 uint32 i;
635 fprintf(f, "REVISION:%d\n", sd->revision);
636 fprintf(f, "CONTROL:0x%x\n", sd->type);
638 /* Print owner and group sid */
640 if (sd->owner_sid) {
641 SidToString(cli, sidstr, sd->owner_sid);
642 } else {
643 fstrcpy(sidstr, "");
646 fprintf(f, "OWNER:%s\n", sidstr);
648 if (sd->group_sid) {
649 SidToString(cli, sidstr, sd->group_sid);
650 } else {
651 fstrcpy(sidstr, "");
654 fprintf(f, "GROUP:%s\n", sidstr);
656 /* Print aces */
657 for (i = 0; sd->dacl && i < sd->dacl->num_aces; i++) {
658 struct security_ace *ace = &sd->dacl->aces[i];
659 fprintf(f, "ACL:");
660 print_ace(cli, f, ace);
661 fprintf(f, "\n");
666 /*****************************************************
667 get fileinfo for filename
668 *******************************************************/
669 static uint16 get_fileinfo(struct cli_state *cli, const char *filename)
671 uint16_t fnum = (uint16_t)-1;
672 uint16 mode = 0;
673 NTSTATUS status;
675 /* The desired access below is the only one I could find that works
676 with NT4, W2KP and Samba */
678 status = cli_ntcreate(cli, filename, 0, CREATE_ACCESS_READ,
679 0, FILE_SHARE_READ|FILE_SHARE_WRITE,
680 FILE_OPEN, 0x0, 0x0, &fnum);
681 if (!NT_STATUS_IS_OK(status)) {
682 printf("Failed to open %s: %s\n", filename, nt_errstr(status));
683 return 0;
686 status = cli_qfileinfo_basic(cli, fnum, &mode, NULL, NULL, NULL,
687 NULL, NULL, NULL);
688 if (!NT_STATUS_IS_OK(status)) {
689 printf("Failed to file info %s: %s\n", filename,
690 nt_errstr(status));
693 cli_close(cli, fnum);
695 return mode;
698 /*****************************************************
699 get sec desc for filename
700 *******************************************************/
701 static struct security_descriptor *get_secdesc(struct cli_state *cli, const char *filename)
703 uint16_t fnum = (uint16_t)-1;
704 struct security_descriptor *sd;
705 NTSTATUS status;
707 /* The desired access below is the only one I could find that works
708 with NT4, W2KP and Samba */
710 status = cli_ntcreate(cli, filename, 0, CREATE_ACCESS_READ,
711 0, FILE_SHARE_READ|FILE_SHARE_WRITE,
712 FILE_OPEN, 0x0, 0x0, &fnum);
713 if (!NT_STATUS_IS_OK(status)) {
714 printf("Failed to open %s: %s\n", filename, nt_errstr(status));
715 return NULL;
718 sd = cli_query_secdesc(cli, fnum, talloc_tos());
720 cli_close(cli, fnum);
722 if (!sd) {
723 printf("Failed to get security descriptor\n");
724 return NULL;
726 return sd;
729 /*****************************************************
730 set sec desc for filename
731 *******************************************************/
732 static bool set_secdesc(struct cli_state *cli, const char *filename,
733 struct security_descriptor *sd)
735 uint16_t fnum = (uint16_t)-1;
736 bool result=true;
737 NTSTATUS status;
739 /* The desired access below is the only one I could find that works
740 with NT4, W2KP and Samba */
742 status = cli_ntcreate(cli, filename, 0,
743 WRITE_DAC_ACCESS|WRITE_OWNER_ACCESS,
744 0, FILE_SHARE_READ|FILE_SHARE_WRITE,
745 FILE_OPEN, 0x0, 0x0, &fnum);
746 if (!NT_STATUS_IS_OK(status)) {
747 printf("Failed to open %s: %s\n", filename, nt_errstr(status));
748 return false;
751 status = cli_set_secdesc(cli, fnum, sd);
752 if (!NT_STATUS_IS_OK(status)) {
753 printf("ERROR: security description set failed: %s\n",
754 nt_errstr(status));
755 result=false;
758 cli_close(cli, fnum);
759 return result;
762 /*****************************************************
763 dump the acls for a file
764 *******************************************************/
765 static int cacl_dump(struct cli_state *cli, const char *filename)
767 int result = EXIT_FAILED;
768 struct security_descriptor *sd;
770 if (test_args)
771 return EXIT_OK;
773 sd = get_secdesc(cli, filename);
775 if (sd) {
776 if (sddl) {
777 printf("%s\n", sddl_encode(talloc_tos(), sd,
778 get_global_sam_sid()));
779 } else {
780 sec_desc_print(cli, stdout, sd);
782 result = EXIT_OK;
785 return result;
788 /*****************************************************
789 Change the ownership or group ownership of a file. Just
790 because the NT docs say this can't be done :-). JRA.
791 *******************************************************/
793 static int owner_set(struct cli_state *cli, enum chown_mode change_mode,
794 const char *filename, const char *new_username)
796 struct dom_sid sid;
797 struct security_descriptor *sd, *old;
798 size_t sd_size;
800 if (!StringToSid(cli, &sid, new_username))
801 return EXIT_PARSE_ERROR;
803 old = get_secdesc(cli, filename);
805 if (!old) {
806 return EXIT_FAILED;
809 sd = make_sec_desc(talloc_tos(),old->revision, old->type,
810 (change_mode == REQUEST_CHOWN) ? &sid : NULL,
811 (change_mode == REQUEST_CHGRP) ? &sid : NULL,
812 NULL, NULL, &sd_size);
814 if (!set_secdesc(cli, filename, sd)) {
815 return EXIT_FAILED;
818 return EXIT_OK;
822 /* The MSDN is contradictory over the ordering of ACE entries in an
823 ACL. However NT4 gives a "The information may have been modified
824 by a computer running Windows NT 5.0" if denied ACEs do not appear
825 before allowed ACEs. At
826 http://technet.microsoft.com/en-us/library/cc781716.aspx the
827 canonical order is specified as "Explicit Deny, Explicit Allow,
828 Inherited ACEs unchanged" */
830 static int ace_compare(struct security_ace *ace1, struct security_ace *ace2)
832 if (sec_ace_equal(ace1, ace2))
833 return 0;
835 if ((ace1->flags & SEC_ACE_FLAG_INHERITED_ACE) &&
836 !(ace2->flags & SEC_ACE_FLAG_INHERITED_ACE))
837 return 1;
838 if (!(ace1->flags & SEC_ACE_FLAG_INHERITED_ACE) &&
839 (ace2->flags & SEC_ACE_FLAG_INHERITED_ACE))
840 return -1;
841 if ((ace1->flags & SEC_ACE_FLAG_INHERITED_ACE) &&
842 (ace2->flags & SEC_ACE_FLAG_INHERITED_ACE))
843 return ace1 - ace2;
845 if (ace1->type != ace2->type)
846 return ace2->type - ace1->type;
848 if (dom_sid_compare(&ace1->trustee, &ace2->trustee))
849 return dom_sid_compare(&ace1->trustee, &ace2->trustee);
851 if (ace1->flags != ace2->flags)
852 return ace1->flags - ace2->flags;
854 if (ace1->access_mask != ace2->access_mask)
855 return ace1->access_mask - ace2->access_mask;
857 if (ace1->size != ace2->size)
858 return ace1->size - ace2->size;
860 return memcmp(ace1, ace2, sizeof(struct security_ace));
863 static void sort_acl(struct security_acl *the_acl)
865 uint32 i;
866 if (!the_acl) return;
868 TYPESAFE_QSORT(the_acl->aces, the_acl->num_aces, ace_compare);
870 for (i=1;i<the_acl->num_aces;) {
871 if (sec_ace_equal(&the_acl->aces[i-1], &the_acl->aces[i])) {
872 int j;
873 for (j=i; j<the_acl->num_aces-1; j++) {
874 the_acl->aces[j] = the_acl->aces[j+1];
876 the_acl->num_aces--;
877 } else {
878 i++;
883 /*****************************************************
884 set the ACLs on a file given an ascii description
885 *******************************************************/
887 static int cacl_set(struct cli_state *cli, const char *filename,
888 char *the_acl, enum acl_mode mode)
890 struct security_descriptor *sd, *old;
891 uint32 i, j;
892 size_t sd_size;
893 int result = EXIT_OK;
895 if (sddl) {
896 sd = sddl_decode(talloc_tos(), the_acl, get_global_sam_sid());
897 } else {
898 sd = sec_desc_parse(talloc_tos(), cli, the_acl);
901 if (!sd) return EXIT_PARSE_ERROR;
902 if (test_args) return EXIT_OK;
904 old = get_secdesc(cli, filename);
906 if (!old) {
907 return EXIT_FAILED;
910 /* the logic here is rather more complex than I would like */
911 switch (mode) {
912 case SMB_ACL_DELETE:
913 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
914 bool found = False;
916 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
917 if (sec_ace_equal(&sd->dacl->aces[i],
918 &old->dacl->aces[j])) {
919 uint32 k;
920 for (k=j; k<old->dacl->num_aces-1;k++) {
921 old->dacl->aces[k] = old->dacl->aces[k+1];
923 old->dacl->num_aces--;
924 found = True;
925 break;
929 if (!found) {
930 printf("ACL for ACE:");
931 print_ace(cli, stdout, &sd->dacl->aces[i]);
932 printf(" not found\n");
935 break;
937 case SMB_ACL_MODIFY:
938 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
939 bool found = False;
941 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
942 if (dom_sid_equal(&sd->dacl->aces[i].trustee,
943 &old->dacl->aces[j].trustee)) {
944 old->dacl->aces[j] = sd->dacl->aces[i];
945 found = True;
949 if (!found) {
950 fstring str;
952 SidToString(cli, str,
953 &sd->dacl->aces[i].trustee);
954 printf("ACL for SID %s not found\n", str);
958 if (sd->owner_sid) {
959 old->owner_sid = sd->owner_sid;
962 if (sd->group_sid) {
963 old->group_sid = sd->group_sid;
966 break;
968 case SMB_ACL_ADD:
969 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
970 add_ace(&old->dacl, &sd->dacl->aces[i]);
972 break;
974 case SMB_ACL_SET:
975 old = sd;
976 break;
979 /* Denied ACE entries must come before allowed ones */
980 sort_acl(old->dacl);
982 /* Create new security descriptor and set it */
984 /* We used to just have "WRITE_DAC_ACCESS" without WRITE_OWNER.
985 But if we're sending an owner, even if it's the same as the one
986 that already exists then W2K3 insists we open with WRITE_OWNER access.
987 I need to check that setting a SD with no owner set works against WNT
988 and W2K. JRA.
991 sd = make_sec_desc(talloc_tos(),old->revision, old->type,
992 old->owner_sid, old->group_sid,
993 NULL, old->dacl, &sd_size);
995 if (!set_secdesc(cli, filename, sd)) {
996 result = EXIT_FAILED;
999 return result;
1002 /*****************************************************
1003 set the inherit on a file
1004 *******************************************************/
1005 static int inherit(struct cli_state *cli, const char *filename,
1006 const char *type)
1008 struct security_descriptor *old,*sd;
1009 uint32 oldattr;
1010 size_t sd_size;
1011 int result = EXIT_OK;
1013 old = get_secdesc(cli, filename);
1015 if (!old) {
1016 return EXIT_FAILED;
1019 oldattr = get_fileinfo(cli,filename);
1021 if (strcmp(type,"allow")==0) {
1022 if ((old->type & SEC_DESC_DACL_PROTECTED) ==
1023 SEC_DESC_DACL_PROTECTED) {
1024 int i;
1025 char *parentname,*temp;
1026 struct security_descriptor *parent;
1027 temp = talloc_strdup(talloc_tos(), filename);
1029 old->type=old->type & (~SEC_DESC_DACL_PROTECTED);
1031 /* look at parent and copy in all its inheritable ACL's. */
1032 string_replace(temp, '\\', '/');
1033 if (!parent_dirname(talloc_tos(),temp,&parentname,NULL)) {
1034 return EXIT_FAILED;
1036 string_replace(parentname, '/', '\\');
1037 parent = get_secdesc(cli,parentname);
1038 if (parent == NULL) {
1039 return EXIT_FAILED;
1041 for (i=0;i<parent->dacl->num_aces;i++) {
1042 struct security_ace *ace=&parent->dacl->aces[i];
1043 /* Add inherited flag to all aces */
1044 ace->flags=ace->flags|
1045 SEC_ACE_FLAG_INHERITED_ACE;
1046 if ((oldattr & aDIR) == aDIR) {
1047 if ((ace->flags & SEC_ACE_FLAG_CONTAINER_INHERIT) ==
1048 SEC_ACE_FLAG_CONTAINER_INHERIT) {
1049 add_ace(&old->dacl, ace);
1051 } else {
1052 if ((ace->flags & SEC_ACE_FLAG_OBJECT_INHERIT) ==
1053 SEC_ACE_FLAG_OBJECT_INHERIT) {
1054 /* clear flags for files */
1055 ace->flags=0;
1056 add_ace(&old->dacl, ace);
1060 } else {
1061 printf("Already set to inheritable permissions.\n");
1062 return EXIT_FAILED;
1064 } else if (strcmp(type,"remove")==0) {
1065 if ((old->type & SEC_DESC_DACL_PROTECTED) !=
1066 SEC_DESC_DACL_PROTECTED) {
1067 old->type=old->type | SEC_DESC_DACL_PROTECTED;
1069 /* remove all inherited ACL's. */
1070 if (old->dacl) {
1071 int i;
1072 struct security_acl *temp=old->dacl;
1073 old->dacl=make_sec_acl(talloc_tos(), 3, 0, NULL);
1074 for (i=temp->num_aces-1;i>=0;i--) {
1075 struct security_ace *ace=&temp->aces[i];
1076 /* Remove all ace with INHERITED flag set */
1077 if ((ace->flags & SEC_ACE_FLAG_INHERITED_ACE) !=
1078 SEC_ACE_FLAG_INHERITED_ACE) {
1079 add_ace(&old->dacl,ace);
1083 } else {
1084 printf("Already set to no inheritable permissions.\n");
1085 return EXIT_FAILED;
1087 } else if (strcmp(type,"copy")==0) {
1088 if ((old->type & SEC_DESC_DACL_PROTECTED) !=
1089 SEC_DESC_DACL_PROTECTED) {
1090 old->type=old->type | SEC_DESC_DACL_PROTECTED;
1092 /* convert all inherited ACL's to non inherated ACL's. */
1093 if (old->dacl) {
1094 int i;
1095 for (i=0;i<old->dacl->num_aces;i++) {
1096 struct security_ace *ace=&old->dacl->aces[i];
1097 /* Remove INHERITED FLAG from all aces */
1098 ace->flags=ace->flags&(~SEC_ACE_FLAG_INHERITED_ACE);
1101 } else {
1102 printf("Already set to no inheritable permissions.\n");
1103 return EXIT_FAILED;
1107 /* Denied ACE entries must come before allowed ones */
1108 sort_acl(old->dacl);
1110 sd = make_sec_desc(talloc_tos(),old->revision, old->type,
1111 old->owner_sid, old->group_sid,
1112 NULL, old->dacl, &sd_size);
1114 if (!set_secdesc(cli, filename, sd)) {
1115 result = EXIT_FAILED;
1118 return result;
1121 /*****************************************************
1122 Return a connection to a server.
1123 *******************************************************/
1124 static struct cli_state *connect_one(struct user_auth_info *auth_info,
1125 const char *server, const char *share)
1127 struct cli_state *c = NULL;
1128 struct sockaddr_storage ss;
1129 NTSTATUS nt_status;
1130 uint32_t flags = 0;
1132 zero_sockaddr(&ss);
1134 if (get_cmdline_auth_info_use_kerberos(auth_info)) {
1135 flags |= CLI_FULL_CONNECTION_USE_KERBEROS |
1136 CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS;
1139 if (get_cmdline_auth_info_use_machine_account(auth_info) &&
1140 !set_cmdline_auth_info_machine_account_creds(auth_info)) {
1141 return NULL;
1144 set_cmdline_auth_info_getpass(auth_info);
1146 nt_status = cli_full_connection(&c, global_myname(), server,
1147 &ss, 0,
1148 share, "?????",
1149 get_cmdline_auth_info_username(auth_info),
1150 lp_workgroup(),
1151 get_cmdline_auth_info_password(auth_info),
1152 flags,
1153 get_cmdline_auth_info_signing_state(auth_info));
1154 if (!NT_STATUS_IS_OK(nt_status)) {
1155 DEBUG(0,("cli_full_connection failed! (%s)\n", nt_errstr(nt_status)));
1156 return NULL;
1159 if (get_cmdline_auth_info_smb_encrypt(auth_info)) {
1160 nt_status = cli_cm_force_encryption(c,
1161 get_cmdline_auth_info_username(auth_info),
1162 get_cmdline_auth_info_password(auth_info),
1163 lp_workgroup(),
1164 share);
1165 if (!NT_STATUS_IS_OK(nt_status)) {
1166 cli_shutdown(c);
1167 c = NULL;
1171 return c;
1174 /****************************************************************************
1175 main program
1176 ****************************************************************************/
1177 int main(int argc, const char *argv[])
1179 char *share;
1180 int opt;
1181 enum acl_mode mode = SMB_ACL_SET;
1182 static char *the_acl = NULL;
1183 enum chown_mode change_mode = REQUEST_NONE;
1184 int result;
1185 char *path;
1186 char *filename = NULL;
1187 poptContext pc;
1188 struct poptOption long_options[] = {
1189 POPT_AUTOHELP
1190 { "delete", 'D', POPT_ARG_STRING, NULL, 'D', "Delete an acl", "ACL" },
1191 { "modify", 'M', POPT_ARG_STRING, NULL, 'M', "Modify an acl", "ACL" },
1192 { "add", 'a', POPT_ARG_STRING, NULL, 'a', "Add an acl", "ACL" },
1193 { "set", 'S', POPT_ARG_STRING, NULL, 'S', "Set acls", "ACLS" },
1194 { "chown", 'C', POPT_ARG_STRING, NULL, 'C', "Change ownership of a file", "USERNAME" },
1195 { "chgrp", 'G', POPT_ARG_STRING, NULL, 'G', "Change group ownership of a file", "GROUPNAME" },
1196 { "inherit", 'I', POPT_ARG_STRING, NULL, 'I', "Inherit allow|remove|copy" },
1197 { "numeric", 0, POPT_ARG_NONE, &numeric, 1, "Don't resolve sids or masks to names" },
1198 { "sddl", 0, POPT_ARG_NONE, &sddl, 1, "Output and input acls in sddl format" },
1199 { "test-args", 't', POPT_ARG_NONE, &test_args, 1, "Test arguments"},
1200 POPT_COMMON_SAMBA
1201 POPT_COMMON_CONNECTION
1202 POPT_COMMON_CREDENTIALS
1203 POPT_TABLEEND
1206 struct cli_state *cli;
1207 TALLOC_CTX *frame = talloc_stackframe();
1208 const char *owner_username = "";
1209 char *server;
1210 struct user_auth_info *auth_info;
1212 load_case_tables();
1214 /* set default debug level to 1 regardless of what smb.conf sets */
1215 setup_logging( "smbcacls", DEBUG_STDERR);
1216 lp_set_cmdline("log level", "1");
1218 setlinebuf(stdout);
1220 lp_load(get_dyn_CONFIGFILE(),True,False,False,True);
1221 load_interfaces();
1223 auth_info = user_auth_info_init(frame);
1224 if (auth_info == NULL) {
1225 exit(1);
1227 popt_common_set_auth_info(auth_info);
1229 pc = poptGetContext("smbcacls", argc, argv, long_options, 0);
1231 poptSetOtherOptionHelp(pc, "//server1/share1 filename\nACLs look like: "
1232 "'ACL:user:[ALLOWED|DENIED]/flags/permissions'");
1234 while ((opt = poptGetNextOpt(pc)) != -1) {
1235 switch (opt) {
1236 case 'S':
1237 the_acl = smb_xstrdup(poptGetOptArg(pc));
1238 mode = SMB_ACL_SET;
1239 break;
1241 case 'D':
1242 the_acl = smb_xstrdup(poptGetOptArg(pc));
1243 mode = SMB_ACL_DELETE;
1244 break;
1246 case 'M':
1247 the_acl = smb_xstrdup(poptGetOptArg(pc));
1248 mode = SMB_ACL_MODIFY;
1249 break;
1251 case 'a':
1252 the_acl = smb_xstrdup(poptGetOptArg(pc));
1253 mode = SMB_ACL_ADD;
1254 break;
1256 case 'C':
1257 owner_username = poptGetOptArg(pc);
1258 change_mode = REQUEST_CHOWN;
1259 break;
1261 case 'G':
1262 owner_username = poptGetOptArg(pc);
1263 change_mode = REQUEST_CHGRP;
1264 break;
1266 case 'I':
1267 owner_username = poptGetOptArg(pc);
1268 change_mode = REQUEST_INHERIT;
1269 break;
1273 /* Make connection to server */
1274 if(!poptPeekArg(pc)) {
1275 poptPrintUsage(pc, stderr, 0);
1276 return -1;
1279 path = talloc_strdup(frame, poptGetArg(pc));
1280 if (!path) {
1281 return -1;
1284 if(!poptPeekArg(pc)) {
1285 poptPrintUsage(pc, stderr, 0);
1286 return -1;
1289 filename = talloc_strdup(frame, poptGetArg(pc));
1290 if (!filename) {
1291 return -1;
1294 string_replace(path,'/','\\');
1296 server = talloc_strdup(frame, path+2);
1297 if (!server) {
1298 return -1;
1300 share = strchr_m(server,'\\');
1301 if (!share) {
1302 printf("Invalid argument: %s\n", share);
1303 return -1;
1306 *share = 0;
1307 share++;
1309 if (!test_args) {
1310 cli = connect_one(auth_info, server, share);
1311 if (!cli) {
1312 exit(EXIT_FAILED);
1314 } else {
1315 exit(0);
1318 string_replace(filename, '/', '\\');
1319 if (filename[0] != '\\') {
1320 filename = talloc_asprintf(frame,
1321 "\\%s",
1322 filename);
1323 if (!filename) {
1324 return -1;
1328 /* Perform requested action */
1330 if (change_mode == REQUEST_INHERIT) {
1331 result = inherit(cli, filename, owner_username);
1332 } else if (change_mode != REQUEST_NONE) {
1333 result = owner_set(cli, change_mode, filename, owner_username);
1334 } else if (the_acl) {
1335 result = cacl_set(cli, filename, the_acl, mode);
1336 } else {
1337 result = cacl_dump(cli, filename);
1340 TALLOC_FREE(frame);
1342 return result;