summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/systemd-delta.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/mageia-cauldron/man1/systemd-delta.1')
-rw-r--r--upstream/mageia-cauldron/man1/systemd-delta.1169
1 files changed, 169 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/systemd-delta.1 b/upstream/mageia-cauldron/man1/systemd-delta.1
new file mode 100644
index 00000000..d874587b
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/systemd-delta.1
@@ -0,0 +1,169 @@
+'\" t
+.TH "SYSTEMD\-DELTA" "1" "" "systemd 255" "systemd-delta"
+.\" -----------------------------------------------------------------
+.\" * 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-delta \- Find overridden configuration files
+.SH "SYNOPSIS"
+.HP \w'\fBsystemd\-delta\fR\ 'u
+\fBsystemd\-delta\fR [OPTIONS...] [\fIPREFIX\fR[/\fISUFFIX\fR]|\fISUFFIX\fR...]
+.SH "DESCRIPTION"
+.PP
+\fBsystemd\-delta\fR
+may be used to identify and compare configuration files that override other configuration files\&. Files in
+/etc/
+have highest priority, files in
+/run/
+have the second highest priority, \&..., files in
+/usr/lib/
+have lowest priority\&. Files in a directory with higher priority override files with the same name in directories of lower priority\&. In addition, certain configuration files can have
+"\&.d"
+directories which contain "drop\-in" files with configuration snippets which augment the main configuration file\&. "Drop\-in" files can be overridden in the same way by placing files with the same name in a directory of higher priority (except that, in case of "drop\-in" files, both the "drop\-in" file name and the name of the containing directory, which corresponds to the name of the main configuration file, must match)\&. For a fuller explanation, see
+\fBsystemd.unit\fR(5)\&.
+.PP
+The command line argument will be split into a prefix and a suffix\&. Either is optional\&. The prefix must be one of the directories containing configuration files (/etc/,
+/run/,
+/usr/lib/, \&...)\&. If it is given, only overriding files contained in this directory will be shown\&. Otherwise, all overriding files will be shown\&. The suffix must be a name of a subdirectory containing configuration files like
+tmpfiles\&.d,
+sysctl\&.d
+or
+systemd/system\&. If it is given, only configuration files in this subdirectory (across all configuration paths) will be analyzed\&. Otherwise, all configuration files will be analyzed\&. If the command line argument is not given at all, all configuration files will be analyzed\&. See below for some examples\&.
+.SH "OPTIONS"
+.PP
+The following options are understood:
+.PP
+\fB\-t\fR, \fB\-\-type=\fR
+.RS 4
+When listing the differences, only list those that are asked for\&. The list itself is a comma\-separated list of desired difference types\&.
+.sp
+Recognized types are:
+.PP
+\fImasked\fR
+.RS 4
+Show masked files
+.RE
+.PP
+\fIequivalent\fR
+.RS 4
+Show overridden files that while overridden, do not differ in content\&.
+.RE
+.PP
+\fIredirected\fR
+.RS 4
+Show files that are redirected to another\&.
+.RE
+.PP
+\fIoverridden\fR
+.RS 4
+Show overridden, and changed files\&.
+.RE
+.PP
+\fIextended\fR
+.RS 4
+Show
+*\&.conf
+files in drop\-in directories for units\&.
+.sp
+Added in version 205\&.
+.RE
+.PP
+\fIunchanged\fR
+.RS 4
+Show unmodified files too\&.
+.RE
+.sp
+.RE
+.PP
+\fB\-\-diff=\fR
+.RS 4
+When showing modified files, when a file is overridden show a diff as well\&. This option takes a boolean argument\&. If omitted, it defaults to
+\fBtrue\fR\&.
+.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
+\fB\-\-no\-pager\fR
+.RS 4
+Do not pipe output into a pager\&.
+.RE
+.SH "EXAMPLES"
+.PP
+To see all local configuration:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+systemd\-delta
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+To see all runtime configuration:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+systemd\-delta /run
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+To see all system unit configuration changes:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+systemd\-delta systemd/system
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+To see all runtime "drop\-in" changes for system units:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+systemd\-delta \-\-type=extended /run/systemd/system
+.fi
+.if n \{\
+.RE
+.\}
+.SH "EXIT STATUS"
+.PP
+On success, 0 is returned, a non\-zero failure code otherwise\&.
+.SH "SEE ALSO"
+.PP
+\fBsystemd\fR(1),
+\fBsystemd.unit\fR(5)