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 int test_args = False;
28 #define CREATE_ACCESS_READ READ_CONTROL_ACCESS
30 /* numeric is set when the user wants numeric SIDs and ACEs rather
31 than going via LSA calls to resolve them */
32 static int numeric = False;
34 enum acl_mode {SMB_ACL_SET, SMB_ACL_DELETE, SMB_ACL_MODIFY, SMB_ACL_ADD };
35 enum chown_mode {REQUEST_NONE, REQUEST_CHOWN, REQUEST_CHGRP};
36 enum exit_values {EXIT_OK, EXIT_FAILED, EXIT_PARSE_ERROR};
43 /* These values discovered by inspection */
45 static const struct perm_value special_values[] = {
55 static const struct perm_value standard_values[] = {
56 { "READ", 0x001200a9 },
57 { "CHANGE", 0x001301bf },
58 { "FULL", 0x001f01ff },
62 /* Open cli connection and policy handle */
64 static NTSTATUS cli_lsa_lookup_sid(struct cli_state *cli,
67 enum lsa_SidType *type,
68 char **domain, char **name)
70 uint16 orig_cnum = cli->cnum;
71 struct rpc_pipe_client *p;
72 struct policy_handle handle;
74 TALLOC_CTX *frame = talloc_stackframe();
75 enum lsa_SidType *types;
79 if (!cli_send_tconX(cli, "IPC$", "?????", "", 0)) {
80 return cli_nt_error(cli);
83 status = cli_rpc_pipe_open_noauth(cli, &ndr_table_lsarpc.syntax_id,
85 if (!NT_STATUS_IS_OK(status)) {
89 status = rpccli_lsa_open_policy(p, talloc_tos(), True,
90 GENERIC_EXECUTE_ACCESS, &handle);
91 if (!NT_STATUS_IS_OK(status)) {
95 status = rpccli_lsa_lookup_sids(p, talloc_tos(), &handle, 1, sid,
96 &domains, &names, &types);
97 if (!NT_STATUS_IS_OK(status)) {
102 *domain = talloc_move(mem_ctx, &domains[0]);
103 *name = talloc_move(mem_ctx, &names[0]);
105 status = NT_STATUS_OK;
109 cli->cnum = orig_cnum;
114 static NTSTATUS cli_lsa_lookup_name(struct cli_state *cli,
116 enum lsa_SidType *type,
119 uint16 orig_cnum = cli->cnum;
120 struct rpc_pipe_client *p;
121 struct policy_handle handle;
123 TALLOC_CTX *frame = talloc_stackframe();
125 enum lsa_SidType *types;
127 if (!cli_send_tconX(cli, "IPC$", "?????", "", 0)) {
128 return cli_nt_error(cli);
131 status = cli_rpc_pipe_open_noauth(cli, &ndr_table_lsarpc.syntax_id,
133 if (!NT_STATUS_IS_OK(status)) {
137 status = rpccli_lsa_open_policy(p, talloc_tos(), True,
138 GENERIC_EXECUTE_ACCESS, &handle);
139 if (!NT_STATUS_IS_OK(status)) {
143 status = rpccli_lsa_lookup_names(p, talloc_tos(), &handle, 1, &name,
144 NULL, 1, &sids, &types);
145 if (!NT_STATUS_IS_OK(status)) {
152 status = NT_STATUS_OK;
156 cli->cnum = orig_cnum;
161 /* convert a SID to a string, either numeric or username/group */
162 static void SidToString(struct cli_state *cli, fstring str, const DOM_SID *sid)
166 enum lsa_SidType type;
169 sid_to_fstring(str, sid);
175 status = cli_lsa_lookup_sid(cli, sid, talloc_tos(), &type,
178 if (!NT_STATUS_IS_OK(status)) {
182 slprintf(str, sizeof(fstring) - 1, "%s%s%s",
183 domain, lp_winbind_separator(), name);
187 /* convert a string to a SID, either numeric or username/group */
188 static bool StringToSid(struct cli_state *cli, DOM_SID *sid, const char *str)
190 enum lsa_SidType type;
192 if (strncmp(str, "S-", 2) == 0) {
193 return string_to_sid(sid, str);
196 return NT_STATUS_IS_OK(cli_lsa_lookup_name(cli, str, &type, sid));
200 /* print an ACE on a FILE, using either numeric or ascii representation */
201 static void print_ace(struct cli_state *cli, FILE *f, SEC_ACE *ace)
203 const struct perm_value *v;
208 SidToString(cli, sidstr, &ace->trustee);
210 fprintf(f, "%s:", sidstr);
213 fprintf(f, "%d/%d/0x%08x",
214 ace->type, ace->flags, ace->access_mask);
220 if (ace->type == SEC_ACE_TYPE_ACCESS_ALLOWED) {
221 fprintf(f, "ALLOWED");
222 } else if (ace->type == SEC_ACE_TYPE_ACCESS_DENIED) {
223 fprintf(f, "DENIED");
225 fprintf(f, "%d", ace->type);
228 /* Not sure what flags can be set in a file ACL */
230 fprintf(f, "/%d/", ace->flags);
232 /* Standard permissions */
234 for (v = standard_values; v->perm; v++) {
235 if (ace->access_mask == v->mask) {
236 fprintf(f, "%s", v->perm);
241 /* Special permissions. Print out a hex value if we have
242 leftover bits in the mask. */
244 got_mask = ace->access_mask;
247 for (v = special_values; v->perm; v++) {
248 if ((ace->access_mask & v->mask) == v->mask) {
250 fprintf(f, "%s", v->perm);
252 got_mask &= ~v->mask;
258 fprintf(f, "0x%08x", ace->access_mask);
267 /* parse an ACE in the same format as print_ace() */
268 static bool parse_ace(struct cli_state *cli, SEC_ACE *ace,
269 const char *orig_str)
274 unsigned int atype = 0;
275 unsigned int aflags = 0;
276 unsigned int amask = 0;
279 const struct perm_value *v;
280 char *str = SMB_STRDUP(orig_str);
281 TALLOC_CTX *frame = talloc_stackframe();
289 p = strchr_m(str,':');
291 printf("ACE '%s': missing ':'.\n", orig_str);
298 /* Try to parse numeric form */
300 if (sscanf(p, "%i/%i/%i", &atype, &aflags, &amask) == 3 &&
301 StringToSid(cli, &sid, str)) {
305 /* Try to parse text form */
307 if (!StringToSid(cli, &sid, str)) {
308 printf("ACE '%s': failed to convert '%s' to SID\n",
316 if (!next_token_talloc(frame, &cp, &tok, "/")) {
317 printf("ACE '%s': failed to find '/' character.\n",
324 if (strncmp(tok, "ALLOWED", strlen("ALLOWED")) == 0) {
325 atype = SEC_ACE_TYPE_ACCESS_ALLOWED;
326 } else if (strncmp(tok, "DENIED", strlen("DENIED")) == 0) {
327 atype = SEC_ACE_TYPE_ACCESS_DENIED;
329 printf("ACE '%s': missing 'ALLOWED' or 'DENIED' entry at '%s'\n",
336 /* Only numeric form accepted for flags at present */
338 if (!(next_token_talloc(frame, &cp, &tok, "/") &&
339 sscanf(tok, "%i", &aflags))) {
340 printf("ACE '%s': bad integer flags entry at '%s'\n",
347 if (!next_token_talloc(frame, &cp, &tok, "/")) {
348 printf("ACE '%s': missing / at '%s'\n",
355 if (strncmp(tok, "0x", 2) == 0) {
356 if (sscanf(tok, "%i", &amask) != 1) {
357 printf("ACE '%s': bad hex number at '%s'\n",
366 for (v = standard_values; v->perm; v++) {
367 if (strcmp(tok, v->perm) == 0) {
378 for (v = special_values; v->perm; v++) {
379 if (v->perm[0] == *p) {
386 printf("ACE '%s': bad permission value at '%s'\n",
403 init_sec_ace(ace, &sid, atype, mask, aflags);
409 /* add an ACE to a list of ACEs in a SEC_ACL */
410 static bool add_ace(SEC_ACL **the_acl, SEC_ACE *ace)
415 return (((*the_acl) = make_sec_acl(talloc_tos(), 3, 1, ace))
419 if (!(aces = SMB_CALLOC_ARRAY(SEC_ACE, 1+(*the_acl)->num_aces))) {
422 memcpy(aces, (*the_acl)->aces, (*the_acl)->num_aces * sizeof(SEC_ACE));
423 memcpy(aces+(*the_acl)->num_aces, ace, sizeof(SEC_ACE));
424 new_ace = make_sec_acl(talloc_tos(),(*the_acl)->revision,1+(*the_acl)->num_aces, aces);
426 (*the_acl) = new_ace;
430 /* parse a ascii version of a security descriptor */
431 static SEC_DESC *sec_desc_parse(TALLOC_CTX *ctx, struct cli_state *cli, char *str)
435 SEC_DESC *ret = NULL;
437 DOM_SID *grp_sid=NULL, *owner_sid=NULL;
441 while (next_token_talloc(ctx, &p, &tok, "\t,\r\n")) {
442 if (strncmp(tok,"REVISION:", 9) == 0) {
443 revision = strtol(tok+9, NULL, 16);
447 if (strncmp(tok,"OWNER:", 6) == 0) {
449 printf("Only specify owner once\n");
452 owner_sid = SMB_CALLOC_ARRAY(DOM_SID, 1);
454 !StringToSid(cli, owner_sid, tok+6)) {
455 printf("Failed to parse owner sid\n");
461 if (strncmp(tok,"GROUP:", 6) == 0) {
463 printf("Only specify group once\n");
466 grp_sid = SMB_CALLOC_ARRAY(DOM_SID, 1);
468 !StringToSid(cli, grp_sid, tok+6)) {
469 printf("Failed to parse group sid\n");
475 if (strncmp(tok,"ACL:", 4) == 0) {
477 if (!parse_ace(cli, &ace, tok+4)) {
480 if(!add_ace(&dacl, &ace)) {
481 printf("Failed to add ACL %s\n", tok);
487 printf("Failed to parse token '%s' in security descriptor,\n", tok);
491 ret = make_sec_desc(ctx,revision, SEC_DESC_SELF_RELATIVE, owner_sid, grp_sid,
492 NULL, dacl, &sd_size);
496 SAFE_FREE(owner_sid);
502 /* print a ascii version of a security descriptor on a FILE handle */
503 static void sec_desc_print(struct cli_state *cli, FILE *f, SEC_DESC *sd)
508 fprintf(f, "REVISION:%d\n", sd->revision);
510 /* Print owner and group sid */
513 SidToString(cli, sidstr, sd->owner_sid);
518 fprintf(f, "OWNER:%s\n", sidstr);
521 SidToString(cli, sidstr, sd->group_sid);
526 fprintf(f, "GROUP:%s\n", sidstr);
529 for (i = 0; sd->dacl && i < sd->dacl->num_aces; i++) {
530 SEC_ACE *ace = &sd->dacl->aces[i];
532 print_ace(cli, f, ace);
538 /*****************************************************
539 dump the acls for a file
540 *******************************************************/
541 static int cacl_dump(struct cli_state *cli, char *filename)
543 int result = EXIT_FAILED;
550 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
553 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
557 sd = cli_query_secdesc(cli, fnum, talloc_tos());
560 printf("ERROR: secdesc query failed: %s\n", cli_errstr(cli));
564 sec_desc_print(cli, stdout, sd);
570 cli_close(cli, fnum);
575 /*****************************************************
576 Change the ownership or group ownership of a file. Just
577 because the NT docs say this can't be done :-). JRA.
578 *******************************************************/
580 static int owner_set(struct cli_state *cli, enum chown_mode change_mode,
581 const char *filename, const char *new_username)
588 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
591 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
595 if (!StringToSid(cli, &sid, new_username))
596 return EXIT_PARSE_ERROR;
598 old = cli_query_secdesc(cli, fnum, talloc_tos());
600 cli_close(cli, fnum);
603 printf("owner_set: Failed to query old descriptor\n");
607 sd = make_sec_desc(talloc_tos(),old->revision, old->type,
608 (change_mode == REQUEST_CHOWN) ? &sid : NULL,
609 (change_mode == REQUEST_CHGRP) ? &sid : NULL,
610 NULL, NULL, &sd_size);
612 fnum = cli_nt_create(cli, filename, WRITE_OWNER_ACCESS);
615 printf("Failed to open %s: %s\n", filename, cli_errstr(cli));
619 if (!cli_set_secdesc(cli, fnum, sd)) {
620 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
623 cli_close(cli, fnum);
629 /* The MSDN is contradictory over the ordering of ACE entries in an ACL.
630 However NT4 gives a "The information may have been modified by a
631 computer running Windows NT 5.0" if denied ACEs do not appear before
634 static int ace_compare(SEC_ACE *ace1, SEC_ACE *ace2)
636 if (sec_ace_equal(ace1, ace2))
639 if (ace1->type != ace2->type)
640 return ace2->type - ace1->type;
642 if (sid_compare(&ace1->trustee, &ace2->trustee))
643 return sid_compare(&ace1->trustee, &ace2->trustee);
645 if (ace1->flags != ace2->flags)
646 return ace1->flags - ace2->flags;
648 if (ace1->access_mask != ace2->access_mask)
649 return ace1->access_mask - ace2->access_mask;
651 if (ace1->size != ace2->size)
652 return ace1->size - ace2->size;
654 return memcmp(ace1, ace2, sizeof(SEC_ACE));
657 static void sort_acl(SEC_ACL *the_acl)
660 if (!the_acl) return;
662 qsort(the_acl->aces, the_acl->num_aces, sizeof(the_acl->aces[0]), QSORT_CAST ace_compare);
664 for (i=1;i<the_acl->num_aces;) {
665 if (sec_ace_equal(&the_acl->aces[i-1], &the_acl->aces[i])) {
667 for (j=i; j<the_acl->num_aces-1; j++) {
668 the_acl->aces[j] = the_acl->aces[j+1];
677 /*****************************************************
678 set the ACLs on a file given an ascii description
679 *******************************************************/
680 static int cacl_set(struct cli_state *cli, char *filename,
681 char *the_acl, enum acl_mode mode)
687 int result = EXIT_OK;
689 sd = sec_desc_parse(talloc_tos(), cli, the_acl);
691 if (!sd) return EXIT_PARSE_ERROR;
692 if (test_args) return EXIT_OK;
694 /* The desired access below is the only one I could find that works
695 with NT4, W2KP and Samba */
697 fnum = cli_nt_create(cli, filename, CREATE_ACCESS_READ);
700 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
704 old = cli_query_secdesc(cli, fnum, talloc_tos());
707 printf("calc_set: Failed to query old descriptor\n");
711 cli_close(cli, fnum);
713 /* the logic here is rather more complex than I would like */
716 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
719 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
720 if (sec_ace_equal(&sd->dacl->aces[i],
721 &old->dacl->aces[j])) {
723 for (k=j; k<old->dacl->num_aces-1;k++) {
724 old->dacl->aces[k] = old->dacl->aces[k+1];
726 old->dacl->num_aces--;
733 printf("ACL for ACE:");
734 print_ace(cli, stdout, &sd->dacl->aces[i]);
735 printf(" not found\n");
741 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
744 for (j=0;old->dacl && j<old->dacl->num_aces;j++) {
745 if (sid_equal(&sd->dacl->aces[i].trustee,
746 &old->dacl->aces[j].trustee)) {
747 old->dacl->aces[j] = sd->dacl->aces[i];
755 SidToString(cli, str,
756 &sd->dacl->aces[i].trustee);
757 printf("ACL for SID %s not found\n", str);
762 old->owner_sid = sd->owner_sid;
766 old->group_sid = sd->group_sid;
772 for (i=0;sd->dacl && i<sd->dacl->num_aces;i++) {
773 add_ace(&old->dacl, &sd->dacl->aces[i]);
782 /* Denied ACE entries must come before allowed ones */
785 /* Create new security descriptor and set it */
787 /* We used to just have "WRITE_DAC_ACCESS" without WRITE_OWNER.
788 But if we're sending an owner, even if it's the same as the one
789 that already exists then W2K3 insists we open with WRITE_OWNER access.
790 I need to check that setting a SD with no owner set works against WNT
794 sd = make_sec_desc(talloc_tos(),old->revision, old->type,
795 old->owner_sid, old->group_sid,
796 NULL, old->dacl, &sd_size);
798 fnum = cli_nt_create(cli, filename, WRITE_DAC_ACCESS|WRITE_OWNER_ACCESS);
801 printf("cacl_set failed to open %s: %s\n", filename, cli_errstr(cli));
805 if (!cli_set_secdesc(cli, fnum, sd)) {
806 printf("ERROR: secdesc set failed: %s\n", cli_errstr(cli));
807 result = EXIT_FAILED;
812 cli_close(cli, fnum);
818 /*****************************************************
819 Return a connection to a server.
820 *******************************************************/
821 static struct cli_state *connect_one(const char *server, const char *share)
823 struct cli_state *c = NULL;
824 struct sockaddr_storage ss;
830 if (get_cmdline_auth_info_use_kerberos()) {
831 flags |= CLI_FULL_CONNECTION_USE_KERBEROS |
832 CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS;
835 if (get_cmdline_auth_info_use_machine_account() &&
836 !set_cmdline_auth_info_machine_account_creds()) {
840 if (!get_cmdline_auth_info_got_pass()) {
841 char *pass = getpass("Password: ");
843 set_cmdline_auth_info_password(pass);
847 nt_status = cli_full_connection(&c, global_myname(), server,
850 get_cmdline_auth_info_username(),
852 get_cmdline_auth_info_password(),
854 get_cmdline_auth_info_signing_state(),
856 if (!NT_STATUS_IS_OK(nt_status)) {
857 DEBUG(0,("cli_full_connection failed! (%s)\n", nt_errstr(nt_status)));
861 if (get_cmdline_auth_info_smb_encrypt()) {
862 nt_status = cli_cm_force_encryption(c,
863 get_cmdline_auth_info_username(),
864 get_cmdline_auth_info_password(),
867 if (!NT_STATUS_IS_OK(nt_status)) {
876 /****************************************************************************
878 ****************************************************************************/
879 int main(int argc, const char *argv[])
883 enum acl_mode mode = SMB_ACL_SET;
884 static char *the_acl = NULL;
885 enum chown_mode change_mode = REQUEST_NONE;
888 char *filename = NULL;
890 struct poptOption long_options[] = {
892 { "delete", 'D', POPT_ARG_STRING, NULL, 'D', "Delete an acl", "ACL" },
893 { "modify", 'M', POPT_ARG_STRING, NULL, 'M', "Modify an acl", "ACL" },
894 { "add", 'a', POPT_ARG_STRING, NULL, 'a', "Add an acl", "ACL" },
895 { "set", 'S', POPT_ARG_STRING, NULL, 'S', "Set acls", "ACLS" },
896 { "chown", 'C', POPT_ARG_STRING, NULL, 'C', "Change ownership of a file", "USERNAME" },
897 { "chgrp", 'G', POPT_ARG_STRING, NULL, 'G', "Change group ownership of a file", "GROUPNAME" },
898 { "numeric", 0, POPT_ARG_NONE, &numeric, True, "Don't resolve sids or masks to names" },
899 { "test-args", 't', POPT_ARG_NONE, &test_args, True, "Test arguments"},
901 POPT_COMMON_CONNECTION
902 POPT_COMMON_CREDENTIALS
906 struct cli_state *cli;
907 TALLOC_CTX *frame = talloc_stackframe();
908 const char *owner_username = "";
914 /* set default debug level to 1 regardless of what smb.conf sets */
915 setup_logging( "smbcacls", True );
916 DEBUGLEVEL_CLASS[DBGC_ALL] = 1;
918 x_setbuf( x_stderr, NULL );
922 lp_load(get_dyn_CONFIGFILE(),True,False,False,True);
925 pc = poptGetContext("smbcacls", argc, argv, long_options, 0);
927 poptSetOtherOptionHelp(pc, "//server1/share1 filename\nACLs look like: "
928 "'ACL:user:[ALLOWED|DENIED]/flags/permissions'");
930 while ((opt = poptGetNextOpt(pc)) != -1) {
933 the_acl = smb_xstrdup(poptGetOptArg(pc));
938 the_acl = smb_xstrdup(poptGetOptArg(pc));
939 mode = SMB_ACL_DELETE;
943 the_acl = smb_xstrdup(poptGetOptArg(pc));
944 mode = SMB_ACL_MODIFY;
948 the_acl = smb_xstrdup(poptGetOptArg(pc));
953 owner_username = poptGetOptArg(pc);
954 change_mode = REQUEST_CHOWN;
958 owner_username = poptGetOptArg(pc);
959 change_mode = REQUEST_CHGRP;
964 /* Make connection to server */
965 if(!poptPeekArg(pc)) {
966 poptPrintUsage(pc, stderr, 0);
970 path = talloc_strdup(frame, poptGetArg(pc));
975 if(!poptPeekArg(pc)) {
976 poptPrintUsage(pc, stderr, 0);
980 filename = talloc_strdup(frame, poptGetArg(pc));
985 string_replace(path,'/','\\');
987 server = talloc_strdup(frame, path+2);
991 share = strchr_m(server,'\\');
993 printf("Invalid argument: %s\n", share);
1001 cli = connect_one(server, share);
1009 string_replace(filename, '/', '\\');
1010 if (filename[0] != '\\') {
1011 filename = talloc_asprintf(frame,
1019 /* Perform requested action */
1021 if (change_mode != REQUEST_NONE) {
1022 result = owner_set(cli, change_mode, filename, owner_username);
1023 } else if (the_acl) {
1024 result = cacl_set(cli, filename, the_acl, mode);
1026 result = cacl_dump(cli, filename);