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 2 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, write to the Free Software
22 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
27 static pstring owner_username
;
28 static fstring server
;
29 static int test_args
= False
;
30 static TALLOC_CTX
*ctx
;
32 #define CREATE_ACCESS_READ READ_CONTROL_ACCESS
34 /* numeric is set when the user wants numeric SIDs and ACEs rather
35 than going via LSA calls to resolve them */
36 static BOOL numeric
= False
;
38 enum acl_mode
{SMB_ACL_SET
, SMB_ACL_DELETE
, SMB_ACL_MODIFY
, SMB_ACL_ADD
};
39 enum chown_mode
{REQUEST_NONE
, REQUEST_CHOWN
, REQUEST_CHGRP
};
40 enum exit_values
{EXIT_OK
, EXIT_FAILED
, EXIT_PARSE_ERROR
};
47 /* These values discovered by inspection */
49 static const struct perm_value special_values
[] = {
59 static const struct perm_value standard_values
[] = {
60 { "READ", 0x001200a9 },
61 { "CHANGE", 0x001301bf },
62 { "FULL", 0x001f01ff },
66 static struct cli_state
*global_hack_cli
;
67 static struct rpc_pipe_client
*global_pipe_hnd
;
68 static POLICY_HND pol
;
69 static BOOL got_policy_hnd
;
71 static struct cli_state
*connect_one(const char *share
);
73 /* Open cli connection and policy handle */
75 static BOOL
cacls_open_policy_hnd(void)
77 /* Initialise cli LSA connection */
79 if (!global_hack_cli
) {
81 global_hack_cli
= connect_one("IPC$");
82 global_pipe_hnd
= cli_rpc_pipe_open_noauth(global_hack_cli
, PI_LSARPC
, &ret
);
83 if (!global_pipe_hnd
) {
88 /* Open policy handle */
90 if (!got_policy_hnd
) {
92 /* Some systems don't support SEC_RIGHTS_MAXIMUM_ALLOWED,
93 but NT sends 0x2000000 so we might as well do it too. */
95 if (!NT_STATUS_IS_OK(rpccli_lsa_open_policy(global_pipe_hnd
, global_hack_cli
->mem_ctx
, True
,
96 GENERIC_EXECUTE_ACCESS
, &pol
))) {
100 got_policy_hnd
= True
;
106 /* convert a SID to a string, either numeric or username/group */
107 static void SidToString(fstring str
, DOM_SID
*sid
)
109 char **domains
= NULL
;
111 enum lsa_SidType
*types
= NULL
;
113 sid_to_string(str
, sid
);
117 /* Ask LSA to convert the sid to a name */
119 if (!cacls_open_policy_hnd() ||
120 !NT_STATUS_IS_OK(rpccli_lsa_lookup_sids(global_pipe_hnd
, global_hack_cli
->mem_ctx
,
121 &pol
, 1, sid
, &domains
,
123 !domains
|| !domains
[0] || !names
|| !names
[0]) {
129 slprintf(str
, sizeof(fstring
) - 1, "%s%s%s",
130 domains
[0], lp_winbind_separator(),
135 /* convert a string to a SID, either numeric or username/group */
136 static BOOL
StringToSid(DOM_SID
*sid
, const char *str
)
138 enum lsa_SidType
*types
= NULL
;
139 DOM_SID
*sids
= NULL
;
142 if (strncmp(str
, "S-", 2) == 0) {
143 return string_to_sid(sid
, str
);
146 if (!cacls_open_policy_hnd() ||
147 !NT_STATUS_IS_OK(rpccli_lsa_lookup_names(global_pipe_hnd
, global_hack_cli
->mem_ctx
,
148 &pol
, 1, &str
, NULL
, &sids
,
154 sid_copy(sid
, &sids
[0]);
161 /* print an ACE on a FILE, using either numeric or ascii representation */
162 static void print_ace(FILE *f
, SEC_ACE
*ace
)
164 const struct perm_value
*v
;
169 SidToString(sidstr
, &ace
->trustee
);
171 fprintf(f
, "%s:", sidstr
);
174 fprintf(f
, "%d/%d/0x%08x",
175 ace
->type
, ace
->flags
, ace
->access_mask
);
181 if (ace
->type
== SEC_ACE_TYPE_ACCESS_ALLOWED
) {
182 fprintf(f
, "ALLOWED");
183 } else if (ace
->type
== SEC_ACE_TYPE_ACCESS_DENIED
) {
184 fprintf(f
, "DENIED");
186 fprintf(f
, "%d", ace
->type
);
189 /* Not sure what flags can be set in a file ACL */
191 fprintf(f
, "/%d/", ace
->flags
);
193 /* Standard permissions */
195 for (v
= standard_values
; v
->perm
; v
++) {
196 if (ace
->access_mask
== v
->mask
) {
197 fprintf(f
, "%s", v
->perm
);
202 /* Special permissions. Print out a hex value if we have
203 leftover bits in the mask. */
205 got_mask
= ace
->access_mask
;
208 for (v
= special_values
; v
->perm
; v
++) {
209 if ((ace
->access_mask
& v
->mask
) == v
->mask
) {
211 fprintf(f
, "%s", v
->perm
);
213 got_mask
&= ~v
->mask
;
219 fprintf(f
, "0x%08x", ace
->access_mask
);
228 /* parse an ACE in the same format as print_ace() */
229 static BOOL
parse_ace(SEC_ACE
*ace
, const char *orig_str
)
234 unsigned int atype
= 0;
235 unsigned int aflags
= 0;
236 unsigned int amask
= 0;
239 const struct perm_value
*v
;
240 char *str
= SMB_STRDUP(orig_str
);
247 p
= strchr_m(str
,':');
249 printf("ACE '%s': missing ':'.\n", orig_str
);
255 /* Try to parse numeric form */
257 if (sscanf(p
, "%i/%i/%i", &atype
, &aflags
, &amask
) == 3 &&
258 StringToSid(&sid
, str
)) {
262 /* Try to parse text form */
264 if (!StringToSid(&sid
, str
)) {
265 printf("ACE '%s': failed to convert '%s' to SID\n",
272 if (!next_token(&cp
, tok
, "/", sizeof(fstring
))) {
273 printf("ACE '%s': failed to find '/' character.\n",
279 if (strncmp(tok
, "ALLOWED", strlen("ALLOWED")) == 0) {
280 atype
= SEC_ACE_TYPE_ACCESS_ALLOWED
;
281 } else if (strncmp(tok
, "DENIED", strlen("DENIED")) == 0) {
282 atype
= SEC_ACE_TYPE_ACCESS_DENIED
;
284 printf("ACE '%s': missing 'ALLOWED' or 'DENIED' entry at '%s'\n",
290 /* Only numeric form accepted for flags at present */
292 if (!(next_token(&cp
, tok
, "/", sizeof(fstring
)) &&
293 sscanf(tok
, "%i", &aflags
))) {
294 printf("ACE '%s': bad integer flags entry at '%s'\n",
300 if (!next_token(&cp
, tok
, "/", sizeof(fstring
))) {
301 printf("ACE '%s': missing / at '%s'\n",
307 if (strncmp(tok
, "0x", 2) == 0) {
308 if (sscanf(tok
, "%i", &amask
) != 1) {
309 printf("ACE '%s': bad hex number at '%s'\n",
317 for (v
= standard_values
; v
->perm
; v
++) {
318 if (strcmp(tok
, v
->perm
) == 0) {
329 for (v
= special_values
; v
->perm
; v
++) {
330 if (v
->perm
[0] == *p
) {
337 printf("ACE '%s': bad permission value at '%s'\n",
352 init_sec_ace(ace
, &sid
, atype
, mask
, aflags
);
357 /* add an ACE to a list of ACEs in a SEC_ACL */
358 static BOOL
add_ace(SEC_ACL
**the_acl
, SEC_ACE
*ace
)
363 return (((*the_acl
) = make_sec_acl(ctx
, 3, 1, ace
)) != NULL
);
366 if (!(aces
= SMB_CALLOC_ARRAY(SEC_ACE
, 1+(*the_acl
)->num_aces
))) {
369 memcpy(aces
, (*the_acl
)->aces
, (*the_acl
)->num_aces
* sizeof(SEC_ACE
));
370 memcpy(aces
+(*the_acl
)->num_aces
, ace
, sizeof(SEC_ACE
));
371 new_ace
= make_sec_acl(ctx
,(*the_acl
)->revision
,1+(*the_acl
)->num_aces
, aces
);
373 (*the_acl
) = new_ace
;
377 /* parse a ascii version of a security descriptor */
378 static SEC_DESC
*sec_desc_parse(char *str
)
382 SEC_DESC
*ret
= NULL
;
384 DOM_SID
*group_sid
=NULL
, *owner_sid
=NULL
;
388 while (next_token(&p
, tok
, "\t,\r\n", sizeof(tok
))) {
390 if (strncmp(tok
,"REVISION:", 9) == 0) {
391 revision
= strtol(tok
+9, NULL
, 16);
395 if (strncmp(tok
,"OWNER:", 6) == 0) {
397 printf("Only specify owner once\n");
400 owner_sid
= SMB_CALLOC_ARRAY(DOM_SID
, 1);
402 !StringToSid(owner_sid
, tok
+6)) {
403 printf("Failed to parse owner sid\n");
409 if (strncmp(tok
,"GROUP:", 6) == 0) {
411 printf("Only specify group once\n");
414 group_sid
= SMB_CALLOC_ARRAY(DOM_SID
, 1);
416 !StringToSid(group_sid
, tok
+6)) {
417 printf("Failed to parse group sid\n");
423 if (strncmp(tok
,"ACL:", 4) == 0) {
425 if (!parse_ace(&ace
, tok
+4)) {
428 if(!add_ace(&dacl
, &ace
)) {
429 printf("Failed to add ACL %s\n", tok
);
435 printf("Failed to parse token '%s' in security descriptor,\n", tok
);
439 ret
= make_sec_desc(ctx
,revision
, SEC_DESC_SELF_RELATIVE
, owner_sid
, group_sid
,
440 NULL
, dacl
, &sd_size
);
443 SAFE_FREE(group_sid
);
444 SAFE_FREE(owner_sid
);
450 /* print a ascii version of a security descriptor on a FILE handle */
451 static void sec_desc_print(FILE *f
, SEC_DESC
*sd
)
456 fprintf(f
, "REVISION:%d\n", sd
->revision
);
458 /* Print owner and group sid */
461 SidToString(sidstr
, sd
->owner_sid
);
466 fprintf(f
, "OWNER:%s\n", sidstr
);
469 SidToString(sidstr
, sd
->group_sid
);
474 fprintf(f
, "GROUP:%s\n", sidstr
);
477 for (i
= 0; sd
->dacl
&& i
< sd
->dacl
->num_aces
; i
++) {
478 SEC_ACE
*ace
= &sd
->dacl
->aces
[i
];
486 /*****************************************************
487 dump the acls for a file
488 *******************************************************/
489 static int cacl_dump(struct cli_state
*cli
, char *filename
)
491 int result
= EXIT_FAILED
;
498 fnum
= cli_nt_create(cli
, filename
, CREATE_ACCESS_READ
);
501 printf("Failed to open %s: %s\n", filename
, cli_errstr(cli
));
505 sd
= cli_query_secdesc(cli
, fnum
, ctx
);
508 printf("ERROR: secdesc query failed: %s\n", cli_errstr(cli
));
512 sec_desc_print(stdout
, sd
);
518 cli_close(cli
, fnum
);
523 /*****************************************************
524 Change the ownership or group ownership of a file. Just
525 because the NT docs say this can't be done :-). JRA.
526 *******************************************************/
528 static int owner_set(struct cli_state
*cli
, enum chown_mode change_mode
,
529 char *filename
, char *new_username
)
536 fnum
= cli_nt_create(cli
, filename
, CREATE_ACCESS_READ
);
539 printf("Failed to open %s: %s\n", filename
, cli_errstr(cli
));
543 if (!StringToSid(&sid
, new_username
))
544 return EXIT_PARSE_ERROR
;
546 old
= cli_query_secdesc(cli
, fnum
, ctx
);
548 cli_close(cli
, fnum
);
551 printf("owner_set: Failed to query old descriptor\n");
555 sd
= make_sec_desc(ctx
,old
->revision
, old
->type
,
556 (change_mode
== REQUEST_CHOWN
) ? &sid
: NULL
,
557 (change_mode
== REQUEST_CHGRP
) ? &sid
: NULL
,
558 NULL
, NULL
, &sd_size
);
560 fnum
= cli_nt_create(cli
, filename
, WRITE_OWNER_ACCESS
);
563 printf("Failed to open %s: %s\n", filename
, cli_errstr(cli
));
567 if (!cli_set_secdesc(cli
, fnum
, sd
)) {
568 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli
));
571 cli_close(cli
, fnum
);
577 /* The MSDN is contradictory over the ordering of ACE entries in an ACL.
578 However NT4 gives a "The information may have been modified by a
579 computer running Windows NT 5.0" if denied ACEs do not appear before
582 static int ace_compare(SEC_ACE
*ace1
, SEC_ACE
*ace2
)
584 if (sec_ace_equal(ace1
, ace2
))
587 if (ace1
->type
!= ace2
->type
)
588 return ace2
->type
- ace1
->type
;
590 if (sid_compare(&ace1
->trustee
, &ace2
->trustee
))
591 return sid_compare(&ace1
->trustee
, &ace2
->trustee
);
593 if (ace1
->flags
!= ace2
->flags
)
594 return ace1
->flags
- ace2
->flags
;
596 if (ace1
->access_mask
!= ace2
->access_mask
)
597 return ace1
->access_mask
- ace2
->access_mask
;
599 if (ace1
->size
!= ace2
->size
)
600 return ace1
->size
- ace2
->size
;
602 return memcmp(ace1
, ace2
, sizeof(SEC_ACE
));
605 static void sort_acl(SEC_ACL
*the_acl
)
608 if (!the_acl
) return;
610 qsort(the_acl
->aces
, the_acl
->num_aces
, sizeof(the_acl
->aces
[0]), QSORT_CAST ace_compare
);
612 for (i
=1;i
<the_acl
->num_aces
;) {
613 if (sec_ace_equal(&the_acl
->aces
[i
-1], &the_acl
->aces
[i
])) {
615 for (j
=i
; j
<the_acl
->num_aces
-1; j
++) {
616 the_acl
->aces
[j
] = the_acl
->aces
[j
+1];
625 /*****************************************************
626 set the ACLs on a file given an ascii description
627 *******************************************************/
628 static int cacl_set(struct cli_state
*cli
, char *filename
,
629 char *the_acl
, enum acl_mode mode
)
635 int result
= EXIT_OK
;
637 sd
= sec_desc_parse(the_acl
);
639 if (!sd
) return EXIT_PARSE_ERROR
;
640 if (test_args
) return EXIT_OK
;
642 /* The desired access below is the only one I could find that works
643 with NT4, W2KP and Samba */
645 fnum
= cli_nt_create(cli
, filename
, CREATE_ACCESS_READ
);
648 printf("cacl_set failed to open %s: %s\n", filename
, cli_errstr(cli
));
652 old
= cli_query_secdesc(cli
, fnum
, ctx
);
655 printf("calc_set: Failed to query old descriptor\n");
659 cli_close(cli
, fnum
);
661 /* the logic here is rather more complex than I would like */
664 for (i
=0;sd
->dacl
&& i
<sd
->dacl
->num_aces
;i
++) {
667 for (j
=0;old
->dacl
&& j
<old
->dacl
->num_aces
;j
++) {
668 if (sec_ace_equal(&sd
->dacl
->aces
[i
],
669 &old
->dacl
->aces
[j
])) {
671 for (k
=j
; k
<old
->dacl
->num_aces
-1;k
++) {
672 old
->dacl
->aces
[k
] = old
->dacl
->aces
[k
+1];
674 old
->dacl
->num_aces
--;
681 printf("ACL for ACE:");
682 print_ace(stdout
, &sd
->dacl
->aces
[i
]);
683 printf(" not found\n");
689 for (i
=0;sd
->dacl
&& i
<sd
->dacl
->num_aces
;i
++) {
692 for (j
=0;old
->dacl
&& j
<old
->dacl
->num_aces
;j
++) {
693 if (sid_equal(&sd
->dacl
->aces
[i
].trustee
,
694 &old
->dacl
->aces
[j
].trustee
)) {
695 old
->dacl
->aces
[j
] = sd
->dacl
->aces
[i
];
703 SidToString(str
, &sd
->dacl
->aces
[i
].trustee
);
704 printf("ACL for SID %s not found\n", str
);
709 old
->owner_sid
= sd
->owner_sid
;
713 old
->group_sid
= sd
->group_sid
;
719 for (i
=0;sd
->dacl
&& i
<sd
->dacl
->num_aces
;i
++) {
720 add_ace(&old
->dacl
, &sd
->dacl
->aces
[i
]);
729 /* Denied ACE entries must come before allowed ones */
732 /* Create new security descriptor and set it */
734 /* We used to just have "WRITE_DAC_ACCESS" without WRITE_OWNER.
735 But if we're sending an owner, even if it's the same as the one
736 that already exists then W2K3 insists we open with WRITE_OWNER access.
737 I need to check that setting a SD with no owner set works against WNT
741 sd
= make_sec_desc(ctx
,old
->revision
, old
->type
, old
->owner_sid
, old
->group_sid
,
742 NULL
, old
->dacl
, &sd_size
);
744 fnum
= cli_nt_create(cli
, filename
, WRITE_DAC_ACCESS
|WRITE_OWNER_ACCESS
);
746 sd
= make_sec_desc(ctx
,old
->revision
, old
->type
, NULL
, NULL
,
747 NULL
, old
->dacl
, &sd_size
);
749 fnum
= cli_nt_create(cli
, filename
, WRITE_DAC_ACCESS
);
752 printf("cacl_set failed to open %s: %s\n", filename
, cli_errstr(cli
));
756 if (!cli_set_secdesc(cli
, fnum
, sd
)) {
757 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli
));
758 result
= EXIT_FAILED
;
763 cli_close(cli
, fnum
);
769 /*****************************************************
770 return a connection to a server
771 *******************************************************/
772 static struct cli_state
*connect_one(const char *share
)
779 if (!cmdline_auth_info
.got_pass
) {
780 char *pass
= getpass("Password: ");
782 pstrcpy(cmdline_auth_info
.password
, pass
);
783 cmdline_auth_info
.got_pass
= True
;
787 if (NT_STATUS_IS_OK(nt_status
= cli_full_connection(&c
, global_myname(), server
,
790 cmdline_auth_info
.username
, lp_workgroup(),
791 cmdline_auth_info
.password
,
792 cmdline_auth_info
.use_kerberos
? CLI_FULL_CONNECTION_USE_KERBEROS
: 0,
793 cmdline_auth_info
.signing_state
, NULL
))) {
796 DEBUG(0,("cli_full_connection failed! (%s)\n", nt_errstr(nt_status
)));
801 /****************************************************************************
803 ****************************************************************************/
804 int main(int argc
, const char *argv
[])
808 enum acl_mode mode
= SMB_ACL_SET
;
809 static char *the_acl
= NULL
;
810 enum chown_mode change_mode
= REQUEST_NONE
;
815 struct poptOption long_options
[] = {
817 { "delete", 'D', POPT_ARG_STRING
, NULL
, 'D', "Delete an acl", "ACL" },
818 { "modify", 'M', POPT_ARG_STRING
, NULL
, 'M', "Modify an acl", "ACL" },
819 { "add", 'a', POPT_ARG_STRING
, NULL
, 'a', "Add an acl", "ACL" },
820 { "set", 'S', POPT_ARG_STRING
, NULL
, 'S', "Set acls", "ACLS" },
821 { "chown", 'C', POPT_ARG_STRING
, NULL
, 'C', "Change ownership of a file", "USERNAME" },
822 { "chgrp", 'G', POPT_ARG_STRING
, NULL
, 'G', "Change group ownership of a file", "GROUPNAME" },
823 { "numeric", 0, POPT_ARG_NONE
, &numeric
, True
, "Don't resolve sids or masks to names" },
824 { "test-args", 't', POPT_ARG_NONE
, &test_args
, True
, "Test arguments"},
826 POPT_COMMON_CREDENTIALS
830 struct cli_state
*cli
;
834 ctx
=talloc_init("main");
836 /* set default debug level to 1 regardless of what smb.conf sets */
837 setup_logging( "smbcacls", True
);
838 DEBUGLEVEL_CLASS
[DBGC_ALL
] = 1;
840 x_setbuf( x_stderr
, NULL
);
844 lp_load(dyn_CONFIGFILE
,True
,False
,False
,True
);
847 pc
= poptGetContext("smbcacls", argc
, argv
, long_options
, 0);
849 poptSetOtherOptionHelp(pc
, "//server1/share1 filename\nACLs look like: "
850 "'ACL:user:[ALLOWED|DENIED]/flags/permissions'");
852 while ((opt
= poptGetNextOpt(pc
)) != -1) {
855 the_acl
= smb_xstrdup(poptGetOptArg(pc
));
860 the_acl
= smb_xstrdup(poptGetOptArg(pc
));
861 mode
= SMB_ACL_DELETE
;
865 the_acl
= smb_xstrdup(poptGetOptArg(pc
));
866 mode
= SMB_ACL_MODIFY
;
870 the_acl
= smb_xstrdup(poptGetOptArg(pc
));
875 pstrcpy(owner_username
,poptGetOptArg(pc
));
876 change_mode
= REQUEST_CHOWN
;
880 pstrcpy(owner_username
,poptGetOptArg(pc
));
881 change_mode
= REQUEST_CHGRP
;
886 /* Make connection to server */
887 if(!poptPeekArg(pc
)) {
888 poptPrintUsage(pc
, stderr
, 0);
892 fstrcpy(path
, poptGetArg(pc
));
894 if(!poptPeekArg(pc
)) {
895 poptPrintUsage(pc
, stderr
, 0);
899 pstrcpy(filename
, poptGetArg(pc
));
901 all_string_sub(path
,"/","\\",0);
903 fstrcpy(server
,path
+2);
904 share
= strchr_m(server
,'\\');
906 share
= strchr_m(server
,'/');
908 printf("Invalid argument: %s\n", share
);
917 cli
= connect_one(share
);
926 all_string_sub(filename
, "/", "\\", 0);
927 if (filename
[0] != '\\') {
930 safe_strcpy(&s
[1], filename
, sizeof(pstring
)-2);
931 pstrcpy(filename
, s
);
934 /* Perform requested action */
936 if (change_mode
!= REQUEST_NONE
) {
937 result
= owner_set(cli
, change_mode
, filename
, owner_username
);
938 } else if (the_acl
) {
939 result
= cacl_set(cli
, filename
, the_acl
, mode
);
941 result
= cacl_dump(cli
, filename
);