mirror of
https://git.proxmox.com/git/systemd
synced 2025-05-29 09:50:39 +00:00
149 lines
4.3 KiB
Groff
149 lines
4.3 KiB
Groff
'\" t
|
|
.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 219" "systemd-tmpfiles"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- Creates, deletes and cleans up volatile and temporary files and directories
|
|
.SH "SYNOPSIS"
|
|
.HP \w'\fBsystemd\-tmpfiles\fR\ 'u
|
|
\fBsystemd\-tmpfiles\fR [OPTIONS...] [\fICONFIGFILE\fR...]
|
|
.PP
|
|
systemd\-tmpfiles\-setup\&.service
|
|
.PP
|
|
systemd\-tmpfiles\-setup\-dev\&.service
|
|
.PP
|
|
systemd\-tmpfiles\-clean\&.service
|
|
.PP
|
|
systemd\-tmpfiles\-clean\&.timer
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
\fBsystemd\-tmpfiles\fR
|
|
creates, deletes, and cleans up volatile and temporary files and directories, based on the configuration file format and location specified in
|
|
\fBtmpfiles.d\fR(5)\&.
|
|
.PP
|
|
If invoked with no arguments, it applies all directives from all configuration files\&. If one or more filenames are passed on the command line, only the directives in these files are applied\&. If only the basename of a configuration file is specified, all configuration directories as specified in
|
|
\fBtmpfiles.d\fR(5)
|
|
are searched for a matching file\&.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
The following options are understood:
|
|
.PP
|
|
\fB\-\-create\fR
|
|
.RS 4
|
|
If this option is passed, all files and directories marked with
|
|
\fIf\fR,
|
|
\fIF\fR,
|
|
\fIw\fR,
|
|
\fId\fR,
|
|
\fID\fR,
|
|
\fIv\fR,
|
|
\fIp\fR,
|
|
\fIL\fR,
|
|
\fIc\fR,
|
|
\fIb\fR,
|
|
\fIm\fR
|
|
in the configuration files are created or written to\&. Files and directories marked with
|
|
\fIz\fR,
|
|
\fIZ\fR,
|
|
\fIt\fR,
|
|
\fIT\fR,
|
|
\fIa\fR, and
|
|
\fIA\fR
|
|
have their ownership, access mode and security labels set\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-clean\fR
|
|
.RS 4
|
|
If this option is passed, all files and directories with an age parameter configured will be cleaned up\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-remove\fR
|
|
.RS 4
|
|
If this option is passed, the contents of directories marked with
|
|
\fID\fR
|
|
or
|
|
\fIR\fR, and files or directories themselves marked with
|
|
\fIr\fR
|
|
or
|
|
\fIR\fR
|
|
are removed\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-boot\fR
|
|
.RS 4
|
|
Also execute lines with an exclamation mark\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-prefix=\fR\fB\fIpath\fR\fR
|
|
.RS 4
|
|
Only apply rules with paths that start with the specified prefix\&. This option can be specified multiple times\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-exclude\-prefix=\fR\fB\fIpath\fR\fR
|
|
.RS 4
|
|
Ignore rules with paths that start with the specified prefix\&. This option can be specified multiple times\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-root=\fR\fB\fIroot\fR\fR
|
|
.RS 4
|
|
Takes a directory path as an argument\&. All paths will be prefixed with the given alternate
|
|
\fIroot\fR
|
|
path, including config search paths\&.
|
|
.RE
|
|
.PP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
.RS 4
|
|
Print a short help text and exit\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-version\fR
|
|
.RS 4
|
|
Print a short version string and exit\&.
|
|
.RE
|
|
.PP
|
|
It is possible to combine
|
|
\fB\-\-create\fR,
|
|
\fB\-\-clean\fR, and
|
|
\fB\-\-remove\fR
|
|
in one invocation\&. 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:
|
|
.sp
|
|
.if n \{\
|
|
.RS 4
|
|
.\}
|
|
.nf
|
|
systemd\-tmpfiles \-\-remove \-\-create
|
|
.fi
|
|
.if n \{\
|
|
.RE
|
|
.\}
|
|
.SH "UNPRIVILEGED --CLEANUP OPERATION"
|
|
.PP
|
|
\fBsystemd\-tmpfiles\fR
|
|
tries to avoid changing the access and modification times on the directories it accesses, which requires
|
|
\fBCAP_ADMIN\fR
|
|
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\&.
|
|
.SH "EXIT STATUS"
|
|
.PP
|
|
On success, 0 is returned, a non\-zero failure code otherwise\&.
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBsystemd\fR(1),
|
|
\fBtmpfiles.d\fR(5)
|