Debian Codegraph @

upstream/debian-unstable/man8/systemd-udevd.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-UDEVD\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-udevd.service"
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-udevd.service, systemd-udevd-control.socket, systemd-udevd-kernel.socket, systemd-udevd-varlink.socket, systemd-udevd \- Device event managing daemon
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-udevd\&.service
27 .PP
28 systemd\-udevd\-control\&.socket
29 .PP
30 systemd\-udevd\-kernel\&.socket
31 .PP
32 systemd\-udevd\-varlink\&.socket
33 .HP \w'\fB/usr/lib/systemd/systemd\-udevd\fR\ 'u
34 \fB/usr/lib/systemd/systemd\-udevd\fR [\fB\-\-daemon\fR] [\fB\-\-debug\fR] [\fB\-\-children\-max=\fR] [\fB\-\-exec\-delay=\fR] [\fB\-\-event\-timeout=\fR] [\fB\-\-resolve\-names=early|late|never\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
35 .SH "DESCRIPTION"
36 .PP
37 \fBsystemd\-udevd\fR
38 listens to kernel uevents\&. For every event, systemd\-udevd executes matching instructions specified in udev rules\&. See
39 \fBudev\fR(7)\&.
40 .PP
41 The behavior of the daemon can be configured using
42 \fBudev.conf\fR(5), its command line options, environment variables, and on the kernel command line, or changed dynamically with
43 \fBudevadm control\fR\&.
44 .SH "OPTIONS"
45 .PP
46 \fB\-d\fR, \fB\-\-daemon\fR
47 .RS 4
48 Detach and run in the background\&.
49 .sp
50 Added in version 186\&.
51 .RE
52 .PP
53 \fB\-D\fR, \fB\-\-debug\fR
54 .RS 4
55 Print debug messages to standard error\&.
56 .sp
57 Added in version 186\&.
58 .RE
59 .PP
60 \fB\-c\fR, \fB\-\-children\-max=\fR
61 .RS 4
62 Limit the number of events executed in parallel\&.
63 .sp
64 Added in version 186\&.
65 .RE
66 .PP
67 \fB\-e\fR, \fB\-\-exec\-delay=\fR
68 .RS 4
69 Delay the execution of each
70 \fIRUN{\fR\fI\fIprogram\fR\fR\fI}\fR
71 parameter by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&.
72 .sp
73 Added in version 186\&.
74 .RE
75 .PP
76 \fB\-t\fR, \fB\-\-event\-timeout=\fR
77 .RS 4
78 Set the number of seconds to wait for events to finish\&. After this time, the event will be terminated\&. The default is 180 seconds\&.
79 .sp
80 Added in version 216\&.
81 .RE
82 .PP
83 \fB\-s\fR, \fB\-\-timeout\-signal=\fR
84 .RS 4
85 Set the signal which
86 systemd\-udevd
87 will send to forked off processes after reaching event timeout\&. The setting can be overridden at boot time with the kernel command line option
88 \fIudev\&.timeout_signal=\fR\&. Setting to
89 \fBSIGABRT\fR
90 may be helpful in order to debug worker timeouts\&. Defaults to
91 \fBSIGKILL\fR\&. Note that setting the option on the command line overrides the setting from the configuration file\&.
92 .sp
93 Added in version 246\&.
94 .RE
95 .PP
96 \fB\-N\fR, \fB\-\-resolve\-names=\fR
97 .RS 4
98 Specify when systemd\-udevd should resolve names of users and groups\&. When set to
99 \fBearly\fR
100 (the default), names will be resolved when the rules are parsed\&. When set to
101 \fBlate\fR, names will be resolved for every event\&. When set to
102 \fBnever\fR, names will never be resolved and all devices will be owned by root\&.
103 .sp
104 Added in version 186\&.
105 .RE
106 .PP
107 \fB\-h\fR, \fB\-\-help\fR
108 .RS 4
109 Print a short help text and exit\&.
110 .RE
111 .PP
112 \fB\-\-version\fR
113 .RS 4
114 Print a short version string and exit\&.
115 .RE
116 .SH "KERNEL COMMAND LINE"
117 .PP
118 Parameters prefixed with "rd\&." will be read when
119 \fBsystemd\-udevd\fR
120 is used in an initrd, those without will be processed both in the initrd and on the host\&.
121 .PP
122 \fIudev\&.log_level=\fR, \fIrd\&.udev\&.log_level=\fR
123 .RS 4
124 Set the log level\&.
125 .sp
126 Added in version 247\&.
127 .RE
128 .PP
129 \fIudev\&.trace[=\fR\fI\fIBOOL\fR\fR\fI]\fR, \fIrd\&.udev\&.trace[=\fR\fI\fIBOOL\fR\fR\fI]\fR
130 .RS 4
131 Enable/disable trace logging\&. When enabled,
132 \fIudev\&.log_level=\fR
133 will be ignored, and
134 "debug"
135 level is assumed\&.
136 .sp
137 Added in version 258\&.
138 .RE
139 .PP
140 \fIudev\&.children_max=\fR, \fIrd\&.udev\&.children_max=\fR
141 .RS 4
142 Limit the number of events executed in parallel\&.
143 .sp
144 Added in version 186\&.
145 .RE
146 .PP
147 \fIudev\&.exec_delay=\fR, \fIrd\&.udev\&.exec_delay=\fR
148 .RS 4
149 Delay the execution of each
150 \fIRUN{\fR\fI\fIprogram\fR\fR\fI}\fR
151 parameter by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&.
152 .sp
153 Added in version 186\&.
154 .RE
155 .PP
156 \fIudev\&.event_timeout=\fR, \fIrd\&.udev\&.event_timeout=\fR
157 .RS 4
158 Wait for events to finish up to the given number of seconds\&. This option might be useful if events are terminated due to kernel drivers taking too long to initialize\&.
159 .sp
160 Added in version 216\&.
161 .RE
162 .PP
163 \fIudev\&.timeout_signal=\fR, \fIrd\&.udev\&.timeout_signal=\fR
164 .RS 4
165 Specifies a signal that
166 systemd\-udevd
167 will send to workers on timeout\&. Note that kernel command line option overrides both the setting in the configuration file and the one on the program command line\&.
168 .sp
169 Added in version 246\&.
170 .RE
171 .PP
172 \fIudev\&.blockdev_read_only\fR, \fIrd\&.udev\&.blockdev_read_only\fR
173 .RS 4
174 If specified, mark all physical block devices read\-only as they appear\&. Synthetic block devices (such as loopback block devices or device mapper devices) are left as they are\&. This is useful to guarantee that the contents of physical block devices remains unmodified during runtime, for example to implement fully stateless systems, for testing or for recovery situations where corrupted file systems shall not be corrupted further through accidental modification\&.
175 .sp
176 A block device may be marked writable again by issuing the
177 \fBblockdev \-\-setrw\fR
178 command, see
179 \fBblockdev\fR(8)
180 for details\&.
181 .sp
182 Added in version 246\&.
183 .RE
184 .PP
185 \fInet\&.ifnames=\fR
186 .RS 4
187 Network interfaces are renamed to give them predictable names when possible\&. It is enabled by default; specifying 0 disables it\&.
188 .sp
189 Added in version 199\&.
190 .RE
191 .PP
192 \fInet\&.naming_scheme=\fR
193 .RS 4
194 Network interfaces are renamed to give them predictable names when possible (unless
195 \fInet\&.ifnames=0\fR
196 is specified, see above)\&. With this kernel command line option it is possible to pick a specific version of this algorithm and override the default chosen at compilation time\&. Expects one of the naming scheme identifiers listed in
197 \fBsystemd.net-naming-scheme\fR(7), or
198 "latest"
199 to select the latest scheme known (to this particular version of
200 systemd\-udevd\&.service)\&.
201 .sp
202 Note that selecting a specific scheme is not sufficient to fully stabilize interface naming: the naming is generally derived from driver attributes exposed by the kernel\&. As the kernel is updated, previously missing attributes
203 systemd\-udevd\&.service
204 is checking might appear, which affects older name derivation algorithms, too\&.
205 .sp
206 Added in version 240\&.
207 .RE
208 .PP
209 \fInet\&.ifname_policy=\fR\fI\fIpolicy1\fR\fR\fI[,\fR\fI\fIpolicy2\fR\fR\fI,\&...][,\fR\fI\fIMAC\fR\fR\fI]\fR
210 .RS 4
211 Specifies naming policies applied when renaming network interfaces\&. Takes a list of policies and an optional MAC address separated with comma\&. Each policy value must be one of the policies understood by the
212 \fINamePolicy=\fR
213 setting in \&.link files, e\&.g\&.
214 "onboard"
215 or
216 "path"\&. See
217 \fBsystemd.link\fR(5)
218 for more details\&. When the MAC address is specified, the policies are applied to the interface which has the address\&. When no MAC address is specified, the policies are applied to all interfaces\&. This kernel command line argument can be specified multiple times\&.
219 .sp
220 This argument is not directly read by
221 \fBsystemd\-udevd\fR, but is instead converted to a \&.link file by
222 \fBsystemd-network-generator.service\fR(8)\&. For this argument to take effect,
223 systemd\-network\-generator\&.service
224 must be enabled\&.
225 .sp
226 Example:
227 .sp
228 .if n \{\
229 .RS 4
230 .\}
231 .nf
232 net\&.ifname_policy=keep,kernel,path,slot,onboard,01:23:45:67:89:ab
233 net\&.ifname_policy=keep,kernel,path,slot,onboard,mac
234 .fi
235 .if n \{\
236 .RE
237 .\}
238 .sp
239 This is mostly equivalent to creating the following \&.link files:
240 .sp
241 .if n \{\
242 .RS 4
243 .\}
244 .nf
245 # 91\-name\-policy\-with\-mac\&.link
246 [Match]
247 MACAddress=01:23:45:67:89:ab
248
249 [Link]
250 NamePolicy=keep kernel path slot onboard
251 AlternativeNamePolicy=path slot onboard
252 .fi
253 .if n \{\
254 .RE
255 .\}
256 .sp
257 and
258 .sp
259 .if n \{\
260 .RS 4
261 .\}
262 .nf
263 # 92\-name\-policy\-for\-all\&.link
264 [Match]
265 OriginalName=*
266
267 [Link]
268 NamePolicy=keep kernel path slot onboard mac
269 AlternativeNamePolicy=path slot onboard mac
270 .fi
271 .if n \{\
272 .RE
273 .\}
274 .sp
275 Added in version 250\&.
276 .RE
277 .SH "SEE ALSO"
278 .PP
279 \fBudev.conf\fR(5), \fBudev\fR(7), \fBudevadm\fR(8)