2 Unix SMB/CIFS implementation.
5 Copyright (C) Andrew Tridgell 2000
6 Copyright (C) Tim Potter 2000
7 Copyright (C) Jeremy Allison 2000
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
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, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 static fstring password;
27 static pstring username;
28 static pstring owner_username;
29 static fstring server;
32 static TALLOC_CTX *ctx;
34 #define CREATE_ACCESS_READ READ_CONTROL_ACCESS
35 #define CREATE_ACCESS_WRITE (WRITE_DAC_ACCESS | WRITE_OWNER_ACCESS)
37 /* numeric is set when the user wants numeric SIDs and ACEs rather
38 than going via LSA calls to resolve them */
41 enum acl_mode {SMB_ACL_SET, SMB_ACL_DELETE, SMB_ACL_MODIFY, SMB_ACL_ADD };
42 enum chown_mode {REQUEST_NONE, REQUEST_CHOWN, REQUEST_CHGRP};
43 enum exit_values {EXIT_OK, EXIT_FAILED, EXIT_PARSE_ERROR};
45 extern pstring global_myname;
46 extern fstring global_myworkgroup;
53 /* These values discovered by inspection */
55 static struct perm_value special_values[] = {
65 static struct perm_value standard_values[] = {
66 { "READ", 0x001200a9 },
67 { "CHANGE", 0x001301bf },
68 { "FULL", 0x001f01ff },
72 static struct cli_state *global_hack_cli;
73 static POLICY_HND pol;
74 static BOOL got_policy_hnd;
76 static struct cli_state *connect_one(char *share);
78 /* Open cli connection and policy handle */
80 static BOOL cacls_open_policy_hnd(void)
82 /* Initialise cli LSA connection */
84 if (!global_hack_cli) {
85 global_hack_cli = connect_one("IPC$");
86 if (!cli_nt_session_open (global_hack_cli, PI_LSARPC)) {
91 /* Open policy handle */
93 if (!got_policy_hnd) {
95 /* Some systems don't support SEC_RIGHTS_MAXIMUM_ALLOWED,
96 but NT sends 0x2000000 so we might as well do it too. */
98 if (!NT_STATUS_IS_OK(cli_lsa_open_policy(global_hack_cli, global_hack_cli->mem_ctx, True,
99 GENERIC_EXECUTE_ACCESS, &pol))) {
103 got_policy_hnd = True;
109 /* convert a SID to a string, either numeric or username/group */
110 static void SidToString(fstring str, DOM_SID *sid)
112 char **domains = NULL;
114 uint32 *types = NULL;
116 sid_to_string(str, sid);
120 /* Ask LSA to convert the sid to a name */
122 if (!cacls_open_policy_hnd() ||
123 !NT_STATUS_IS_OK(cli_lsa_lookup_sids(global_hack_cli, global_hack_cli->mem_ctx,
124 &pol, 1, sid, &domains,
126 !domains || !domains[0] || !names || !names[0]) {
132 slprintf(str, sizeof(fstring) - 1, "%s%s%s",
133 domains[0], lp_winbind_separator(),
138 /* convert a string to a SID, either numeric or username/group */
139 static BOOL StringToSid(DOM_SID *sid, const char *str)
141 uint32 *types = NULL;
142 DOM_SID *sids = NULL;
145 if (strncmp(str, "S-", 2) == 0) {
146 return string_to_sid(sid, str);
149 if (!cacls_open_policy_hnd() ||
150 !NT_STATUS_IS_OK(cli_lsa_lookup_names(global_hack_cli, global_hack_cli->mem_ctx,
151 &pol, 1, &str, &sids,
157 sid_copy(sid, &sids[0]);
164 /* print an ACE on a FILE, using either numeric or ascii representation */
165 static void print_ace(FILE *f, SEC_ACE *ace)
167 struct perm_value *v;
172 SidToString(sidstr, &ace->trustee);
174 fprintf(f, "%s:", sidstr);
177 fprintf(f, "%d/%d/0x%08x",
178 ace->type, ace->flags, ace->info.mask);
184 if (ace->type == SEC_ACE_TYPE_ACCESS_ALLOWED) {
185 fprintf(f, "ALLOWED");
186 } else if (ace->type == SEC_ACE_TYPE_ACCESS_DENIED) {
187 fprintf(f, "DENIED");
189 fprintf(f, "%d", ace->type);
192 /* Not sure what flags can be set in a file ACL */
194 fprintf(f, "/%d/", ace->flags);
196 /* Standard permissions */
198 for (v = standard_values; v->perm; v++) {
199 if (ace->info.mask == v->mask) {
200 fprintf(f, "%s", v->perm);
205 /* Special permissions. Print out a hex value if we have
206 leftover bits in the mask. */
208 got_mask = ace->info.mask;
211 for (v = special_values; v->perm; v++) {
212 if ((ace->info.mask & v->mask) == v->mask) {
214 fprintf(f, "%s", v->perm);
216 got_mask &= ~v->mask;
222 fprintf(f, "0x%08x", ace->info.mask);
231 /* parse an ACE in the same format as print_ace() */
232 static BOOL parse_ace(SEC_ACE *ace, char *str)
236 unsigned atype, aflags, amask;
239 struct perm_value *v;
242 p = strchr_m(str,':');
243 if (!p) return False;
247 /* Try to parse numeric form */
249 if (sscanf(p, "%i/%i/%i", &atype, &aflags, &amask) == 3 &&
250 StringToSid(&sid, str)) {
254 /* Try to parse text form */
256 if (!StringToSid(&sid, str)) {
260 if (!next_token(&p, tok, "/", sizeof(fstring))) {
264 if (strncmp(tok, "ALLOWED", strlen("ALLOWED")) == 0) {
265 atype = SEC_ACE_TYPE_ACCESS_ALLOWED;
266 } else if (strncmp(tok, "DENIED", strlen("DENIED")) == 0) {
267 atype = SEC_ACE_TYPE_ACCESS_DENIED;
272 /* Only numeric form accepted for flags at present */
274 if (!(next_token(&p, tok, "/", sizeof(fstring)) &&
275 sscanf(tok, "%i", &aflags))) {
279 if (!next_token(&p, tok, "/", sizeof(fstring))) {
283 if (strncmp(tok, "0x", 2) == 0) {
284 if (sscanf(tok, "%i", &amask) != 1) {
290 for (v = standard_values; v->perm; v++) {
291 if (strcmp(tok, v->perm) == 0) {
302 for (v = special_values; v->perm; v++) {
303 if (v->perm[0] == *p) {
309 if (!found) return False;
319 init_sec_ace(ace, &sid, atype, mask, aflags);
323 /* add an ACE to a list of ACEs in a SEC_ACL */
324 static BOOL add_ace(SEC_ACL **the_acl, SEC_ACE *ace)
329 (*the_acl) = make_sec_acl(ctx, 3, 1, ace);
333 aces = calloc(1+(*the_acl)->num_aces,sizeof(SEC_ACE));
334 memcpy(aces, (*the_acl)->ace, (*the_acl)->num_aces * sizeof(SEC_ACE));
335 memcpy(aces+(*the_acl)->num_aces, ace, sizeof(SEC_ACE));
336 new = make_sec_acl(ctx,(*the_acl)->revision,1+(*the_acl)->num_aces, aces);
342 /* parse a ascii version of a security descriptor */
343 static SEC_DESC *sec_desc_parse(char *str)
349 DOM_SID *grp_sid=NULL, *owner_sid=NULL;
353 while (next_token(&p, tok, "\t,\r\n", sizeof(tok))) {
355 if (strncmp(tok,"REVISION:", 9) == 0) {
356 revision = strtol(tok+9, NULL, 16);
360 if (strncmp(tok,"OWNER:", 6) == 0) {
361 owner_sid = (DOM_SID *)calloc(1, sizeof(DOM_SID));
363 !StringToSid(owner_sid, tok+6)) {
364 printf("Failed to parse owner sid\n");
370 if (strncmp(tok,"GROUP:", 6) == 0) {
371 grp_sid = (DOM_SID *)calloc(1, sizeof(DOM_SID));
373 !StringToSid(grp_sid, tok+6)) {
374 printf("Failed to parse group sid\n");
380 if (strncmp(tok,"ACL:", 4) == 0) {
382 if (!parse_ace(&ace, tok+4)) {
383 printf("Failed to parse ACL %s\n", tok);
386 if(!add_ace(&dacl, &ace)) {
387 printf("Failed to add ACL %s\n", tok);
393 printf("Failed to parse security descriptor\n");
397 ret = make_sec_desc(ctx,revision, owner_sid, grp_sid,
398 NULL, dacl, &sd_size);
401 SAFE_FREE(owner_sid);
407 /* print a ascii version of a security descriptor on a FILE handle */
408 static void sec_desc_print(FILE *f, SEC_DESC *sd)
413 printf("REVISION:%d\n", sd->revision);
415 /* Print owner and group sid */
418 SidToString(sidstr, sd->owner_sid);
423 printf("OWNER:%s\n", sidstr);
426 SidToString(sidstr, sd->grp_sid);
431 fprintf(f, "GROUP:%s\n", sidstr);
434 for (i = 0; sd->dacl && i < sd->dacl->num_aces; i++) {
435 SEC_ACE *ace = &sd->dacl->ace[i];
443 /*****************************************************
444 dump the acls for a file
445 *******************************************************/
446 static int cacl_dump(struct cli_state *cli, char *filename)
451 if (test_args) return EXIT_OK;
453 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
455 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
459 sd = cli_query_secdesc(cli, fnum, ctx);
462 printf("ERROR: secdesc query failed: %s\n", cli_errstr(cli));
466 sec_desc_print(stdout, sd);
468 cli_close(cli, fnum);
473 /*****************************************************
474 Change the ownership or group ownership of a file. Just
475 because the NT docs say this can't be done :-). JRA.
476 *******************************************************/
478 static int owner_set(struct cli_state *cli, enum chown_mode change_mode,
479 char *filename, char *new_username)
486 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
489 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
493 if (!StringToSid(&sid, new_username))
494 return EXIT_PARSE_ERROR;
496 old = cli_query_secdesc(cli, fnum, ctx);
498 cli_close(cli, fnum);
501 printf("owner_set: Failed to query old descriptor\n");
505 sd = make_sec_desc(ctx,old->revision,
506 (change_mode == REQUEST_CHOWN) ? &sid : old->owner_sid,
507 (change_mode == REQUEST_CHGRP) ? &sid : old->grp_sid,
508 NULL, old->dacl, &sd_size);
510 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_WRITE);
513 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
517 if (!cli_set_secdesc(cli, fnum, sd)) {
518 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
521 cli_close(cli, fnum);
527 /* The MSDN is contradictory over the ordering of ACE entries in an ACL.
528 However NT4 gives a "The information may have been modified by a
529 computer running Windows NT 5.0" if denied ACEs do not appear before
532 static int ace_compare(SEC_ACE *ace1, SEC_ACE *ace2)
534 if (sec_ace_equal(ace1, ace2))
537 if (ace1->type != ace2->type)
538 return ace2->type - ace1->type;
540 if (sid_compare(&ace1->trustee, &ace2->trustee))
541 return sid_compare(&ace1->trustee, &ace2->trustee);
543 if (ace1->flags != ace2->flags)
544 return ace1->flags - ace2->flags;
546 if (ace1->info.mask != ace2->info.mask)
547 return ace1->info.mask - ace2->info.mask;
549 if (ace1->size != ace2->size)
550 return ace1->size - ace2->size;
552 return memcmp(ace1, ace2, sizeof(SEC_ACE));
555 static void sort_acl(SEC_ACL *the_acl)
558 if (!the_acl) return;
560 qsort(the_acl->ace, the_acl->num_aces, sizeof(the_acl->ace[0]), QSORT_CAST ace_compare);
562 for (i=1;i<the_acl->num_aces;) {
563 if (sec_ace_equal(&the_acl->ace[i-1], &the_acl->ace[i])) {
565 for (j=i; j<the_acl->num_aces-1; j++) {
566 the_acl->ace[j] = the_acl->ace[j+1];
575 /*****************************************************
576 set the ACLs on a file given an ascii description
577 *******************************************************/
578 static int cacl_set(struct cli_state *cli, char *filename,
579 char *the_acl, enum acl_mode mode)
585 int result = EXIT_OK;
587 sd = sec_desc_parse(the_acl);
589 if (!sd) return EXIT_PARSE_ERROR;
590 if (test_args) return EXIT_OK;
592 /* The desired access below is the only one I could find that works
593 with NT4, W2KP and Samba */
595 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
598 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
602 old = cli_query_secdesc(cli, fnum, ctx);
605 printf("calc_set: Failed to query old descriptor\n");
609 cli_close(cli, fnum);
611 /* the logic here is rather more complex than I would like */
614 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
617 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
618 if (sec_ace_equal(&sd->dacl->ace[i],
619 &old->dacl->ace[j])) {
621 for (k=j; k<old->dacl->num_aces-1;k++) {
622 old->dacl->ace[k] = old->dacl->ace[k+1];
624 old->dacl->num_aces--;
625 if (old->dacl->num_aces == 0) {
626 SAFE_FREE(old->dacl->ace);
627 SAFE_FREE(old->dacl);
636 printf("ACL for ACE:");
637 print_ace(stdout, &sd->dacl->ace[i]);
638 printf(" not found\n");
644 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
647 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
648 if (sid_equal(&sd->dacl->ace[i].trustee,
649 &old->dacl->ace[j].trustee)) {
650 old->dacl->ace[j] = sd->dacl->ace[i];
658 SidToString(str, &sd->dacl->ace[i].trustee);
659 printf("ACL for SID %s not found\n", str);
666 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
667 add_ace(&old->dacl, &sd->dacl->ace[i]);
676 /* Denied ACE entries must come before allowed ones */
679 /* Create new security descriptor and set it */
680 sd = make_sec_desc(ctx,old->revision, old->owner_sid, old->grp_sid,
681 NULL, old->dacl, &sd_size);
683 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_WRITE);
686 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
690 if (!cli_set_secdesc(cli, fnum, sd)) {
691 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
692 result = EXIT_FAILED;
697 cli_close(cli, fnum);
703 /*****************************************************
704 return a connection to a server
705 *******************************************************/
706 static struct cli_state *connect_one(char *share)
714 char *pass = getpass("Password: ");
716 pstrcpy(password, pass);
721 if (NT_STATUS_IS_OK(nt_status = cli_full_connection(&c, global_myname, server,
724 username, global_myworkgroup,
728 DEBUG(0,("cli_full_connection failed! (%s)\n", nt_errstr(nt_status)));
734 static void usage(void)
737 "Usage: smbcacls //server1/share1 filename [options]\n\
739 \t-D <acls> delete an acl\n\
740 \t-M <acls> modify an acl\n\
741 \t-A <acls> add an acl\n\
742 \t-S <acls> set acls\n\
743 \t-C username change ownership of a file\n\
744 \t-G username change group ownership of a file\n\
745 \t-n don't resolve sids or masks to names\n\
747 \t-d debuglevel set debug output level\n\
748 \t-U username user to autheticate as\n\
750 The username can be of the form username%%password or\n\
751 workgroup\\username%%password.\n\n\
752 An acl is of the form ACL:<SID>:type/flags/mask\n\
753 You can string acls together with spaces, commas or newlines\n\
757 /****************************************************************************
759 ****************************************************************************/
760 int main(int argc,char *argv[])
768 enum acl_mode mode = SMB_ACL_SET;
769 char *the_acl = NULL;
770 enum chown_mode change_mode = REQUEST_NONE;
773 struct cli_state *cli;
781 if (argc < 3 || argv[1][0] == '-') {
784 exit(EXIT_PARSE_ERROR);
787 setup_logging(argv[0],True);
790 pstrcpy(filename, argv[2]);
791 all_string_sub(share,"/","\\",0);
796 lp_load(dyn_CONFIGFILE,True,False,False);
799 if (getenv("USER")) {
800 pstrcpy(username,getenv("USER"));
802 if ((p=strchr_m(username,'%'))) {
804 pstrcpy(password,p+1);
806 memset(strchr_m(getenv("USER"), '%') + 1, 'X',
811 while ((opt = getopt(argc, argv, "U:nhS:D:A:M:C:G:td:")) != EOF) {
814 pstrcpy(username,optarg);
815 p = strchr_m(username,'%');
818 pstrcpy(password, p+1);
830 mode = SMB_ACL_DELETE;
835 mode = SMB_ACL_MODIFY;
844 pstrcpy(owner_username,optarg);
845 change_mode = REQUEST_CHOWN;
849 pstrcpy(owner_username,optarg);
850 change_mode = REQUEST_CHGRP;
864 exit(EXIT_PARSE_ERROR);
867 DEBUGLEVEL = atoi(optarg);
871 printf("Unknown option %c (%d)\n", (char)opt, opt);
873 exit(EXIT_PARSE_ERROR);
883 exit(EXIT_PARSE_ERROR);
886 /* Make connection to server */
888 fstrcpy(server,share+2);
889 share = strchr_m(server,'\\');
891 share = strchr_m(server,'/');
901 cli = connect_one(share);
910 all_string_sub(filename, "/", "\\", 0);
911 if (filename[0] != '\\') {
914 safe_strcpy(&s[1], filename, sizeof(pstring)-1);
915 pstrcpy(filename, s);
918 /* Perform requested action */
920 if (change_mode != REQUEST_NONE) {
921 result = owner_set(cli, change_mode, filename, owner_username);
922 } else if (the_acl) {
923 result = cacl_set(cli, filename, the_acl, mode);
925 result = cacl_dump(cli, filename);