1 /* makepath.c -- Ensure that a directory path exists.
2 Copyright (C) 1990, 1997, 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
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)
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.
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. */
18 /* Written by David MacKenzie <djm@gnu.ai.mit.edu> and Jim Meyering. */
25 # define alloca __builtin_alloca
39 #include <sys/types.h>
45 #if STAT_MACROS_BROKEN
49 #if !defined S_ISDIR && defined S_IFDIR
50 # define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
54 # define S_IRWXUGO (S_IRWXU | S_IRWXG | S_IRWXO)
79 # define S_ISUID 04000
82 # define S_ISGID 02000
85 # define S_ISVTX 01000
98 # define S_IRWXU (S_IRUSR | S_IWUSR | S_IXUSR)
101 #define WX_USR (S_IWUSR | S_IXUSR)
103 /* Include this before libintl.h so we get our definition of PARAMS. */
104 #include "makepath.h"
107 #define _(msgid) gettext (msgid)
109 #include "save-cwd.h"
114 #define CLEANUP_CWD \
117 /* We're done operating on basename_dir. \
118 Restore working directory. */ \
121 int _fail = restore_cwd (&cwd, NULL, NULL); \
137 /* Attempt to create directory DIR (aka DIRPATH) with the specified MODE.
138 If CREATED_DIR_P is non-NULL, set *CREATED_DIR_P to non-zero if this
139 function creates DIR and to zero otherwise. Give a diagnostic and
140 return non-zero if DIR cannot be created or cannot be determined to
141 exist already. Use DIRPATH in any diagnostic, not DIR.
142 Note that if DIR already exists, this function returns zero
143 (indicating success) and sets *CREATED_DIR_P to zero. */
146 make_dir (const char *dir, const char *dirpath, mode_t mode, int *created_dir_p)
151 created_dir = (mkdir (dir, mode) == 0);
156 int saved_errno = errno;
158 /* The mkdir and stat calls below may appear to be reversed.
159 They are not. It is important to call mkdir first and then to
160 call stat (to distinguish the three cases) only if mkdir fails.
161 The alternative to this approach is to `stat' each directory,
162 then to call mkdir if it doesn't exist. But if some other process
163 were to create the directory between the stat & mkdir, the mkdir
164 would fail with EEXIST. */
166 if (stat (dir, &stats))
168 error (0, saved_errno, _("cannot create directory %s"),
172 else if (!S_ISDIR (stats.st_mode))
174 error (0, 0, _("%s exists but is not a directory"), quote (dirpath));
179 /* DIR (aka DIRPATH) already exists and is a directory. */
184 *created_dir_p = created_dir;
189 /* Ensure that the directory ARGPATH exists.
191 Create any leading directories that don't already exist, with
192 permissions PARENT_MODE.
193 If the last element of ARGPATH does not exist, create it as
194 a new directory with permissions MODE.
195 If OWNER and GROUP are non-negative, use them to set the UID and GID of
196 any created directories.
197 If VERBOSE_FMT_STRING is nonzero, use it as a printf format
198 string for printing a message after successfully making a directory,
199 with the name of the directory that was just made as an argument.
200 If PRESERVE_EXISTING is non-zero and ARGPATH is an existing directory,
201 then do not attempt to set its permissions and ownership.
203 Return 0 if ARGPATH exists as a directory with the proper
204 ownership and permissions when done, otherwise 1. */
207 make_path (const char *argpath,
212 int preserve_existing,
213 const char *verbose_fmt_string)
218 if (stat (argpath, &stats))
221 int tmp_mode; /* Initial perms for leading dirs. */
222 int re_protect; /* Should leading dirs be unwritable? */
226 struct ptr_list *next;
228 struct ptr_list *p, *leading_dirs = NULL;
229 int do_chdir; /* Whether to chdir before each mkdir. */
230 struct saved_cwd cwd;
234 /* Temporarily relax umask in case it's overly restrictive. */
235 mode_t oldmask = umask (0);
237 /* Make a copy of ARGPATH that we can scribble NULs on. */
238 dirpath = (char *) alloca (strlen (argpath) + 1);
239 strcpy (dirpath, argpath);
240 strip_trailing_slashes (dirpath);
242 /* If leading directories shouldn't be writable or executable,
243 or should have set[ug]id or sticky bits set and we are setting
244 their owners, we need to fix their permissions after making them. */
245 if (((parent_mode & WX_USR) != WX_USR)
246 || ((owner != (uid_t) -1 || group != (gid_t) -1)
247 && (parent_mode & (S_ISUID | S_ISGID | S_ISVTX)) != 0))
254 tmp_mode = parent_mode;
258 /* If we can record the current working directory, we may be able
259 to do the chdir optimization. */
260 do_chdir = !save_cwd (&cwd);
262 /* If we've saved the cwd and DIRPATH is an absolute pathname,
263 we must chdir to `/' in order to enable the chdir optimization.
264 So if chdir ("/") fails, turn off the optimization. */
265 if (do_chdir && *dirpath == '/' && chdir ("/") < 0)
270 /* Skip over leading slashes. */
271 while (*slash == '/')
276 int newly_created_dir;
279 /* slash points to the leftmost unprocessed component of dirpath. */
280 basename_dir = slash;
282 slash = strchr (slash, '/');
286 /* If we're *not* doing chdir before each mkdir, then we have to refer
287 to the target using the full (multi-component) directory name. */
289 basename_dir = dirpath;
292 fail = make_dir (basename_dir, dirpath, tmp_mode, &newly_created_dir);
299 if (newly_created_dir)
301 if (verbose_fmt_string)
302 error (0, 0, verbose_fmt_string, quote (dirpath));
304 if ((owner != (uid_t) -1 || group != (gid_t) -1)
305 && chown (basename_dir, owner, group)
306 #if defined AFS && defined EPERM
311 error (0, errno, _("cannot change owner and/or group of %s"),
319 struct ptr_list *new = (struct ptr_list *)
320 alloca (sizeof (struct ptr_list));
321 new->dirname_end = slash;
322 new->next = leading_dirs;
327 /* If we were able to save the initial working directory,
328 then we can use chdir to change into each directory before
329 creating an entry in that directory. This avoids making
330 stat and mkdir process O(n^2) file name components. */
331 if (do_chdir && chdir (basename_dir) < 0)
333 error (0, errno, _("cannot chdir to directory %s"),
341 /* Avoid unnecessary calls to `stat' when given
342 pathnames containing multiple adjacent slashes. */
343 while (*slash == '/')
348 basename_dir = dirpath;
350 /* Done creating leading directories. Restore original umask. */
353 /* We're done making leading directories.
354 Create the final component of the path. */
356 if (make_dir (basename_dir, dirpath, mode, NULL))
362 if (verbose_fmt_string != NULL)
363 error (0, 0, verbose_fmt_string, quote (dirpath));
365 if (owner != (uid_t) -1 || group != (gid_t) -1)
367 if (chown (basename_dir, owner, group)
373 error (0, errno, _("cannot change owner and/or group of %s"),
379 /* The above chown may have turned off some permission bits in MODE.
380 Another reason we may have to use chmod here is that mkdir(2) is
381 required to honor only the file permission bits. In particular,
382 it need not honor the `special' bits, so if MODE includes any
383 special bits, set them here. */
384 if ((mode & ~S_IRWXUGO)
385 && chmod (basename_dir, mode))
387 error (0, errno, _("cannot change permissions of %s"),
394 /* If the mode for leading directories didn't include owner "wx"
395 privileges, we have to reset their protections to the correct
397 for (p = leading_dirs; p != NULL; p = p->next)
399 *(p->dirname_end) = '\0';
400 if (chmod (dirpath, parent_mode))
402 error (0, errno, "cannot change permissions of %s",
410 /* We get here if the entire path already exists. */
412 const char *dirpath = argpath;
414 if (!S_ISDIR (stats.st_mode))
416 error (0, 0, _("%s exists but is not a directory"), quote (dirpath));
420 if (!preserve_existing)
422 /* chown must precede chmod because on some systems,
423 chown clears the set[ug]id bits for non-superusers,
424 resulting in incorrect permissions.
425 On System V, users can give away files with chown and then not
426 be able to chmod them. So don't give files away. */
428 if ((owner != (uid_t) -1 || group != (gid_t) -1)
429 && chown (dirpath, owner, group)
435 error (0, errno, _("cannot change owner and/or group of %s"),
439 if (chmod (dirpath, mode))
441 error (0, errno, _("cannot change permissions of %s"),