1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
13 #include <sys/xattr.h>
21 #include "alloc-util.h"
22 #include "btrfs-util.h"
23 #include "capability-util.h"
24 #include "chase-symlinks.h"
25 #include "chattr-util.h"
26 #include "conf-files.h"
29 #include "dirent-util.h"
30 #include "dissect-image.h"
35 #include "format-util.h"
37 #include "glob-util.h"
42 #include "main-func.h"
43 #include "missing_stat.h"
44 #include "missing_syscall.h"
45 #include "mkdir-label.h"
46 #include "mount-util.h"
47 #include "mountpoint-util.h"
48 #include "offline-passwd.h"
50 #include "parse-argument.h"
51 #include "parse-util.h"
52 #include "path-lookup.h"
53 #include "path-util.h"
54 #include "pretty-print.h"
55 #include "rlimit-util.h"
57 #include "selinux-util.h"
59 #include "sort-util.h"
60 #include "specifier.h"
61 #include "stat-util.h"
62 #include "stdio-util.h"
63 #include "string-table.h"
64 #include "string-util.h"
66 #include "terminal-util.h"
67 #include "umask-util.h"
68 #include "user-util.h"
70 /* This reads all files listed in /etc/tmpfiles.d/?*.conf and creates
71 * them in the file system. This is intended to be used to create
72 * properly owned directories beneath /tmp, /var/tmp, /run, which are
73 * volatile and hence need to be recreated on bootup. */
75 typedef enum OperationMask
{
76 OPERATION_CREATE
= 1 << 0,
77 OPERATION_REMOVE
= 1 << 1,
78 OPERATION_CLEAN
= 1 << 2,
81 typedef enum ItemType
{
82 /* These ones take file names */
84 TRUNCATE_FILE
= 'F', /* deprecated: use f+ */
85 CREATE_DIRECTORY
= 'd',
86 TRUNCATE_DIRECTORY
= 'D',
87 CREATE_SUBVOLUME
= 'v',
88 CREATE_SUBVOLUME_INHERIT_QUOTA
= 'q',
89 CREATE_SUBVOLUME_NEW_QUOTA
= 'Q',
92 CREATE_CHAR_DEVICE
= 'c',
93 CREATE_BLOCK_DEVICE
= 'b',
96 /* These ones take globs */
98 EMPTY_DIRECTORY
= 'e',
100 RECURSIVE_SET_XATTR
= 'T',
102 RECURSIVE_SET_ACL
= 'A',
104 RECURSIVE_SET_ATTRIBUTE
= 'H',
106 IGNORE_DIRECTORY_PATH
= 'X',
108 RECURSIVE_REMOVE_PATH
= 'R',
110 RECURSIVE_RELABEL_PATH
= 'Z',
111 ADJUST_MODE
= 'm', /* legacy, 'z' is identical to this */
115 AGE_BY_ATIME
= 1 << 0,
116 AGE_BY_BTIME
= 1 << 1,
117 AGE_BY_CTIME
= 1 << 2,
118 AGE_BY_MTIME
= 1 << 3,
120 /* All file timestamp types are checked by default. */
121 AGE_BY_DEFAULT_FILE
= AGE_BY_ATIME
| AGE_BY_BTIME
| AGE_BY_CTIME
| AGE_BY_MTIME
,
122 AGE_BY_DEFAULT_DIR
= AGE_BY_ATIME
| AGE_BY_BTIME
| AGE_BY_MTIME
125 typedef struct Item
{
139 AgeBy age_by_file
, age_by_dir
;
142 unsigned attribute_value
;
143 unsigned attribute_mask
;
150 bool attribute_set
:1;
152 bool keep_first_level
:1;
154 bool append_or_force
:1;
156 bool allow_failure
:1;
163 typedef struct ItemArray
{
167 struct ItemArray
*parent
;
171 typedef enum DirectoryType
{
179 static bool arg_cat_config
= false;
180 static bool arg_user
= false;
181 static OperationMask arg_operation
= 0;
182 static bool arg_boot
= false;
183 static PagerFlags arg_pager_flags
= 0;
185 static char **arg_include_prefixes
= NULL
;
186 static char **arg_exclude_prefixes
= NULL
;
187 static char *arg_root
= NULL
;
188 static char *arg_image
= NULL
;
189 static char *arg_replace
= NULL
;
191 #define MAX_DEPTH 256
193 static OrderedHashmap
*items
= NULL
, *globs
= NULL
;
194 static Set
*unix_sockets
= NULL
;
196 STATIC_DESTRUCTOR_REGISTER(items
, ordered_hashmap_freep
);
197 STATIC_DESTRUCTOR_REGISTER(globs
, ordered_hashmap_freep
);
198 STATIC_DESTRUCTOR_REGISTER(unix_sockets
, set_freep
);
199 STATIC_DESTRUCTOR_REGISTER(arg_include_prefixes
, freep
);
200 STATIC_DESTRUCTOR_REGISTER(arg_exclude_prefixes
, freep
);
201 STATIC_DESTRUCTOR_REGISTER(arg_root
, freep
);
202 STATIC_DESTRUCTOR_REGISTER(arg_image
, freep
);
204 static int specifier_machine_id_safe(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
);
205 static int specifier_directory(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
);
207 static int specifier_machine_id_safe(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
210 /* If /etc/machine_id is missing or empty (e.g. in a chroot environment) return a recognizable error
211 * so that the caller can skip the rule gracefully. */
213 r
= specifier_machine_id(specifier
, data
, root
, userdata
, ret
);
214 if (IN_SET(r
, -ENOENT
, -ENOMEDIUM
))
220 static int specifier_directory(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
226 static const struct table_entry paths_system
[] = {
227 [DIRECTORY_RUNTIME
] = { SD_PATH_SYSTEM_RUNTIME
},
228 [DIRECTORY_STATE
] = { SD_PATH_SYSTEM_STATE_PRIVATE
},
229 [DIRECTORY_CACHE
] = { SD_PATH_SYSTEM_STATE_CACHE
},
230 [DIRECTORY_LOGS
] = { SD_PATH_SYSTEM_STATE_LOGS
},
233 static const struct table_entry paths_user
[] = {
234 [DIRECTORY_RUNTIME
] = { SD_PATH_USER_RUNTIME
},
235 [DIRECTORY_STATE
] = { SD_PATH_USER_CONFIGURATION
},
236 [DIRECTORY_CACHE
] = { SD_PATH_USER_STATE_CACHE
},
237 [DIRECTORY_LOGS
] = { SD_PATH_USER_CONFIGURATION
, "log" },
240 const struct table_entry
*paths
;
241 _cleanup_free_
char *p
= NULL
;
245 assert_cc(ELEMENTSOF(paths_system
) == ELEMENTSOF(paths_user
));
246 paths
= arg_user
? paths_user
: paths_system
;
248 i
= PTR_TO_UINT(data
);
249 assert(i
< ELEMENTSOF(paths_system
));
251 r
= sd_path_lookup(paths
[i
].type
, paths
[i
].suffix
, &p
);
256 _cleanup_free_
char *j
= NULL
;
258 j
= path_join(arg_root
, p
);
269 static int log_unresolvable_specifier(const char *filename
, unsigned line
) {
270 static bool notified
= false;
272 /* In system mode, this is called when /etc is not fully initialized (e.g.
273 * in a chroot environment) where some specifiers are unresolvable. In user
274 * mode, this is called when some variables are not defined. These cases are
275 * not considered as an error so log at LOG_NOTICE only for the first time
276 * and then downgrade this to LOG_DEBUG for the rest. */
279 notified
? LOG_DEBUG
: LOG_NOTICE
,
281 "Failed to resolve specifier: %s, skipping",
282 arg_user
? "Required $XDG_... variable not defined" : "uninitialized /etc detected");
285 log_notice("All rules containing unresolvable specifiers will be skipped.");
291 static int user_config_paths(char*** ret
) {
292 _cleanup_strv_free_
char **config_dirs
= NULL
, **data_dirs
= NULL
;
293 _cleanup_free_
char *persistent_config
= NULL
, *runtime_config
= NULL
, *data_home
= NULL
;
294 _cleanup_strv_free_
char **res
= NULL
;
297 r
= xdg_user_dirs(&config_dirs
, &data_dirs
);
301 r
= xdg_user_config_dir(&persistent_config
, "/user-tmpfiles.d");
302 if (r
< 0 && r
!= -ENXIO
)
305 r
= xdg_user_runtime_dir(&runtime_config
, "/user-tmpfiles.d");
306 if (r
< 0 && r
!= -ENXIO
)
309 r
= xdg_user_data_dir(&data_home
, "/user-tmpfiles.d");
310 if (r
< 0 && r
!= -ENXIO
)
313 r
= strv_extend_strv_concat(&res
, config_dirs
, "/user-tmpfiles.d");
317 r
= strv_extend(&res
, persistent_config
);
321 r
= strv_extend(&res
, runtime_config
);
325 r
= strv_extend(&res
, data_home
);
329 r
= strv_extend_strv_concat(&res
, data_dirs
, "/user-tmpfiles.d");
333 r
= path_strv_make_absolute_cwd(res
);
337 *ret
= TAKE_PTR(res
);
341 static bool needs_glob(ItemType t
) {
345 IGNORE_DIRECTORY_PATH
,
347 RECURSIVE_REMOVE_PATH
,
351 RECURSIVE_RELABEL_PATH
,
357 RECURSIVE_SET_ATTRIBUTE
);
360 static bool takes_ownership(ItemType t
) {
368 CREATE_SUBVOLUME_INHERIT_QUOTA
,
369 CREATE_SUBVOLUME_NEW_QUOTA
,
377 IGNORE_DIRECTORY_PATH
,
379 RECURSIVE_REMOVE_PATH
);
382 static struct Item
* find_glob(OrderedHashmap
*h
, const char *match
) {
385 ORDERED_HASHMAP_FOREACH(j
, h
) {
388 for (n
= 0; n
< j
->n_items
; n
++) {
389 Item
*item
= j
->items
+ n
;
391 if (fnmatch(item
->path
, match
, FNM_PATHNAME
|FNM_PERIOD
) == 0)
399 static int load_unix_sockets(void) {
400 _cleanup_set_free_ Set
*sockets
= NULL
;
401 _cleanup_fclose_
FILE *f
= NULL
;
407 /* We maintain a cache of the sockets we found in /proc/net/unix to speed things up a little. */
409 f
= fopen("/proc/net/unix", "re");
411 return log_full_errno(errno
== ENOENT
? LOG_DEBUG
: LOG_WARNING
, errno
,
412 "Failed to open /proc/net/unix, ignoring: %m");
415 r
= read_line(f
, LONG_LINE_MAX
, NULL
);
417 return log_warning_errno(r
, "Failed to skip /proc/net/unix header line: %m");
419 return log_warning_errno(SYNTHETIC_ERRNO(EIO
), "Premature end of file reading /proc/net/unix.");
422 _cleanup_free_
char *line
= NULL
;
425 r
= read_line(f
, LONG_LINE_MAX
, &line
);
427 return log_warning_errno(r
, "Failed to read /proc/net/unix line, ignoring: %m");
428 if (r
== 0) /* EOF */
431 p
= strchr(line
, ':');
439 p
+= strspn(p
, WHITESPACE
);
440 p
+= strcspn(p
, WHITESPACE
); /* skip one more word */
441 p
+= strspn(p
, WHITESPACE
);
443 if (!path_is_absolute(p
))
446 r
= set_put_strdup_full(&sockets
, &path_hash_ops_free
, p
);
448 return log_warning_errno(r
, "Failed to add AF_UNIX socket to set, ignoring: %m");
451 unix_sockets
= TAKE_PTR(sockets
);
455 static bool unix_socket_alive(const char *fn
) {
458 if (load_unix_sockets() < 0)
459 return true; /* We don't know, so assume yes */
461 return set_contains(unix_sockets
, fn
);
464 static DIR* xopendirat_nomod(int dirfd
, const char *path
) {
467 dir
= xopendirat(dirfd
, path
, O_NOFOLLOW
|O_NOATIME
);
471 log_debug_errno(errno
, "Cannot open %sdirectory \"%s\": %m", dirfd
== AT_FDCWD
? "" : "sub", path
);
475 dir
= xopendirat(dirfd
, path
, O_NOFOLLOW
);
477 log_debug_errno(errno
, "Cannot open %sdirectory \"%s\": %m", dirfd
== AT_FDCWD
? "" : "sub", path
);
482 static DIR* opendir_nomod(const char *path
) {
483 return xopendirat_nomod(AT_FDCWD
, path
);
486 static inline nsec_t
load_statx_timestamp_nsec(const struct statx_timestamp
*ts
) {
490 return NSEC_INFINITY
;
492 if ((nsec_t
) ts
->tv_sec
>= (UINT64_MAX
- ts
->tv_nsec
) / NSEC_PER_SEC
)
493 return NSEC_INFINITY
;
495 return ts
->tv_sec
* NSEC_PER_SEC
+ ts
->tv_nsec
;
498 static bool needs_cleanup(
504 const char *sub_path
,
508 if (FLAGS_SET(age_by
, AGE_BY_MTIME
) && mtime
!= NSEC_INFINITY
&& mtime
>= cutoff
) {
509 /* Follows spelling in stat(1). */
510 log_debug("%s \"%s\": modify time %s is too new.",
511 is_dir
? "Directory" : "File",
513 FORMAT_TIMESTAMP_STYLE(mtime
/ NSEC_PER_USEC
, TIMESTAMP_US
));
518 if (FLAGS_SET(age_by
, AGE_BY_ATIME
) && atime
!= NSEC_INFINITY
&& atime
>= cutoff
) {
519 log_debug("%s \"%s\": access time %s is too new.",
520 is_dir
? "Directory" : "File",
522 FORMAT_TIMESTAMP_STYLE(atime
/ NSEC_PER_USEC
, TIMESTAMP_US
));
528 * Note: Unless explicitly specified by the user, "ctime" is ignored
529 * by default for directories, because we change it when deleting.
531 if (FLAGS_SET(age_by
, AGE_BY_CTIME
) && ctime
!= NSEC_INFINITY
&& ctime
>= cutoff
) {
532 log_debug("%s \"%s\": change time %s is too new.",
533 is_dir
? "Directory" : "File",
535 FORMAT_TIMESTAMP_STYLE(ctime
/ NSEC_PER_USEC
, TIMESTAMP_US
));
540 if (FLAGS_SET(age_by
, AGE_BY_BTIME
) && btime
!= NSEC_INFINITY
&& btime
>= cutoff
) {
541 log_debug("%s \"%s\": birth time %s is too new.",
542 is_dir
? "Directory" : "File",
544 FORMAT_TIMESTAMP_STYLE(btime
/ NSEC_PER_USEC
, TIMESTAMP_US
));
552 static int dir_cleanup(
556 nsec_t self_atime_nsec
,
557 nsec_t self_mtime_nsec
,
563 bool keep_this_level
,
567 bool deleted
= false;
570 FOREACH_DIRENT_ALL(de
, d
, break) {
571 _cleanup_free_
char *sub_path
= NULL
;
572 nsec_t atime_nsec
, mtime_nsec
, ctime_nsec
, btime_nsec
;
574 if (dot_or_dot_dot(de
->d_name
))
577 /* If statx() is supported, use it. It's preferable over fstatat() since it tells us
578 * explicitly where we are looking at a mount point, for free as side information. Determining
579 * the same information without statx() is hard, see the complexity of path_is_mount_point(),
580 * and also much slower as it requires a number of syscalls instead of just one. Hence, when
581 * we have modern statx() we use it instead of fstat() and do proper mount point checks,
582 * while on older kernels's well do traditional st_dev based detection of mount points.
584 * Using statx() for detecting mount points also has the benfit that we handle weird file
585 * systems such as overlayfs better where each file is originating from a different
588 STRUCT_STATX_DEFINE(sx
);
591 dirfd(d
), de
->d_name
,
592 AT_SYMLINK_NOFOLLOW
|AT_NO_AUTOMOUNT
,
593 STATX_TYPE
|STATX_MODE
|STATX_UID
|STATX_ATIME
|STATX_MTIME
|STATX_CTIME
|STATX_BTIME
,
598 /* FUSE, NFS mounts, SELinux might return EACCES */
599 r
= log_full_errno(errno
== EACCES
? LOG_DEBUG
: LOG_ERR
, errno
,
600 "statx(%s/%s) failed: %m", p
, de
->d_name
);
604 if (FLAGS_SET(sx
.stx_attributes_mask
, STATX_ATTR_MOUNT_ROOT
)) {
605 /* Yay, we have the mount point API, use it */
606 if (FLAGS_SET(sx
.stx_attributes
, STATX_ATTR_MOUNT_ROOT
)) {
607 log_debug("Ignoring \"%s/%s\": different mount points.", p
, de
->d_name
);
611 /* So we might have statx() but the STATX_ATTR_MOUNT_ROOT flag is not supported, fall
612 * back to traditional stx_dev checking. */
613 if (sx
.stx_dev_major
!= rootdev_major
||
614 sx
.stx_dev_minor
!= rootdev_minor
) {
615 log_debug("Ignoring \"%s/%s\": different filesystem.", p
, de
->d_name
);
619 /* Try to detect bind mounts of the same filesystem instance; they do not differ in device
620 * major/minors. This type of query is not supported on all kernels or filesystem types
622 if (S_ISDIR(sx
.stx_mode
)) {
625 q
= fd_is_mount_point(dirfd(d
), de
->d_name
, 0);
627 log_debug_errno(q
, "Failed to determine whether \"%s/%s\" is a mount point, ignoring: %m", p
, de
->d_name
);
629 log_debug("Ignoring \"%s/%s\": different mount of the same filesystem.", p
, de
->d_name
);
635 atime_nsec
= FLAGS_SET(sx
.stx_mask
, STATX_ATIME
) ? load_statx_timestamp_nsec(&sx
.stx_atime
) : 0;
636 mtime_nsec
= FLAGS_SET(sx
.stx_mask
, STATX_MTIME
) ? load_statx_timestamp_nsec(&sx
.stx_mtime
) : 0;
637 ctime_nsec
= FLAGS_SET(sx
.stx_mask
, STATX_CTIME
) ? load_statx_timestamp_nsec(&sx
.stx_ctime
) : 0;
638 btime_nsec
= FLAGS_SET(sx
.stx_mask
, STATX_BTIME
) ? load_statx_timestamp_nsec(&sx
.stx_btime
) : 0;
640 sub_path
= path_join(p
, de
->d_name
);
646 /* Is there an item configured for this path? */
647 if (ordered_hashmap_get(items
, sub_path
)) {
648 log_debug("Ignoring \"%s\": a separate entry exists.", sub_path
);
652 if (find_glob(globs
, sub_path
)) {
653 log_debug("Ignoring \"%s\": a separate glob exists.", sub_path
);
657 if (S_ISDIR(sx
.stx_mode
)) {
658 _cleanup_closedir_
DIR *sub_dir
= NULL
;
661 streq(de
->d_name
, "lost+found") &&
663 log_debug("Ignoring directory \"%s\".", sub_path
);
668 log_warning("Reached max depth on \"%s\".", sub_path
);
672 sub_dir
= xopendirat_nomod(dirfd(d
), de
->d_name
);
675 r
= log_warning_errno(errno
, "Opening directory \"%s\" failed, ignoring: %m", sub_path
);
680 if (flock(dirfd(sub_dir
), LOCK_EX
|LOCK_NB
) < 0) {
681 log_debug_errno(errno
, "Couldn't acquire shared BSD lock on directory \"%s\", skipping: %m", p
);
687 atime_nsec
, mtime_nsec
, cutoff_nsec
,
688 rootdev_major
, rootdev_minor
,
689 false, maxdepth
-1, false,
690 age_by_file
, age_by_dir
);
695 /* Note: if you are wondering why we don't support the sticky bit for excluding
696 * directories from cleaning like we do it for other file system objects: well, the
697 * sticky bit already has a meaning for directories, so we don't want to overload
700 if (keep_this_level
) {
701 log_debug("Keeping directory \"%s\".", sub_path
);
706 * Check the file timestamps of an entry against the
707 * given cutoff time; delete if it is older.
709 if (!needs_cleanup(atime_nsec
, btime_nsec
, ctime_nsec
, mtime_nsec
,
710 cutoff_nsec
, sub_path
, age_by_dir
, true))
713 log_debug("Removing directory \"%s\".", sub_path
);
714 if (unlinkat(dirfd(d
), de
->d_name
, AT_REMOVEDIR
) < 0)
715 if (!IN_SET(errno
, ENOENT
, ENOTEMPTY
))
716 r
= log_warning_errno(errno
, "Failed to remove directory \"%s\", ignoring: %m", sub_path
);
719 /* Skip files for which the sticky bit is set. These are semantics we define, and are
720 * unknown elsewhere. See XDG_RUNTIME_DIR specification for details. */
721 if (sx
.stx_mode
& S_ISVTX
) {
722 log_debug("Skipping \"%s\": sticky bit set.", sub_path
);
727 S_ISREG(sx
.stx_mode
) &&
729 STR_IN_SET(de
->d_name
,
733 log_debug("Skipping \"%s\".", sub_path
);
737 /* Ignore sockets that are listed in /proc/net/unix */
738 if (S_ISSOCK(sx
.stx_mode
) && unix_socket_alive(sub_path
)) {
739 log_debug("Skipping \"%s\": live socket.", sub_path
);
743 /* Ignore device nodes */
744 if (S_ISCHR(sx
.stx_mode
) || S_ISBLK(sx
.stx_mode
)) {
745 log_debug("Skipping \"%s\": a device.", sub_path
);
749 /* Keep files on this level around if this is requested */
750 if (keep_this_level
) {
751 log_debug("Keeping \"%s\".", sub_path
);
755 if (!needs_cleanup(atime_nsec
, btime_nsec
, ctime_nsec
, mtime_nsec
,
756 cutoff_nsec
, sub_path
, age_by_file
, false))
759 log_debug("Removing \"%s\".", sub_path
);
760 if (unlinkat(dirfd(d
), de
->d_name
, 0) < 0)
762 r
= log_warning_errno(errno
, "Failed to remove \"%s\", ignoring: %m", sub_path
);
770 struct timespec ts
[2];
772 log_debug("Restoring access and modification time on \"%s\": %s, %s",
774 FORMAT_TIMESTAMP_STYLE(self_atime_nsec
/ NSEC_PER_USEC
, TIMESTAMP_US
),
775 FORMAT_TIMESTAMP_STYLE(self_mtime_nsec
/ NSEC_PER_USEC
, TIMESTAMP_US
));
777 timespec_store_nsec(ts
+ 0, self_atime_nsec
);
778 timespec_store_nsec(ts
+ 1, self_mtime_nsec
);
780 /* Restore original directory timestamps */
781 if (futimens(dirfd(d
), ts
) < 0)
782 log_warning_errno(errno
, "Failed to revert timestamps of '%s', ignoring: %m", p
);
788 static bool dangerous_hardlinks(void) {
789 _cleanup_free_
char *value
= NULL
;
790 static int cached
= -1;
793 /* Check whether the fs.protected_hardlinks sysctl is on. If we can't determine it we assume its off, as that's
794 * what the upstream default is. */
799 r
= read_one_line_file("/proc/sys/fs/protected_hardlinks", &value
);
801 log_debug_errno(r
, "Failed to read fs.protected_hardlinks sysctl: %m");
805 r
= parse_boolean(value
);
807 log_debug_errno(r
, "Failed to parse fs.protected_hardlinks sysctl: %m");
815 static bool hardlink_vulnerable(const struct stat
*st
) {
818 return !S_ISDIR(st
->st_mode
) && st
->st_nlink
> 1 && dangerous_hardlinks();
821 static mode_t
process_mask_perms(mode_t mode
, mode_t current
) {
823 if ((current
& 0111) == 0)
825 if ((current
& 0222) == 0)
827 if ((current
& 0444) == 0)
829 if (!S_ISDIR(current
))
830 mode
&= ~07000; /* remove sticky/sgid/suid bit, unless directory */
835 static int fd_set_perms(Item
*i
, int fd
, const char *path
, const struct stat
*st
) {
845 if (!i
->mode_set
&& !i
->uid_set
&& !i
->gid_set
)
849 if (fstat(fd
, &stbuf
) < 0)
850 return log_error_errno(errno
, "fstat(%s) failed: %m", path
);
854 if (hardlink_vulnerable(st
))
855 return log_error_errno(SYNTHETIC_ERRNO(EPERM
),
856 "Refusing to set permissions on hardlinked file %s while the fs.protected_hardlinks sysctl is turned off.",
859 /* Do we need a chown()? */
861 (i
->uid_set
&& i
->uid
!= st
->st_uid
) ||
862 (i
->gid_set
&& i
->gid
!= st
->st_gid
);
864 /* Calculate the mode to apply */
865 new_mode
= i
->mode_set
? (i
->mask_perms
?
866 process_mask_perms(i
->mode
, st
->st_mode
) :
868 (st
->st_mode
& 07777);
870 if (i
->mode_set
&& do_chown
) {
871 /* Before we issue the chmod() let's reduce the access mode to the common bits of the old and
872 * the new mode. That way there's no time window where the file exists under the old owner
873 * with more than the old access modes — and not under the new owner with more than the new
874 * access modes either. */
876 if (S_ISLNK(st
->st_mode
))
877 log_debug("Skipping temporary mode fix for symlink %s.", path
);
879 mode_t m
= new_mode
& st
->st_mode
; /* Mask new mode by old mode */
881 if (((m
^ st
->st_mode
) & 07777) == 0)
882 log_debug("\"%s\" matches temporary mode %o already.", path
, m
);
884 log_debug("Temporarily changing \"%s\" to mode %o.", path
, m
);
885 r
= fchmod_opath(fd
, m
);
887 return log_error_errno(r
, "fchmod() of %s failed: %m", path
);
893 log_debug("Changing \"%s\" to owner "UID_FMT
":"GID_FMT
,
895 i
->uid_set
? i
->uid
: UID_INVALID
,
896 i
->gid_set
? i
->gid
: GID_INVALID
);
900 i
->uid_set
? i
->uid
: UID_INVALID
,
901 i
->gid_set
? i
->gid
: GID_INVALID
,
903 return log_error_errno(errno
, "fchownat() of %s failed: %m", path
);
906 /* Now, apply the final mode. We do this in two cases: when the user set a mode explicitly, or after a
907 * chown(), since chown()'s mangle the access mode in regards to sgid/suid in some conditions. */
908 if (i
->mode_set
|| do_chown
) {
909 if (S_ISLNK(st
->st_mode
))
910 log_debug("Skipping mode fix for symlink %s.", path
);
912 /* Check if the chmod() is unnecessary. Note that if we did a chown() before we always
913 * chmod() here again, since it might have mangled the bits. */
914 if (!do_chown
&& ((new_mode
^ st
->st_mode
) & 07777) == 0)
915 log_debug("\"%s\" matches mode %o already.", path
, new_mode
);
917 log_debug("Changing \"%s\" to mode %o.", path
, new_mode
);
918 r
= fchmod_opath(fd
, new_mode
);
920 return log_error_errno(r
, "fchmod() of %s failed: %m", path
);
926 return label_fix(path
, 0);
929 static int path_open_parent_safe(const char *path
) {
930 _cleanup_free_
char *dn
= NULL
;
933 if (path_equal(path
, "/") || !path_is_normalized(path
))
934 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
935 "Failed to open parent of '%s': invalid path.",
938 dn
= dirname_malloc(path
);
942 r
= chase_symlinks(dn
, arg_root
, CHASE_SAFE
|CHASE_WARN
, NULL
, &fd
);
943 if (r
< 0 && r
!= -ENOLINK
)
944 return log_error_errno(r
, "Failed to validate path %s: %m", path
);
946 return r
< 0 ? r
: fd
;
949 static int path_open_safe(const char *path
) {
952 /* path_open_safe() returns a file descriptor opened with O_PATH after
953 * verifying that the path doesn't contain unsafe transitions, except
954 * for its final component as the function does not follow symlink. */
958 if (!path_is_normalized(path
))
959 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
960 "Failed to open invalid path '%s'.",
963 r
= chase_symlinks(path
, arg_root
, CHASE_SAFE
|CHASE_WARN
|CHASE_NOFOLLOW
, NULL
, &fd
);
964 if (r
< 0 && r
!= -ENOLINK
)
965 return log_error_errno(r
, "Failed to validate path %s: %m", path
);
967 return r
< 0 ? r
: fd
;
970 static int path_set_perms(Item
*i
, const char *path
) {
971 _cleanup_close_
int fd
= -1;
976 fd
= path_open_safe(path
);
980 return fd_set_perms(i
, fd
, path
, NULL
);
983 static int parse_xattrs_from_arg(Item
*i
) {
993 _cleanup_free_
char *name
= NULL
, *value
= NULL
, *xattr
= NULL
;
995 r
= extract_first_word(&p
, &xattr
, NULL
, EXTRACT_UNQUOTE
|EXTRACT_CUNESCAPE
);
997 log_warning_errno(r
, "Failed to parse extended attribute '%s', ignoring: %m", p
);
1001 r
= split_pair(xattr
, "=", &name
, &value
);
1003 log_warning_errno(r
, "Failed to parse extended attribute, ignoring: %s", xattr
);
1007 if (isempty(name
) || isempty(value
)) {
1008 log_warning("Malformed extended attribute found, ignoring: %s", xattr
);
1012 if (strv_push_pair(&i
->xattrs
, name
, value
) < 0)
1015 name
= value
= NULL
;
1021 static int fd_set_xattrs(Item
*i
, int fd
, const char *path
, const struct stat
*st
) {
1026 STRV_FOREACH_PAIR(name
, value
, i
->xattrs
) {
1027 log_debug("Setting extended attribute '%s=%s' on %s.", *name
, *value
, path
);
1028 if (setxattr(FORMAT_PROC_FD_PATH(fd
), *name
, *value
, strlen(*value
), 0) < 0)
1029 return log_error_errno(errno
, "Setting extended attribute %s=%s on %s failed: %m",
1030 *name
, *value
, path
);
1035 static int path_set_xattrs(Item
*i
, const char *path
) {
1036 _cleanup_close_
int fd
= -1;
1041 fd
= path_open_safe(path
);
1045 return fd_set_xattrs(i
, fd
, path
, NULL
);
1048 static int parse_acls_from_arg(Item
*item
) {
1054 /* If append_or_force (= modify) is set, we will not modify the acl
1055 * afterwards, so the mask can be added now if necessary. */
1057 r
= parse_acl(item
->argument
, &item
->acl_access
, &item
->acl_default
, !item
->append_or_force
);
1059 log_warning_errno(r
, "Failed to parse ACL \"%s\": %m. Ignoring", item
->argument
);
1061 log_warning("ACLs are not supported. Ignoring.");
1068 static int path_set_acl(const char *path
, const char *pretty
, acl_type_t type
, acl_t acl
, bool modify
) {
1069 _cleanup_(acl_free_charpp
) char *t
= NULL
;
1070 _cleanup_(acl_freep
) acl_t dup
= NULL
;
1073 /* Returns 0 for success, positive error if already warned,
1074 * negative error otherwise. */
1077 r
= acls_for_file(path
, type
, acl
, &dup
);
1081 r
= calc_acl_mask_if_needed(&dup
);
1089 /* the mask was already added earlier if needed */
1092 r
= add_base_acls_if_needed(&dup
, path
);
1096 t
= acl_to_any_text(dup
, NULL
, ',', TEXT_ABBREVIATE
);
1097 log_debug("Setting %s ACL %s on %s.",
1098 type
== ACL_TYPE_ACCESS
? "access" : "default",
1101 r
= acl_set_file(path
, type
, dup
);
1103 if (ERRNO_IS_NOT_SUPPORTED(errno
))
1104 /* No error if filesystem doesn't support ACLs. Return negative. */
1107 /* Return positive to indicate we already warned */
1108 return -log_error_errno(errno
,
1109 "Setting %s ACL \"%s\" on %s failed: %m",
1110 type
== ACL_TYPE_ACCESS
? "access" : "default",
1117 static int fd_set_acls(Item
*item
, int fd
, const char *path
, const struct stat
*st
) {
1127 if (fstat(fd
, &stbuf
) < 0)
1128 return log_error_errno(errno
, "fstat(%s) failed: %m", path
);
1132 if (hardlink_vulnerable(st
))
1133 return log_error_errno(SYNTHETIC_ERRNO(EPERM
),
1134 "Refusing to set ACLs on hardlinked file %s while the fs.protected_hardlinks sysctl is turned off.",
1137 if (S_ISLNK(st
->st_mode
)) {
1138 log_debug("Skipping ACL fix for symlink %s.", path
);
1142 if (item
->acl_access
)
1143 r
= path_set_acl(FORMAT_PROC_FD_PATH(fd
), path
, ACL_TYPE_ACCESS
, item
->acl_access
, item
->append_or_force
);
1145 /* set only default acls to folders */
1146 if (r
== 0 && item
->acl_default
&& S_ISDIR(st
->st_mode
))
1147 r
= path_set_acl(FORMAT_PROC_FD_PATH(fd
), path
, ACL_TYPE_DEFAULT
, item
->acl_default
, item
->append_or_force
);
1149 if (ERRNO_IS_NOT_SUPPORTED(r
)) {
1150 log_debug_errno(r
, "ACLs not supported by file system at %s", path
);
1155 return -r
; /* already warned */
1157 /* The above procfs paths don't work if /proc is not mounted. */
1158 if (r
== -ENOENT
&& proc_mounted() == 0)
1162 return log_error_errno(r
, "ACL operation on \"%s\" failed: %m", path
);
1167 static int path_set_acls(Item
*item
, const char *path
) {
1170 _cleanup_close_
int fd
= -1;
1175 fd
= path_open_safe(path
);
1179 r
= fd_set_acls(item
, fd
, path
, NULL
);
1184 static int parse_attribute_from_arg(Item
*item
) {
1186 static const struct {
1190 { 'A', FS_NOATIME_FL
}, /* do not update atime */
1191 { 'S', FS_SYNC_FL
}, /* Synchronous updates */
1192 { 'D', FS_DIRSYNC_FL
}, /* dirsync behaviour (directories only) */
1193 { 'a', FS_APPEND_FL
}, /* writes to file may only append */
1194 { 'c', FS_COMPR_FL
}, /* Compress file */
1195 { 'd', FS_NODUMP_FL
}, /* do not dump file */
1196 { 'e', FS_EXTENT_FL
}, /* Extents */
1197 { 'i', FS_IMMUTABLE_FL
}, /* Immutable file */
1198 { 'j', FS_JOURNAL_DATA_FL
}, /* Reserved for ext3 */
1199 { 's', FS_SECRM_FL
}, /* Secure deletion */
1200 { 'u', FS_UNRM_FL
}, /* Undelete */
1201 { 't', FS_NOTAIL_FL
}, /* file tail should not be merged */
1202 { 'T', FS_TOPDIR_FL
}, /* Top of directory hierarchies */
1203 { 'C', FS_NOCOW_FL
}, /* Do not cow file */
1204 { 'P', FS_PROJINHERIT_FL
}, /* Inherit the quota project ID */
1213 unsigned value
= 0, mask
= 0;
1223 } else if (*p
== '-') {
1226 } else if (*p
== '=') {
1232 if (isempty(p
) && mode
!= MODE_SET
)
1233 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1234 "Setting file attribute on '%s' needs an attribute specification.",
1237 for (; p
&& *p
; p
++) {
1240 for (i
= 0; i
< ELEMENTSOF(attributes
); i
++)
1241 if (*p
== attributes
[i
].character
)
1244 if (i
>= ELEMENTSOF(attributes
))
1245 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1246 "Unknown file attribute '%c' on '%s'.",
1249 v
= attributes
[i
].value
;
1251 SET_FLAG(value
, v
, IN_SET(mode
, MODE_ADD
, MODE_SET
));
1256 if (mode
== MODE_SET
)
1257 mask
|= CHATTR_ALL_FL
;
1261 item
->attribute_mask
= mask
;
1262 item
->attribute_value
= value
;
1263 item
->attribute_set
= true;
1268 static int fd_set_attribute(Item
*item
, int fd
, const char *path
, const struct stat
*st
) {
1269 _cleanup_close_
int procfs_fd
= -1;
1278 if (!item
->attribute_set
|| item
->attribute_mask
== 0)
1282 if (fstat(fd
, &stbuf
) < 0)
1283 return log_error_errno(errno
, "fstat(%s) failed: %m", path
);
1287 /* Issuing the file attribute ioctls on device nodes is not
1288 * safe, as that will be delivered to the drivers, not the
1289 * file system containing the device node. */
1290 if (!S_ISREG(st
->st_mode
) && !S_ISDIR(st
->st_mode
))
1291 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1292 "Setting file flags is only supported on regular files and directories, cannot set on '%s'.",
1295 f
= item
->attribute_value
& item
->attribute_mask
;
1297 /* Mask away directory-specific flags */
1298 if (!S_ISDIR(st
->st_mode
))
1299 f
&= ~FS_DIRSYNC_FL
;
1301 procfs_fd
= fd_reopen(fd
, O_RDONLY
|O_CLOEXEC
|O_NOATIME
);
1303 return log_error_errno(procfs_fd
, "Failed to re-open '%s': %m", path
);
1305 unsigned previous
, current
;
1306 r
= chattr_full(NULL
, procfs_fd
, f
, item
->attribute_mask
, &previous
, ¤t
, CHATTR_FALLBACK_BITWISE
);
1308 log_warning("Cannot set file attributes for '%s', maybe due to incompatibility in specified attributes, "
1309 "previous=0x%08x, current=0x%08x, expected=0x%08x, ignoring.",
1310 path
, previous
, current
, (previous
& ~item
->attribute_mask
) | (f
& item
->attribute_mask
));
1312 log_full_errno(ERRNO_IS_NOT_SUPPORTED(r
) ? LOG_DEBUG
: LOG_WARNING
, r
,
1313 "Cannot set file attributes for '%s', value=0x%08x, mask=0x%08x, ignoring: %m",
1314 path
, item
->attribute_value
, item
->attribute_mask
);
1319 static int path_set_attribute(Item
*item
, const char *path
) {
1320 _cleanup_close_
int fd
= -1;
1322 if (!item
->attribute_set
|| item
->attribute_mask
== 0)
1325 fd
= path_open_safe(path
);
1329 return fd_set_attribute(item
, fd
, path
, NULL
);
1332 static int write_one_file(Item
*i
, const char *path
) {
1333 _cleanup_close_
int fd
= -1, dir_fd
= -1;
1339 assert(i
->argument
);
1340 assert(i
->type
== WRITE_FILE
);
1342 /* Validate the path and keep the fd on the directory for opening the
1343 * file so we're sure that it can't be changed behind our back. */
1344 dir_fd
= path_open_parent_safe(path
);
1348 bn
= basename(path
);
1350 /* Follows symlinks */
1351 fd
= openat(dir_fd
, bn
,
1352 O_NONBLOCK
|O_CLOEXEC
|O_WRONLY
|O_NOCTTY
|(i
->append_or_force
? O_APPEND
: 0),
1355 if (errno
== ENOENT
) {
1356 log_debug_errno(errno
, "Not writing missing file \"%s\": %m", path
);
1360 if (i
->allow_failure
)
1361 return log_debug_errno(errno
, "Failed to open file \"%s\", ignoring: %m", path
);
1363 return log_error_errno(errno
, "Failed to open file \"%s\": %m", path
);
1366 /* 'w' is allowed to write into any kind of files. */
1367 log_debug("Writing to \"%s\".", path
);
1369 r
= loop_write(fd
, i
->argument
, strlen(i
->argument
), false);
1371 return log_error_errno(r
, "Failed to write file \"%s\": %m", path
);
1373 return fd_set_perms(i
, fd
, path
, NULL
);
1376 static int create_file(Item
*i
, const char *path
) {
1377 _cleanup_close_
int fd
= -1, dir_fd
= -1;
1378 struct stat stbuf
, *st
= NULL
;
1384 assert(i
->type
== CREATE_FILE
);
1386 /* 'f' operates on regular files exclusively. */
1388 /* Validate the path and keep the fd on the directory for opening the
1389 * file so we're sure that it can't be changed behind our back. */
1390 dir_fd
= path_open_parent_safe(path
);
1394 bn
= basename(path
);
1396 RUN_WITH_UMASK(0000) {
1397 mac_selinux_create_file_prepare(path
, S_IFREG
);
1398 fd
= openat(dir_fd
, bn
, O_CREAT
|O_EXCL
|O_NOFOLLOW
|O_NONBLOCK
|O_CLOEXEC
|O_WRONLY
|O_NOCTTY
, i
->mode
);
1399 mac_selinux_create_file_clear();
1403 /* Even on a read-only filesystem, open(2) returns EEXIST if the
1404 * file already exists. It returns EROFS only if it needs to
1405 * create the file. */
1406 if (errno
!= EEXIST
)
1407 return log_error_errno(errno
, "Failed to create file %s: %m", path
);
1409 /* Re-open the file. At that point it must exist since open(2)
1410 * failed with EEXIST. We still need to check if the perms/mode
1411 * need to be changed. For read-only filesystems, we let
1412 * fd_set_perms() report the error if the perms need to be
1414 fd
= openat(dir_fd
, bn
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
, i
->mode
);
1416 return log_error_errno(errno
, "Failed to re-open file %s: %m", path
);
1418 if (fstat(fd
, &stbuf
) < 0)
1419 return log_error_errno(errno
, "stat(%s) failed: %m", path
);
1421 if (!S_ISREG(stbuf
.st_mode
))
1422 return log_error_errno(SYNTHETIC_ERRNO(EEXIST
),
1423 "%s exists and is not a regular file.",
1429 log_debug("\"%s\" has been created.", path
);
1432 log_debug("Writing to \"%s\".", path
);
1434 r
= loop_write(fd
, i
->argument
, strlen(i
->argument
), false);
1436 return log_error_errno(r
, "Failed to write file \"%s\": %m", path
);
1440 return fd_set_perms(i
, fd
, path
, st
);
1443 static int truncate_file(Item
*i
, const char *path
) {
1444 _cleanup_close_
int fd
= -1, dir_fd
= -1;
1445 struct stat stbuf
, *st
= NULL
;
1452 assert(i
->type
== TRUNCATE_FILE
|| (i
->type
== CREATE_FILE
&& i
->append_or_force
));
1454 /* We want to operate on regular file exclusively especially since
1455 * O_TRUNC is unspecified if the file is neither a regular file nor a
1456 * fifo nor a terminal device. Therefore we first open the file and make
1457 * sure it's a regular one before truncating it. */
1459 /* Validate the path and keep the fd on the directory for opening the
1460 * file so we're sure that it can't be changed behind our back. */
1461 dir_fd
= path_open_parent_safe(path
);
1465 bn
= basename(path
);
1467 RUN_WITH_UMASK(0000) {
1468 mac_selinux_create_file_prepare(path
, S_IFREG
);
1469 fd
= openat(dir_fd
, bn
, O_CREAT
|O_NOFOLLOW
|O_NONBLOCK
|O_CLOEXEC
|O_WRONLY
|O_NOCTTY
, i
->mode
);
1470 mac_selinux_create_file_clear();
1475 return log_error_errno(errno
, "Failed to open/create file %s: %m", path
);
1477 /* On a read-only filesystem, we don't want to fail if the
1478 * target is already empty and the perms are set. So we still
1479 * proceed with the sanity checks and let the remaining
1480 * operations fail with EROFS if they try to modify the target
1483 fd
= openat(dir_fd
, bn
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
, i
->mode
);
1485 if (errno
== ENOENT
)
1486 return log_error_errno(SYNTHETIC_ERRNO(EROFS
),
1487 "Cannot create file %s on a read-only file system.",
1490 return log_error_errno(errno
, "Failed to re-open file %s: %m", path
);
1496 if (fstat(fd
, &stbuf
) < 0)
1497 return log_error_errno(errno
, "stat(%s) failed: %m", path
);
1499 if (!S_ISREG(stbuf
.st_mode
))
1500 return log_error_errno(SYNTHETIC_ERRNO(EEXIST
),
1501 "%s exists and is not a regular file.",
1504 if (stbuf
.st_size
> 0) {
1505 if (ftruncate(fd
, 0) < 0) {
1506 r
= erofs
? -EROFS
: -errno
;
1507 return log_error_errno(r
, "Failed to truncate file %s: %m", path
);
1512 log_debug("\"%s\" has been created.", path
);
1515 log_debug("Writing to \"%s\".", path
);
1517 r
= loop_write(fd
, i
->argument
, strlen(i
->argument
), false);
1519 r
= erofs
? -EROFS
: r
;
1520 return log_error_errno(r
, "Failed to write file %s: %m", path
);
1524 return fd_set_perms(i
, fd
, path
, st
);
1527 static int copy_files(Item
*i
) {
1528 _cleanup_close_
int dfd
= -1, fd
= -1;
1532 log_debug("Copying tree \"%s\" to \"%s\".", i
->argument
, i
->path
);
1534 bn
= basename(i
->path
);
1536 /* Validate the path and use the returned directory fd for copying the
1537 * target so we're sure that the path can't be changed behind our
1539 dfd
= path_open_parent_safe(i
->path
);
1543 r
= copy_tree_at(AT_FDCWD
, i
->argument
,
1545 i
->uid_set
? i
->uid
: UID_INVALID
,
1546 i
->gid_set
? i
->gid
: GID_INVALID
,
1547 COPY_REFLINK
| COPY_MERGE_EMPTY
| COPY_MAC_CREATE
| COPY_HARDLINKS
);
1551 /* If the target already exists on read-only filesystems, trying
1552 * to create the target will not fail with EEXIST but with
1554 if (r
== -EROFS
&& faccessat(dfd
, bn
, F_OK
, AT_SYMLINK_NOFOLLOW
) == 0)
1558 return log_error_errno(r
, "Failed to copy files to %s: %m", i
->path
);
1560 if (stat(i
->argument
, &a
) < 0)
1561 return log_error_errno(errno
, "stat(%s) failed: %m", i
->argument
);
1563 if (fstatat(dfd
, bn
, &b
, AT_SYMLINK_NOFOLLOW
) < 0)
1564 return log_error_errno(errno
, "stat(%s) failed: %m", i
->path
);
1566 if ((a
.st_mode
^ b
.st_mode
) & S_IFMT
) {
1567 log_debug("Can't copy to %s, file exists already and is of different type", i
->path
);
1572 fd
= openat(dfd
, bn
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
);
1574 return log_error_errno(errno
, "Failed to openat(%s): %m", i
->path
);
1576 return fd_set_perms(i
, fd
, i
->path
, NULL
);
1584 _CREATION_MODE_INVALID
= -EINVAL
,
1587 static const char *const creation_mode_verb_table
[_CREATION_MODE_MAX
] = {
1588 [CREATION_NORMAL
] = "Created",
1589 [CREATION_EXISTING
] = "Found existing",
1590 [CREATION_FORCE
] = "Created replacement",
1593 DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(creation_mode_verb
, CreationMode
);
1595 static int create_directory_or_subvolume(const char *path
, mode_t mode
, bool subvol
, CreationMode
*creation
) {
1596 _cleanup_close_
int pfd
= -1;
1605 pfd
= path_open_parent_safe(path
);
1610 r
= getenv_bool("SYSTEMD_TMPFILES_FORCE_SUBVOL");
1612 if (r
!= -ENXIO
) /* env var is unset */
1613 log_warning_errno(r
, "Cannot parse value of $SYSTEMD_TMPFILES_FORCE_SUBVOL, ignoring.");
1614 r
= btrfs_is_subvol(empty_to_root(arg_root
)) > 0;
1617 /* Don't create a subvolume unless the root directory is
1618 * one, too. We do this under the assumption that if the
1619 * root directory is just a plain directory (i.e. very
1620 * light-weight), we shouldn't try to split it up into
1621 * subvolumes (i.e. more heavy-weight). Thus, chroot()
1622 * environments and suchlike will get a full brtfs
1623 * subvolume set up below their tree only if they
1624 * specifically set up a btrfs subvolume for the root
1629 RUN_WITH_UMASK((~mode
) & 0777)
1630 r
= btrfs_subvol_make_fd(pfd
, basename(path
));
1635 if (!subvol
|| r
== -ENOTTY
)
1636 RUN_WITH_UMASK(0000)
1637 r
= mkdirat_label(pfd
, basename(path
), mode
);
1642 if (!IN_SET(r
, -EEXIST
, -EROFS
))
1643 return log_error_errno(r
, "Failed to create directory or subvolume \"%s\": %m", path
);
1646 if (k
== -ENOENT
&& r
== -EROFS
)
1647 return log_error_errno(r
, "%s does not exist and cannot be created as the file system is read-only.", path
);
1649 return log_error_errno(k
, "Failed to check if %s exists: %m", path
);
1651 return log_warning_errno(SYNTHETIC_ERRNO(EEXIST
),
1652 "\"%s\" already exists and is not a directory.", path
);
1654 *creation
= CREATION_EXISTING
;
1656 *creation
= CREATION_NORMAL
;
1658 log_debug("%s directory \"%s\".", creation_mode_verb_to_string(*creation
), path
);
1660 r
= openat(pfd
, basename(path
), O_NOCTTY
|O_CLOEXEC
|O_DIRECTORY
);
1662 return log_error_errno(errno
, "Failed to open directory '%s': %m", basename(path
));
1667 static int create_directory(Item
*i
, const char *path
) {
1668 _cleanup_close_
int fd
= -1;
1671 assert(IN_SET(i
->type
, CREATE_DIRECTORY
, TRUNCATE_DIRECTORY
));
1673 fd
= create_directory_or_subvolume(path
, i
->mode
, false, NULL
);
1679 return fd_set_perms(i
, fd
, path
, NULL
);
1682 static int create_subvolume(Item
*i
, const char *path
) {
1683 _cleanup_close_
int fd
= -1;
1684 CreationMode creation
;
1688 assert(IN_SET(i
->type
, CREATE_SUBVOLUME
, CREATE_SUBVOLUME_NEW_QUOTA
, CREATE_SUBVOLUME_INHERIT_QUOTA
));
1690 fd
= create_directory_or_subvolume(path
, i
->mode
, true, &creation
);
1696 if (creation
== CREATION_NORMAL
&&
1697 IN_SET(i
->type
, CREATE_SUBVOLUME_NEW_QUOTA
, CREATE_SUBVOLUME_INHERIT_QUOTA
)) {
1698 r
= btrfs_subvol_auto_qgroup_fd(fd
, 0, i
->type
== CREATE_SUBVOLUME_NEW_QUOTA
);
1700 log_debug_errno(r
, "Couldn't adjust quota for subvolume \"%s\" (unsupported fs or dir not a subvolume): %m", i
->path
);
1701 else if (r
== -EROFS
)
1702 log_debug_errno(r
, "Couldn't adjust quota for subvolume \"%s\" (fs is read-only).", i
->path
);
1703 else if (r
== -ENOTCONN
)
1704 log_debug_errno(r
, "Couldn't adjust quota for subvolume \"%s\" (quota support is disabled).", i
->path
);
1706 q
= log_error_errno(r
, "Failed to adjust quota for subvolume \"%s\": %m", i
->path
);
1708 log_debug("Adjusted quota for subvolume \"%s\".", i
->path
);
1710 log_debug("Quota for subvolume \"%s\" already in place, no change made.", i
->path
);
1713 r
= fd_set_perms(i
, fd
, path
, NULL
);
1714 if (q
< 0) /* prefer the quota change error from above */
1720 static int empty_directory(Item
*i
, const char *path
) {
1724 assert(i
->type
== EMPTY_DIRECTORY
);
1726 r
= is_dir(path
, false);
1728 /* Option "e" operates only on existing objects. Do not
1729 * print errors about non-existent files or directories */
1730 log_debug("Skipping missing directory: %s", path
);
1734 return log_error_errno(r
, "is_dir() failed on path %s: %m", path
);
1736 log_warning("\"%s\" already exists and is not a directory.", path
);
1740 return path_set_perms(i
, path
);
1743 static int create_device(Item
*i
, mode_t file_type
) {
1744 _cleanup_close_
int dfd
= -1, fd
= -1;
1745 CreationMode creation
;
1750 assert(IN_SET(file_type
, S_IFBLK
, S_IFCHR
));
1752 bn
= basename(i
->path
);
1754 /* Validate the path and use the returned directory fd for copying the
1755 * target so we're sure that the path can't be changed behind our
1757 dfd
= path_open_parent_safe(i
->path
);
1761 RUN_WITH_UMASK(0000) {
1762 mac_selinux_create_file_prepare(i
->path
, file_type
);
1763 r
= mknodat(dfd
, bn
, i
->mode
| file_type
, i
->major_minor
);
1764 mac_selinux_create_file_clear();
1770 if (errno
== EPERM
) {
1771 log_debug("We lack permissions, possibly because of cgroup configuration; "
1772 "skipping creation of device node %s.", i
->path
);
1776 if (errno
!= EEXIST
)
1777 return log_error_errno(errno
, "Failed to create device node %s: %m", i
->path
);
1779 if (fstatat(dfd
, bn
, &st
, 0) < 0)
1780 return log_error_errno(errno
, "stat(%s) failed: %m", i
->path
);
1782 if ((st
.st_mode
& S_IFMT
) != file_type
) {
1784 if (i
->append_or_force
) {
1786 RUN_WITH_UMASK(0000) {
1787 mac_selinux_create_file_prepare(i
->path
, file_type
);
1788 /* FIXME: need to introduce mknodat_atomic() */
1789 r
= mknod_atomic(i
->path
, i
->mode
| file_type
, i
->major_minor
);
1790 mac_selinux_create_file_clear();
1794 return log_error_errno(r
, "Failed to create device node \"%s\": %m", i
->path
);
1795 creation
= CREATION_FORCE
;
1797 log_warning("\"%s\" already exists is not a device node.", i
->path
);
1801 creation
= CREATION_EXISTING
;
1803 creation
= CREATION_NORMAL
;
1805 log_debug("%s %s device node \"%s\" %u:%u.",
1806 creation_mode_verb_to_string(creation
),
1807 i
->type
== CREATE_BLOCK_DEVICE
? "block" : "char",
1808 i
->path
, major(i
->mode
), minor(i
->mode
));
1810 fd
= openat(dfd
, bn
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
);
1812 return log_error_errno(errno
, "Failed to openat(%s): %m", i
->path
);
1814 return fd_set_perms(i
, fd
, i
->path
, NULL
);
1817 static int create_fifo(Item
*i
, const char *path
) {
1818 _cleanup_close_
int pfd
= -1, fd
= -1;
1819 CreationMode creation
;
1824 pfd
= path_open_parent_safe(path
);
1828 bn
= basename(path
);
1830 RUN_WITH_UMASK(0000) {
1831 mac_selinux_create_file_prepare(path
, S_IFIFO
);
1832 r
= mkfifoat(pfd
, bn
, i
->mode
);
1833 mac_selinux_create_file_clear();
1837 if (errno
!= EEXIST
)
1838 return log_error_errno(errno
, "Failed to create fifo %s: %m", path
);
1840 if (fstatat(pfd
, bn
, &st
, AT_SYMLINK_NOFOLLOW
) < 0)
1841 return log_error_errno(errno
, "stat(%s) failed: %m", path
);
1843 if (!S_ISFIFO(st
.st_mode
)) {
1845 if (i
->append_or_force
) {
1846 RUN_WITH_UMASK(0000) {
1847 mac_selinux_create_file_prepare(path
, S_IFIFO
);
1848 r
= mkfifoat_atomic(pfd
, bn
, i
->mode
);
1849 mac_selinux_create_file_clear();
1853 return log_error_errno(r
, "Failed to create fifo %s: %m", path
);
1854 creation
= CREATION_FORCE
;
1856 log_warning("\"%s\" already exists and is not a fifo.", path
);
1860 creation
= CREATION_EXISTING
;
1862 creation
= CREATION_NORMAL
;
1864 log_debug("%s fifo \"%s\".", creation_mode_verb_to_string(creation
), path
);
1866 fd
= openat(pfd
, bn
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
);
1868 return log_error_errno(errno
, "Failed to openat(%s): %m", path
);
1870 return fd_set_perms(i
, fd
, i
->path
, NULL
);
1873 typedef int (*action_t
)(Item
*i
, const char *path
);
1874 typedef int (*fdaction_t
)(Item
*i
, int fd
, const char *path
, const struct stat
*st
);
1876 static int item_do(Item
*i
, int fd
, const char *path
, fdaction_t action
) {
1884 if (fstat(fd
, &st
) < 0) {
1885 r
= log_error_errno(errno
, "fstat() on file failed: %m");
1889 /* This returns the first error we run into, but nevertheless
1891 r
= action(i
, fd
, path
, &st
);
1893 if (S_ISDIR(st
.st_mode
)) {
1894 _cleanup_closedir_
DIR *d
= NULL
;
1896 /* The passed 'fd' was opened with O_PATH. We need to convert it into a 'regular' fd before
1897 * reading the directory content. */
1898 d
= opendir(FORMAT_PROC_FD_PATH(fd
));
1900 log_error_errno(errno
, "Failed to opendir() '%s': %m", FORMAT_PROC_FD_PATH(fd
));
1906 FOREACH_DIRENT_ALL(de
, d
, q
= -errno
; goto finish
) {
1909 if (dot_or_dot_dot(de
->d_name
))
1912 de_fd
= openat(fd
, de
->d_name
, O_NOFOLLOW
|O_CLOEXEC
|O_PATH
);
1914 q
= log_error_errno(errno
, "Failed to open() file '%s': %m", de
->d_name
);
1916 _cleanup_free_
char *de_path
= NULL
;
1918 de_path
= path_join(path
, de
->d_name
);
1922 /* Pass ownership of dirent fd over */
1923 q
= item_do(i
, de_fd
, de_path
, action
);
1926 if (q
< 0 && r
== 0)
1935 static int glob_item(Item
*i
, action_t action
) {
1936 _cleanup_globfree_ glob_t g
= {
1937 .gl_opendir
= (void *(*)(const char *)) opendir_nomod
,
1941 k
= safe_glob(i
->path
, GLOB_NOSORT
|GLOB_BRACE
, &g
);
1942 if (k
< 0 && k
!= -ENOENT
)
1943 return log_error_errno(k
, "glob(%s) failed: %m", i
->path
);
1945 STRV_FOREACH(fn
, g
.gl_pathv
) {
1947 if (k
< 0 && r
== 0)
1954 static int glob_item_recursively(Item
*i
, fdaction_t action
) {
1955 _cleanup_globfree_ glob_t g
= {
1956 .gl_opendir
= (void *(*)(const char *)) opendir_nomod
,
1960 k
= safe_glob(i
->path
, GLOB_NOSORT
|GLOB_BRACE
, &g
);
1961 if (k
< 0 && k
!= -ENOENT
)
1962 return log_error_errno(k
, "glob(%s) failed: %m", i
->path
);
1964 STRV_FOREACH(fn
, g
.gl_pathv
) {
1965 _cleanup_close_
int fd
= -1;
1967 /* Make sure we won't trigger/follow file object (such as
1968 * device nodes, automounts, ...) pointed out by 'fn' with
1969 * O_PATH. Note, when O_PATH is used, flags other than
1970 * O_CLOEXEC, O_DIRECTORY, and O_NOFOLLOW are ignored. */
1972 fd
= open(*fn
, O_CLOEXEC
|O_NOFOLLOW
|O_PATH
);
1974 log_error_errno(errno
, "Opening '%s' failed: %m", *fn
);
1980 k
= item_do(i
, fd
, *fn
, action
);
1981 if (k
< 0 && r
== 0)
1984 /* we passed fd ownership to the previous call */
1991 static int rm_if_wrong_type_safe(
1994 const struct stat
*parent_st
, /* Only used if follow_links below is true. */
1997 _cleanup_free_
char *parent_name
= NULL
;
1998 bool follow_links
= !FLAGS_SET(flags
, AT_SYMLINK_NOFOLLOW
);
2003 assert((mode
& ~S_IFMT
) == 0);
2004 assert(!follow_links
|| parent_st
);
2005 assert((flags
& ~AT_SYMLINK_NOFOLLOW
) == 0);
2007 if (!filename_is_valid(name
))
2008 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "\"%s\" is not a valid filename.", name
);
2010 r
= fstatat_harder(parent_fd
, name
, &st
, flags
, REMOVE_CHMOD
| REMOVE_CHMOD_RESTORE
);
2012 (void) fd_get_path(parent_fd
, &parent_name
);
2013 return log_full_errno(r
== -ENOENT
? LOG_DEBUG
: LOG_ERR
, r
,
2014 "Failed to stat \"%s\" at \"%s\": %m", name
, strna(parent_name
));
2017 /* Fail before removing anything if this is an unsafe transition. */
2018 if (follow_links
&& unsafe_transition(parent_st
, &st
)) {
2019 (void) fd_get_path(parent_fd
, &parent_name
);
2020 return log_error_errno(SYNTHETIC_ERRNO(ENOLINK
),
2021 "Unsafe transition from \"%s\" to \"%s\".", parent_name
, name
);
2024 if ((st
.st_mode
& S_IFMT
) == mode
)
2027 (void) fd_get_path(parent_fd
, &parent_name
);
2028 log_notice("Wrong file type 0x%x; rm -rf \"%s/%s\"", st
.st_mode
& S_IFMT
, strna(parent_name
), name
);
2030 /* If the target of the symlink was the wrong type, the link needs to be removed instead of the
2031 * target, so make sure it is identified as a link and not a directory. */
2033 r
= fstatat_harder(parent_fd
, name
, &st
, AT_SYMLINK_NOFOLLOW
, REMOVE_CHMOD
| REMOVE_CHMOD_RESTORE
);
2035 return log_error_errno(r
, "Failed to stat \"%s\" at \"%s\": %m", name
, strna(parent_name
));
2038 /* Do not remove mount points. */
2039 r
= fd_is_mount_point(parent_fd
, name
, follow_links
? AT_SYMLINK_FOLLOW
: 0);
2041 (void) log_warning_errno(r
, "Failed to check if \"%s/%s\" is a mount point: %m; Continuing",
2042 strna(parent_name
), name
);
2044 return log_error_errno(SYNTHETIC_ERRNO(EBUSY
),
2045 "Not removing \"%s/%s\" because it is a mount point.", strna(parent_name
), name
);
2047 if ((st
.st_mode
& S_IFMT
) == S_IFDIR
) {
2048 _cleanup_close_
int child_fd
= -1;
2050 child_fd
= openat(parent_fd
, name
, O_NOCTTY
| O_CLOEXEC
| O_DIRECTORY
);
2052 return log_error_errno(errno
, "Failed to open \"%s\" at \"%s\": %m", name
, strna(parent_name
));
2054 r
= rm_rf_children(TAKE_FD(child_fd
), REMOVE_ROOT
|REMOVE_SUBVOLUME
|REMOVE_PHYSICAL
, &st
);
2056 return log_error_errno(r
, "Failed to remove contents of \"%s\" at \"%s\": %m", name
, strna(parent_name
));
2058 r
= unlinkat_harder(parent_fd
, name
, AT_REMOVEDIR
, REMOVE_CHMOD
| REMOVE_CHMOD_RESTORE
);
2060 r
= unlinkat_harder(parent_fd
, name
, 0, REMOVE_CHMOD
| REMOVE_CHMOD_RESTORE
);
2062 return log_error_errno(r
, "Failed to remove \"%s\" at \"%s\": %m", name
, strna(parent_name
));
2064 /* This is covered by the log_notice "Wrong file type..." It is logged earlier because it gives
2065 * context to other error messages that might follow. */
2069 /* If child_mode is non-zero, rm_if_wrong_type_safe will be executed for the last path component. */
2070 static int mkdir_parents_rm_if_wrong_type(mode_t child_mode
, const char *path
) {
2071 _cleanup_close_
int parent_fd
= -1;
2072 struct stat parent_st
;
2077 assert((child_mode
& ~S_IFMT
) == 0);
2079 path_len
= strlen(path
);
2082 /* rm_if_wrong_type_safe already logs errors. */
2083 return child_mode
!= 0 ? rm_if_wrong_type_safe(child_mode
, AT_FDCWD
, NULL
, path
, AT_SYMLINK_NOFOLLOW
) : 0;
2085 if (child_mode
!= 0 && endswith(path
, "/"))
2086 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
2087 "Trailing path separators are only allowed if child_mode is not set; got \"%s\"", path
);
2089 /* Get the parent_fd and stat. */
2090 parent_fd
= openat(AT_FDCWD
, path_is_absolute(path
) ? "/" : ".", O_NOCTTY
| O_CLOEXEC
| O_DIRECTORY
);
2092 return log_error_errno(errno
, "Failed to open root: %m");
2094 if (fstat(parent_fd
, &parent_st
) < 0)
2095 return log_error_errno(errno
, "Failed to stat root: %m");
2097 /* Check every parent directory in the path, except the last component */
2098 for (const char *e
= path
;;) {
2099 _cleanup_close_
int next_fd
= -1;
2100 char t
[path_len
+ 1];
2103 /* Find the start of the next path component. */
2104 s
= e
+ strspn(e
, "/");
2105 /* Find the end of the next path component. */
2106 e
= s
+ strcspn(s
, "/");
2108 /* Copy the path component to t so it can be a null terminated string. */
2109 *((char*) mempcpy(t
, s
, e
- s
)) = 0;
2111 /* Is this the last component? If so, then check the type */
2113 return child_mode
!= 0 ? rm_if_wrong_type_safe(child_mode
, parent_fd
, &parent_st
, t
, AT_SYMLINK_NOFOLLOW
) : 0;
2115 r
= rm_if_wrong_type_safe(S_IFDIR
, parent_fd
, &parent_st
, t
, 0);
2116 /* Remove dangling symlinks. */
2118 r
= rm_if_wrong_type_safe(S_IFDIR
, parent_fd
, &parent_st
, t
, AT_SYMLINK_NOFOLLOW
);
2120 RUN_WITH_UMASK(0000)
2121 r
= mkdirat_label(parent_fd
, t
, 0755);
2123 _cleanup_free_
char *parent_name
= NULL
;
2125 (void) fd_get_path(parent_fd
, &parent_name
);
2126 return log_error_errno(r
, "Failed to mkdir \"%s\" at \"%s\": %m", t
, strnull(parent_name
));
2129 /* rm_if_wrong_type_safe already logs errors. */
2132 next_fd
= RET_NERRNO(openat(parent_fd
, t
, O_NOCTTY
| O_CLOEXEC
| O_DIRECTORY
));
2134 _cleanup_free_
char *parent_name
= NULL
;
2136 (void) fd_get_path(parent_fd
, &parent_name
);
2137 return log_error_errno(next_fd
, "Failed to open \"%s\" at \"%s\": %m", t
, strnull(parent_name
));
2139 r
= RET_NERRNO(fstat(next_fd
, &parent_st
));
2141 _cleanup_free_
char *parent_name
= NULL
;
2143 (void) fd_get_path(parent_fd
, &parent_name
);
2144 return log_error_errno(r
, "Failed to stat \"%s\" at \"%s\": %m", t
, strnull(parent_name
));
2147 CLOSE_AND_REPLACE(parent_fd
, next_fd
);
2151 static int mkdir_parents_item(Item
*i
, mode_t child_mode
) {
2153 if (i
->try_replace
) {
2154 r
= mkdir_parents_rm_if_wrong_type(child_mode
, i
->path
);
2155 if (r
< 0 && r
!= -ENOENT
)
2158 RUN_WITH_UMASK(0000)
2159 (void) mkdir_parents_label(i
->path
, 0755);
2164 static int create_item(Item
*i
) {
2165 CreationMode creation
;
2170 log_debug("Running create action for entry %c %s", (char) i
->type
, i
->path
);
2175 case IGNORE_DIRECTORY_PATH
:
2177 case RECURSIVE_REMOVE_PATH
:
2182 r
= mkdir_parents_item(i
, S_IFREG
);
2186 if ((i
->type
== CREATE_FILE
&& i
->append_or_force
) || i
->type
== TRUNCATE_FILE
)
2187 r
= truncate_file(i
, i
->path
);
2189 r
= create_file(i
, i
->path
);
2196 r
= mkdir_parents_item(i
, 0);
2206 r
= glob_item(i
, write_one_file
);
2212 case CREATE_DIRECTORY
:
2213 case TRUNCATE_DIRECTORY
:
2214 r
= mkdir_parents_item(i
, S_IFDIR
);
2218 r
= create_directory(i
, i
->path
);
2223 case CREATE_SUBVOLUME
:
2224 case CREATE_SUBVOLUME_INHERIT_QUOTA
:
2225 case CREATE_SUBVOLUME_NEW_QUOTA
:
2226 r
= mkdir_parents_item(i
, S_IFDIR
);
2230 r
= create_subvolume(i
, i
->path
);
2235 case EMPTY_DIRECTORY
:
2236 r
= glob_item(i
, empty_directory
);
2242 r
= mkdir_parents_item(i
, S_IFIFO
);
2246 r
= create_fifo(i
, i
->path
);
2251 case CREATE_SYMLINK
: {
2252 r
= mkdir_parents_item(i
, S_IFLNK
);
2256 mac_selinux_create_file_prepare(i
->path
, S_IFLNK
);
2257 r
= symlink(i
->argument
, i
->path
);
2258 mac_selinux_create_file_clear();
2261 _cleanup_free_
char *x
= NULL
;
2263 if (errno
!= EEXIST
)
2264 return log_error_errno(errno
, "symlink(%s, %s) failed: %m", i
->argument
, i
->path
);
2266 r
= readlink_malloc(i
->path
, &x
);
2267 if (r
< 0 || !streq(i
->argument
, x
)) {
2269 if (i
->append_or_force
) {
2270 mac_selinux_create_file_prepare(i
->path
, S_IFLNK
);
2271 r
= symlink_atomic(i
->argument
, i
->path
);
2272 mac_selinux_create_file_clear();
2274 if (IN_SET(r
, -EISDIR
, -EEXIST
, -ENOTEMPTY
)) {
2275 r
= rm_rf(i
->path
, REMOVE_ROOT
|REMOVE_PHYSICAL
);
2277 return log_error_errno(r
, "rm -fr %s failed: %m", i
->path
);
2279 mac_selinux_create_file_prepare(i
->path
, S_IFLNK
);
2280 r
= RET_NERRNO(symlink(i
->argument
, i
->path
));
2281 mac_selinux_create_file_clear();
2284 return log_error_errno(r
, "symlink(%s, %s) failed: %m", i
->argument
, i
->path
);
2286 creation
= CREATION_FORCE
;
2288 log_debug("\"%s\" is not a symlink or does not point to the correct path.", i
->path
);
2292 creation
= CREATION_EXISTING
;
2295 creation
= CREATION_NORMAL
;
2296 log_debug("%s symlink \"%s\".", creation_mode_verb_to_string(creation
), i
->path
);
2300 case CREATE_BLOCK_DEVICE
:
2301 case CREATE_CHAR_DEVICE
:
2302 if (have_effective_cap(CAP_MKNOD
) == 0) {
2303 /* In a container we lack CAP_MKNOD. We shouldn't attempt to create the device node in that
2304 * case to avoid noise, and we don't support virtualized devices in containers anyway. */
2306 log_debug("We lack CAP_MKNOD, skipping creation of device node %s.", i
->path
);
2310 r
= mkdir_parents_item(i
, i
->type
== CREATE_BLOCK_DEVICE
? S_IFBLK
: S_IFCHR
);
2314 r
= create_device(i
, i
->type
== CREATE_BLOCK_DEVICE
? S_IFBLK
: S_IFCHR
);
2322 r
= glob_item(i
, path_set_perms
);
2327 case RECURSIVE_RELABEL_PATH
:
2328 r
= glob_item_recursively(i
, fd_set_perms
);
2334 r
= glob_item(i
, path_set_xattrs
);
2339 case RECURSIVE_SET_XATTR
:
2340 r
= glob_item_recursively(i
, fd_set_xattrs
);
2346 r
= glob_item(i
, path_set_acls
);
2351 case RECURSIVE_SET_ACL
:
2352 r
= glob_item_recursively(i
, fd_set_acls
);
2358 r
= glob_item(i
, path_set_attribute
);
2363 case RECURSIVE_SET_ATTRIBUTE
:
2364 r
= glob_item_recursively(i
, fd_set_attribute
);
2373 static int remove_item_instance(Item
*i
, const char *instance
) {
2381 if (remove(instance
) < 0 && errno
!= ENOENT
)
2382 return log_error_errno(errno
, "rm(%s): %m", instance
);
2386 case RECURSIVE_REMOVE_PATH
:
2387 /* FIXME: we probably should use dir_cleanup() here instead of rm_rf() so that 'x' is honoured. */
2388 log_debug("rm -rf \"%s\"", instance
);
2389 r
= rm_rf(instance
, REMOVE_ROOT
|REMOVE_SUBVOLUME
|REMOVE_PHYSICAL
);
2390 if (r
< 0 && r
!= -ENOENT
)
2391 return log_error_errno(r
, "rm_rf(%s): %m", instance
);
2396 assert_not_reached();
2402 static int remove_item(Item
*i
) {
2407 log_debug("Running remove action for entry %c %s", (char) i
->type
, i
->path
);
2411 case TRUNCATE_DIRECTORY
:
2412 /* FIXME: we probably should use dir_cleanup() here instead of rm_rf() so that 'x' is honoured. */
2413 log_debug("rm -rf \"%s\"", i
->path
);
2414 r
= rm_rf(i
->path
, REMOVE_PHYSICAL
);
2415 if (r
< 0 && r
!= -ENOENT
)
2416 return log_error_errno(r
, "rm_rf(%s): %m", i
->path
);
2421 case RECURSIVE_REMOVE_PATH
:
2422 return glob_item(i
, remove_item_instance
);
2429 static char *age_by_to_string(AgeBy ab
, bool is_dir
) {
2430 static const char ab_map
[] = { 'a', 'b', 'c', 'm' };
2434 ret
= new(char, ELEMENTSOF(ab_map
) + 1);
2438 for (size_t i
= 0; i
< ELEMENTSOF(ab_map
); i
++)
2439 if (FLAGS_SET(ab
, 1U << i
))
2440 ret
[j
++] = is_dir
? ascii_toupper(ab_map
[i
]) : ab_map
[i
];
2446 static int clean_item_instance(Item
*i
, const char* instance
) {
2447 _cleanup_closedir_
DIR *d
= NULL
;
2448 STRUCT_STATX_DEFINE(sx
);
2457 n
= now(CLOCK_REALTIME
);
2461 cutoff
= n
- i
->age
;
2463 d
= opendir_nomod(instance
);
2465 if (IN_SET(errno
, ENOENT
, ENOTDIR
)) {
2466 log_debug_errno(errno
, "Directory \"%s\": %m", instance
);
2470 return log_error_errno(errno
, "Failed to open directory %s: %m", instance
);
2473 r
= statx_fallback(dirfd(d
), "", AT_EMPTY_PATH
, STATX_MODE
|STATX_INO
|STATX_ATIME
|STATX_MTIME
, &sx
);
2475 return log_error_errno(r
, "statx(%s) failed: %m", instance
);
2477 if (FLAGS_SET(sx
.stx_attributes_mask
, STATX_ATTR_MOUNT_ROOT
))
2478 mountpoint
= FLAGS_SET(sx
.stx_attributes
, STATX_ATTR_MOUNT_ROOT
);
2482 if (fstatat(dirfd(d
), "..", &ps
, AT_SYMLINK_NOFOLLOW
) != 0)
2483 return log_error_errno(errno
, "stat(%s/..) failed: %m", i
->path
);
2486 sx
.stx_dev_major
!= major(ps
.st_dev
) ||
2487 sx
.stx_dev_minor
!= minor(ps
.st_dev
) ||
2488 sx
.stx_ino
!= ps
.st_ino
;
2491 if (DEBUG_LOGGING
) {
2492 _cleanup_free_
char *ab_f
= NULL
, *ab_d
= NULL
;
2494 ab_f
= age_by_to_string(i
->age_by_file
, false);
2498 ab_d
= age_by_to_string(i
->age_by_dir
, true);
2502 log_debug("Cleanup threshold for %s \"%s\" is %s; age-by: %s%s",
2503 mountpoint
? "mount point" : "directory",
2505 FORMAT_TIMESTAMP_STYLE(cutoff
, TIMESTAMP_US
),
2509 return dir_cleanup(i
, instance
, d
,
2510 load_statx_timestamp_nsec(&sx
.stx_atime
),
2511 load_statx_timestamp_nsec(&sx
.stx_mtime
),
2512 cutoff
* NSEC_PER_USEC
,
2513 sx
.stx_dev_major
, sx
.stx_dev_minor
, mountpoint
,
2514 MAX_DEPTH
, i
->keep_first_level
,
2515 i
->age_by_file
, i
->age_by_dir
);
2518 static int clean_item(Item
*i
) {
2521 log_debug("Running clean action for entry %c %s", (char) i
->type
, i
->path
);
2524 case CREATE_DIRECTORY
:
2525 case CREATE_SUBVOLUME
:
2526 case CREATE_SUBVOLUME_INHERIT_QUOTA
:
2527 case CREATE_SUBVOLUME_NEW_QUOTA
:
2528 case TRUNCATE_DIRECTORY
:
2531 clean_item_instance(i
, i
->path
);
2533 case EMPTY_DIRECTORY
:
2534 case IGNORE_DIRECTORY_PATH
:
2535 return glob_item(i
, clean_item_instance
);
2541 static int process_item(Item
*i
, OperationMask operation
) {
2543 _cleanup_free_
char *_path
= NULL
;
2549 todo
= operation
& ~i
->done
;
2550 if (todo
== 0) /* Everything already done? */
2553 i
->done
|= operation
;
2556 if (string_is_glob(path
)) {
2557 /* We can't easily check whether a glob matches any autofs path, so let's do the check only
2558 * for the non-glob part. */
2560 r
= glob_non_glob_prefix(path
, &_path
);
2561 if (r
< 0 && r
!= -ENOENT
)
2562 return log_debug_errno(r
, "Failed to deglob path: %m");
2567 r
= chase_symlinks(path
, arg_root
, CHASE_NO_AUTOFS
|CHASE_NONEXISTENT
|CHASE_WARN
, NULL
, NULL
);
2568 if (r
== -EREMOTE
) {
2569 log_notice_errno(r
, "Skipping %s", i
->path
); /* We log the configured path, to not confuse the user. */
2573 log_debug_errno(r
, "Failed to determine whether '%s' is below autofs, ignoring: %m", i
->path
);
2575 r
= FLAGS_SET(operation
, OPERATION_CREATE
) ? create_item(i
) : 0;
2576 /* Failure can only be tolerated for create */
2577 if (i
->allow_failure
)
2580 q
= FLAGS_SET(operation
, OPERATION_REMOVE
) ? remove_item(i
) : 0;
2581 p
= FLAGS_SET(operation
, OPERATION_CLEAN
) ? clean_item(i
) : 0;
2588 static int process_item_array(ItemArray
*array
, OperationMask operation
) {
2594 /* Create any parent first. */
2595 if (FLAGS_SET(operation
, OPERATION_CREATE
) && array
->parent
)
2596 r
= process_item_array(array
->parent
, operation
& OPERATION_CREATE
);
2598 /* Clean up all children first */
2599 if ((operation
& (OPERATION_REMOVE
|OPERATION_CLEAN
)) && !set_isempty(array
->children
)) {
2602 SET_FOREACH(c
, array
->children
) {
2605 k
= process_item_array(c
, operation
& (OPERATION_REMOVE
|OPERATION_CLEAN
));
2606 if (k
< 0 && r
== 0)
2611 for (n
= 0; n
< array
->n_items
; n
++) {
2614 k
= process_item(array
->items
+ n
, operation
);
2615 if (k
< 0 && r
== 0)
2622 static void item_free_contents(Item
*i
) {
2626 strv_free(i
->xattrs
);
2629 acl_free(i
->acl_access
);
2630 acl_free(i
->acl_default
);
2634 static ItemArray
* item_array_free(ItemArray
*a
) {
2640 for (n
= 0; n
< a
->n_items
; n
++)
2641 item_free_contents(a
->items
+ n
);
2643 set_free(a
->children
);
2648 static int item_compare(const Item
*a
, const Item
*b
) {
2649 /* Make sure that the ownership taking item is put first, so
2650 * that we first create the node, and then can adjust it */
2652 if (takes_ownership(a
->type
) && !takes_ownership(b
->type
))
2654 if (!takes_ownership(a
->type
) && takes_ownership(b
->type
))
2657 return CMP(a
->type
, b
->type
);
2660 static bool item_compatible(Item
*a
, Item
*b
) {
2663 assert(streq(a
->path
, b
->path
));
2665 if (takes_ownership(a
->type
) && takes_ownership(b
->type
))
2666 /* check if the items are the same */
2667 return streq_ptr(a
->argument
, b
->argument
) &&
2669 a
->uid_set
== b
->uid_set
&&
2672 a
->gid_set
== b
->gid_set
&&
2675 a
->mode_set
== b
->mode_set
&&
2676 a
->mode
== b
->mode
&&
2678 a
->age_set
== b
->age_set
&&
2681 a
->age_by_file
== b
->age_by_file
&&
2682 a
->age_by_dir
== b
->age_by_dir
&&
2684 a
->mask_perms
== b
->mask_perms
&&
2686 a
->keep_first_level
== b
->keep_first_level
&&
2688 a
->major_minor
== b
->major_minor
;
2693 static bool should_include_path(const char *path
) {
2694 STRV_FOREACH(prefix
, arg_exclude_prefixes
)
2695 if (path_startswith(path
, *prefix
)) {
2696 log_debug("Entry \"%s\" matches exclude prefix \"%s\", skipping.",
2701 STRV_FOREACH(prefix
, arg_include_prefixes
)
2702 if (path_startswith(path
, *prefix
)) {
2703 log_debug("Entry \"%s\" matches include prefix \"%s\".", path
, *prefix
);
2707 /* no matches, so we should include this path only if we have no allow list at all */
2708 if (strv_isempty(arg_include_prefixes
))
2711 log_debug("Entry \"%s\" does not match any include prefix, skipping.", path
);
2715 static int specifier_expansion_from_arg(const Specifier
*specifier_table
, Item
*i
) {
2725 case CREATE_SYMLINK
:
2729 _cleanup_free_
char *unescaped
= NULL
, *resolved
= NULL
;
2732 l
= cunescape(i
->argument
, 0, &unescaped
);
2734 return log_error_errno(l
, "Failed to unescape parameter to write: %s", i
->argument
);
2736 r
= specifier_printf(unescaped
, PATH_MAX
-1, specifier_table
, arg_root
, NULL
, &resolved
);
2740 return free_and_replace(i
->argument
, resolved
);
2743 case RECURSIVE_SET_XATTR
:
2744 STRV_FOREACH(xattr
, i
->xattrs
) {
2745 _cleanup_free_
char *resolved
= NULL
;
2747 r
= specifier_printf(*xattr
, SIZE_MAX
, specifier_table
, arg_root
, NULL
, &resolved
);
2751 free_and_replace(*xattr
, resolved
);
2760 static int patch_var_run(const char *fname
, unsigned line
, char **path
) {
2767 /* Optionally rewrites lines referencing /var/run/, to use /run/ instead. Why bother? tmpfiles merges lines in
2768 * some cases and detects conflicts in others. If files/directories are specified through two equivalent lines
2769 * this is problematic as neither case will be detected. Ideally we'd detect these cases by resolving symlinks
2770 * early, but that's precisely not what we can do here as this code very likely is running very early on, at a
2771 * time where the paths in question are not available yet, or even more importantly, our own tmpfiles rules
2772 * might create the paths that are intermediary to the listed paths. We can't really cover the generic case,
2773 * but the least we can do is cover the specific case of /var/run vs. /run, as /var/run is a legacy name for
2774 * /run only, and we explicitly document that and require that on systemd systems the former is a symlink to
2775 * the latter. Moreover files below this path are by far the primary usecase for tmpfiles.d/. */
2777 k
= path_startswith(*path
, "/var/run/");
2778 if (isempty(k
)) /* Don't complain about other paths than /var/run, and not about /var/run itself either. */
2781 n
= path_join("/run", k
);
2785 /* Also log about this briefly. We do so at LOG_NOTICE level, as we fixed up the situation automatically, hence
2786 * there's no immediate need for action by the user. However, in the interest of making things less confusing
2787 * to the user, let's still inform the user that these snippets should really be updated. */
2788 log_syntax(NULL
, LOG_NOTICE
, fname
, line
, 0,
2789 "Line references path below legacy directory /var/run/, updating %s → %s; please update the tmpfiles.d/ drop-in file accordingly.",
2792 free_and_replace(*path
, n
);
2797 static int find_uid(const char *user
, uid_t
*ret_uid
, Hashmap
**cache
) {
2803 /* First: parse as numeric UID string */
2804 r
= parse_uid(user
, ret_uid
);
2808 /* Second: pass to NSS if we are running "online" */
2810 return get_user_creds(&user
, ret_uid
, NULL
, NULL
, NULL
, 0);
2812 /* Third, synthesize "root" unconditionally */
2813 if (streq(user
, "root")) {
2818 /* Fourth: use fgetpwent() to read /etc/passwd directly, if we are "offline" */
2819 return name_to_uid_offline(arg_root
, user
, ret_uid
, cache
);
2822 static int find_gid(const char *group
, gid_t
*ret_gid
, Hashmap
**cache
) {
2828 /* First: parse as numeric GID string */
2829 r
= parse_gid(group
, ret_gid
);
2833 /* Second: pass to NSS if we are running "online" */
2835 return get_group_creds(&group
, ret_gid
, 0);
2837 /* Third, synthesize "root" unconditionally */
2838 if (streq(group
, "root")) {
2843 /* Fourth: use fgetgrent() to read /etc/group directly, if we are "offline" */
2844 return name_to_gid_offline(arg_root
, group
, ret_gid
, cache
);
2847 static int parse_age_by_from_arg(const char *age_by_str
, Item
*item
) {
2848 AgeBy ab_f
= 0, ab_d
= 0;
2850 static const struct {
2853 } age_by_types
[] = {
2854 { 'a', AGE_BY_ATIME
},
2855 { 'b', AGE_BY_BTIME
},
2856 { 'c', AGE_BY_CTIME
},
2857 { 'm', AGE_BY_MTIME
},
2863 if (isempty(age_by_str
))
2866 for (const char *s
= age_by_str
; *s
!= 0; s
++) {
2869 /* Ignore whitespace. */
2870 if (strchr(WHITESPACE
, *s
))
2873 for (i
= 0; i
< ELEMENTSOF(age_by_types
); i
++) {
2874 /* Check lower-case for files, upper-case for directories. */
2875 if (*s
== age_by_types
[i
].age_by_chr
) {
2876 ab_f
|= age_by_types
[i
].age_by_flag
;
2878 } else if (*s
== ascii_toupper(age_by_types
[i
].age_by_chr
)) {
2879 ab_d
|= age_by_types
[i
].age_by_flag
;
2884 /* Invalid character. */
2885 if (i
>= ELEMENTSOF(age_by_types
))
2890 if (ab_f
== 0 && ab_d
== 0)
2893 item
->age_by_file
= ab_f
> 0 ? ab_f
: AGE_BY_DEFAULT_FILE
;
2894 item
->age_by_dir
= ab_d
> 0 ? ab_d
: AGE_BY_DEFAULT_DIR
;
2899 static int parse_line(
2903 bool *invalid_config
,
2904 Hashmap
**uid_cache
,
2905 Hashmap
**gid_cache
) {
2907 _cleanup_free_
char *action
= NULL
, *mode
= NULL
, *user
= NULL
, *group
= NULL
, *age
= NULL
, *path
= NULL
;
2908 _cleanup_(item_free_contents
) Item i
= {
2909 /* The "age-by" argument considers all file timestamp types by default. */
2910 .age_by_file
= AGE_BY_DEFAULT_FILE
,
2911 .age_by_dir
= AGE_BY_DEFAULT_DIR
,
2913 ItemArray
*existing
;
2916 bool append_or_force
= false, boot
= false, allow_failure
= false, try_replace
= false;
2922 const Specifier specifier_table
[] = {
2923 { 'a', specifier_architecture
, NULL
},
2924 { 'b', specifier_boot_id
, NULL
},
2925 { 'B', specifier_os_build_id
, NULL
},
2926 { 'H', specifier_host_name
, NULL
},
2927 { 'l', specifier_short_host_name
, NULL
},
2928 { 'm', specifier_machine_id_safe
, NULL
},
2929 { 'o', specifier_os_id
, NULL
},
2930 { 'v', specifier_kernel_release
, NULL
},
2931 { 'w', specifier_os_version_id
, NULL
},
2932 { 'W', specifier_os_variant_id
, NULL
},
2934 { 'h', specifier_user_home
, NULL
},
2936 { 'C', specifier_directory
, UINT_TO_PTR(DIRECTORY_CACHE
) },
2937 { 'L', specifier_directory
, UINT_TO_PTR(DIRECTORY_LOGS
) },
2938 { 'S', specifier_directory
, UINT_TO_PTR(DIRECTORY_STATE
) },
2939 { 't', specifier_directory
, UINT_TO_PTR(DIRECTORY_RUNTIME
) },
2941 COMMON_CREDS_SPECIFIERS(arg_user
? LOOKUP_SCOPE_USER
: LOOKUP_SCOPE_SYSTEM
),
2942 COMMON_TMP_SPECIFIERS
,
2946 r
= extract_many_words(
2958 if (IN_SET(r
, -EINVAL
, -EBADSLT
))
2959 /* invalid quoting and such or an unknown specifier */
2960 *invalid_config
= true;
2961 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Failed to parse line: %m");
2963 *invalid_config
= true;
2964 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Syntax error.");
2967 if (!empty_or_dash(buffer
)) {
2968 i
.argument
= strdup(buffer
);
2973 if (isempty(action
)) {
2974 *invalid_config
= true;
2975 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Command too short '%s'.", action
);
2978 for (pos
= 1; action
[pos
]; pos
++) {
2979 if (action
[pos
] == '!' && !boot
)
2981 else if (action
[pos
] == '+' && !append_or_force
)
2982 append_or_force
= true;
2983 else if (action
[pos
] == '-' && !allow_failure
)
2984 allow_failure
= true;
2985 else if (action
[pos
] == '=' && !try_replace
)
2988 *invalid_config
= true;
2989 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Unknown modifiers in command '%s'", action
);
2993 if (boot
&& !arg_boot
) {
2994 log_syntax(NULL
, LOG_DEBUG
, fname
, line
, 0, "Ignoring entry %s \"%s\" because --boot is not specified.", action
, path
);
2999 i
.append_or_force
= append_or_force
;
3000 i
.allow_failure
= allow_failure
;
3001 i
.try_replace
= try_replace
;
3003 r
= specifier_printf(path
, PATH_MAX
-1, specifier_table
, arg_root
, NULL
, &i
.path
);
3005 return log_unresolvable_specifier(fname
, line
);
3007 if (IN_SET(r
, -EINVAL
, -EBADSLT
))
3008 *invalid_config
= true;
3009 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Failed to replace specifiers in '%s': %m", path
);
3012 r
= patch_var_run(fname
, line
, &i
.path
);
3018 case CREATE_DIRECTORY
:
3019 case CREATE_SUBVOLUME
:
3020 case CREATE_SUBVOLUME_INHERIT_QUOTA
:
3021 case CREATE_SUBVOLUME_NEW_QUOTA
:
3022 case EMPTY_DIRECTORY
:
3023 case TRUNCATE_DIRECTORY
:
3026 case IGNORE_DIRECTORY_PATH
:
3028 case RECURSIVE_REMOVE_PATH
:
3031 case RECURSIVE_RELABEL_PATH
:
3033 log_syntax(NULL
, LOG_WARNING
, fname
, line
, 0, "%c lines don't take argument fields, ignoring.", i
.type
);
3041 case CREATE_SYMLINK
:
3043 i
.argument
= path_join("/usr/share/factory", i
.path
);
3051 *invalid_config
= true;
3052 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Write file requires argument.");
3058 i
.argument
= path_join("/usr/share/factory", i
.path
);
3062 } else if (!path_is_absolute(i
.argument
)) {
3063 *invalid_config
= true;
3064 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Source path '%s' is not absolute.", i
.argument
);
3068 if (!empty_or_root(arg_root
)) {
3071 p
= path_join(arg_root
, i
.argument
);
3074 free_and_replace(i
.argument
, p
);
3077 path_simplify(i
.argument
);
3080 case CREATE_CHAR_DEVICE
:
3081 case CREATE_BLOCK_DEVICE
:
3083 *invalid_config
= true;
3084 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
), "Device file requires argument.");
3087 r
= parse_dev(i
.argument
, &i
.major_minor
);
3089 *invalid_config
= true;
3090 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Can't parse device file major/minor '%s'.", i
.argument
);
3096 case RECURSIVE_SET_XATTR
:
3098 *invalid_config
= true;
3099 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
),
3100 "Set extended attribute requires argument.");
3102 r
= parse_xattrs_from_arg(&i
);
3108 case RECURSIVE_SET_ACL
:
3110 *invalid_config
= true;
3111 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
),
3112 "Set ACLs requires argument.");
3114 r
= parse_acls_from_arg(&i
);
3120 case RECURSIVE_SET_ATTRIBUTE
:
3122 *invalid_config
= true;
3123 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
),
3124 "Set file attribute requires argument.");
3126 r
= parse_attribute_from_arg(&i
);
3127 if (IN_SET(r
, -EINVAL
, -EBADSLT
))
3128 *invalid_config
= true;
3134 *invalid_config
= true;
3135 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
),
3136 "Unknown command type '%c'.", (char) i
.type
);
3139 if (!path_is_absolute(i
.path
)) {
3140 *invalid_config
= true;
3141 return log_syntax(NULL
, LOG_ERR
, fname
, line
, SYNTHETIC_ERRNO(EBADMSG
),
3142 "Path '%s' not absolute.", i
.path
);
3145 path_simplify(i
.path
);
3147 if (!should_include_path(i
.path
))
3150 r
= specifier_expansion_from_arg(specifier_table
, &i
);
3152 return log_unresolvable_specifier(fname
, line
);
3154 if (IN_SET(r
, -EINVAL
, -EBADSLT
))
3155 *invalid_config
= true;
3156 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Failed to substitute specifiers in argument: %m");
3159 if (!empty_or_root(arg_root
)) {
3162 p
= path_join(arg_root
, i
.path
);
3165 free_and_replace(i
.path
, p
);
3168 if (!empty_or_dash(user
)) {
3169 r
= find_uid(user
, &i
.uid
, uid_cache
);
3171 *invalid_config
= true;
3172 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Failed to resolve user '%s': %m", user
);
3178 if (!empty_or_dash(group
)) {
3179 r
= find_gid(group
, &i
.gid
, gid_cache
);
3181 *invalid_config
= true;
3182 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Failed to resolve group '%s'.", group
);
3188 if (!empty_or_dash(mode
)) {
3189 const char *mm
= mode
;
3193 i
.mask_perms
= true;
3197 r
= parse_mode(mm
, &m
);
3199 *invalid_config
= true;
3200 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Invalid mode '%s'.", mode
);
3206 i
.mode
= IN_SET(i
.type
, CREATE_DIRECTORY
, TRUNCATE_DIRECTORY
, CREATE_SUBVOLUME
, CREATE_SUBVOLUME_INHERIT_QUOTA
, CREATE_SUBVOLUME_NEW_QUOTA
) ? 0755 : 0644;
3208 if (!empty_or_dash(age
)) {
3209 const char *a
= age
;
3210 _cleanup_free_
char *seconds
= NULL
, *age_by
= NULL
;
3213 i
.keep_first_level
= true;
3217 /* Format: "age-by:age"; where age-by is "[abcmABCM]+". */
3218 r
= split_pair(a
, ":", &age_by
, &seconds
);
3221 if (r
< 0 && r
!= -EINVAL
)
3222 return log_error_errno(r
, "Failed to parse age-by for '%s': %m", age
);
3224 /* We found a ":", parse the "age-by" part. */
3225 r
= parse_age_by_from_arg(age_by
, &i
);
3229 *invalid_config
= true;
3230 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Invalid age-by '%s'.", age_by
);
3233 /* For parsing the "age" part, after the ":". */
3237 r
= parse_sec(a
, &i
.age
);
3239 *invalid_config
= true;
3240 return log_syntax(NULL
, LOG_ERR
, fname
, line
, r
, "Invalid age '%s'.", a
);
3246 h
= needs_glob(i
.type
) ? globs
: items
;
3248 existing
= ordered_hashmap_get(h
, i
.path
);
3252 for (n
= 0; n
< existing
->n_items
; n
++) {
3253 if (!item_compatible(existing
->items
+ n
, &i
) && !i
.append_or_force
) {
3254 log_syntax(NULL
, LOG_NOTICE
, fname
, line
, 0, "Duplicate line for path \"%s\", ignoring.", i
.path
);
3259 existing
= new0(ItemArray
, 1);
3263 r
= ordered_hashmap_put(h
, i
.path
, existing
);
3270 if (!GREEDY_REALLOC(existing
->items
, existing
->n_items
+ 1))
3273 existing
->items
[existing
->n_items
++] = i
;
3274 i
= (struct Item
) {};
3276 /* Sort item array, to enforce stable ordering of application */
3277 typesafe_qsort(existing
->items
, existing
->n_items
, item_compare
);
3282 static int cat_config(char **config_dirs
, char **args
) {
3283 _cleanup_strv_free_
char **files
= NULL
;
3286 r
= conf_files_list_with_replacement(arg_root
, config_dirs
, arg_replace
, &files
, NULL
);
3290 return cat_files(NULL
, files
, 0);
3293 static int exclude_default_prefixes(void) {
3296 /* Provide an easy way to exclude virtual/memory file systems from what we do here. Useful in
3297 * combination with --root= where we probably don't want to apply stuff to these dirs as they are
3298 * likely over-mounted if the root directory is actually used, and it wouldbe less than ideal to have
3299 * all kinds of files created/adjusted underneath these mount points. */
3301 r
= strv_extend_strv(
3302 &arg_exclude_prefixes
,
3314 static int help(void) {
3315 _cleanup_free_
char *link
= NULL
;
3318 r
= terminal_urlify_man("systemd-tmpfiles", "8", &link
);
3322 printf("%s [OPTIONS...] [CONFIGURATION FILE...]\n"
3323 "\n%sCreates, deletes and cleans up volatile and temporary files and directories.%s\n\n"
3324 " -h --help Show this help\n"
3325 " --user Execute user configuration\n"
3326 " --version Show package version\n"
3327 " --cat-config Show configuration files\n"
3328 " --create Create marked files/directories\n"
3329 " --clean Clean up marked directories\n"
3330 " --remove Remove marked files/directories\n"
3331 " --boot Execute actions only safe at boot\n"
3332 " --prefix=PATH Only apply rules with the specified prefix\n"
3333 " --exclude-prefix=PATH Ignore rules with the specified prefix\n"
3334 " -E Ignore rules prefixed with /dev, /proc, /run, /sys\n"
3335 " --root=PATH Operate on an alternate filesystem root\n"
3336 " --image=PATH Operate on disk image as filesystem root\n"
3337 " --replace=PATH Treat arguments as replacement for PATH\n"
3338 " --no-pager Do not pipe output into a pager\n"
3339 "\nSee the %s for details.\n",
3340 program_invocation_short_name
,
3348 static int parse_argv(int argc
, char *argv
[]) {
3351 ARG_VERSION
= 0x100,
3366 static const struct option options
[] = {
3367 { "help", no_argument
, NULL
, 'h' },
3368 { "user", no_argument
, NULL
, ARG_USER
},
3369 { "version", no_argument
, NULL
, ARG_VERSION
},
3370 { "cat-config", no_argument
, NULL
, ARG_CAT_CONFIG
},
3371 { "create", no_argument
, NULL
, ARG_CREATE
},
3372 { "clean", no_argument
, NULL
, ARG_CLEAN
},
3373 { "remove", no_argument
, NULL
, ARG_REMOVE
},
3374 { "boot", no_argument
, NULL
, ARG_BOOT
},
3375 { "prefix", required_argument
, NULL
, ARG_PREFIX
},
3376 { "exclude-prefix", required_argument
, NULL
, ARG_EXCLUDE_PREFIX
},
3377 { "root", required_argument
, NULL
, ARG_ROOT
},
3378 { "image", required_argument
, NULL
, ARG_IMAGE
},
3379 { "replace", required_argument
, NULL
, ARG_REPLACE
},
3380 { "no-pager", no_argument
, NULL
, ARG_NO_PAGER
},
3389 while ((c
= getopt_long(argc
, argv
, "hE", options
, NULL
)) >= 0)
3399 case ARG_CAT_CONFIG
:
3400 arg_cat_config
= true;
3408 arg_operation
|= OPERATION_CREATE
;
3412 arg_operation
|= OPERATION_CLEAN
;
3416 arg_operation
|= OPERATION_REMOVE
;
3424 if (strv_push(&arg_include_prefixes
, optarg
) < 0)
3428 case ARG_EXCLUDE_PREFIX
:
3429 if (strv_push(&arg_exclude_prefixes
, optarg
) < 0)
3434 r
= parse_path_argument(optarg
, /* suppress_root= */ false, &arg_root
);
3441 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
3442 "This systemd-tmpfiles version is compiled without support for --image=.");
3444 r
= parse_path_argument(optarg
, /* suppress_root= */ false, &arg_image
);
3448 /* Imply -E here since it makes little sense to create files persistently in the /run mountpoint of a disk image */
3452 r
= exclude_default_prefixes();
3459 if (!path_is_absolute(optarg
) ||
3460 !endswith(optarg
, ".conf"))
3461 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
3462 "The argument to --replace= must an absolute path to a config file");
3464 arg_replace
= optarg
;
3468 arg_pager_flags
|= PAGER_DISABLE
;
3475 assert_not_reached();
3478 if (arg_operation
== 0 && !arg_cat_config
)
3479 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
3480 "You need to specify at least one of --clean, --create or --remove.");
3482 if (arg_replace
&& arg_cat_config
)
3483 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
3484 "Option --replace= is not supported with --cat-config");
3486 if (arg_replace
&& optind
>= argc
)
3487 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
3488 "When --replace= is given, some configuration items must be specified");
3490 if (arg_root
&& arg_user
)
3491 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
3492 "Combination of --user and --root= is not supported.");
3494 if (arg_image
&& arg_root
)
3495 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Please specify either --root= or --image=, the combination of both is not supported.");
3500 static int read_config_file(char **config_dirs
, const char *fn
, bool ignore_enoent
, bool *invalid_config
) {
3501 _cleanup_(hashmap_freep
) Hashmap
*uid_cache
= NULL
, *gid_cache
= NULL
;
3502 _cleanup_fclose_
FILE *_f
= NULL
;
3503 _cleanup_free_
char *pp
= NULL
;
3511 if (streq(fn
, "-")) {
3512 log_debug("Reading config from stdin…");
3516 r
= search_and_fopen(fn
, "re", arg_root
, (const char**) config_dirs
, &_f
, &pp
);
3518 if (ignore_enoent
&& r
== -ENOENT
) {
3519 log_debug_errno(r
, "Failed to open \"%s\", ignoring: %m", fn
);
3523 return log_error_errno(r
, "Failed to open '%s': %m", fn
);
3526 log_debug("Reading config file \"%s\"…", pp
);
3532 _cleanup_free_
char *line
= NULL
;
3533 bool invalid_line
= false;
3537 k
= read_line(f
, LONG_LINE_MAX
, &line
);
3539 return log_error_errno(k
, "Failed to read '%s': %m", fn
);
3546 if (IN_SET(*l
, 0, '#'))
3549 k
= parse_line(fn
, v
, l
, &invalid_line
, &uid_cache
, &gid_cache
);
3552 /* Allow reporting with a special code if the caller requested this */
3553 *invalid_config
= true;
3555 /* The first error becomes our return value */
3560 /* we have to determine age parameter for each entry of type X */
3561 ORDERED_HASHMAP_FOREACH(ia
, globs
)
3562 for (size_t ni
= 0; ni
< ia
->n_items
; ni
++) {
3564 Item
*i
= ia
->items
+ ni
, *candidate_item
= NULL
;
3566 if (i
->type
!= IGNORE_DIRECTORY_PATH
)
3569 ORDERED_HASHMAP_FOREACH(ja
, items
)
3570 for (size_t nj
= 0; nj
< ja
->n_items
; nj
++) {
3571 Item
*j
= ja
->items
+ nj
;
3573 if (!IN_SET(j
->type
, CREATE_DIRECTORY
,
3576 CREATE_SUBVOLUME_INHERIT_QUOTA
,
3577 CREATE_SUBVOLUME_NEW_QUOTA
))
3580 if (path_equal(j
->path
, i
->path
)) {
3586 ? (path_startswith(j
->path
, candidate_item
->path
) && fnmatch(i
->path
, j
->path
, FNM_PATHNAME
| FNM_PERIOD
) == 0)
3587 : path_startswith(i
->path
, j
->path
) != NULL
)
3591 if (candidate_item
&& candidate_item
->age_set
) {
3592 i
->age
= candidate_item
->age
;
3598 log_error_errno(errno
, "Failed to read from file %s: %m", fn
);
3606 static int parse_arguments(char **config_dirs
, char **args
, bool *invalid_config
) {
3609 STRV_FOREACH(arg
, args
) {
3610 r
= read_config_file(config_dirs
, *arg
, false, invalid_config
);
3618 static int read_config_files(char **config_dirs
, char **args
, bool *invalid_config
) {
3619 _cleanup_strv_free_
char **files
= NULL
;
3620 _cleanup_free_
char *p
= NULL
;
3623 r
= conf_files_list_with_replacement(arg_root
, config_dirs
, arg_replace
, &files
, &p
);
3627 STRV_FOREACH(f
, files
)
3628 if (p
&& path_equal(*f
, p
)) {
3629 log_debug("Parsing arguments at position \"%s\"…", *f
);
3631 r
= parse_arguments(config_dirs
, args
, invalid_config
);
3635 /* Just warn, ignore result otherwise.
3636 * read_config_file() has some debug output, so no need to print anything. */
3637 (void) read_config_file(config_dirs
, *f
, true, invalid_config
);
3642 static int link_parent(ItemArray
*a
) {
3649 /* Finds the closest "parent" item array for the specified item array. Then registers the specified item array
3650 * as child of it, and fills the parent in, linking them both ways. This allows us to later create parents
3651 * before their children, and clean up/remove children before their parents. */
3653 if (a
->n_items
<= 0)
3656 path
= a
->items
[0].path
;
3657 prefix
= newa(char, strlen(path
) + 1);
3658 PATH_FOREACH_PREFIX(prefix
, path
) {
3661 j
= ordered_hashmap_get(items
, prefix
);
3663 j
= ordered_hashmap_get(globs
, prefix
);
3665 r
= set_ensure_put(&j
->children
, NULL
, a
);
3677 DEFINE_PRIVATE_HASH_OPS_WITH_VALUE_DESTRUCTOR(item_array_hash_ops
, char, string_hash_func
, string_compare_func
,
3678 ItemArray
, item_array_free
);
3680 static int run(int argc
, char *argv
[]) {
3682 _cleanup_(loop_device_unrefp
) LoopDevice
*loop_device
= NULL
;
3683 _cleanup_(decrypted_image_unrefp
) DecryptedImage
*decrypted_image
= NULL
;
3684 _cleanup_(umount_and_rmdir_and_freep
) char *unlink_dir
= NULL
;
3686 _cleanup_strv_free_
char **config_dirs
= NULL
;
3687 bool invalid_config
= false;
3690 PHASE_REMOVE_AND_CLEAN
,
3696 r
= parse_argv(argc
, argv
);
3702 /* We require /proc/ for a lot of our operations, i.e. for adjusting access modes, for anything
3703 * SELinux related, for recursive operation, for xattr, acl and chattr handling, for btrfs stuff and
3704 * a lot more. It's probably the majority of invocations where /proc/ is required. Since people
3705 * apparently invoke it without anyway and are surprised about the failures, let's catch this early
3706 * and output a nice and friendly warning. */
3707 if (proc_mounted() == 0)
3708 return log_error_errno(SYNTHETIC_ERRNO(ENOSYS
),
3709 "/proc/ is not mounted, but required for successful operation of systemd-tmpfiles. "
3710 "Please mount /proc/. Alternatively, consider using the --root= or --image= switches.");
3712 /* Descending down file system trees might take a lot of fds */
3713 (void) rlimit_nofile_bump(HIGH_RLIMIT_NOFILE
);
3716 r
= user_config_paths(&config_dirs
);
3718 return log_error_errno(r
, "Failed to initialize configuration directory list: %m");
3720 config_dirs
= strv_split_nulstr(CONF_PATHS_NULSTR("tmpfiles.d"));
3725 if (DEBUG_LOGGING
) {
3726 _cleanup_free_
char *t
= NULL
;
3728 STRV_FOREACH(i
, config_dirs
) {
3729 _cleanup_free_
char *j
= NULL
;
3731 j
= path_join(arg_root
, *i
);
3735 if (!strextend(&t
, "\n\t", j
))
3739 log_debug("Looking for configuration files in (higher priority first):%s", t
);
3742 if (arg_cat_config
) {
3743 pager_open(arg_pager_flags
);
3745 return cat_config(config_dirs
, argv
+ optind
);
3750 r
= mac_selinux_init();
3758 r
= mount_image_privately_interactively(
3760 DISSECT_IMAGE_GENERIC_ROOT
|
3761 DISSECT_IMAGE_REQUIRE_ROOT
|
3762 DISSECT_IMAGE_VALIDATE_OS
|
3763 DISSECT_IMAGE_RELAX_VAR_CHECK
|
3764 DISSECT_IMAGE_FSCK
|
3765 DISSECT_IMAGE_GROWFS
,
3772 arg_root
= strdup(unlink_dir
);
3780 items
= ordered_hashmap_new(&item_array_hash_ops
);
3781 globs
= ordered_hashmap_new(&item_array_hash_ops
);
3782 if (!items
|| !globs
)
3785 /* If command line arguments are specified along with --replace, read all
3786 * configuration files and insert the positional arguments at the specified
3787 * place. Otherwise, if command line arguments are specified, execute just
3788 * them, and finally, without --replace= or any positional arguments, just
3789 * read configuration and execute it.
3791 if (arg_replace
|| optind
>= argc
)
3792 r
= read_config_files(config_dirs
, argv
+ optind
, &invalid_config
);
3794 r
= parse_arguments(config_dirs
, argv
+ optind
, &invalid_config
);
3798 /* Let's now link up all child/parent relationships */
3799 ORDERED_HASHMAP_FOREACH(a
, items
) {
3804 ORDERED_HASHMAP_FOREACH(a
, globs
) {
3810 /* If multiple operations are requested, let's first run the remove/clean operations, and only then the create
3811 * operations. i.e. that we first clean out the platform we then build on. */
3812 for (phase
= 0; phase
< _PHASE_MAX
; phase
++) {
3815 if (phase
== PHASE_REMOVE_AND_CLEAN
)
3816 op
= arg_operation
& (OPERATION_REMOVE
|OPERATION_CLEAN
);
3817 else if (phase
== PHASE_CREATE
)
3818 op
= arg_operation
& OPERATION_CREATE
;
3820 assert_not_reached();
3822 if (op
== 0) /* Nothing requested in this phase */
3825 /* The non-globbing ones usually create things, hence we apply them first */
3826 ORDERED_HASHMAP_FOREACH(a
, items
) {
3827 k
= process_item_array(a
, op
);
3828 if (k
< 0 && r
>= 0)
3832 /* The globbing ones usually alter things, hence we apply them second. */
3833 ORDERED_HASHMAP_FOREACH(a
, globs
) {
3834 k
= process_item_array(a
, op
);
3835 if (k
< 0 && r
>= 0)
3840 if (ERRNO_IS_RESOURCE(r
))
3845 return EX_CANTCREAT
;
3849 DEFINE_MAIN_FUNCTION_WITH_POSITIVE_FAILURE(run
);