summary |
shortlog |
log |
commit | commitdiff |
tree
raw |
patch |
inline | side by side (from parent 1:
d69b220)
Simple %e enumerations never worked reliably outside of udevstart and
udevstart is no longer recommended to use.
Signed-off-by: Kay Sievers <kay.sievers@suse.de>
<para>Usually udev runs as <citerefentry><refentrytitle>udevd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry> and receives uevents directly from the
<para>Usually udev runs as <citerefentry><refentrytitle>udevd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry> and receives uevents directly from the
- kernel if a device is added or removed form the system. The program
- <command>udev</command> itself may be used as an event handler in situations,
- where running the daemon is not appropriate, like in initramfs.</para>
+ kernel if a device is added or removed form the system.</para>
<para>If udev receives a device event, it matches its configured rules
against the available device attributes provided in sysfs to identify the device.
<para>If udev receives a device event, it matches its configured rules
against the available device attributes provided in sysfs to identify the device.
</varlistentry>
<varlistentry>
</varlistentry>
<varlistentry>
- <term><option>%e{<replaceable>key</replaceable>}</option>, <option>$env{<replaceable>key</replaceable>}</option></term>
+ <term><option>%E{<replaceable>key</replaceable>}</option>, <option>$env{<replaceable>key</replaceable>}</option></term>
<listitem>
<para>The value of an environment variable.</para>
</listitem>
<listitem>
<para>The value of an environment variable.</para>
</listitem>
</listitem>
</varlistentry>
</listitem>
</varlistentry>
- <varlistentry>
- <term><option>%e</option>, <option>$enum</option></term>
- <listitem>
- <para>If a device node already exists with the name, the smallest next free
- number is used. This can be used to create compatibility symlinks and enumerate
- devices of the same type originating from different kernel subsystems.</para>
- <para>Note: The use of the enumeration facility is unreliable for events that
- request a number at the same time. The use of enumerations in todays setups
- where devices can come and go at any time is not recommended.</para>
- </listitem>
- </varlistentry>
-
<varlistentry>
<term><option>%P</option>, <option>$parent</option></term>
<listitem>
<varlistentry>
<term><option>%P</option>, <option>$parent</option></term>
<listitem>
.PP
Usually udev runs as
\fBudevd\fR(8)
.PP
Usually udev runs as
\fBudevd\fR(8)
-and receives uevents directly from the kernel if a device is added or removed form the system. The program
-\fBudev\fR
-itself may be used as an event handler in situations, where running the daemon is not appropriate, like in initramfs.
+and receives uevents directly from the kernel if a device is added or removed form the system.
.PP
If udev receives a device event, it matches its configured rules against the available device attributes provided in sysfs to identify the device. Rules that match, may provide additional device information or specify a device node name and multiple symlink names and instruct udev to run additional programs as part of the device event handling.
.SH "CONFIGURATION"
.PP
If udev receives a device event, it matches its configured rules against the available device attributes provided in sysfs to identify the device. Rules that match, may provide additional device information or specify a device node name and multiple symlink names and instruct udev to run additional programs as part of the device event handling.
.SH "CONFIGURATION"
\fB%s{\fR\fB\fIfile\fR\fR\fB}\fR, \fB$sysfs{\fR\fB\fIfile\fR\fR\fB}\fR
The content of a sysfs attribute.
.TP
\fB%s{\fR\fB\fIfile\fR\fR\fB}\fR, \fB$sysfs{\fR\fB\fIfile\fR\fR\fB}\fR
The content of a sysfs attribute.
.TP
-\fB%e{\fR\fB\fIkey\fR\fR\fB}\fR, \fB$env{\fR\fB\fIkey\fR\fR\fB}\fR
+\fB%E{\fR\fB\fIkey\fR\fR\fB}\fR, \fB$env{\fR\fB\fIkey\fR\fR\fB}\fR
The value of an environment variable.
.TP
\fB%m\fR, \fB$major\fR
The value of an environment variable.
.TP
\fB%m\fR, \fB$major\fR
\fB%c{N}\fR. If the number is followed by the '+' char this part plus all remaining parts of the result string are substituted:
\fB%c{N+}\fR
.TP
\fB%c{N}\fR. If the number is followed by the '+' char this part plus all remaining parts of the result string are substituted:
\fB%c{N+}\fR
.TP
-\fB%e\fR, \fB$enum\fR
-If a device node already exists with the name, the smallest next free number is used. This can be used to create compatibility symlinks and enumerate devices of the same type originating from different kernel subsystems.
-
-Note: The use of the enumeration facility is unreliable for events that request a number at the same time. The use of enumerations in todays setups where devices can come and go at any time is not recommended.
-.TP
\fB%P\fR, \fB$parent\fR
The node name of the parent device.
.TP
\fB%P\fR, \fB$parent\fR
The node name of the parent device.
.TP