X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsystemd-tmpfiles.xml;h=998fd0911baa5ba35df16e3a64d81ca51d81b53b;hb=cc832f977208a020cdef133b8f44d00040802b81;hp=c1aab5155178ab81d8e1b29122c2893d0086c6c9;hpb=f5df066d1d28920e49cf03d5950330138ea4f236;p=thirdparty%2Fsystemd.git diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index c1aab515517..998fd0911ba 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -1,25 +1,7 @@ - - - + @@ -27,15 +9,6 @@ systemd-tmpfiles systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - @@ -60,10 +33,16 @@ CONFIGFILE - systemd-tmpfiles-setup.service - systemd-tmpfiles-setup-dev.service - systemd-tmpfiles-clean.service - systemd-tmpfiles-clean.timer + System units: +systemd-tmpfiles-setup.service +systemd-tmpfiles-setup-dev.service +systemd-tmpfiles-clean.service +systemd-tmpfiles-clean.timer + + User units: +systemd-tmpfiles-setup.service +systemd-tmpfiles-clean.service +systemd-tmpfiles-clean.timer @@ -76,12 +55,32 @@ If invoked with no arguments, it applies all directives from all configuration - files. If one or more absolute filenames are passed on the command line, only the - directives in these files are applied. If - is specified instead - of a filename, directives are read from standard input. If only the basename of a - configuration file is specified, all configuration directories as specified in + files. When invoked with , + arguments specified on the command line are used instead of the configuration file + PATH. Otherwise, if one or more absolute filenames are + passed on the command line, only the directives in these files are applied. If + - is specified instead of a filename, directives are read from + standard input. If only the basename of a configuration file is specified, all + configuration directories as specified in tmpfiles.d5 - are searched for a matching file. + are searched for a matching file and the file found that has the highest priority is + executed. + + System services (systemd-tmpfiles-setup.service, + systemd-tmpfiles-setup-dev.service, + systemd-tmpfiles-clean.service) invoke systemd-tmpfiles to create + system files and to perform system wide cleanup. Those services read administrator-controlled + configuration files in tmpfiles.d/ directories. User services + (systemd-tmpfiles-setup.service, + systemd-tmpfiles-clean.service) also invoke systemd-tmpfiles, but + it reads a separate set of files, which includes user-controlled files under + ~/.config/user-tmpfiles.d/ and ~/.local/share/user-tmpfiles.d/, + and administrator-controller files under /usr/share/user-tmpfiles.d/. Users may use + this to create and clean up files under their control, but the system instance performs global cleanup + and is not influenced by user configuration. Note that this means a time-based cleanup configured in the + system instance, such as the one typically configured for /tmp, will thus also + affect files created by the user instance if they are placed in /tmp, even if the + user instance's time-based cleanup is turned off. @@ -113,7 +112,7 @@ T, a, and A have their ownership, access mode and - security labels set. + security labels set. @@ -131,11 +130,19 @@ marked with r or R are removed. + + + + Execute "user" configuration, i.e. tmpfiles.d + files in user configuration directories. + + Also execute lines with an exclamation mark. + Only apply rules with paths that start with @@ -148,26 +155,46 @@ specified prefix. This option can be specified multiple times. + - Takes a directory path as an argument. All - paths will be prefixed with the given alternate - root path, including config search - paths. + Takes a directory path as an argument. All paths will be prefixed with the given alternate + root path, including config search paths. + + When this option is used, the libc Name Service Switch (NSS) is bypassed for resolving users + and groups. Instead the files /etc/passwd and /etc/group + inside the alternate root are read directly. This means that users/groups not listed in these files + will not be resolved, i.e. LDAP NIS and other complex databases are not considered. + + + + + When this option is given, one ore more positional arguments + must be specified. All configuration files found in the directories listed in + tmpfiles.d5 + will be read, and the configuration given on the command line will be + handled instead of and with the same priority as the configuration file + PATH. + + This option is intended to be used when package installation scripts + are running and files belonging to that package are not yet available on + disk, so their contents must be given on the command line, but the admin + configuration might already exist and should be given higher priority. + + + - It is possible to combine , - , and in one - invocation. For example, during boot the following command line is - executed to ensure that all temporary and volatile directories are + It is possible to combine , , and + in one invocation (in which case removal and cleanup are executed before creation of new files). For example, + during boot the following command line is executed to ensure that all temporary and volatile directories are removed and created according to the configuration file: systemd-tmpfiles --remove --create - @@ -175,7 +202,7 @@ systemd-tmpfiles tries to avoid changing the access and modification times on the directories it accesses, - which requires CAP_ADMIN privileges. When + which requires CAP_FOWNER privileges. When running as non-root, directories which are checked for files to clean up will have their access time bumped, which might prevent their cleanup. @@ -185,8 +212,16 @@ Exit status - On success, 0 is returned, a non-zero failure code - otherwise. + On success, 0 is returned. If the configuration was syntactically invalid (syntax errors, + missing arguments, …), so some lines had to be ignored, but no other errors occurred, + 65 is returned (EX_DATAERR from + /usr/include/sysexits.h). If the configuration was syntactically valid, but + could not be executed (lack of permissions, creation of files in missing directories, invalid + contents when writing to /sys/ values, …), 73 is + returned (EX_CANTCREAT from /usr/include/sysexits.h). + Otherwise, 1 is returned (EXIT_FAILURE from + /usr/include/stdlib.h). +