docs: Fix some typos in the idmap backend section.
[Samba.git] / source3 / utils / net_usershare.c
blob78d38daaf97b4fae4764773544dd8527f302a844
1 /*
2 Samba Unix/Linux SMB client library
3 Distributed SMB/CIFS Server Management Utility
5 Copyright (C) Jeremy Allison (jra@samba.org) 2005
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "includes.h"
22 #include "system/passwd.h"
23 #include "system/filesys.h"
24 #include "utils/net.h"
25 #include "../libcli/security/security.h"
27 struct {
28 const char *us_errstr;
29 enum usershare_err us_err;
30 } us_errs [] = {
31 {"",USERSHARE_OK},
32 {N_("Malformed usershare file"), USERSHARE_MALFORMED_FILE},
33 {N_("Bad version number"), USERSHARE_BAD_VERSION},
34 {N_("Malformed path entry"), USERSHARE_MALFORMED_PATH},
35 {N_("Malformed comment entryfile"), USERSHARE_MALFORMED_COMMENT_DEF},
36 {N_("Malformed acl definition"), USERSHARE_MALFORMED_ACL_DEF},
37 {N_("Acl parse error"), USERSHARE_ACL_ERR},
38 {N_("Path not absolute"), USERSHARE_PATH_NOT_ABSOLUTE},
39 {N_("Path is denied"), USERSHARE_PATH_IS_DENIED},
40 {N_("Path not allowed"), USERSHARE_PATH_NOT_ALLOWED},
41 {N_("Path is not a directory"), USERSHARE_PATH_NOT_DIRECTORY},
42 {N_("System error"), USERSHARE_POSIX_ERR},
43 {N_("Malformed sharename definition"), USERSHARE_MALFORMED_SHARENAME_DEF},
44 {N_("Bad sharename (doesn't match filename)"), USERSHARE_BAD_SHARENAME},
45 {NULL,(enum usershare_err)-1}
48 static const char *get_us_error_code(enum usershare_err us_err)
50 char *result;
51 int idx = 0;
53 while (us_errs[idx].us_errstr != NULL) {
54 if (us_errs[idx].us_err == us_err) {
55 return us_errs[idx].us_errstr;
57 idx++;
60 result = talloc_asprintf(talloc_tos(), _("Usershare error code (0x%x)"),
61 (unsigned int)us_err);
62 SMB_ASSERT(result != NULL);
63 return result;
66 /* The help subsystem for the USERSHARE subcommand */
68 static int net_usershare_add_usage(struct net_context *c, int argc, const char **argv)
70 char chr = *lp_winbind_separator();
71 d_printf(_(
72 "net usershare add [-l|--long] <sharename> <path> [<comment>] [<acl>] [<guest_ok=[y|n]>]\n"
73 "\tAdds the specified share name for this user.\n"
74 "\t<sharename> is the new share name.\n"
75 "\t<path> is the path on the filesystem to export.\n"
76 "\t<comment> is the optional comment for the new share.\n"
77 "\t<acl> is an optional share acl in the format \"DOMAIN%cname:X,DOMAIN%cname:X,....\"\n"
78 "\t<guest_ok=y> if present sets \"guest ok = yes\" on this usershare.\n"
79 "\t\t\"X\" represents a permission and can be any one of the characters f, r or d\n"
80 "\t\twhere \"f\" means full control, \"r\" means read-only, \"d\" means deny access.\n"
81 "\t\tname may be a domain user or group. For local users use the local server name "
82 "instead of \"DOMAIN\"\n"
83 "\t\tThe default acl is \"Everyone:r\" which allows everyone read-only access.\n"
84 "\tAdd -l or --long to print the info on the newly added share.\n"),
85 chr, chr );
86 return -1;
89 static int net_usershare_delete_usage(struct net_context *c, int argc, const char **argv)
91 d_printf(_(
92 "net usershare delete <sharename>\n"
93 "\tdeletes the specified share name for this user.\n"));
94 return -1;
97 static int net_usershare_info_usage(struct net_context *c, int argc, const char **argv)
99 d_printf(_(
100 "net usershare info [-l|--long] [wildcard sharename]\n"
101 "\tPrints out the path, comment and acl elements of shares that match the wildcard.\n"
102 "\tBy default only gives info on shares owned by the current user\n"
103 "\tAdd -l or --long to apply this to all shares\n"
104 "\tOmit the sharename or use a wildcard of '*' to see all shares\n"));
105 return -1;
108 static int net_usershare_list_usage(struct net_context *c, int argc, const char **argv)
110 d_printf(_(
111 "net usershare list [-l|--long] [wildcard sharename]\n"
112 "\tLists the names of all shares that match the wildcard.\n"
113 "\tBy default only lists shares owned by the current user\n"
114 "\tAdd -l or --long to apply this to all shares\n"
115 "\tOmit the sharename or use a wildcard of '*' to see all shares\n"));
116 return -1;
119 int net_usershare_usage(struct net_context *c, int argc, const char **argv)
121 d_printf(_("net usershare add <sharename> <path> [<comment>] [<acl>] [<guest_ok=[y|n]>] to "
122 "add or change a user defined share.\n"
123 "net usershare delete <sharename> to delete a user defined share.\n"
124 "net usershare info [-l|--long] [wildcard sharename] to print info about a user defined share.\n"
125 "net usershare list [-l|--long] [wildcard sharename] to list user defined shares.\n"
126 "net usershare help\n"
127 "\nType \"net usershare help <option>\" to get more information on that option\n\n"));
129 net_common_flags_usage(c, argc, argv);
130 return -1;
133 /***************************************************************************
134 ***************************************************************************/
136 static char *get_basepath(TALLOC_CTX *ctx)
138 char *basepath = lp_usershare_path(ctx);
140 if (!basepath) {
141 return NULL;
143 if ((basepath[0] != '\0') && (basepath[strlen(basepath)-1] == '/')) {
144 basepath[strlen(basepath)-1] = '\0';
146 return basepath;
149 /***************************************************************************
150 Delete a single userlevel share.
151 ***************************************************************************/
153 static int net_usershare_delete(struct net_context *c, int argc, const char **argv)
155 char *us_path;
156 char *sharename;
158 if (argc != 1 || c->display_usage) {
159 return net_usershare_delete_usage(c, argc, argv);
162 if ((sharename = strlower_talloc(talloc_tos(), argv[0])) == NULL) {
163 d_fprintf(stderr, _("strlower_talloc failed\n"));
164 return -1;
167 if (!validate_net_name(sharename, INVALID_SHARENAME_CHARS, strlen(sharename))) {
168 d_fprintf(stderr, _("net usershare delete: share name %s contains "
169 "invalid characters (any of %s)\n"),
170 sharename, INVALID_SHARENAME_CHARS);
171 TALLOC_FREE(sharename);
172 return -1;
175 us_path = talloc_asprintf(talloc_tos(),
176 "%s/%s",
177 lp_usershare_path(talloc_tos()),
178 sharename);
179 if (!us_path) {
180 TALLOC_FREE(sharename);
181 return -1;
184 if (unlink(us_path) != 0) {
185 d_fprintf(stderr, _("net usershare delete: unable to remove usershare %s. "
186 "Error was %s\n"),
187 us_path, strerror(errno));
188 TALLOC_FREE(sharename);
189 return -1;
191 TALLOC_FREE(sharename);
192 return 0;
195 /***************************************************************************
196 Data structures to handle a list of usershare files.
197 ***************************************************************************/
199 struct file_list {
200 struct file_list *next, *prev;
201 const char *pathname;
204 static struct file_list *flist;
206 /***************************************************************************
207 ***************************************************************************/
209 static int get_share_list(TALLOC_CTX *ctx, const char *wcard, bool only_ours)
211 DIR *dp;
212 struct dirent *de;
213 uid_t myuid = geteuid();
214 struct file_list *fl = NULL;
215 char *basepath = get_basepath(ctx);
217 if (!basepath) {
218 return -1;
220 dp = opendir(basepath);
221 if (!dp) {
222 d_fprintf(stderr,
223 _("get_share_list: cannot open usershare directory %s. "
224 "Error %s\n"),
225 basepath, strerror(errno) );
226 return -1;
229 while((de = readdir(dp)) != 0) {
230 SMB_STRUCT_STAT sbuf;
231 char *path;
232 const char *n = de->d_name;
234 /* Ignore . and .. */
235 if (*n == '.') {
236 if ((n[1] == '\0') || (n[1] == '.' && n[2] == '\0')) {
237 continue;
241 if (!validate_net_name(n, INVALID_SHARENAME_CHARS, strlen(n))) {
242 d_fprintf(stderr,
243 _("get_share_list: ignoring bad share "
244 "name %s\n"), n);
245 continue;
247 path = talloc_asprintf(ctx,
248 "%s/%s",
249 basepath,
251 if (!path) {
252 closedir(dp);
253 return -1;
256 if (sys_lstat(path, &sbuf, false) != 0) {
257 d_fprintf(stderr,
258 _("get_share_list: can't lstat file %s. Error "
259 "was %s\n"),
260 path, strerror(errno) );
261 continue;
264 if (!S_ISREG(sbuf.st_ex_mode)) {
265 d_fprintf(stderr,
266 _("get_share_list: file %s is not a regular "
267 "file. Ignoring.\n"),
268 path );
269 continue;
272 if (only_ours && sbuf.st_ex_uid != myuid) {
273 continue;
276 if (!unix_wild_match(wcard, n)) {
277 continue;
280 /* (Finally) - add to list. */
281 fl = talloc(ctx, struct file_list);
282 if (!fl) {
283 closedir(dp);
284 return -1;
286 fl->pathname = talloc_strdup(ctx, n);
287 if (!fl->pathname) {
288 closedir(dp);
289 return -1;
292 DLIST_ADD(flist, fl);
295 closedir(dp);
296 return 0;
299 enum us_priv_op { US_LIST_OP, US_INFO_OP};
301 struct us_priv_info {
302 TALLOC_CTX *ctx;
303 enum us_priv_op op;
304 struct net_context *c;
307 /***************************************************************************
308 Call a function for every share on the list.
309 ***************************************************************************/
311 static int process_share_list(int (*fn)(struct file_list *, void *), void *priv)
313 struct file_list *fl;
314 int ret = 0;
316 for (fl = flist; fl; fl = fl->next) {
317 ret = (*fn)(fl, priv);
320 return ret;
323 /***************************************************************************
324 Info function.
325 ***************************************************************************/
327 static int info_fn(struct file_list *fl, void *priv)
329 SMB_STRUCT_STAT sbuf;
330 char **lines = NULL;
331 struct us_priv_info *pi = (struct us_priv_info *)priv;
332 TALLOC_CTX *ctx = pi->ctx;
333 struct net_context *c = pi->c;
334 int fd = -1;
335 int numlines = 0;
336 struct security_descriptor *psd = NULL;
337 char *basepath;
338 char *sharepath = NULL;
339 char *comment = NULL;
340 char *cp_sharename = NULL;
341 char *acl_str;
342 int num_aces;
343 char sep_str[2];
344 enum usershare_err us_err;
345 bool guest_ok = false;
347 sep_str[0] = *lp_winbind_separator();
348 sep_str[1] = '\0';
350 basepath = get_basepath(ctx);
351 if (!basepath) {
352 return -1;
354 basepath = talloc_asprintf_append(basepath,
355 "/%s",
356 fl->pathname);
357 if (!basepath) {
358 return -1;
361 #ifdef O_NOFOLLOW
362 fd = open(basepath, O_RDONLY|O_NOFOLLOW, 0);
363 #else
364 fd = open(basepath, O_RDONLY, 0);
365 #endif
367 if (fd == -1) {
368 d_fprintf(stderr, _("info_fn: unable to open %s. %s\n"),
369 basepath, strerror(errno) );
370 return -1;
373 /* Paranoia... */
374 if (sys_fstat(fd, &sbuf, false) != 0) {
375 d_fprintf(stderr,
376 _("info_fn: can't fstat file %s. Error was %s\n"),
377 basepath, strerror(errno) );
378 close(fd);
379 return -1;
382 if (!S_ISREG(sbuf.st_ex_mode)) {
383 d_fprintf(stderr,
384 _("info_fn: file %s is not a regular file. Ignoring.\n"),
385 basepath );
386 close(fd);
387 return -1;
390 lines = fd_lines_load(fd, &numlines, 10240, NULL);
391 close(fd);
393 if (lines == NULL) {
394 return -1;
397 /* Ensure it's well formed. */
398 us_err = parse_usershare_file(ctx, &sbuf, fl->pathname, -1, lines, numlines,
399 &sharepath,
400 &comment,
401 &cp_sharename,
402 &psd,
403 &guest_ok);
405 TALLOC_FREE(lines);
407 if (us_err != USERSHARE_OK) {
408 d_fprintf(stderr,
409 _("info_fn: file %s is not a well formed usershare "
410 "file.\n"),
411 basepath );
412 d_fprintf(stderr, _("info_fn: Error was %s.\n"),
413 get_us_error_code(us_err) );
414 return -1;
417 acl_str = talloc_strdup(ctx, "usershare_acl=");
418 if (!acl_str) {
419 return -1;
422 for (num_aces = 0; num_aces < psd->dacl->num_aces; num_aces++) {
423 const char *domain;
424 const char *name;
425 NTSTATUS ntstatus;
427 ntstatus = net_lookup_name_from_sid(c, ctx,
428 &psd->dacl->aces[num_aces].trustee,
429 &domain, &name);
431 if (NT_STATUS_IS_OK(ntstatus)) {
432 if (domain && *domain) {
433 acl_str = talloc_asprintf_append(acl_str,
434 "%s%s",
435 domain,
436 sep_str);
437 if (!acl_str) {
438 return -1;
441 acl_str = talloc_asprintf_append(acl_str,
442 "%s",
443 name);
444 if (!acl_str) {
445 return -1;
448 } else {
449 fstring sidstr;
450 sid_to_fstring(sidstr,
451 &psd->dacl->aces[num_aces].trustee);
452 acl_str = talloc_asprintf_append(acl_str,
453 "%s",
454 sidstr);
455 if (!acl_str) {
456 return -1;
459 acl_str = talloc_asprintf_append(acl_str, ":");
460 if (!acl_str) {
461 return -1;
464 if (psd->dacl->aces[num_aces].type == SEC_ACE_TYPE_ACCESS_DENIED) {
465 acl_str = talloc_asprintf_append(acl_str, "D,");
466 if (!acl_str) {
467 return -1;
469 } else {
470 if (psd->dacl->aces[num_aces].access_mask & GENERIC_ALL_ACCESS) {
471 acl_str = talloc_asprintf_append(acl_str, "F,");
472 } else {
473 acl_str = talloc_asprintf_append(acl_str, "R,");
475 if (!acl_str) {
476 return -1;
481 /* NOTE: This is smb.conf-like output. Do not translate. */
482 if (pi->op == US_INFO_OP) {
483 d_printf("[%s]\n", cp_sharename );
484 d_printf("path=%s\n", sharepath );
485 d_printf("comment=%s\n", comment);
486 d_printf("%s\n", acl_str);
487 d_printf("guest_ok=%c\n\n", guest_ok ? 'y' : 'n');
488 } else if (pi->op == US_LIST_OP) {
489 d_printf("%s\n", cp_sharename);
492 return 0;
495 /***************************************************************************
496 Print out info (internal detail) on userlevel shares.
497 ***************************************************************************/
499 static int net_usershare_info(struct net_context *c, int argc, const char **argv)
501 fstring wcard;
502 bool only_ours = true;
503 int ret = -1;
504 struct us_priv_info pi;
505 TALLOC_CTX *ctx;
507 fstrcpy(wcard, "*");
509 if (c->display_usage)
510 return net_usershare_info_usage(c, argc, argv);
512 if (c->opt_long_list_entries) {
513 only_ours = false;
516 switch (argc) {
517 case 0:
518 break;
519 case 1:
520 fstrcpy(wcard, argv[0]);
521 break;
522 default:
523 return net_usershare_info_usage(c, argc, argv);
526 if (!strlower_m(wcard)) {
527 return -1;
530 ctx = talloc_init("share_info");
531 ret = get_share_list(ctx, wcard, only_ours);
532 if (ret) {
533 return ret;
536 pi.ctx = ctx;
537 pi.op = US_INFO_OP;
538 pi.c = c;
540 ret = process_share_list(info_fn, &pi);
541 talloc_destroy(ctx);
542 return ret;
545 /***************************************************************************
546 Count the current total number of usershares.
547 ***************************************************************************/
549 static int count_num_usershares(void)
551 DIR *dp;
552 struct dirent *de;
553 int num_usershares = 0;
554 TALLOC_CTX *ctx = talloc_tos();
555 char *basepath = get_basepath(ctx);
557 if (!basepath) {
558 return -1;
561 dp = opendir(basepath);
562 if (!dp) {
563 d_fprintf(stderr,
564 _("count_num_usershares: cannot open usershare "
565 "directory %s. Error %s\n"),
566 basepath, strerror(errno) );
567 return -1;
570 while((de = readdir(dp)) != 0) {
571 SMB_STRUCT_STAT sbuf;
572 char *path;
573 const char *n = de->d_name;
575 /* Ignore . and .. */
576 if (*n == '.') {
577 if ((n[1] == '\0') || (n[1] == '.' && n[2] == '\0')) {
578 continue;
582 if (!validate_net_name(n, INVALID_SHARENAME_CHARS, strlen(n))) {
583 d_fprintf(stderr,
584 _("count_num_usershares: ignoring bad share "
585 "name %s\n"), n);
586 continue;
588 path = talloc_asprintf(ctx,
589 "%s/%s",
590 basepath,
592 if (!path) {
593 closedir(dp);
594 return -1;
597 if (sys_lstat(path, &sbuf, false) != 0) {
598 d_fprintf(stderr,
599 _("count_num_usershares: can't lstat file %s. "
600 "Error was %s\n"),
601 path, strerror(errno) );
602 continue;
605 if (!S_ISREG(sbuf.st_ex_mode)) {
606 d_fprintf(stderr,
607 _("count_num_usershares: file %s is not a "
608 "regular file. Ignoring.\n"),
609 path );
610 continue;
612 num_usershares++;
615 closedir(dp);
616 return num_usershares;
619 /***************************************************************************
620 Add a single userlevel share.
621 ***************************************************************************/
623 static int net_usershare_add(struct net_context *c, int argc, const char **argv)
625 TALLOC_CTX *ctx = talloc_stackframe();
626 SMB_STRUCT_STAT sbuf;
627 SMB_STRUCT_STAT lsbuf;
628 char *sharename;
629 const char *cp_sharename;
630 char *full_path;
631 char *full_path_tmp;
632 const char *us_path;
633 const char *us_comment;
634 const char *arg_acl;
635 char *us_acl;
636 char *file_img;
637 int num_aces = 0;
638 int i;
639 int tmpfd;
640 const char *pacl;
641 size_t to_write;
642 uid_t myeuid = geteuid();
643 bool guest_ok = false;
644 int num_usershares;
645 mode_t mask;
647 us_comment = "";
648 arg_acl = "S-1-1-0:R";
650 if (c->display_usage)
651 return net_usershare_add_usage(c, argc, argv);
653 switch (argc) {
654 case 0:
655 case 1:
656 default:
657 return net_usershare_add_usage(c, argc, argv);
658 case 2:
659 cp_sharename = argv[0];
660 sharename = strlower_talloc(ctx, argv[0]);
661 us_path = argv[1];
662 break;
663 case 3:
664 cp_sharename = argv[0];
665 sharename = strlower_talloc(ctx, argv[0]);
666 us_path = argv[1];
667 us_comment = argv[2];
668 break;
669 case 4:
670 cp_sharename = argv[0];
671 sharename = strlower_talloc(ctx, argv[0]);
672 us_path = argv[1];
673 us_comment = argv[2];
674 arg_acl = argv[3];
675 break;
676 case 5:
677 cp_sharename = argv[0];
678 sharename = strlower_talloc(ctx, argv[0]);
679 us_path = argv[1];
680 us_comment = argv[2];
681 arg_acl = argv[3];
682 if (strlen(arg_acl) == 0) {
683 arg_acl = "S-1-1-0:R";
685 if (!strnequal(argv[4], "guest_ok=", 9)) {
686 TALLOC_FREE(ctx);
687 return net_usershare_add_usage(c, argc, argv);
689 switch (argv[4][9]) {
690 case 'y':
691 case 'Y':
692 guest_ok = true;
693 break;
694 case 'n':
695 case 'N':
696 guest_ok = false;
697 break;
698 default:
699 TALLOC_FREE(ctx);
700 return net_usershare_add_usage(c, argc, argv);
702 break;
705 /* Ensure we're under the "usershare max shares" number. Advisory only. */
706 num_usershares = count_num_usershares();
707 if (num_usershares >= lp_usershare_max_shares()) {
708 d_fprintf(stderr,
709 _("net usershare add: maximum number of allowed "
710 "usershares (%d) reached\n"),
711 lp_usershare_max_shares() );
712 TALLOC_FREE(ctx);
713 return -1;
716 if (!validate_net_name(sharename, INVALID_SHARENAME_CHARS, strlen(sharename))) {
717 d_fprintf(stderr, _("net usershare add: share name %s contains "
718 "invalid characters (any of %s)\n"),
719 sharename, INVALID_SHARENAME_CHARS);
720 TALLOC_FREE(ctx);
721 return -1;
724 /* Disallow shares the same as users. */
725 if (getpwnam(sharename)) {
726 d_fprintf(stderr,
727 _("net usershare add: share name %s is already a valid "
728 "system user name\n"),
729 sharename );
730 TALLOC_FREE(ctx);
731 return -1;
734 /* Construct the full path for the usershare file. */
735 full_path = get_basepath(ctx);
736 if (!full_path) {
737 TALLOC_FREE(ctx);
738 return -1;
740 full_path_tmp = talloc_asprintf(ctx,
741 "%s/:tmpXXXXXX",
742 full_path);
743 if (!full_path_tmp) {
744 TALLOC_FREE(ctx);
745 return -1;
748 full_path = talloc_asprintf_append(full_path,
749 "/%s",
750 sharename);
751 if (!full_path) {
752 TALLOC_FREE(ctx);
753 return -1;
756 /* The path *must* be absolute. */
757 if (us_path[0] != '/') {
758 d_fprintf(stderr,
759 _("net usershare add: path %s is not an absolute "
760 "path.\n"),
761 us_path);
762 TALLOC_FREE(ctx);
763 return -1;
766 /* Check the directory to be shared exists. */
767 if (sys_stat(us_path, &sbuf, false) != 0) {
768 d_fprintf(stderr,
769 _("net usershare add: cannot stat path %s to ensure "
770 "this is a directory. Error was %s\n"),
771 us_path, strerror(errno) );
772 TALLOC_FREE(ctx);
773 return -1;
776 if (!S_ISDIR(sbuf.st_ex_mode)) {
777 d_fprintf(stderr,
778 _("net usershare add: path %s is not a directory.\n"),
779 us_path );
780 TALLOC_FREE(ctx);
781 return -1;
784 /* If we're not root, check if we're restricted to sharing out directories
785 that we own only. */
787 if ((myeuid != 0) && lp_usershare_owner_only() && (myeuid != sbuf.st_ex_uid)) {
788 d_fprintf(stderr, _("net usershare add: cannot share path %s as "
789 "we are restricted to only sharing directories we own.\n"
790 "\tAsk the administrator to add the line \"usershare owner only = false\" \n"
791 "\tto the [global] section of the smb.conf to allow this.\n"),
792 us_path );
793 TALLOC_FREE(ctx);
794 return -1;
797 /* No validation needed on comment. Now go through and validate the
798 acl string. Convert names to SID's as needed. Then run it through
799 parse_usershare_acl to ensure it's valid. */
801 /* Start off the string we'll append to. */
802 us_acl = talloc_strdup(ctx, "");
803 if (!us_acl) {
804 TALLOC_FREE(ctx);
805 return -1;
808 pacl = arg_acl;
809 num_aces = 1;
811 /* Add the number of ',' characters to get the number of aces. */
812 num_aces += count_chars(pacl,',');
814 for (i = 0; i < num_aces; i++) {
815 struct dom_sid sid;
816 const char *pcolon = strchr_m(pacl, ':');
817 const char *name;
819 if (pcolon == NULL) {
820 d_fprintf(stderr,
821 _("net usershare add: malformed acl %s "
822 "(missing ':').\n"),
823 pacl );
824 TALLOC_FREE(ctx);
825 return -1;
828 switch(pcolon[1]) {
829 case 'f':
830 case 'F':
831 case 'd':
832 case 'r':
833 case 'R':
834 break;
835 default:
836 d_fprintf(stderr,
837 _("net usershare add: malformed acl %s "
838 "(access control must be 'r', 'f', "
839 "or 'd')\n"),
840 pacl );
841 TALLOC_FREE(ctx);
842 return -1;
845 if (pcolon[2] != ',' && pcolon[2] != '\0') {
846 d_fprintf(stderr,
847 _("net usershare add: malformed terminating "
848 "character for acl %s\n"),
849 pacl );
850 TALLOC_FREE(ctx);
851 return -1;
854 /* Get the name */
855 if ((name = talloc_strndup(ctx, pacl, pcolon - pacl)) == NULL) {
856 d_fprintf(stderr, _("talloc_strndup failed\n"));
857 TALLOC_FREE(ctx);
858 return -1;
860 if (!string_to_sid(&sid, name)) {
861 /* Convert to a SID */
862 NTSTATUS ntstatus = net_lookup_sid_from_name(c, ctx, name, &sid);
863 if (!NT_STATUS_IS_OK(ntstatus)) {
864 d_fprintf(stderr,
865 _("net usershare add: cannot convert "
866 "name \"%s\" to a SID. %s."),
867 name, get_friendly_nt_error_msg(ntstatus) );
868 if (NT_STATUS_EQUAL(ntstatus, NT_STATUS_CONNECTION_REFUSED)) {
869 d_fprintf(stderr,
870 _(" Maybe smbd is not running.\n"));
871 } else {
872 d_fprintf(stderr, "\n");
874 TALLOC_FREE(ctx);
875 return -1;
878 us_acl = talloc_asprintf_append(
879 us_acl, "%s:%c,", sid_string_tos(&sid), pcolon[1]);
881 /* Move to the next ACL entry. */
882 if (pcolon[2] == ',') {
883 pacl = &pcolon[3];
887 /* Remove the last ',' */
888 us_acl[strlen(us_acl)-1] = '\0';
890 if (guest_ok && !lp_usershare_allow_guests()) {
891 d_fprintf(stderr, _("net usershare add: guest_ok=y requested "
892 "but the \"usershare allow guests\" parameter is not "
893 "enabled by this server.\n"));
894 TALLOC_FREE(ctx);
895 return -1;
898 /* Create a temporary filename for this share. */
899 mask = umask(S_IRWXO | S_IRWXG);
900 tmpfd = mkstemp(full_path_tmp);
901 umask(mask);
903 if (tmpfd == -1) {
904 d_fprintf(stderr,
905 _("net usershare add: cannot create tmp file %s\n"),
906 full_path_tmp );
907 TALLOC_FREE(ctx);
908 return -1;
911 /* Ensure we opened the file we thought we did. */
912 if (sys_lstat(full_path_tmp, &lsbuf, false) != 0) {
913 d_fprintf(stderr,
914 _("net usershare add: cannot lstat tmp file %s\n"),
915 full_path_tmp );
916 TALLOC_FREE(ctx);
917 close(tmpfd);
918 return -1;
921 /* Check this is the same as the file we opened. */
922 if (sys_fstat(tmpfd, &sbuf, false) != 0) {
923 d_fprintf(stderr,
924 _("net usershare add: cannot fstat tmp file %s\n"),
925 full_path_tmp );
926 TALLOC_FREE(ctx);
927 close(tmpfd);
928 return -1;
931 if (!S_ISREG(sbuf.st_ex_mode) || sbuf.st_ex_dev != lsbuf.st_ex_dev || sbuf.st_ex_ino != lsbuf.st_ex_ino) {
932 d_fprintf(stderr,
933 _("net usershare add: tmp file %s is not a regular "
934 "file ?\n"),
935 full_path_tmp );
936 TALLOC_FREE(ctx);
937 close(tmpfd);
938 return -1;
941 if (fchmod(tmpfd, 0644) == -1) {
942 d_fprintf(stderr,
943 _("net usershare add: failed to fchmod tmp file %s "
944 "to 0644n"),
945 full_path_tmp );
946 TALLOC_FREE(ctx);
947 close(tmpfd);
948 return -1;
951 /* Create the in-memory image of the file. */
952 file_img = talloc_strdup(ctx, "#VERSION 2\npath=");
953 file_img = talloc_asprintf_append(file_img,
954 "%s\ncomment=%s\nusershare_acl=%s\n"
955 "guest_ok=%c\nsharename=%s\n",
956 us_path,
957 us_comment,
958 us_acl,
959 guest_ok ? 'y' : 'n',
960 cp_sharename);
962 to_write = strlen(file_img);
964 if (write(tmpfd, file_img, to_write) != to_write) {
965 d_fprintf(stderr,
966 _("net usershare add: failed to write %u bytes to "
967 "file %s. Error was %s\n"),
968 (unsigned int)to_write, full_path_tmp, strerror(errno));
969 unlink(full_path_tmp);
970 TALLOC_FREE(ctx);
971 close(tmpfd);
972 return -1;
975 /* Attempt to replace any existing share by this name. */
976 if (rename(full_path_tmp, full_path) != 0) {
977 unlink(full_path_tmp);
978 d_fprintf(stderr,
979 _("net usershare add: failed to add share %s. Error "
980 "was %s\n"),
981 sharename, strerror(errno));
982 TALLOC_FREE(ctx);
983 close(tmpfd);
984 return -1;
987 close(tmpfd);
989 if (c->opt_long_list_entries) {
990 const char *my_argv[2];
991 my_argv[0] = sharename;
992 my_argv[1] = NULL;
993 net_usershare_info(c, 1, my_argv);
996 TALLOC_FREE(ctx);
997 return 0;
1000 #if 0
1001 /***************************************************************************
1002 List function.
1003 ***************************************************************************/
1005 static int list_fn(struct file_list *fl, void *priv)
1007 d_printf("%s\n", fl->pathname);
1008 return 0;
1010 #endif
1012 /***************************************************************************
1013 List userlevel shares.
1014 ***************************************************************************/
1016 static int net_usershare_list(struct net_context *c, int argc,
1017 const char **argv)
1019 fstring wcard;
1020 bool only_ours = true;
1021 int ret = -1;
1022 struct us_priv_info pi;
1023 TALLOC_CTX *ctx;
1025 fstrcpy(wcard, "*");
1027 if (c->display_usage)
1028 return net_usershare_list_usage(c, argc, argv);
1030 if (c->opt_long_list_entries) {
1031 only_ours = false;
1034 switch (argc) {
1035 case 0:
1036 break;
1037 case 1:
1038 fstrcpy(wcard, argv[0]);
1039 break;
1040 default:
1041 return net_usershare_list_usage(c, argc, argv);
1044 if (!strlower_m(wcard)) {
1045 return -1;
1048 ctx = talloc_init("share_list");
1049 ret = get_share_list(ctx, wcard, only_ours);
1050 if (ret) {
1051 return ret;
1054 pi.ctx = ctx;
1055 pi.op = US_LIST_OP;
1056 pi.c = c;
1058 ret = process_share_list(info_fn, &pi);
1059 talloc_destroy(ctx);
1060 return ret;
1063 /***************************************************************************
1064 Entry-point for all the USERSHARE functions.
1065 ***************************************************************************/
1067 int net_usershare(struct net_context *c, int argc, const char **argv)
1069 DIR *dp;
1071 struct functable func[] = {
1073 "add",
1074 net_usershare_add,
1075 NET_TRANSPORT_LOCAL,
1076 N_("Add/modify user defined share"),
1077 N_("net usershare add\n"
1078 " Add/modify user defined share")
1081 "delete",
1082 net_usershare_delete,
1083 NET_TRANSPORT_LOCAL,
1084 N_("Delete user defined share"),
1085 N_("net usershare delete\n"
1086 " Delete user defined share")
1089 "info",
1090 net_usershare_info,
1091 NET_TRANSPORT_LOCAL,
1092 N_("Display information about a user defined share"),
1093 N_("net usershare info\n"
1094 " Display information about a user defined share")
1097 "list",
1098 net_usershare_list,
1099 NET_TRANSPORT_LOCAL,
1100 N_("List user defined shares"),
1101 N_("net usershare list\n"
1102 " List user defined shares")
1104 {NULL, NULL, 0, NULL, NULL}
1107 if (lp_usershare_max_shares() == 0) {
1108 d_fprintf(stderr,
1109 _("net usershare: usershares are currently "
1110 "disabled\n"));
1111 return -1;
1114 dp = opendir(lp_usershare_path(talloc_tos()));
1115 if (!dp) {
1116 int err = errno;
1117 d_fprintf(stderr,
1118 _("net usershare: cannot open usershare directory %s. "
1119 "Error %s\n"),
1120 lp_usershare_path(talloc_tos()), strerror(err) );
1121 if (err == EACCES) {
1122 d_fprintf(stderr,
1123 _("You do not have permission to create a "
1124 "usershare. Ask your administrator to grant "
1125 "you permissions to create a share.\n"));
1126 } else if (err == ENOENT) {
1127 d_fprintf(stderr,
1128 _("Please ask your system administrator to "
1129 "enable user sharing.\n"));
1131 return -1;
1133 closedir(dp);
1135 return net_run_function(c, argc, argv, "net usershare", func);