2 Unix SMB/CIFS implementation.
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/>.
26 static pstring owner_username;
27 static fstring server;
28 static int test_args = False;
29 static TALLOC_CTX *ctx;
31 #define CREATE_ACCESS_READ READ_CONTROL_ACCESS
33 /* numeric is set when the user wants numeric SIDs and ACEs rather
34 than going via LSA calls to resolve them */
35 static BOOL numeric = False;
37 enum acl_mode {SMB_ACL_SET, SMB_ACL_DELETE, SMB_ACL_MODIFY, SMB_ACL_ADD };
38 enum chown_mode {REQUEST_NONE, REQUEST_CHOWN, REQUEST_CHGRP};
39 enum exit_values {EXIT_OK, EXIT_FAILED, EXIT_PARSE_ERROR};
46 /* These values discovered by inspection */
48 static const struct perm_value special_values[] = {
58 static const struct perm_value standard_values[] = {
59 { "READ", 0x001200a9 },
60 { "CHANGE", 0x001301bf },
61 { "FULL", 0x001f01ff },
65 static struct cli_state *global_hack_cli;
66 static struct rpc_pipe_client *global_pipe_hnd;
67 static POLICY_HND pol;
68 static BOOL got_policy_hnd;
70 static struct cli_state *connect_one(const char *share);
72 /* Open cli connection and policy handle */
74 static BOOL cacls_open_policy_hnd(void)
76 /* Initialise cli LSA connection */
78 if (!global_hack_cli) {
80 global_hack_cli = connect_one("IPC$");
81 global_pipe_hnd = cli_rpc_pipe_open_noauth(global_hack_cli, PI_LSARPC, &ret);
82 if (!global_pipe_hnd) {
87 /* Open policy handle */
89 if (!got_policy_hnd) {
91 /* Some systems don't support SEC_RIGHTS_MAXIMUM_ALLOWED,
92 but NT sends 0x2000000 so we might as well do it too. */
94 if (!NT_STATUS_IS_OK(rpccli_lsa_open_policy(global_pipe_hnd, global_hack_cli->mem_ctx, True,
95 GENERIC_EXECUTE_ACCESS, &pol))) {
99 got_policy_hnd = True;
105 /* convert a SID to a string, either numeric or username/group */
106 static void SidToString(fstring str, DOM_SID *sid)
108 char **domains = NULL;
110 enum lsa_SidType *types = NULL;
112 sid_to_string(str, sid);
116 /* Ask LSA to convert the sid to a name */
118 if (!cacls_open_policy_hnd() ||
119 !NT_STATUS_IS_OK(rpccli_lsa_lookup_sids(global_pipe_hnd, global_hack_cli->mem_ctx,
120 &pol, 1, sid, &domains,
122 !domains || !domains[0] || !names || !names[0]) {
128 slprintf(str, sizeof(fstring) - 1, "%s%s%s",
129 domains[0], lp_winbind_separator(),
134 /* convert a string to a SID, either numeric or username/group */
135 static BOOL StringToSid(DOM_SID *sid, const char *str)
137 enum lsa_SidType *types = NULL;
138 DOM_SID *sids = NULL;
141 if (strncmp(str, "S-", 2) == 0) {
142 return string_to_sid(sid, str);
145 if (!cacls_open_policy_hnd() ||
146 !NT_STATUS_IS_OK(rpccli_lsa_lookup_names(global_pipe_hnd, global_hack_cli->mem_ctx,
147 &pol, 1, &str, NULL, 1, &sids,
153 sid_copy(sid, &sids[0]);
160 /* print an ACE on a FILE, using either numeric or ascii representation */
161 static void print_ace(FILE *f, SEC_ACE *ace)
163 const struct perm_value *v;
168 SidToString(sidstr, &ace->trustee);
170 fprintf(f, "%s:", sidstr);
173 fprintf(f, "%d/%d/0x%08x",
174 ace->type, ace->flags, ace->access_mask);
180 if (ace->type == SEC_ACE_TYPE_ACCESS_ALLOWED) {
181 fprintf(f, "ALLOWED");
182 } else if (ace->type == SEC_ACE_TYPE_ACCESS_DENIED) {
183 fprintf(f, "DENIED");
185 fprintf(f, "%d", ace->type);
188 /* Not sure what flags can be set in a file ACL */
190 fprintf(f, "/%d/", ace->flags);
192 /* Standard permissions */
194 for (v = standard_values; v->perm; v++) {
195 if (ace->access_mask == v->mask) {
196 fprintf(f, "%s", v->perm);
201 /* Special permissions. Print out a hex value if we have
202 leftover bits in the mask. */
204 got_mask = ace->access_mask;
207 for (v = special_values; v->perm; v++) {
208 if ((ace->access_mask & v->mask) == v->mask) {
210 fprintf(f, "%s", v->perm);
212 got_mask &= ~v->mask;
218 fprintf(f, "0x%08x", ace->access_mask);
227 /* parse an ACE in the same format as print_ace() */
228 static BOOL parse_ace(SEC_ACE *ace, const char *orig_str)
233 unsigned int atype = 0;
234 unsigned int aflags = 0;
235 unsigned int amask = 0;
238 const struct perm_value *v;
239 char *str = SMB_STRDUP(orig_str);
246 p = strchr_m(str,':');
248 printf("ACE '%s': missing ':'.\n", orig_str);
254 /* Try to parse numeric form */
256 if (sscanf(p, "%i/%i/%i", &atype, &aflags, &amask) == 3 &&
257 StringToSid(&sid, str)) {
261 /* Try to parse text form */
263 if (!StringToSid(&sid, str)) {
264 printf("ACE '%s': failed to convert '%s' to SID\n",
271 if (!next_token(&cp, tok, "/", sizeof(fstring))) {
272 printf("ACE '%s': failed to find '/' character.\n",
278 if (strncmp(tok, "ALLOWED", strlen("ALLOWED")) == 0) {
279 atype = SEC_ACE_TYPE_ACCESS_ALLOWED;
280 } else if (strncmp(tok, "DENIED", strlen("DENIED")) == 0) {
281 atype = SEC_ACE_TYPE_ACCESS_DENIED;
283 printf("ACE '%s': missing 'ALLOWED' or 'DENIED' entry at '%s'\n",
289 /* Only numeric form accepted for flags at present */
291 if (!(next_token(&cp, tok, "/", sizeof(fstring)) &&
292 sscanf(tok, "%i", &aflags))) {
293 printf("ACE '%s': bad integer flags entry at '%s'\n",
299 if (!next_token(&cp, tok, "/", sizeof(fstring))) {
300 printf("ACE '%s': missing / at '%s'\n",
306 if (strncmp(tok, "0x", 2) == 0) {
307 if (sscanf(tok, "%i", &amask) != 1) {
308 printf("ACE '%s': bad hex number at '%s'\n",
316 for (v = standard_values; v->perm; v++) {
317 if (strcmp(tok, v->perm) == 0) {
328 for (v = special_values; v->perm; v++) {
329 if (v->perm[0] == *p) {
336 printf("ACE '%s': bad permission value at '%s'\n",
351 init_sec_ace(ace, &sid, atype, mask, aflags);
356 /* add an ACE to a list of ACEs in a SEC_ACL */
357 static BOOL add_ace(SEC_ACL **the_acl, SEC_ACE *ace)
362 return (((*the_acl) = make_sec_acl(ctx, 3, 1, ace)) != NULL);
365 if (!(aces = SMB_CALLOC_ARRAY(SEC_ACE, 1+(*the_acl)->num_aces))) {
368 memcpy(aces, (*the_acl)->aces, (*the_acl)->num_aces * sizeof(SEC_ACE));
369 memcpy(aces+(*the_acl)->num_aces, ace, sizeof(SEC_ACE));
370 new_ace = make_sec_acl(ctx,(*the_acl)->revision,1+(*the_acl)->num_aces, aces);
372 (*the_acl) = new_ace;
376 /* parse a ascii version of a security descriptor */
377 static SEC_DESC *sec_desc_parse(char *str)
381 SEC_DESC *ret = NULL;
383 DOM_SID *grp_sid=NULL, *owner_sid=NULL;
387 while (next_token(&p, tok, "\t,\r\n", sizeof(tok))) {
389 if (strncmp(tok,"REVISION:", 9) == 0) {
390 revision = strtol(tok+9, NULL, 16);
394 if (strncmp(tok,"OWNER:", 6) == 0) {
396 printf("Only specify owner once\n");
399 owner_sid = SMB_CALLOC_ARRAY(DOM_SID, 1);
401 !StringToSid(owner_sid, tok+6)) {
402 printf("Failed to parse owner sid\n");
408 if (strncmp(tok,"GROUP:", 6) == 0) {
410 printf("Only specify group once\n");
413 grp_sid = SMB_CALLOC_ARRAY(DOM_SID, 1);
415 !StringToSid(grp_sid, tok+6)) {
416 printf("Failed to parse group sid\n");
422 if (strncmp(tok,"ACL:", 4) == 0) {
424 if (!parse_ace(&ace, tok+4)) {
427 if(!add_ace(&dacl, &ace)) {
428 printf("Failed to add ACL %s\n", tok);
434 printf("Failed to parse token '%s' in security descriptor,\n", tok);
438 ret = make_sec_desc(ctx,revision, SEC_DESC_SELF_RELATIVE, owner_sid, grp_sid,
439 NULL, dacl, &sd_size);
443 SAFE_FREE(owner_sid);
449 /* print a ascii version of a security descriptor on a FILE handle */
450 static void sec_desc_print(FILE *f, SEC_DESC *sd)
455 fprintf(f, "REVISION:%d\n", sd->revision);
457 /* Print owner and group sid */
460 SidToString(sidstr, sd->owner_sid);
465 fprintf(f, "OWNER:%s\n", sidstr);
468 SidToString(sidstr, sd->group_sid);
473 fprintf(f, "GROUP:%s\n", sidstr);
476 for (i = 0; sd->dacl && i < sd->dacl->num_aces; i++) {
477 SEC_ACE *ace = &sd->dacl->aces[i];
485 /*****************************************************
486 dump the acls for a file
487 *******************************************************/
488 static int cacl_dump(struct cli_state *cli, char *filename)
490 int result = EXIT_FAILED;
497 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
500 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
504 sd = cli_query_secdesc(cli, fnum, ctx);
507 printf("ERROR: secdesc query failed: %s\n", cli_errstr(cli));
511 sec_desc_print(stdout, sd);
517 cli_close(cli, fnum);
522 /*****************************************************
523 Change the ownership or group ownership of a file. Just
524 because the NT docs say this can't be done :-). JRA.
525 *******************************************************/
527 static int owner_set(struct cli_state *cli, enum chown_mode change_mode,
528 char *filename, char *new_username)
535 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
538 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
542 if (!StringToSid(&sid, new_username))
543 return EXIT_PARSE_ERROR;
545 old = cli_query_secdesc(cli, fnum, ctx);
547 cli_close(cli, fnum);
550 printf("owner_set: Failed to query old descriptor\n");
554 sd = make_sec_desc(ctx,old->revision, old->type,
555 (change_mode == REQUEST_CHOWN) ? &sid : NULL,
556 (change_mode == REQUEST_CHGRP) ? &sid : NULL,
557 NULL, NULL, &sd_size);
559 fnum = cli_nt_create(cli, filename, WRITE_OWNER_ACCESS);
562 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
566 if (!cli_set_secdesc(cli, fnum, sd)) {
567 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
570 cli_close(cli, fnum);
576 /* The MSDN is contradictory over the ordering of ACE entries in an ACL.
577 However NT4 gives a "The information may have been modified by a
578 computer running Windows NT 5.0" if denied ACEs do not appear before
581 static int ace_compare(SEC_ACE *ace1, SEC_ACE *ace2)
583 if (sec_ace_equal(ace1, ace2))
586 if (ace1->type != ace2->type)
587 return ace2->type - ace1->type;
589 if (sid_compare(&ace1->trustee, &ace2->trustee))
590 return sid_compare(&ace1->trustee, &ace2->trustee);
592 if (ace1->flags != ace2->flags)
593 return ace1->flags - ace2->flags;
595 if (ace1->access_mask != ace2->access_mask)
596 return ace1->access_mask - ace2->access_mask;
598 if (ace1->size != ace2->size)
599 return ace1->size - ace2->size;
601 return memcmp(ace1, ace2, sizeof(SEC_ACE));
604 static void sort_acl(SEC_ACL *the_acl)
607 if (!the_acl) return;
609 qsort(the_acl->aces, the_acl->num_aces, sizeof(the_acl->aces[0]), QSORT_CAST ace_compare);
611 for (i=1;i<the_acl->num_aces;) {
612 if (sec_ace_equal(&the_acl->aces[i-1], &the_acl->aces[i])) {
614 for (j=i; j<the_acl->num_aces-1; j++) {
615 the_acl->aces[j] = the_acl->aces[j+1];
624 /*****************************************************
625 set the ACLs on a file given an ascii description
626 *******************************************************/
627 static int cacl_set(struct cli_state *cli, char *filename,
628 char *the_acl, enum acl_mode mode)
634 int result = EXIT_OK;
636 sd = sec_desc_parse(the_acl);
638 if (!sd) return EXIT_PARSE_ERROR;
639 if (test_args) return EXIT_OK;
641 /* The desired access below is the only one I could find that works
642 with NT4, W2KP and Samba */
644 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
647 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
651 old = cli_query_secdesc(cli, fnum, ctx);
654 printf("calc_set: Failed to query old descriptor\n");
658 cli_close(cli, fnum);
660 /* the logic here is rather more complex than I would like */
663 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
666 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
667 if (sec_ace_equal(&sd->dacl->aces[i],
668 &old->dacl->aces[j])) {
670 for (k=j; k<old->dacl->num_aces-1;k++) {
671 old->dacl->aces[k] = old->dacl->aces[k+1];
673 old->dacl->num_aces--;
680 printf("ACL for ACE:");
681 print_ace(stdout, &sd->dacl->aces[i]);
682 printf(" not found\n");
688 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
691 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
692 if (sid_equal(&sd->dacl->aces[i].trustee,
693 &old->dacl->aces[j].trustee)) {
694 old->dacl->aces[j] = sd->dacl->aces[i];
702 SidToString(str, &sd->dacl->aces[i].trustee);
703 printf("ACL for SID %s not found\n", str);
708 old->owner_sid = sd->owner_sid;
712 old->group_sid = sd->group_sid;
718 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
719 add_ace(&old->dacl, &sd->dacl->aces[i]);
728 /* Denied ACE entries must come before allowed ones */
731 /* Create new security descriptor and set it */
733 /* We used to just have "WRITE_DAC_ACCESS" without WRITE_OWNER.
734 But if we're sending an owner, even if it's the same as the one
735 that already exists then W2K3 insists we open with WRITE_OWNER access.
736 I need to check that setting a SD with no owner set works against WNT
740 sd = make_sec_desc(ctx,old->revision, old->type, old->owner_sid, old->group_sid,
741 NULL, old->dacl, &sd_size);
743 fnum = cli_nt_create(cli, filename, WRITE_DAC_ACCESS|WRITE_OWNER_ACCESS);
746 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
750 if (!cli_set_secdesc(cli, fnum, sd)) {
751 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
752 result = EXIT_FAILED;
757 cli_close(cli, fnum);
763 /*****************************************************
764 return a connection to a server
765 *******************************************************/
766 static struct cli_state *connect_one(const char *share)
773 if (!cmdline_auth_info.got_pass) {
774 char *pass = getpass("Password: ");
776 pstrcpy(cmdline_auth_info.password, pass);
777 cmdline_auth_info.got_pass = True;
781 if (NT_STATUS_IS_OK(nt_status = cli_full_connection(&c, global_myname(), server,
784 cmdline_auth_info.username, lp_workgroup(),
785 cmdline_auth_info.password, 0,
786 cmdline_auth_info.signing_state, NULL))) {
789 DEBUG(0,("cli_full_connection failed! (%s)\n", nt_errstr(nt_status)));
794 /****************************************************************************
796 ****************************************************************************/
797 int main(int argc, const char *argv[])
801 enum acl_mode mode = SMB_ACL_SET;
802 static char *the_acl = NULL;
803 enum chown_mode change_mode = REQUEST_NONE;
808 struct poptOption long_options[] = {
810 { "delete", 'D', POPT_ARG_STRING, NULL, 'D', "Delete an acl", "ACL" },
811 { "modify", 'M', POPT_ARG_STRING, NULL, 'M', "Modify an acl", "ACL" },
812 { "add", 'a', POPT_ARG_STRING, NULL, 'a', "Add an acl", "ACL" },
813 { "set", 'S', POPT_ARG_STRING, NULL, 'S', "Set acls", "ACLS" },
814 { "chown", 'C', POPT_ARG_STRING, NULL, 'C', "Change ownership of a file", "USERNAME" },
815 { "chgrp", 'G', POPT_ARG_STRING, NULL, 'G', "Change group ownership of a file", "GROUPNAME" },
816 { "numeric", 0, POPT_ARG_NONE, &numeric, True, "Don't resolve sids or masks to names" },
817 { "test-args", 't', POPT_ARG_NONE, &test_args, True, "Test arguments"},
819 POPT_COMMON_CREDENTIALS
823 struct cli_state *cli;
827 ctx=talloc_stackframe();
829 /* set default debug level to 1 regardless of what smb.conf sets */
830 setup_logging( "smbcacls", True );
831 DEBUGLEVEL_CLASS[DBGC_ALL] = 1;
833 x_setbuf( x_stderr, NULL );
837 lp_load(dyn_CONFIGFILE,True,False,False,True);
840 pc = poptGetContext("smbcacls", argc, argv, long_options, 0);
842 poptSetOtherOptionHelp(pc, "//server1/share1 filename\nACLs look like: "
843 "'ACL:user:[ALLOWED|DENIED]/flags/permissions'");
845 while ((opt = poptGetNextOpt(pc)) != -1) {
848 the_acl = smb_xstrdup(poptGetOptArg(pc));
853 the_acl = smb_xstrdup(poptGetOptArg(pc));
854 mode = SMB_ACL_DELETE;
858 the_acl = smb_xstrdup(poptGetOptArg(pc));
859 mode = SMB_ACL_MODIFY;
863 the_acl = smb_xstrdup(poptGetOptArg(pc));
868 pstrcpy(owner_username,poptGetOptArg(pc));
869 change_mode = REQUEST_CHOWN;
873 pstrcpy(owner_username,poptGetOptArg(pc));
874 change_mode = REQUEST_CHGRP;
879 /* Make connection to server */
880 if(!poptPeekArg(pc)) {
881 poptPrintUsage(pc, stderr, 0);
885 fstrcpy(path, poptGetArg(pc));
887 if(!poptPeekArg(pc)) {
888 poptPrintUsage(pc, stderr, 0);
892 pstrcpy(filename, poptGetArg(pc));
894 all_string_sub(path,"/","\\",0);
896 fstrcpy(server,path+2);
897 share = strchr_m(server,'\\');
899 printf("Invalid argument: %s\n", share);
907 cli = connect_one(share);
916 all_string_sub(filename, "/", "\\", 0);
917 if (filename[0] != '\\') {
920 safe_strcpy(&s[1], filename, sizeof(pstring)-2);
921 pstrcpy(filename, s);
924 /* Perform requested action */
926 if (change_mode != REQUEST_NONE) {
927 result = owner_set(cli, change_mode, filename, owner_username);
928 } else if (the_acl) {
929 result = cacl_set(cli, filename, the_acl, mode);
931 result = cacl_dump(cli, filename);