Debian Codegraph @

upstream/debian-unstable/man5/sysext.conf.5

raw
1 '\" t
2 .TH "SYSEXT\&.CONF" "5" "" "systemd 261~rc3" "sysext.conf"
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 sysext.conf, confext.conf, sysext.conf.d, confext.conf.d \- Configuration files for systemd\-sysext
24 .SH "SYNOPSIS"
25 .PP
26 /etc/systemd/sysext\&.conf
27 .PP
28 /etc/systemd/sysext\&.conf\&.d/*\&.conf
29 .PP
30 /run/systemd/sysext\&.conf
31 .PP
32 /run/systemd/sysext\&.conf\&.d/*\&.conf
33 .PP
34 /usr/lib/systemd/sysext\&.conf
35 .PP
36 /usr/lib/systemd/sysext\&.conf\&.d/*\&.conf
37 .PP
38 /etc/systemd/confext\&.conf
39 .PP
40 /etc/systemd/confext\&.conf\&.d/*\&.conf
41 .PP
42 /run/systemd/confext\&.conf
43 .PP
44 /run/systemd/confext\&.conf\&.d/*\&.conf
45 .PP
46 /usr/lib/systemd/confext\&.conf
47 .PP
48 /usr/lib/systemd/confext\&.conf\&.d/*\&.conf
49 .SH "DESCRIPTION"
50 .PP
51 These configuration files control the behavior of
52 \fBsystemd-sysext\fR(8)
53 and
54 \fBsystemd-confext\fR(8)\&. They are especially useful when needing to customize the behavior of the respective extension service units\&.
55 .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE"
56 .PP
57 The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used:
58 /etc/systemd/,
59 /run/systemd/,
60 /usr/local/lib/systemd/
61 \&\s-2\u[1]\d\s+2,
62 /usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in
63 /etc/
64 if it is shipped under
65 /usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&.
66 .PP
67 In addition to the main configuration file, drop\-in configuration snippets are read from
68 /usr/lib/systemd/*\&.conf\&.d/,
69 /usr/local/lib/systemd/*\&.conf\&.d/, and
70 /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the
71 *\&.conf\&.d/
72 configuration subdirectories are sorted by their filename in lexicographic order, regardless of in which of the subdirectories they reside\&. When multiple files specify the same option, for options which accept just a single value, the entry in the file sorted last takes precedence, and for options which accept a list of values, entries are collected as they occur in the sorted files\&.
73 .PP
74 When packages need to customize the configuration, they can install drop\-ins under
75 /usr/\&. Files in
76 /etc/
77 are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in
78 /usr/
79 and the range 60\-90 for drop\-ins in
80 /etc/
81 and
82 /run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&.
83 .PP
84 To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to
85 /dev/null
86 in the configuration directory in
87 /etc/, with the same filename as the vendor configuration file\&.
88 .SH "OPTIONS"
89 .PP
90 The following options are understood in both the
91 "[SysExt]"
92 and
93 "[ConfExt]"
94 sections:
95 .SS "Section Options"
96 .PP
97 \fIMutable=\fR
98 .RS 4
99 Set the mutable mode for system extensions\&. Takes one of
100 "no",
101 "yes",
102 "auto",
103 "import",
104 "ephemeral", or
105 "ephemeral\-import"\&. For details about the modes, see the
106 \fB\-\-mutable=\fR
107 option in
108 \fBsystemd-sysext\fR(8)\&. Defaults to
109 "no"\&.
110 .sp
111 Added in version 259\&.
112 .RE
113 .PP
114 \fIImagePolicy=\fR
115 .RS 4
116 Set the image policy\&. Takes an image policy string as argument, as per
117 \fBsystemd.image-policy\fR(7)\&. For details, see the
118 \fB\-\-image\-policy=\fR
119 option in
120 \fBsystemd-sysext\fR(8)\&.
121 .sp
122 Added in version 259\&.
123 .RE
124 .SH "SEE ALSO"
125 .PP
126 \fBsystemd\fR(1), \fBsystemd-sysext\fR(8), \fBsystemd.syntax\fR(7)
127 .SH "NOTES"
128 .IP " 1." 4
129 💣💥🧨💥💥💣 Please note that those configuration files must be available at all times. If
130 /usr/local/
131 is a separate partition, it may not be available during early boot, and must not be used for configuration.
132