(usage): Note that ``Mandatory arguments to long options are mandatory
[platform/upstream/coreutils.git] / src / mkdir.c
1 /* mkdir -- make directories
2    Copyright (C) 90, 1995-2001 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
17
18 /* David MacKenzie <djm@ai.mit.edu>  */
19
20 #include <config.h>
21 #include <stdio.h>
22 #include <getopt.h>
23 #include <sys/types.h>
24
25 #include "system.h"
26 #include "dirname.h"
27 #include "error.h"
28 #include "makepath.h"
29 #include "modechange.h"
30 #include "quote.h"
31
32 /* The official name of this program (e.g., no `g' prefix).  */
33 #define PROGRAM_NAME "mkdir"
34
35 #define AUTHORS "David MacKenzie"
36
37 /* The name this program was run with. */
38 char *program_name;
39
40 /* If nonzero, ensure that all parents of the specified directory exist.  */
41 static int create_parents;
42
43 static struct option const longopts[] =
44 {
45   {"mode", required_argument, NULL, 'm'},
46   {"parents", no_argument, NULL, 'p'},
47   {"verbose", no_argument, NULL, 'v'},
48   {GETOPT_HELP_OPTION_DECL},
49   {GETOPT_VERSION_OPTION_DECL},
50   {NULL, 0, NULL, 0}
51 };
52
53 void
54 usage (int status)
55 {
56   if (status != 0)
57     fprintf (stderr, _("Try `%s --help' for more information.\n"),
58              program_name);
59   else
60     {
61       printf (_("Usage: %s [OPTION] DIRECTORY...\n"), program_name);
62       fputs (_("\
63 Create the DIRECTORY(ies), if they do not already exist.\n\
64 \n\
65 "), stdout);
66       fputs (_("\
67 Mandatory arguments to long options are mandatory for short options too.\n\
68 "), stdout);
69       fputs (_("\
70   -m, --mode=MODE   set permission mode (as in chmod), not rwxrwxrwx - umask\n\
71   -p, --parents     no error if existing, make parent directories as needed\n\
72   -v, --verbose     print a message for each created directory\n\
73 "), stdout);
74       fputs (_("\
75       --help        display this help and exit\n\
76       --version     output version information and exit\n\
77 "), stdout);
78       puts (_("\nReport bugs to <bug-fileutils@gnu.org>."));
79     }
80   exit (status);
81 }
82
83 int
84 main (int argc, char **argv)
85 {
86   mode_t newmode;
87   mode_t parent_mode;
88   const char *specified_mode = NULL;
89   const char *verbose_fmt_string = NULL;
90   int errors = 0;
91   int optc;
92
93   program_name = argv[0];
94   setlocale (LC_ALL, "");
95   bindtextdomain (PACKAGE, LOCALEDIR);
96   textdomain (PACKAGE);
97
98   atexit (close_stdout);
99
100   create_parents = 0;
101
102   while ((optc = getopt_long (argc, argv, "pm:v", longopts, NULL)) != -1)
103     {
104       switch (optc)
105         {
106         case 0:                 /* Long option. */
107           break;
108         case 'p':
109           create_parents = 1;
110           break;
111         case 'm':
112           specified_mode = optarg;
113           break;
114         case 'v': /* --verbose  */
115           verbose_fmt_string = _("created directory %s");
116           break;
117         case_GETOPT_HELP_CHAR;
118         case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS);
119         default:
120           usage (1);
121         }
122     }
123
124   if (optind == argc)
125     {
126       error (0, 0, _("too few arguments"));
127       usage (1);
128     }
129
130   newmode = S_IRWXUGO;
131   {
132     mode_t umask_value = umask (0);
133     umask (umask_value);                /* Restore the old value. */
134     parent_mode = (newmode & (~ umask_value)) | S_IWUSR | S_IXUSR;
135   }
136
137   if (specified_mode)
138     {
139       struct mode_change *change = mode_compile (specified_mode, 0);
140       newmode &= ~ umask (0);
141       if (change == MODE_INVALID)
142         error (1, 0, _("invalid mode %s"), quote (specified_mode));
143       else if (change == MODE_MEMORY_EXHAUSTED)
144         xalloc_die ();
145       newmode = mode_adjust (newmode, change);
146     }
147
148   for (; optind < argc; ++optind)
149     {
150       int fail = 0;
151
152       if (create_parents)
153         {
154           char *parents = dir_name (argv[optind]);
155           fail = make_path (parents, parent_mode, parent_mode,
156                             -1, -1, 1, verbose_fmt_string);
157           free (parents);
158         }
159
160       if (fail == 0)
161         {
162           const char *dir = argv[optind];
163           int dir_created;
164           fail = make_dir (dir, dir, newmode, &dir_created);
165           if (fail)
166             {
167               /* make_dir already gave a diagnostic.  */
168             }
169           else if (!create_parents && !dir_created)
170             {
171               /* make_dir `succeeds' when DIR already exists.
172                  In that case, mkdir must fail, unless --parents (-p)
173                  was specified.  */
174               error (0, EEXIST, _("cannot create directory %s"),
175                      quote (dir));
176               fail = 1;
177             }
178           else if (verbose_fmt_string)
179             error (0, 0, verbose_fmt_string, quote (dir));
180
181           /* mkdir(2) is required to honor only the file permission bits.
182              In particular, it needn't do anything about `special' bits,
183              so if any were set in newmode, apply them with chmod.
184              This extra step is necessary in some cases when the containing
185              directory has a default ACL.  */
186
187           /* Set the permissions only if this directory has just
188              been created.  */
189
190           if (fail == 0 && specified_mode && dir_created)
191             {
192               fail = chmod (dir, newmode);
193               if (fail)
194                 error (0, errno, _("cannot set permissions of directory %s"),
195                        quote (dir));
196             }
197         }
198
199       if (fail)
200         errors = 1;
201     }
202
203   exit (errors);
204 }