Debian Codegraph @

upstream/debian-unstable/man1/systemd-delta.1

raw
1 '\" t
2 .TH "SYSTEMD\-DELTA" "1" "" "systemd 261~rc3" "systemd-delta"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-delta \- Find overridden configuration files
24 .SH "SYNOPSIS"
25 .HP \w'\fBsystemd\-delta\fR\ 'u
26 \fBsystemd\-delta\fR [OPTIONS...] [\fIPREFIX\fR | \fIPREFIX\fR/\fISUFFIX\fR | \fISUFFIX\fR...]
27 .SH "DESCRIPTION"
28 .PP
29 \fBsystemd\-delta\fR
30 may be used to identify and compare configuration files that override other configuration files\&. Files in
31 /etc/
32 have highest priority, files in
33 /run/
34 have the second highest priority, \&..., files in
35 /usr/lib/
36 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
37 "\&.d"
38 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
39 \fBsystemd.unit\fR(5)\&.
40 .PP
41 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/,
42 /run/,
43 /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
44 tmpfiles\&.d,
45 sysctl\&.d
46 or
47 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\&.
48 .SH "OPTIONS"
49 .PP
50 The following options are understood:
51 .PP
52 \fB\-t\fR, \fB\-\-type=\fR
53 .RS 4
54 When listing the differences, only list those that are asked for\&. The list itself is a comma\-separated list of desired difference types\&.
55 .sp
56 Recognized types are:
57 .PP
58 \fImasked\fR
59 .RS 4
60 Show masked files
61 .RE
62 .PP
63 \fIequivalent\fR
64 .RS 4
65 Show overridden files that while overridden, do not differ in content\&.
66 .RE
67 .PP
68 \fIredirected\fR
69 .RS 4
70 Show files that are redirected to another\&.
71 .RE
72 .PP
73 \fIoverridden\fR
74 .RS 4
75 Show overridden, and changed files\&.
76 .RE
77 .PP
78 \fIextended\fR
79 .RS 4
80 Show
81 *\&.conf
82 files in drop\-in directories for units\&.
83 .sp
84 Added in version 205\&.
85 .RE
86 .PP
87 \fIunchanged\fR
88 .RS 4
89 Show unmodified files too\&.
90 .RE
91 .sp
92 .RE
93 .PP
94 \fB\-\-diff=\fR
95 .RS 4
96 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
97 \fBtrue\fR\&.
98 .RE
99 .PP
100 \fB\-h\fR, \fB\-\-help\fR
101 .RS 4
102 Print a short help text and exit\&.
103 .RE
104 .PP
105 \fB\-\-version\fR
106 .RS 4
107 Print a short version string and exit\&.
108 .RE
109 .PP
110 \fB\-\-no\-pager\fR
111 .RS 4
112 Do not pipe output into a pager\&.
113 .RE
114 .SH "EXAMPLES"
115 .PP
116 To see all local configuration:
117 .sp
118 .if n \{\
119 .RS 4
120 .\}
121 .nf
122 systemd\-delta
123 .fi
124 .if n \{\
125 .RE
126 .\}
127 .PP
128 To see all runtime configuration:
129 .sp
130 .if n \{\
131 .RS 4
132 .\}
133 .nf
134 systemd\-delta /run
135 .fi
136 .if n \{\
137 .RE
138 .\}
139 .PP
140 To see all system unit configuration changes:
141 .sp
142 .if n \{\
143 .RS 4
144 .\}
145 .nf
146 systemd\-delta systemd/system
147 .fi
148 .if n \{\
149 .RE
150 .\}
151 .PP
152 To see all runtime "drop\-in" changes for system units:
153 .sp
154 .if n \{\
155 .RS 4
156 .\}
157 .nf
158 systemd\-delta \-\-type=extended /run/systemd/system
159 .fi
160 .if n \{\
161 .RE
162 .\}
163 .SH "EXIT STATUS"
164 .PP
165 On success, 0 is returned, a non\-zero failure code otherwise\&.
166 .SH "SEE ALSO"
167 .PP
168 \fBsystemd\fR(1), \fBsystemd.unit\fR(5)