s3-registry: Check return code of push_reg_sz().
[kai/samba.git] / source3 / utils / net_usershare.c
1 /*
2    Samba Unix/Linux SMB client library
3    Distributed SMB/CIFS Server Management Utility
4
5    Copyright (C) Jeremy Allison (jra@samba.org) 2005
6
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.
11
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.
16
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/>.
19 */
20
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"
26
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}
46 };
47
48 static const char *get_us_error_code(enum usershare_err us_err)
49 {
50         char *result;
51         int idx = 0;
52
53         while (us_errs[idx].us_errstr != NULL) {
54                 if (us_errs[idx].us_err == us_err) {
55                         return us_errs[idx].us_errstr;
56                 }
57                 idx++;
58         }
59
60         result = talloc_asprintf(talloc_tos(), _("Usershare error code (0x%x)"),
61                                  (unsigned int)us_err);
62         SMB_ASSERT(result != NULL);
63         return result;
64 }
65
66 /* The help subsystem for the USERSHARE subcommand */
67
68 static int net_usershare_add_usage(struct net_context *c, int argc, const char **argv)
69 {
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;
87 }
88
89 static int net_usershare_delete_usage(struct net_context *c, int argc, const char **argv)
90 {
91         d_printf(_(
92                 "net usershare delete <sharename>\n"
93                 "\tdeletes the specified share name for this user.\n"));
94         return -1;
95 }
96
97 static int net_usershare_info_usage(struct net_context *c, int argc, const char **argv)
98 {
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;
106 }
107
108 static int net_usershare_list_usage(struct net_context *c, int argc, const char **argv)
109 {
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;
117 }
118
119 int net_usershare_usage(struct net_context *c, int argc, const char **argv)
120 {
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"));
128
129         net_common_flags_usage(c, argc, argv);
130         return -1;
131 }
132
133 /***************************************************************************
134 ***************************************************************************/
135
136 static char *get_basepath(TALLOC_CTX *ctx)
137 {
138         char *basepath = lp_usershare_path(ctx);
139
140         if (!basepath) {
141                 return NULL;
142         }
143         if ((basepath[0] != '\0') && (basepath[strlen(basepath)-1] == '/')) {
144                 basepath[strlen(basepath)-1] = '\0';
145         }
146         return basepath;
147 }
148
149 /***************************************************************************
150  Delete a single userlevel share.
151 ***************************************************************************/
152
153 static int net_usershare_delete(struct net_context *c, int argc, const char **argv)
154 {
155         char *us_path;
156         char *sharename;
157
158         if (argc != 1 || c->display_usage) {
159                 return net_usershare_delete_usage(c, argc, argv);
160         }
161
162         if ((sharename = strlower_talloc(talloc_tos(), argv[0])) == NULL) {
163                 d_fprintf(stderr, _("strlower_talloc failed\n"));
164                 return -1;
165         }
166
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;
173         }
174
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;
182         }
183
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;
190         }
191         TALLOC_FREE(sharename);
192         return 0;
193 }
194
195 /***************************************************************************
196  Data structures to handle a list of usershare files.
197 ***************************************************************************/
198
199 struct file_list {
200         struct file_list *next, *prev;
201         const char *pathname;
202 };
203
204 static struct file_list *flist;
205
206 /***************************************************************************
207 ***************************************************************************/
208
209 static int get_share_list(TALLOC_CTX *ctx, const char *wcard, bool only_ours)
210 {
211         DIR *dp;
212         struct dirent *de;
213         uid_t myuid = geteuid();
214         struct file_list *fl = NULL;
215         char *basepath = get_basepath(ctx);
216
217         if (!basepath) {
218                 return -1;
219         }
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;
227         }
228
229         while((de = readdir(dp)) != 0) {
230                 SMB_STRUCT_STAT sbuf;
231                 char *path;
232                 const char *n = de->d_name;
233
234                 /* Ignore . and .. */
235                 if (*n == '.') {
236                         if ((n[1] == '\0') || (n[1] == '.' && n[2] == '\0')) {
237                                 continue;
238                         }
239                 }
240
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;
246                 }
247                 path = talloc_asprintf(ctx,
248                                         "%s/%s",
249                                         basepath,
250                                         n);
251                 if (!path) {
252                         closedir(dp);
253                         return -1;
254                 }
255
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;
262                 }
263
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;
270                 }
271
272                 if (only_ours && sbuf.st_ex_uid != myuid) {
273                         continue;
274                 }
275
276                 if (!unix_wild_match(wcard, n)) {
277                         continue;
278                 }
279
280                 /* (Finally) - add to list. */
281                 fl = talloc(ctx, struct file_list);
282                 if (!fl) {
283                         closedir(dp);
284                         return -1;
285                 }
286                 fl->pathname = talloc_strdup(ctx, n);
287                 if (!fl->pathname) {
288                         closedir(dp);
289                         return -1;
290                 }
291
292                 DLIST_ADD(flist, fl);
293         }
294
295         closedir(dp);
296         return 0;
297 }
298
299 enum us_priv_op { US_LIST_OP, US_INFO_OP};
300
301 struct us_priv_info {
302         TALLOC_CTX *ctx;
303         enum us_priv_op op;
304         struct net_context *c;
305 };
306
307 /***************************************************************************
308  Call a function for every share on the list.
309 ***************************************************************************/
310
311 static int process_share_list(int (*fn)(struct file_list *, void *), void *priv)
312 {
313         struct file_list *fl;
314         int ret = 0;
315
316         for (fl = flist; fl; fl = fl->next) {
317                 ret = (*fn)(fl, priv);
318         }
319
320         return ret;
321 }
322
323 /***************************************************************************
324  Info function.
325 ***************************************************************************/
326
327 static int info_fn(struct file_list *fl, void *priv)
328 {
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;
346
347         sep_str[0] = *lp_winbind_separator();
348         sep_str[1] = '\0';
349
350         basepath = get_basepath(ctx);
351         if (!basepath) {
352                 return -1;
353         }
354         basepath = talloc_asprintf_append(basepath,
355                         "/%s",
356                         fl->pathname);
357         if (!basepath) {
358                 return -1;
359         }
360
361 #ifdef O_NOFOLLOW
362         fd = open(basepath, O_RDONLY|O_NOFOLLOW, 0);
363 #else
364         fd = open(basepath, O_RDONLY, 0);
365 #endif
366
367         if (fd == -1) {
368                 d_fprintf(stderr, _("info_fn: unable to open %s. %s\n"),
369                         basepath, strerror(errno) );
370                 return -1;
371         }
372
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;
380         }
381
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;
388         }
389
390         lines = fd_lines_load(fd, &numlines, 10240, NULL);
391         close(fd);
392
393         if (lines == NULL) {
394                 return -1;
395         }
396
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);
404
405         TALLOC_FREE(lines);
406
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;
415         }
416
417         acl_str = talloc_strdup(ctx, "usershare_acl=");
418         if (!acl_str) {
419                 return -1;
420         }
421
422         for (num_aces = 0; num_aces < psd->dacl->num_aces; num_aces++) {
423                 const char *domain;
424                 const char *name;
425                 NTSTATUS ntstatus;
426
427                 ntstatus = net_lookup_name_from_sid(c, ctx,
428                                                     &psd->dacl->aces[num_aces].trustee,
429                                                     &domain, &name);
430
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;
439                                 }
440                         }
441                         acl_str = talloc_asprintf_append(acl_str,
442                                                 "%s",
443                                                 name);
444                         if (!acl_str) {
445                                 return -1;
446                         }
447
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;
457                         }
458                 }
459                 acl_str = talloc_asprintf_append(acl_str, ":");
460                 if (!acl_str) {
461                         return -1;
462                 }
463
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;
468                         }
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,");
474                         }
475                         if (!acl_str) {
476                                 return -1;
477                         }
478                 }
479         }
480
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);
490         }
491
492         return 0;
493 }
494
495 /***************************************************************************
496  Print out info (internal detail) on userlevel shares.
497 ***************************************************************************/
498
499 static int net_usershare_info(struct net_context *c, int argc, const char **argv)
500 {
501         fstring wcard;
502         bool only_ours = true;
503         int ret = -1;
504         struct us_priv_info pi;
505         TALLOC_CTX *ctx;
506
507         fstrcpy(wcard, "*");
508
509         if (c->display_usage)
510                 return net_usershare_info_usage(c, argc, argv);
511
512         if (c->opt_long_list_entries) {
513                 only_ours = false;
514         }
515
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);
524         }
525
526         if (!strlower_m(wcard)) {
527                 return -1;
528         }
529
530         ctx = talloc_init("share_info");
531         ret = get_share_list(ctx, wcard, only_ours);
532         if (ret) {
533                 return ret;
534         }
535
536         pi.ctx = ctx;
537         pi.op = US_INFO_OP;
538         pi.c = c;
539
540         ret = process_share_list(info_fn, &pi);
541         talloc_destroy(ctx);
542         return ret;
543 }
544
545 /***************************************************************************
546  Count the current total number of usershares.
547 ***************************************************************************/
548
549 static int count_num_usershares(void)
550 {
551         DIR *dp;
552         struct dirent *de;
553         int num_usershares = 0;
554         TALLOC_CTX *ctx = talloc_tos();
555         char *basepath = get_basepath(ctx);
556
557         if (!basepath) {
558                 return -1;
559         }
560
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;
568         }
569
570         while((de = readdir(dp)) != 0) {
571                 SMB_STRUCT_STAT sbuf;
572                 char *path;
573                 const char *n = de->d_name;
574
575                 /* Ignore . and .. */
576                 if (*n == '.') {
577                         if ((n[1] == '\0') || (n[1] == '.' && n[2] == '\0')) {
578                                 continue;
579                         }
580                 }
581
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;
587                 }
588                 path = talloc_asprintf(ctx,
589                                 "%s/%s",
590                                 basepath,
591                                 n);
592                 if (!path) {
593                         closedir(dp);
594                         return -1;
595                 }
596
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;
603                 }
604
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;
611                 }
612                 num_usershares++;
613         }
614
615         closedir(dp);
616         return num_usershares;
617 }
618
619 /***************************************************************************
620  Add a single userlevel share.
621 ***************************************************************************/
622
623 static int net_usershare_add(struct net_context *c, int argc, const char **argv)
624 {
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
646         us_comment = "";
647         arg_acl = "S-1-1-0:R";
648
649         if (c->display_usage)
650                 return net_usershare_add_usage(c, argc, argv);
651
652         switch (argc) {
653                 case 0:
654                 case 1:
655                 default:
656                         return net_usershare_add_usage(c, argc, argv);
657                 case 2:
658                         cp_sharename = argv[0];
659                         sharename = strlower_talloc(ctx, argv[0]);
660                         us_path = argv[1];
661                         break;
662                 case 3:
663                         cp_sharename = argv[0];
664                         sharename = strlower_talloc(ctx, argv[0]);
665                         us_path = argv[1];
666                         us_comment = argv[2];
667                         break;
668                 case 4:
669                         cp_sharename = argv[0];
670                         sharename = strlower_talloc(ctx, argv[0]);
671                         us_path = argv[1];
672                         us_comment = argv[2];
673                         arg_acl = argv[3];
674                         break;
675                 case 5:
676                         cp_sharename = argv[0];
677                         sharename = strlower_talloc(ctx, argv[0]);
678                         us_path = argv[1];
679                         us_comment = argv[2];
680                         arg_acl = argv[3];
681                         if (strlen(arg_acl) == 0) {
682                                 arg_acl = "S-1-1-0:R";
683                         }
684                         if (!strnequal(argv[4], "guest_ok=", 9)) {
685                                 TALLOC_FREE(ctx);
686                                 return net_usershare_add_usage(c, argc, argv);
687                         }
688                         switch (argv[4][9]) {
689                                 case 'y':
690                                 case 'Y':
691                                         guest_ok = true;
692                                         break;
693                                 case 'n':
694                                 case 'N':
695                                         guest_ok = false;
696                                         break;
697                                 default:
698                                         TALLOC_FREE(ctx);
699                                         return net_usershare_add_usage(c, argc, argv);
700                         }
701                         break;
702         }
703
704         /* Ensure we're under the "usershare max shares" number. Advisory only. */
705         num_usershares = count_num_usershares();
706         if (num_usershares >= lp_usershare_max_shares()) {
707                 d_fprintf(stderr,
708                         _("net usershare add: maximum number of allowed "
709                           "usershares (%d) reached\n"),
710                         lp_usershare_max_shares() );
711                 TALLOC_FREE(ctx);
712                 return -1;
713         }
714
715         if (!validate_net_name(sharename, INVALID_SHARENAME_CHARS, strlen(sharename))) {
716                 d_fprintf(stderr, _("net usershare add: share name %s contains "
717                         "invalid characters (any of %s)\n"),
718                         sharename, INVALID_SHARENAME_CHARS);
719                 TALLOC_FREE(ctx);
720                 return -1;
721         }
722
723         /* Disallow shares the same as users. */
724         if (getpwnam(sharename)) {
725                 d_fprintf(stderr,
726                         _("net usershare add: share name %s is already a valid "
727                           "system user name\n"),
728                         sharename );
729                 TALLOC_FREE(ctx);
730                 return -1;
731         }
732
733         /* Construct the full path for the usershare file. */
734         full_path = get_basepath(ctx);
735         if (!full_path) {
736                 TALLOC_FREE(ctx);
737                 return -1;
738         }
739         full_path_tmp = talloc_asprintf(ctx,
740                         "%s/:tmpXXXXXX",
741                         full_path);
742         if (!full_path_tmp) {
743                 TALLOC_FREE(ctx);
744                 return -1;
745         }
746
747         full_path = talloc_asprintf_append(full_path,
748                                         "/%s",
749                                         sharename);
750         if (!full_path) {
751                 TALLOC_FREE(ctx);
752                 return -1;
753         }
754
755         /* The path *must* be absolute. */
756         if (us_path[0] != '/') {
757                 d_fprintf(stderr,
758                         _("net usershare add: path %s is not an absolute "
759                           "path.\n"),
760                         us_path);
761                 TALLOC_FREE(ctx);
762                 return -1;
763         }
764
765         /* Check the directory to be shared exists. */
766         if (sys_stat(us_path, &sbuf, false) != 0) {
767                 d_fprintf(stderr,
768                         _("net usershare add: cannot stat path %s to ensure "
769                           "this is a directory. Error was %s\n"),
770                         us_path, strerror(errno) );
771                 TALLOC_FREE(ctx);
772                 return -1;
773         }
774
775         if (!S_ISDIR(sbuf.st_ex_mode)) {
776                 d_fprintf(stderr,
777                         _("net usershare add: path %s is not a directory.\n"),
778                         us_path );
779                 TALLOC_FREE(ctx);
780                 return -1;
781         }
782
783         /* If we're not root, check if we're restricted to sharing out directories
784            that we own only. */
785
786         if ((myeuid != 0) && lp_usershare_owner_only() && (myeuid != sbuf.st_ex_uid)) {
787                 d_fprintf(stderr, _("net usershare add: cannot share path %s as "
788                         "we are restricted to only sharing directories we own.\n"
789                         "\tAsk the administrator to add the line \"usershare owner only = false\" \n"
790                         "\tto the [global] section of the smb.conf to allow this.\n"),
791                         us_path );
792                 TALLOC_FREE(ctx);
793                 return -1;
794         }
795
796         /* No validation needed on comment. Now go through and validate the
797            acl string. Convert names to SID's as needed. Then run it through
798            parse_usershare_acl to ensure it's valid. */
799
800         /* Start off the string we'll append to. */
801         us_acl = talloc_strdup(ctx, "");
802         if (!us_acl) {
803                 TALLOC_FREE(ctx);
804                 return -1;
805         }
806
807         pacl = arg_acl;
808         num_aces = 1;
809
810         /* Add the number of ',' characters to get the number of aces. */
811         num_aces += count_chars(pacl,',');
812
813         for (i = 0; i < num_aces; i++) {
814                 struct dom_sid sid;
815                 const char *pcolon = strchr_m(pacl, ':');
816                 const char *name;
817
818                 if (pcolon == NULL) {
819                         d_fprintf(stderr,
820                                 _("net usershare add: malformed acl %s "
821                                   "(missing ':').\n"),
822                                 pacl );
823                         TALLOC_FREE(ctx);
824                         return -1;
825                 }
826
827                 switch(pcolon[1]) {
828                         case 'f':
829                         case 'F':
830                         case 'd':
831                         case 'r':
832                         case 'R':
833                                 break;
834                         default:
835                                 d_fprintf(stderr,
836                                         _("net usershare add: malformed acl %s "
837                                           "(access control must be 'r', 'f', "
838                                           "or 'd')\n"),
839                                         pacl );
840                                 TALLOC_FREE(ctx);
841                                 return -1;
842                 }
843
844                 if (pcolon[2] != ',' && pcolon[2] != '\0') {
845                         d_fprintf(stderr,
846                                 _("net usershare add: malformed terminating "
847                                   "character for acl %s\n"),
848                                 pacl );
849                         TALLOC_FREE(ctx);
850                         return -1;
851                 }
852
853                 /* Get the name */
854                 if ((name = talloc_strndup(ctx, pacl, pcolon - pacl)) == NULL) {
855                         d_fprintf(stderr, _("talloc_strndup failed\n"));
856                         TALLOC_FREE(ctx);
857                         return -1;
858                 }
859                 if (!string_to_sid(&sid, name)) {
860                         /* Convert to a SID */
861                         NTSTATUS ntstatus = net_lookup_sid_from_name(c, ctx, name, &sid);
862                         if (!NT_STATUS_IS_OK(ntstatus)) {
863                                 d_fprintf(stderr,
864                                         _("net usershare add: cannot convert "
865                                           "name \"%s\" to a SID. %s."),
866                                         name, get_friendly_nt_error_msg(ntstatus) );
867                                 if (NT_STATUS_EQUAL(ntstatus, NT_STATUS_CONNECTION_REFUSED)) {
868                                         d_fprintf(stderr,
869                                             _(" Maybe smbd is not running.\n"));
870                                 } else {
871                                         d_fprintf(stderr, "\n");
872                                 }
873                                 TALLOC_FREE(ctx);
874                                 return -1;
875                         }
876                 }
877                 us_acl = talloc_asprintf_append(
878                         us_acl, "%s:%c,", sid_string_tos(&sid), pcolon[1]);
879
880                 /* Move to the next ACL entry. */
881                 if (pcolon[2] == ',') {
882                         pacl = &pcolon[3];
883                 }
884         }
885
886         /* Remove the last ',' */
887         us_acl[strlen(us_acl)-1] = '\0';
888
889         if (guest_ok && !lp_usershare_allow_guests()) {
890                 d_fprintf(stderr, _("net usershare add: guest_ok=y requested "
891                         "but the \"usershare allow guests\" parameter is not "
892                         "enabled by this server.\n"));
893                 TALLOC_FREE(ctx);
894                 return -1;
895         }
896
897         /* Create a temporary filename for this share. */
898         tmpfd = mkstemp(full_path_tmp);
899
900         if (tmpfd == -1) {
901                 d_fprintf(stderr,
902                           _("net usershare add: cannot create tmp file %s\n"),
903                           full_path_tmp );
904                 TALLOC_FREE(ctx);
905                 return -1;
906         }
907
908         /* Ensure we opened the file we thought we did. */
909         if (sys_lstat(full_path_tmp, &lsbuf, false) != 0) {
910                 d_fprintf(stderr,
911                           _("net usershare add: cannot lstat tmp file %s\n"),
912                           full_path_tmp );
913                 TALLOC_FREE(ctx);
914                 close(tmpfd);
915                 return -1;
916         }
917
918         /* Check this is the same as the file we opened. */
919         if (sys_fstat(tmpfd, &sbuf, false) != 0) {
920                 d_fprintf(stderr,
921                           _("net usershare add: cannot fstat tmp file %s\n"),
922                           full_path_tmp );
923                 TALLOC_FREE(ctx);
924                 close(tmpfd);
925                 return -1;
926         }
927
928         if (!S_ISREG(sbuf.st_ex_mode) || sbuf.st_ex_dev != lsbuf.st_ex_dev || sbuf.st_ex_ino != lsbuf.st_ex_ino) {
929                 d_fprintf(stderr,
930                           _("net usershare add: tmp file %s is not a regular "
931                             "file ?\n"),
932                           full_path_tmp );
933                 TALLOC_FREE(ctx);
934                 close(tmpfd);
935                 return -1;
936         }
937
938         if (fchmod(tmpfd, 0644) == -1) {
939                 d_fprintf(stderr,
940                           _("net usershare add: failed to fchmod tmp file %s "
941                             "to 0644n"),
942                           full_path_tmp );
943                 TALLOC_FREE(ctx);
944                 close(tmpfd);
945                 return -1;
946         }
947
948         /* Create the in-memory image of the file. */
949         file_img = talloc_strdup(ctx, "#VERSION 2\npath=");
950         file_img = talloc_asprintf_append(file_img,
951                         "%s\ncomment=%s\nusershare_acl=%s\n"
952                         "guest_ok=%c\nsharename=%s\n",
953                         us_path,
954                         us_comment,
955                         us_acl,
956                         guest_ok ? 'y' : 'n',
957                         cp_sharename);
958
959         to_write = strlen(file_img);
960
961         if (write(tmpfd, file_img, to_write) != to_write) {
962                 d_fprintf(stderr,
963                         _("net usershare add: failed to write %u bytes to "
964                           "file %s. Error was %s\n"),
965                         (unsigned int)to_write, full_path_tmp, strerror(errno));
966                 unlink(full_path_tmp);
967                 TALLOC_FREE(ctx);
968                 close(tmpfd);
969                 return -1;
970         }
971
972         /* Attempt to replace any existing share by this name. */
973         if (rename(full_path_tmp, full_path) != 0) {
974                 unlink(full_path_tmp);
975                 d_fprintf(stderr,
976                         _("net usershare add: failed to add share %s. Error "
977                           "was %s\n"),
978                         sharename, strerror(errno));
979                 TALLOC_FREE(ctx);
980                 close(tmpfd);
981                 return -1;
982         }
983
984         close(tmpfd);
985
986         if (c->opt_long_list_entries) {
987                 const char *my_argv[2];
988                 my_argv[0] = sharename;
989                 my_argv[1] = NULL;
990                 net_usershare_info(c, 1, my_argv);
991         }
992
993         TALLOC_FREE(ctx);
994         return 0;
995 }
996
997 #if 0
998 /***************************************************************************
999  List function.
1000 ***************************************************************************/
1001
1002 static int list_fn(struct file_list *fl, void *priv)
1003 {
1004         d_printf("%s\n", fl->pathname);
1005         return 0;
1006 }
1007 #endif
1008
1009 /***************************************************************************
1010  List userlevel shares.
1011 ***************************************************************************/
1012
1013 static int net_usershare_list(struct net_context *c, int argc,
1014                               const char **argv)
1015 {
1016         fstring wcard;
1017         bool only_ours = true;
1018         int ret = -1;
1019         struct us_priv_info pi;
1020         TALLOC_CTX *ctx;
1021
1022         fstrcpy(wcard, "*");
1023
1024         if (c->display_usage)
1025                 return net_usershare_list_usage(c, argc, argv);
1026
1027         if (c->opt_long_list_entries) {
1028                 only_ours = false;
1029         }
1030
1031         switch (argc) {
1032                 case 0:
1033                         break;
1034                 case 1:
1035                         fstrcpy(wcard, argv[0]);
1036                         break;
1037                 default:
1038                         return net_usershare_list_usage(c, argc, argv);
1039         }
1040
1041         if (!strlower_m(wcard)) {
1042                 return -1;
1043         }
1044
1045         ctx = talloc_init("share_list");
1046         ret = get_share_list(ctx, wcard, only_ours);
1047         if (ret) {
1048                 return ret;
1049         }
1050
1051         pi.ctx = ctx;
1052         pi.op = US_LIST_OP;
1053         pi.c = c;
1054
1055         ret = process_share_list(info_fn, &pi);
1056         talloc_destroy(ctx);
1057         return ret;
1058 }
1059
1060 /***************************************************************************
1061  Entry-point for all the USERSHARE functions.
1062 ***************************************************************************/
1063
1064 int net_usershare(struct net_context *c, int argc, const char **argv)
1065 {
1066         DIR *dp;
1067
1068         struct functable func[] = {
1069                 {
1070                         "add",
1071                         net_usershare_add,
1072                         NET_TRANSPORT_LOCAL,
1073                         N_("Add/modify user defined share"),
1074                         N_("net usershare add\n"
1075                            "    Add/modify user defined share")
1076                 },
1077                 {
1078                         "delete",
1079                         net_usershare_delete,
1080                         NET_TRANSPORT_LOCAL,
1081                         N_("Delete user defined share"),
1082                         N_("net usershare delete\n"
1083                            "    Delete user defined share")
1084                 },
1085                 {
1086                         "info",
1087                         net_usershare_info,
1088                         NET_TRANSPORT_LOCAL,
1089                         N_("Display information about a user defined share"),
1090                         N_("net usershare info\n"
1091                            "    Display information about a user defined share")
1092                 },
1093                 {
1094                         "list",
1095                         net_usershare_list,
1096                         NET_TRANSPORT_LOCAL,
1097                         N_("List user defined shares"),
1098                         N_("net usershare list\n"
1099                            "    List user defined shares")
1100                 },
1101                 {NULL, NULL, 0, NULL, NULL}
1102         };
1103
1104         if (lp_usershare_max_shares() == 0) {
1105                 d_fprintf(stderr,
1106                           _("net usershare: usershares are currently "
1107                             "disabled\n"));
1108                 return -1;
1109         }
1110
1111         dp = opendir(lp_usershare_path(talloc_tos()));
1112         if (!dp) {
1113                 int err = errno;
1114                 d_fprintf(stderr,
1115                         _("net usershare: cannot open usershare directory %s. "
1116                           "Error %s\n"),
1117                         lp_usershare_path(talloc_tos()), strerror(err) );
1118                 if (err == EACCES) {
1119                         d_fprintf(stderr,
1120                                 _("You do not have permission to create a "
1121                                 "usershare. Ask your administrator to grant "
1122                                 "you permissions to create a share.\n"));
1123                 } else if (err == ENOENT) {
1124                         d_fprintf(stderr,
1125                                 _("Please ask your system administrator to "
1126                                   "enable user sharing.\n"));
1127                 }
1128                 return -1;
1129         }
1130         closedir(dp);
1131
1132         return net_run_function(c, argc, argv, "net usershare", func);
1133 }