Debian Codegraph @

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

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