summaryrefslogtreecommitdiffstats
path: root/src/lib/mkdir-parents.h
blob: 9b5ddf0eae3abdb9bcb5fa2c3a9eb1115ff10df8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#ifndef MKDIR_PARENTS_H
#define MKDIR_PARENTS_H

#include <sys/stat.h>

/* Create path and all the directories under it if needed. Permissions for
   existing directories isn't changed. Returns 0 if ok. If directory already
   exists, returns -1 with errno=EEXIST. */
int mkdir_parents(const char *path, mode_t mode);

/* Like mkdir_parents(), but use the given uid/gid for newly created
   directories. (uid_t)-1 or (gid_t)-1 can be used to indicate that it
   doesn't need to be changed. If gid isn't (gid_t)-1 and the parent directory
   had setgid-bit enabled, it's removed unless explicitly included in the
   mode. */
int mkdir_parents_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);
/* Like mkdir_parents_chown(), but change only group. If chown() fails with
   EACCES, use gid_origin in the error message. */
int mkdir_parents_chgrp(const char *path, mode_t mode,
			gid_t gid, const char *gid_origin);

/* Like mkdir_parents_chown(), but don't actually create any parents. */
int mkdir_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);
int mkdir_chgrp(const char *path, mode_t mode,
		gid_t gid, const char *gid_origin);

/* stat() the path or its first parent that exists. Returns 0 if ok, -1 if
   failed. root_dir is set to the last stat()ed directory (on success and
   on failure). */
int stat_first_parent(const char *path, const char **root_dir_r,
		      struct stat *st_r);

#endif