*.o
*.a
udevd
-udevcontrol
-udevtrigger
-udevsettle
-udevsend
-udevinfo
-udevmonitor
+udevadm
udevstart
-udevtest
udev_version.h
test-udev
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
#
-VERSION = 116
+VERSION = 118
# set this to make use of syslog
USE_LOG = true
PROGRAMS = \
udevd \
- udevtrigger \
- udevsettle \
- udevcontrol \
- udevmonitor \
- udevinfo \
- udevtest \
- test-udev \
- udevstart
+ udevadm \
+ udevstart \
+ test-udev
HEADERS = \
udev.h \
udev_utils.o \
udev_utils_string.o \
udev_utils_file.o \
+ udevmonitor.o \
+ udevinfo.o \
+ udevcontrol.o \
+ udevtrigger.o \
+ udevsettle.o \
+ udevtest.o \
udev_sysdeps.o
LIBUDEV = libudev.a
MAN_PAGES = \
udev.7 \
- udevmonitor.8 \
udevd.8 \
- udevtrigger.8 \
- udevsettle.8 \
- udevtest.8 \
- udevinfo.8 \
- udevstart.8
+ udevadm.8
GEN_HEADERS = \
udev_version.h
install-man:
$(INSTALL_DATA) -D udev.7 $(DESTDIR)$(mandir)/man7/udev.7
- $(INSTALL_DATA) -D udevinfo.8 $(DESTDIR)$(mandir)/man8/udevinfo.8
- $(INSTALL_DATA) -D udevtest.8 $(DESTDIR)$(mandir)/man8/udevtest.8
$(INSTALL_DATA) -D udevd.8 $(DESTDIR)$(mandir)/man8/udevd.8
- $(INSTALL_DATA) -D udevtrigger.8 $(DESTDIR)$(mandir)/man8/udevtrigger.8
- $(INSTALL_DATA) -D udevsettle.8 $(DESTDIR)$(mandir)/man8/udevsettle.8
- $(INSTALL_DATA) -D udevmonitor.8 $(DESTDIR)$(mandir)/man8/udevmonitor.8
- - ln -f -s udevd.8 $(DESTDIR)$(mandir)/man8/udevcontrol.8
+ $(INSTALL_DATA) -D udevadm.8 $(DESTDIR)$(mandir)/man8/udevadm.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevinfo.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevtest.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevtrigger.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevsettle.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevmonitor.8
+ ln -f -s udevadm.8 $(DESTDIR)$(mandir)/man8/udevcontrol.8
@extras="$(EXTRAS)"; for target in $$extras; do \
$(MAKE) -C $$target $@ || exit 1; \
done;
uninstall-man:
- rm -f $(DESTDIR)$(mandir)/man7/udev.7
+ - rm -f $(DESTDIR)$(mandir)/man8/udevadm.8
- rm -f $(DESTDIR)$(mandir)/man8/udevinfo.8
- rm -f $(DESTDIR)$(mandir)/man8/udevtest.8
- rm -f $(DESTDIR)$(mandir)/man8/udevd.8
install-bin:
$(INSTALL) -d $(DESTDIR)$(udevdir)
$(INSTALL_PROGRAM) -D udevd $(DESTDIR)$(sbindir)/udevd
- $(INSTALL_PROGRAM) -D udevtrigger $(DESTDIR)$(sbindir)/udevtrigger
- $(INSTALL_PROGRAM) -D udevsettle $(DESTDIR)$(sbindir)/udevsettle
- $(INSTALL_PROGRAM) -D udevcontrol $(DESTDIR)$(sbindir)/udevcontrol
- $(INSTALL_PROGRAM) -D udevmonitor $(DESTDIR)$(usrsbindir)/udevmonitor
- $(INSTALL_PROGRAM) -D udevinfo $(DESTDIR)$(usrbindir)/udevinfo
- $(INSTALL_PROGRAM) -D udevtest $(DESTDIR)$(usrbindir)/udevtest
+ $(INSTALL_PROGRAM) -D udevadm $(DESTDIR)$(sbindir)/udevadm
+ ln -f -s udevadm $(DESTDIR)$(sbindir)/udevtrigger
+ ln -f -s udevadm $(DESTDIR)$(sbindir)/udevsettle
+ ln -f -s udevadm $(DESTDIR)$(sbindir)/udevcontrol
+ mkdir -p -m 0755 $(DESTDIR)$(usrsbindir)
+ ln -f -s $(sbindir)/udevadm $(DESTDIR)$(usrsbindir)/udevmonitor
+ mkdir -p -m 0755 $(DESTDIR)$(usrbindir)
+ ln -f -s $(sbindir)/udevadm $(DESTDIR)$(usrbindir)/udevinfo
+ ln -f -s $(sbindir)/udevadm $(DESTDIR)$(usrbindir)/udevtest
@extras="$(EXTRAS)"; for target in $$extras; do \
$(MAKE) -C $$target $@ || exit 1; \
done;
uninstall-bin:
- rm -f $(DESTDIR)$(sbindir)/udevd
+ - rm -f $(DESTDIR)$(sbindir)/udevadm
- rm -f $(DESTDIR)$(sbindir)/udevtrigger
- rm -f $(DESTDIR)$(sbindir)/udevsettle
- rm -f $(DESTDIR)$(sbindir)/udevcontrol
+udev 117
+========
+Bugfixes.
+
+All udev tools are merged into a single binary called udevadm now.
+The old names of the binary are commands for udevadm now. Symlinks
+provide the functionality of the standalone tools. There is only a
+single udevadm.8 man page for all tools left.
+
udev 116
========
Bugfixes.
.SH "SEE ALSO"
.PP
\fBudevd\fR(8),
-\fBudevinfo\fR(8),
-\fBudevmonitor\fR(8)
+\fBudevadm\fR(8)
extern int unlink_secure(const char *filename);
extern size_t buf_get_line(const char *buf, size_t buflen, size_t cur);
+/* udev commands */
+extern int udevmonitor(int argc, char *argv[], char *envp[]);
+extern int udevinfo(int argc, char *argv[], char *envp[]);
+extern int udevcontrol(int argc, char *argv[], char *envp[]);
+extern int udevtrigger(int argc, char *argv[], char *envp[]);
+extern int udevsettle(int argc, char *argv[], char *envp[]);
+extern int udevtest(int argc, char *argv[], char *envp[]);
+
#endif
<refentrytitle>udevd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
- <refentrytitle>udevinfo</refentrytitle><manvolnum>8</manvolnum>
- </citerefentry>,
- <citerefentry>
- <refentrytitle>udevmonitor</refentrytitle><manvolnum>8</manvolnum>
+ <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
</citerefentry></para>
</refsect1>
</refentry>
--- /dev/null
+.\" Title: udevadm
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
+.\" Date: November 2007
+.\" Manual: udevadm
+.\" Source: udev
+.\"
+.TH "UDEVADM" "8" "November 2007" "udev" "udevadm"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+udevadm - udev management tool
+.SH "SYNOPSIS"
+.HP 21
+\fBudevadm info \fR\fB[options]\fR
+.HP 24
+\fBudevadm trigger \fR\fB[options]\fR
+.HP 23
+\fBudevadm settle \fR\fB[options]\fR
+.HP 36
+\fBudevadm control \fR\fB[options]\fR\fB \fR\fB\fIinstruction\fR\fR
+.HP 24
+\fBudevadm monitor \fR\fB[options]\fR
+.HP 29
+\fBudevadm test \fR\fB[options]\fR\fB \fR\fB\fIdevpath\fR\fR
+.HP 16
+\fBudevadm version\fR
+.HP 13
+\fBudevadm help\fR
+.SH "DESCRIPTION"
+.PP
+udevadm expects a command and command specific options\. It controls the runtime behavior of udev, request kernel events, manages the event queue, and provides simple debugging mechanisms\.
+.SH "OPTIONS"
+.SS "udevadm info"
+.PP
+Queries the udev database for device information stored in the udev database\. It can also query the properties of a device from its sysfs representation to help creating udev rules that match this device\.
+.PP
+\fB\-\-query=\fR\fB\fItype\fR\fR
+.RS 4
+Query the database for specified type of device data\. It needs the
+\fB\-\-path\fR
+or
+\fB\-\-name\fR
+to identify the specified device\. Valid queries are:
+\fBname\fR,
+\fBsymlink\fR,
+\fBpath\fR,
+\fBenv\fR,
+\fBall\fR\.
+.RE
+.PP
+\fB\-\-path=\fR\fB\fIdevpath\fR\fR
+.RS 4
+The devpath of the device to query\.
+.RE
+.PP
+\fB\-\-name=\fR\fB\fInode\fR\fR
+.RS 4
+The name of the device node or a symlink to query
+.RE
+.PP
+\fB\-\-root\fR
+.RS 4
+The udev root directory:
+\fI/dev\fR\. If used in conjunction with a
+\fBname\fR
+or
+\fBsymlink\fR
+query, the query returns the absolute path including the root directory\.
+.RE
+.PP
+\fB\-\-attribute\-walk\fR
+.RS 4
+Print all sysfs properties of the specified device that can be used in udev rules to match the specified device\. It prints all devices along the chain, up to the root of sysfs that can be used in udev rules\.
+.RE
+.PP
+\fB\-\-export\-db\fR
+.RS 4
+Export the content of the udev database\.
+.RE
+.PP
+\fB\-\-version\fR
+.RS 4
+Print version\.
+.RE
+.PP
+\fB\-\-help\fR
+.RS 4
+Print help text\.
+.RE
+.SS "udevadm trigger"
+.PP
+Request kernel device uevents, usually used to replay events at system coldplug\.
+.PP
+\fB\-\-verbose\fR
+.RS 4
+Print the list of devices which will be triggered\.
+.RE
+.PP
+\fB\-\-dry\-run\fR
+.RS 4
+Do not actually trigger the event\.
+.RE
+.PP
+\fB\-\-retry\-failed\fR
+.RS 4
+Trigger only the events which are failed during a previous run\.
+.RE
+.PP
+\fB\-\-action=\fR\fB\fIaction\fR\fR
+.RS 4
+Type of event to be triggered\. The default value is "add"\.
+.RE
+.PP
+\fB\-\-subsystem\-match=\fR\fB\fIsubsystem\fR\fR
+.RS 4
+Trigger events for devices which belong to a matching subsystem\. This option can be specified multiple times and supports shell style pattern matching\.
+.RE
+.PP
+\fB\-\-subsystem\-nomatch=\fR\fB\fIsubsystem\fR\fR
+.RS 4
+Do not trigger events for devices which belong to a matching subsystem\. This option can be specified multiple times and supports shell style pattern matching\.
+.RE
+.PP
+\fB\-\-attr\-match=\fR\fB\fIattribute=value\fR\fR
+.RS 4
+Trigger events for devices with a matching sysfs attribute\. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\. If no value is specified, the existence of the sysfs attribute is checked\. This option can be specified multiple times\.
+.RE
+.PP
+\fB\-\-attr\-nomatch\fR\fB\fIattribute=value\fR\fR
+.RS 4
+Do not trigger events for devices with a matching sysfs attribute\. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\. If no value is specified, the existence of the sysfs attribute is checked\. This option can be specified multiple times\.
+.RE
+.SS "udevadm settle"
+.PP
+Watches the udev event queue, and exits if all current events are handled\.
+.PP
+\fB\-\-timeout=\fR\fB\fIseconds\fR\fR
+.RS 4
+Maximum seconds to wait for the queue to become empty\.
+.RE
+.PP
+\fB\-\-help\fR
+.RS 4
+Print help text\.
+.RE
+.SS "udevadm control \fIinstruction\fR"
+.PP
+Modify the internal state of the running udev daemon\.
+.PP
+\fBlog_priority=\fR\fB\fIvalue\fR\fR
+.RS 4
+Set the internal log level of udevd\. Valid values are the numerical syslog priorities or their textual representations:
+\fBerr\fR,
+\fBinfo\fR
+and
+\fBdebug\fR\.
+.RE
+.PP
+\fBstop_exec_queue\fR
+.RS 4
+Signal udevd to stop executing new events\. Incoming events will be queued\.
+.RE
+.PP
+\fBstart_exec_queue\fR
+.RS 4
+Signal udevd to enable the execution of events\.
+.RE
+.PP
+\fBreload_rules\fR
+.RS 4
+Signal udevd to reload the rules from the config\.
+.RE
+.PP
+\fBenv \fR\fB\fIvar\fR\fR\fB=\fR\fB\fIvalue\fR\fR
+.RS 4
+Set global variable\.
+.RE
+.PP
+\fBmax_childs\fR
+.RS 4
+Set the maximum number of events, udevd will handle at the same time\.
+.RE
+.PP
+\fBmax_childs_running\fR
+.RS 4
+Set the maximum number of events, which are allowed to run at the same time\.
+.RE
+.PP
+\fBhelp\fR
+.RS 4
+Print help text\.
+.RE
+.SS "udevadm monitor"
+.PP
+Listens to the kernel uevents and events sent out by a udev rule and prints the devpath of the event to the console\. It can be used to analyze the event timing, by comparing the timestamps of the kernel uevent and the udev event\.
+.PP
+\fB\-\-environment\fR
+.RS 4
+Print the complete environment for all events\. Can be used to compare the kernel supplied and the udev added environment values\.
+.RE
+.PP
+\fB\-\-kernel\fR
+.RS 4
+Print the kernel uevents\.
+.RE
+.PP
+\fB\-\-udev\fR
+.RS 4
+Print the udev event after the rule processing\.
+.RE
+.PP
+\fB\-\-help\fR
+.RS 4
+Print help text\.
+.RE
+.SS "udevadm test"
+.PP
+Simulate a udev event run for the given device, and print out debug output\. Unless forced to, no device node or symlink will be created\.
+.PP
+\fB\-\-action=\fR\fB\fIstring\fR\fR
+.RS 4
+The action string\.
+.RE
+.PP
+\fB\-\-subsystem=\fR\fB\fIstring\fR\fR
+.RS 4
+The subsystem string\.
+.RE
+.PP
+\fB\-\-force\fR
+.RS 4
+Force the creation of a device node or symlink\. Usually the test run prints only debug output\.
+.RE
+.PP
+\fB\-\-help\fR
+.RS 4
+Print help text\.
+.RE
+.SS "udevadm version"
+.PP
+Print version number\.
+.SS "udevadm help"
+.PP
+Print help text\.
+.SH "AUTHOR"
+.PP
+Written by Kay Sievers
+<kay\.sievers@vrfy\.org>\.
+.SH "SEE ALSO"
+.PP
+\fBudev\fR(7)
+\fBudevd\fR(8)
--- /dev/null
+/*
+ * Copyright (C) 2007 Kay Sievers <kay.sievers@vrfy.org>
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the
+ * Free Software Foundation version 2 of the License.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <stddef.h>
+#include <string.h>
+#include <errno.h>
+#include <getopt.h>
+
+#include "udev.h"
+
+static int verbose;
+
+#ifdef USE_LOG
+void log_message(int priority, const char *format, ...)
+{
+ va_list args;
+
+ if (priority > udev_log_priority)
+ return;
+
+ va_start(args, format);
+ if (verbose) {
+ vprintf(format, args);
+ printf("\n");
+ } else
+ vsyslog(priority, format, args);
+ va_end(args);
+}
+#endif
+
+struct command {
+ const char *name;
+ int (*cmd)(int argc, char *argv[], char *envp[]);
+ const char *help;
+ int verbose;
+};
+
+static const struct command cmds[];
+
+static int version(int argc, char *argv[], char *envp[])
+{
+ printf("%s\n", UDEV_VERSION);
+ return 0;
+}
+
+static int help(int argc, char *argv[], char *envp[])
+{
+ const struct command *cmd;
+
+ printf("Usage: udev COMMAND [OPTIONS]\n");
+ for (cmd = cmds; cmd->name != NULL; cmd++)
+ printf(" %-12s %s\n", cmd->name, cmd->help);
+ printf("\n");
+ return 0;
+}
+
+static const struct command cmds[] = {
+ {
+ .name = "info",
+ .cmd = udevinfo,
+ .help = "query sysfs or the udev database",
+ },
+ {
+ .name = "trigger",
+ .cmd = udevtrigger,
+ .help = "request events from the kernel",
+ },
+ {
+ .name = "settle",
+ .cmd = udevsettle, "",
+ .help = "wait for the event queue to finish",
+ },
+ {
+ .name = "control",
+ .cmd = udevcontrol,
+ .help = "control the udev daemon",
+ },
+ {
+ .name = "monitor",
+ .cmd = udevmonitor,
+ .help = "listen to kernel and udev events",
+ },
+ {
+ .name = "test",
+ .cmd = udevtest,
+ .help = "simulation run",
+ .verbose = 1,
+ },
+ {
+ .name = "version",
+ .cmd = version,
+ .help = "print the version number",
+ },
+ {
+ .name = "help",
+ .cmd = help,
+ .help = "print this help text",
+ },
+ {}
+};
+
+int main(int argc, char *argv[], char *envp[])
+{
+ const char *command;
+ const char *pos;
+ const struct command *cmd;
+ int rc;
+
+ /* get binary or symlink name */
+ pos = strrchr(argv[0], '/');
+ if (pos != NULL)
+ command = &pos[1];
+ else
+ command = argv[0];
+
+ /* the trailing part of the binary or symlink name is the command */
+ if (strncmp(command, "udev", 4) == 0)
+ command = &command[4];
+
+ if (command == NULL || command[0] == '\0')
+ goto err_unknown;
+
+ /* udevadm itself needs to strip its name from the passed options */
+ if (strcmp(command, "adm") == 0) {
+ command = argv[1];
+ argv++;
+ argc--;
+ }
+
+ if (command == NULL || command[0] == '\0')
+ goto err_unknown;
+
+ /* find and execute command */
+ for (cmd = cmds; cmd->name != NULL; cmd++) {
+ if (strcmp(cmd->name, command) == 0) {
+ verbose = cmd->verbose;
+ rc = cmd->cmd(argc, argv, envp);
+ goto out;
+ }
+ }
+
+err_unknown:
+ fprintf(stderr, "unknown command, try help\n\n");
+ rc = 2;
+out:
+ return rc;
+}
--- /dev/null
+<?xml version='1.0'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+
+<article>
+ <section>
+ <title>udevadm</title>
+ <refentry>
+ <refentryinfo>
+ <title>udevd</title>
+ <date>November 2007</date>
+ <productname>udev</productname>
+ </refentryinfo>
+
+ <refmeta>
+ <refentrytitle>udevadm</refentrytitle>
+ <manvolnum>8</manvolnum>
+ <refmiscinfo class="version"></refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>udevadm</refname><refpurpose>udev management tool</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>udevadm info <optional>options</optional></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm trigger <optional>options</optional></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm settle <optional>options</optional></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm control <optional>options</optional> <replaceable>instruction</replaceable></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm monitor <optional>options</optional></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm test <optional>options</optional> <replaceable>devpath</replaceable></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm version</command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>udevadm help</command>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1><title>DESCRIPTION</title>
+ <para>udevadm expects a command and command specific options. It
+ controls the runtime behavior of udev, request kernel events,
+ manages the event queue, and provides simple debugging mechanisms.</para>
+ </refsect1>
+
+ <refsect1><title>OPTIONS</title>
+
+ <refsect2><title>udevadm info</title>
+ <para>Queries the udev database for device information
+ stored in the udev database. It can also query the properties
+ of a device from its sysfs representation to help creating udev
+ rules that match this device.</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--query=<replaceable>type</replaceable></option></term>
+ <listitem>
+ <para>Query the database for specified type of device data. It needs the
+ <option>--path</option> or <option>--name</option> to identify the specified
+ device. Valid queries are:
+ <command>name</command>, <command>symlink</command>, <command>path</command>,
+ <command>env</command>, <command>all</command>.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--path=<replaceable>devpath</replaceable></option></term>
+ <listitem>
+ <para>The devpath of the device to query.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--name=<replaceable>node</replaceable></option></term>
+ <listitem>
+ <para>The name of the device node or a symlink to query</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--root</option></term>
+ <listitem>
+ <para>The udev root directory: <filename>/dev</filename>. If used in conjunction
+ with a <command>name</command> or <command>symlink</command> query, the
+ query returns the absolute path including the root directory.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--attribute-walk</option></term>
+ <listitem>
+ <para>Print all sysfs properties of the specified device that can be used
+ in udev rules to match the specified device. It prints all devices
+ along the chain, up to the root of sysfs that can be used in udev rules.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--export-db</option></term>
+ <listitem>
+ <para>Export the content of the udev database.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--version</option></term>
+ <listitem>
+ <para>Print version.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>Print help text.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm trigger</title>
+ <para>Request kernel device uevents, usually used to replay events at system coldplug.</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--verbose</option></term>
+ <listitem>
+ <para>Print the list of devices which will be triggered.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--dry-run</option></term>
+ <listitem>
+ <para>Do not actually trigger the event.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--retry-failed</option></term>
+ <listitem>
+ <para>Trigger only the events which are failed during a previous run.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--action=<replaceable>action</replaceable></option></term>
+ <listitem>
+ <para>Type of event to be triggered. The default value is "add".</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--subsystem-match=<replaceable>subsystem</replaceable></option></term>
+ <listitem>
+ <para>Trigger events for devices which belong to a matching subsystem. This option
+ can be specified multiple times and supports shell style pattern matching.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
+ <listitem>
+ <para>Do not trigger events for devices which belong to a matching subsystem. This option
+ can be specified multiple times and supports shell style pattern matching.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--attr-match=<replaceable>attribute=value</replaceable></option></term>
+ <listitem>
+ <para>Trigger events for devices with a matching sysfs attribute. If a value is specified
+ along with the attribute name, the content of the attribute is matched against the given
+ value using shell style pattern matching. If no value is specified, the existence of the
+ sysfs attribute is checked. This option can be specified multiple times.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--attr-nomatch<replaceable>attribute=value</replaceable></option></term>
+ <listitem>
+ <para>Do not trigger events for devices with a matching sysfs attribute. If a value is
+ specified along with the attribute name, the content of the attribute is matched against
+ the given value using shell style pattern matching. If no value is specified, the existence
+ of the sysfs attribute is checked. This option can be specified multiple times.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm settle</title>
+ <para>Watches the udev event queue, and exits if all current events are handled.</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--timeout=<replaceable>seconds</replaceable></option></term>
+ <listitem>
+ <para>Maximum seconds to wait for the queue to become empty.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>Print help text.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm control <replaceable>instruction</replaceable></title>
+ <para>Modify the internal state of the running udev daemon.</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>log_priority=<replaceable>value</replaceable></option></term>
+ <listitem>
+ <para>Set the internal log level of udevd. Valid values are the numerical
+ syslog priorities or their textual representations: <option>err</option>,
+ <option>info</option> and <option>debug</option>.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>stop_exec_queue</option></term>
+ <listitem>
+ <para>Signal udevd to stop executing new events. Incoming events
+ will be queued.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>start_exec_queue</option></term>
+ <listitem>
+ <para>Signal udevd to enable the execution of events.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>reload_rules</option></term>
+ <listitem>
+ <para>Signal udevd to reload the rules from the config.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>env <replaceable>var</replaceable>=<replaceable>value</replaceable></option></term>
+ <listitem>
+ <para>Set global variable.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>max_childs</option></term>
+ <listitem>
+ <para>Set the maximum number of events, udevd will handle at the
+ same time.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>max_childs_running</option></term>
+ <listitem>
+ <para>Set the maximum number of events, which are allowed to run at the
+ same time.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>help</option></term>
+ <listitem>
+ <para>Print help text.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm monitor</title>
+ <para>Listens to the kernel uevents and events sent out by a udev rule
+ and prints the devpath of the event to the console. It can be used to analyze the
+ event timing, by comparing the timestamps of the kernel uevent and the udev event.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--environment</option></term>
+ <listitem>
+ <para>Print the complete environment for all events. Can be used to compare the
+ kernel supplied and the udev added environment values.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--kernel</option></term>
+ <listitem>
+ <para>Print the kernel uevents.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--udev</option></term>
+ <listitem>
+ <para>Print the udev event after the rule processing.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>Print help text.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm test</title>
+ <para>Simulate a udev event run for the given device, and print out debug
+ output. Unless forced to, no device node or symlink will be created.</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--action=<replaceable>string</replaceable></option></term>
+ <listitem>
+ <para>The action string.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--subsystem=<replaceable>string</replaceable></option></term>
+ <listitem>
+ <para>The subsystem string.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--force</option></term>
+ <listitem>
+ <para>Force the creation of a device node or symlink. Usually the test run
+ prints only debug output.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>Print help text.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect2>
+
+ <refsect2><title>udevadm version</title>
+ <para>Print version number.</para>
+ </refsect2>
+
+ <refsect2><title>udevadm help</title>
+ <para>Print help text.</para>
+ </refsect2>
+ </refsect1>
+
+ <refsect1><title>AUTHOR</title>
+ <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
+ </refsect1>
+
+ <refsect1>
+ <title>SEE ALSO</title>
+ <para><citerefentry>
+ <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
+ </citerefentry>
+ <citerefentry>
+ <refentrytitle>udevd</refentrytitle><manvolnum>8</manvolnum>
+ </citerefentry></para>
+ </refsect1>
+ </refentry>
+ </section>
+</article>
static int sock = -1;
static int udev_log = 0;
-#ifdef USE_LOG
-void log_message (int priority, const char *format, ...)
-{
- va_list args;
-
- if (priority > udev_log)
- return;
-
- va_start(args, format);
- vsyslog(priority, format, args);
- va_end(args);
-}
-#endif
-
-int main(int argc, char *argv[], char *envp[])
+int udevcontrol(int argc, char *argv[], char *envp[])
{
static struct udevd_ctrl_msg ctrl_msg;
struct sockaddr_un saddr;
strlcpy(ctrl_msg.buf, val, sizeof(ctrl_msg.buf));
info("send env '%s'", val);
} else if (strcmp(arg, "help") == 0 || strcmp(arg, "--help") == 0 || strcmp(arg, "-h") == 0) {
- printf("Usage: udevcontrol COMMAND\n"
+ printf("Usage: udevadm control COMMAND\n"
" log_priority=<level> set the udev log level for the daemon\n"
" stop_exec_queue keep udevd from executing events, queue only\n"
" start_exec_queue execute events, flush queue\n"
<kay\.sievers@vrfy\.org>\.
.SH "SEE ALSO"
.PP
-\fBudev\fR(7)
+\fBudev\fR(8),
+\fBudevadm\fR(8)
if (priority > udev_log_priority)
return;
+ va_start(args, format);
if (verbose) {
printf("[%d] ", (int) getpid());
- va_start(args, format);
vprintf(format, args);
- va_end(args);
printf("\n");
- } else {
- va_start(args, format);
+ } else
vsyslog(priority, format, args);
- va_end(args);
- }
+ va_end(args);
}
#endif
<refsect1>
<title>SEE ALSO</title>
<para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
+ <refentrytitle>udev</refentrytitle><manvolnum>8</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
</citerefentry></para>
</refsect1>
</refentry>
+++ /dev/null
-.\" Title: udevinfo
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: August 2005
-.\" Manual: udevinfo
-.\" Source: udev
-.\"
-.TH "UDEVINFO" "8" "August 2005" "udev" "udevinfo"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevinfo - query udev device information
-.SH "SYNOPSIS"
-.HP 9
-\fBudevinfo\fR [\fB\-\-query=\fR\fB\fIquery\-type\fR\fR] [\fB\-\-path=\fR\fB\fIdevpath\fR\fR] [\fB\-\-name=\fR\fB\fInode\fR\fR] [\fB\-\-root\fR] [\fB\-\-attribute\-walk\fR] [\fB\-\-export\-db\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
-.SH "DESCRIPTION"
-.PP
-udevinfo queries the udev database for device information stored in the udev database\. It can also query the properties of a device from its sysfs representation to help creating udev rules that match this device\.
-.SH "OPTIONS"
-.PP
-\fB\-\-query=\fR\fB\fItype\fR\fR
-.RS 4
-Query the database for specified type of device data\. It needs the
-\fB\-\-path\fR
-or
-\fB\-\-name\fR
-to identify the specified device\. Valid queries are:
-\fBname\fR,
-\fBsymlink\fR,
-\fBpath\fR,
-\fBenv\fR,
-\fBall\fR\.
-.RE
-.PP
-\fB\-\-path=\fR\fB\fIdevpath\fR\fR
-.RS 4
-The devpath of the device to query\.
-.RE
-.PP
-\fB\-\-name=\fR\fB\fInode\fR\fR
-.RS 4
-The name of the device node or a symlink to query
-.RE
-.PP
-\fB\-\-root\fR
-.RS 4
-The udev root directory:
-\fI/dev\fR\. If used in conjunction with a
-\fBname\fR
-or
-\fBsymlink\fR
-query, the query returns the absolute path including the root directory\.
-.RE
-.PP
-\fB\-\-attribute\-walk\fR
-.RS 4
-Print all sysfs properties of the specified device that can be used in udev rules to match the specified device\. It prints all devices along the chain, up to the root of sysfs that can be used in udev rules\.
-.RE
-.PP
-\fB\-\-export\-db\fR
-.RS 4
-Export the content of the udev database\.
-.RE
-.PP
-\fB\-\-version\fR
-.RS 4
-Print version\.
-.RE
-.PP
-\fB\-\-help\fR
-.RS 4
-Print help text\.
-.RE
-.SH "AUTHOR"
-.PP
-Written by Kay Sievers
-<kay\.sievers@vrfy\.org>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
#include "udev.h"
-
-#ifdef USE_LOG
-void log_message (int priority, const char *format, ...)
-{
- va_list args;
-
- if (priority > udev_log_priority)
- return;
-
- va_start(args, format);
- vsyslog(priority, format, args);
- va_end(args);
-}
-#endif
-
static void print_all_attributes(const char *devpath, const char *key)
{
char path[PATH_SIZE];
return rc;
}
-int main(int argc, char *argv[], char *envp[])
+int udevinfo(int argc, char *argv[], char *envp[])
{
int option;
struct udevice *udev;
printf("udevinfo, version %s\n", UDEV_VERSION);
goto exit;
case 'h':
- printf("Usage: udevinfo OPTIONS\n"
+ printf("Usage: udevadm info OPTIONS\n"
" --query=<type> query database for the specified value:\n"
" name name of device node\n"
" symlink pointing to node\n"
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevinfo</title>
- <refentry>
- <refentryinfo>
- <title>udevinfo</title>
- <date>August 2005</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevinfo</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevinfo</refname>
- <refpurpose>query udev device information</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevinfo</command>
- <arg><option>--query=<replaceable>query-type</replaceable></option></arg>
- <arg><option>--path=<replaceable>devpath</replaceable></option></arg>
- <arg><option>--name=<replaceable>node</replaceable></option></arg>
- <arg><option>--root</option></arg>
- <arg><option>--attribute-walk</option></arg>
- <arg><option>--export-db</option></arg>
- <arg><option>--version</option></arg>
- <arg><option>--help</option></arg>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>udevinfo queries the udev database for device information
- stored in the udev database. It can also query the properties
- of a device from its sysfs representation to help creating udev
- rules that match this device.</para>
- </refsect1>
-
- <refsect1><title>OPTIONS</title>
- <variablelist>
- <varlistentry>
- <term><option>--query=<replaceable>type</replaceable></option></term>
- <listitem>
- <para>Query the database for specified type of device data. It needs the
- <option>--path</option> or <option>--name</option> to identify the specified
- device. Valid queries are:
- <command>name</command>, <command>symlink</command>, <command>path</command>,
- <command>env</command>, <command>all</command>.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--path=<replaceable>devpath</replaceable></option></term>
- <listitem>
- <para>The devpath of the device to query.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--name=<replaceable>node</replaceable></option></term>
- <listitem>
- <para>The name of the device node or a symlink to query</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--root</option></term>
- <listitem>
- <para>The udev root directory: <filename>/dev</filename>. If used in conjunction
- with a <command>name</command> or <command>symlink</command> query, the
- query returns the absolute path including the root directory.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--attribute-walk</option></term>
- <listitem>
- <para>Print all sysfs properties of the specified device that can be used
- in udev rules to match the specified device. It prints all devices
- along the chain, up to the root of sysfs that can be used in udev rules.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--export-db</option></term>
- <listitem>
- <para>Export the content of the udev database.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><option>--version</option></term>
- <listitem>
- <para>Print version.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><option>--help</option></term>
- <listitem>
- <para>Print help text.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
+++ /dev/null
-.\" Title: udevmonitor
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: August 2005
-.\" Manual: udevmonitor
-.\" Source: udev
-.\"
-.TH "UDEVMONITOR" "8" "August 2005" "udev" "udevmonitor"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevmonitor - print the kernel and udev event sequence to the console
-.SH "SYNOPSIS"
-.HP 12
-\fBudevmonitor\fR [\fB\-\-environment\fR] [\fB\-\-kernel\fR] [\fB\-\-udev\fR] [\fB\-\-help\fR]
-.SH "DESCRIPTION"
-.PP
-udevmonitor listens to the kernel uevents and events sent out by a udev rule and prints the devpath of the event to the console\. It can be used to analyze the event timing, by comparing the timestamps of the kernel uevent and the udev event\.
-.SH "OPTIONS"
-.PP
-\fB\-\-environment\fR
-.RS 4
-Print the complete environment for all events\. Can be used to compare the kernel supplied and the udev added environment values\.
-.RE
-.PP
-\fB\-\-kernel\fR
-.RS 4
-Print the kernel uevents\.
-.RE
-.PP
-\fB\-\-udev\fR
-.RS 4
-Print the udev event after the rule processing\.
-.RE
-.PP
-\fB\-\-help\fR
-.RS 4
-Print usage\.
-.RE
-.SH "AUTHOR"
-.PP
-Written by Kay Sievers
-<kay\.sievers@vrfy\.org>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
return NULL;
}
-int main(int argc, char *argv[])
+int udevmonitor(int argc, char *argv[], char *envp[])
{
struct sigaction act;
int option;
udev = 1;
break;
case 'h':
- printf("Usage: udevmonitor [--environment] [--kernel] [--udev] [--help]\n"
+ printf("Usage: udevadm monitor [--environment] [--kernel] [--udev] [--help]\n"
" --env print the whole event environment\n"
" --kernel print kernel uevents\n"
" --udev print udev events\n"
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevmonitor</title>
- <refentry>
- <refentryinfo>
- <title>udevmonitor</title>
- <date>August 2005</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevmonitor</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevmonitor</refname>
- <refpurpose>print the kernel and udev event sequence to the console</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevmonitor</command>
- <arg><option>--environment</option></arg>
- <arg><option>--kernel</option></arg>
- <arg><option>--udev</option></arg>
- <arg><option>--help</option></arg>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>udevmonitor listens to the kernel uevents and events sent out by a udev rule
- and prints the devpath of the event to the console. It can be used to analyze the
- event timing, by comparing the timestamps of the kernel uevent and the udev event.
- </para>
- </refsect1>
-
- <refsect1><title>OPTIONS</title>
- <variablelist>
- <varlistentry>
- <term><option>--environment</option></term>
- <listitem>
- <para>Print the complete environment for all events. Can be used to compare the
- kernel supplied and the udev added environment values.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--kernel</option></term>
- <listitem>
- <para>Print the kernel uevents.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--udev</option></term>
- <listitem>
- <para>Print the udev event after the rule processing.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--help</option></term>
- <listitem>
- <para>Print usage.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
+++ /dev/null
-.\" Title: udevsettle
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: March 2006
-.\" Manual: udevsettle
-.\" Source: udev
-.\"
-.TH "UDEVSETTLE" "8" "March 2006" "udev" "udevsettle"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevsettle - wait until queued kernel/udev events are handled
-.SH "SYNOPSIS"
-.HP 11
-\fBudevsettle\fR [\fB\-\-timeout=\fR\fB\fIseconds\fR\fR]
-.SH "DESCRIPTION"
-.PP
-Waits watching the udev event queue and exits if all current events are handled\.
-.SH "OPTIONS"
-.PP
-\fB\-\-timeout=\fR\fB\fIseconds\fR\fR
-.RS 4
-maximum seconds to wait for the queue to become empty\.
-.RE
-.SH "ENVIRONMENT"
-.PP
-\fBUDEV_LOG\fR
-.RS 4
-Overrides the syslog priority specified in the config file\.
-.RE
-.SH "AUTHOR"
-.PP
-Written by Kay Sievers
-<kay\.sievers@vrfy\.org>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
#define DEFAULT_TIMEOUT 180
#define LOOP_PER_SECOND 20
-
-#ifdef USE_LOG
-void log_message(int priority, const char *format, ...)
-{
- va_list args;
-
- if (priority > udev_log_priority)
- return;
-
- va_start(args, format);
- vsyslog(priority, format, args);
- va_end(args);
-}
-#endif
-
-int main(int argc, char *argv[], char *envp[])
+int udevsettle(int argc, char *argv[], char *envp[])
{
char queuename[PATH_SIZE];
char filename[PATH_SIZE];
dbg("timeout=%i", timeout);
break;
case 'h':
- printf("Usage: udevsettle [--help] [--timeout=<seconds>]\n\n");
+ printf("Usage: udevadm settle [--help] [--timeout=<seconds>]\n\n");
goto exit;
}
}
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevsettle</title>
- <refentry>
- <refentryinfo>
- <title>udevsettle</title>
- <date>March 2006</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevsettle</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevsettle</refname><refpurpose>wait until queued kernel/udev events are handled</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevsettle</command>
- <arg><option>--timeout=<replaceable>seconds</replaceable></option></arg>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>Waits watching the udev event queue and exits if all current events are handled.</para>
- </refsect1>
-
- <refsect1><title>OPTIONS</title>
- <variablelist>
- <varlistentry>
- <term><option>--timeout=<replaceable>seconds</replaceable></option></term>
- <listitem>
- <para>maximum seconds to wait for the queue to become empty.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>ENVIRONMENT</title>
- <variablelist>
- <varlistentry>
- <term><option>UDEV_LOG</option></term>
- <listitem>
- <para>Overrides the syslog priority specified in the config file.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
+++ /dev/null
-.\" Title: udevstart
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: August 2005
-.\" Manual: udevstart
-.\" Source: udev
-.\"
-.TH "UDEVSTART" "8" "August 2005" "udev" "udevstart"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevstart - populate initial device directory
-.SH "SYNOPSIS"
-.HP 10
-\fBudevstart\fR
-.SH "DESCRIPTION"
-.PP
-udevstart scans the kernel exported device information available in sysfs for devices which require a device node to operate and creates the node using the specified udev rules\. udevstart is used to create the initial device directory after system bootup\.
-.SH "AUTHOR"
-.PP
-Written by Harald Hoyer
-<harald@redhat\.com>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevstart</title>
- <refentry>
- <refentryinfo>
- <title>udevstart</title>
- <date>August 2005</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevstart</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevstart</refname><refpurpose>populate initial device directory</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevstart</command>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>udevstart scans the kernel exported device information available in
- sysfs for devices which require a device node to operate and creates the node
- using the specified udev rules. udevstart is used to create the initial
- device directory after system bootup.</para>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Harald Hoyer <email>harald@redhat.com</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
+++ /dev/null
-.\" Title: udevtest
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: August 2005
-.\" Manual: udevtest
-.\" Source: udev
-.\"
-.TH "UDEVTEST" "8" "August 2005" "udev" "udevtest"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevtest - simulate a udev run and print the action to the console
-.SH "SYNOPSIS"
-.HP 21
-\fBudevtest \fR\fB\fIdevice\-path\fR\fR
-.SH "DESCRIPTION"
-.PP
-udevtest simulates a udev run for the given device and prints out the name of the node udev would have created, or the name of the network interface, that would have been renamed\.
-.SH "AUTHOR"
-.PP
-Written by Greg Kroah\-Hartman
-<greg@kroah\.com>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
#include "udev.h"
#include "udev_rules.h"
-
-#ifdef USE_LOG
-void log_message (int priority, const char *format, ...)
-{
- va_list args;
-
- if (priority > udev_log_priority)
- return;
-
- va_start(args, format);
- vprintf(format, args);
- va_end(args);
- printf("\n");
-}
-#endif
-
static int import_uevent_var(const char *devpath)
{
char path[PATH_SIZE];
return rc;
}
-int main(int argc, char *argv[], char *envp[])
+int udevtest(int argc, char *argv[], char *envp[])
{
int force = 0;
const char *action = "add";
force = 1;
break;
case 'h':
- printf("Usage: udevtest OPTIONS <devpath>\n"
+ printf("Usage: udevadm test OPTIONS <devpath>\n"
" --action=<string> set action string\n"
" --subsystem=<string> set subsystem string\n"
" --force don't skip node/link creation\n"
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevtest</title>
- <refentry>
- <refentryinfo>
- <title>udevtest</title>
- <date>August 2005</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevtest</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevtest</refname>
- <refpurpose>simulate a udev run and print the action to the console</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevtest <filename>device-path</filename></command>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>udevtest simulates a udev run for the given device and prints out the
- name of the node udev would have created, or the name of the network interface,
- that would have been renamed.</para>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Greg Kroah-Hartman <email>greg@kroah.com</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
+++ /dev/null
-.\" Title: udevtrigger
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
-.\" Date: March 2006
-.\" Manual: udevtrigger
-.\" Source: udev
-.\"
-.TH "UDEVTRIGGER" "8" "March 2006" "udev" "udevtrigger"
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.SH "NAME"
-udevtrigger - request kernel devices events for coldplug
-.SH "SYNOPSIS"
-.HP 12
-\fBudevtrigger\fR [\fB\-\-verbose\fR] [\fB\-\-dry\-run\fR] [\fB\-\-retry\-failed\fR] [\fB\-\-help\fR] [\fB\-\-action=\fR\fB\fIaction\fR\fR] [\fB\-\-subsystem\-match=\fR\fB\fIsubsystem\fR\fR] [\fB\-\-subsystem\-nomatch=\fR\fB\fIsubsystem\fR\fR] [\fB\-\-attr\-match=\fR\fB\fIattribute=value\fR\fR] [\fB\-\-attr\-nomatch=\fR\fB\fIattribute=value\fR\fR]
-.SH "DESCRIPTION"
-.PP
-Trigger kernel device uevents to replay missing events at system coldplug\.
-.SH "OPTIONS"
-.PP
-\fB\-\-verbose\fR
-.RS 4
-Print the list of devices which will be triggered\.
-.RE
-.PP
-\fB\-\-dry\-run\fR
-.RS 4
-Do not actually trigger the event\.
-.RE
-.PP
-\fB\-\-retry\-failed\fR
-.RS 4
-Trigger only the events which are failed during a previous run\.
-.RE
-.PP
-\fB\-\-action=\fR\fB\fIaction\fR\fR
-.RS 4
-Type of event to be triggered\. The default value is "add"\.
-.RE
-.PP
-\fB\-\-subsystem\-match=\fR\fB\fIsubsystem\fR\fR
-.RS 4
-Trigger events for devices which belong to a matching subsystem\. This option can be specified multiple times and supports shell style pattern matching\.
-.RE
-.PP
-\fB\-\-subsystem\-nomatch=\fR\fB\fIsubsystem\fR\fR
-.RS 4
-Do not trigger events for devices which belong to a matching subsystem\. This option can be specified multiple times and supports shell style pattern matching\.
-.RE
-.PP
-\fB\-\-attr\-match=\fR\fB\fIattribute=value\fR\fR
-.RS 4
-Trigger events for devices with a matching sysfs attribute\. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\. If no value is specified, the existence of the sysfs attribute is checked\. This option can be specified multiple times\.
-.RE
-.PP
-\fB\-\-attr\-nomatch\fR\fB\fIattribute=value\fR\fR
-.RS 4
-Do not trigger events for devices with a matching sysfs attribute\. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\. If no value is specified, the existence of the sysfs attribute is checked\. This option can be specified multiple times\.
-.RE
-.SH "ENVIRONMENT"
-.PP
-\fBUDEV_LOG\fR
-.RS 4
-Overrides the syslog priority specified in the config file\.
-.RE
-.SH "AUTHOR"
-.PP
-Written by Kay Sievers
-<kay\.sievers@vrfy\.org>
-and Hannes Reinecke
-<hare@suse\.de>\.
-.SH "SEE ALSO"
-.PP
-\fBudev\fR(7)
LIST_HEAD(filter_attr_match_list);
LIST_HEAD(filter_attr_nomatch_list);
-#ifdef USE_LOG
-void log_message(int priority, const char *format, ...)
-{
- va_list args;
-
- if (priority > udev_log_priority)
- return;
-
- va_start(args, format);
- vsyslog(priority, format, args);
- va_end(args);
-}
-#endif
-
/* devices that should run last cause of their dependencies */
static int delay_device(const char *devpath)
{
}
}
-int main(int argc, char *argv[], char *envp[])
+int udevtrigger(int argc, char *argv[], char *envp[])
{
int failed = 0;
int option;
name_list_add(&filter_attr_nomatch_list, optarg, 0);
break;
case 'h':
- printf("Usage: udevtrigger OPTIONS\n"
+ printf("Usage: udevadm trigger OPTIONS\n"
" --verbose print the list of devices while running\n"
" --dry-run do not actually trigger the events\n"
" --retry-failed trigger only the events which have been\n"
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<article>
- <section>
- <title>udevtrigger</title>
- <refentry>
- <refentryinfo>
- <title>udevtrigger</title>
- <date>March 2006</date>
- <productname>udev</productname>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>udevtrigger</refentrytitle>
- <manvolnum>8</manvolnum>
- <refmiscinfo class="version"></refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>udevtrigger</refname><refpurpose>request kernel devices events for coldplug</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>udevtrigger</command>
- <arg><option>--verbose</option></arg>
- <arg><option>--dry-run</option></arg>
- <arg><option>--retry-failed</option></arg>
- <arg><option>--help</option></arg>
- <arg><option>--action=<replaceable>action</replaceable></option></arg>
- <arg><option>--subsystem-match=<replaceable>subsystem</replaceable></option></arg>
- <arg><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></arg>
- <arg><option>--attr-match=<replaceable>attribute=value</replaceable></option></arg>
- <arg><option>--attr-nomatch=<replaceable>attribute=value</replaceable></option></arg>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1><title>DESCRIPTION</title>
- <para>Trigger kernel device uevents to replay missing events at system coldplug.</para>
- </refsect1>
-
- <refsect1><title>OPTIONS</title>
- <variablelist>
- <varlistentry>
- <term><option>--verbose</option></term>
- <listitem>
- <para>Print the list of devices which will be triggered.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--dry-run</option></term>
- <listitem>
- <para>Do not actually trigger the event.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--retry-failed</option></term>
- <listitem>
- <para>Trigger only the events which are failed during a previous run.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--action=<replaceable>action</replaceable></option></term>
- <listitem>
- <para>Type of event to be triggered. The default value is "add".</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--subsystem-match=<replaceable>subsystem</replaceable></option></term>
- <listitem>
- <para>Trigger events for devices which belong to a matching subsystem. This option
- can be specified multiple times and supports shell style pattern matching.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
- <listitem>
- <para>Do not trigger events for devices which belong to a matching subsystem. This option
- can be specified multiple times and supports shell style pattern matching.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--attr-match=<replaceable>attribute=value</replaceable></option></term>
- <listitem>
- <para>Trigger events for devices with a matching sysfs attribute. If a value is specified
- along with the attribute name, the content of the attribute is matched against the given
- value using shell style pattern matching. If no value is specified, the existence of the
- sysfs attribute is checked. This option can be specified multiple times.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--attr-nomatch<replaceable>attribute=value</replaceable></option></term>
- <listitem>
- <para>Do not trigger events for devices with a matching sysfs attribute. If a value is
- specified along with the attribute name, the content of the attribute is matched against
- the given value using shell style pattern matching. If no value is specified, the existence
- of the sysfs attribute is checked. This option can be specified multiple times.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>ENVIRONMENT</title>
- <variablelist>
- <varlistentry>
- <term><option>UDEV_LOG</option></term>
- <listitem>
- <para>Overrides the syslog priority specified in the config file.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1><title>AUTHOR</title>
- <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email> and
- Hannes Reinecke <email>hare@suse.de</email>.</para>
- </refsect1>
-
- <refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry>
- <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
- </citerefentry></para>
- </refsect1>
- </refentry>
- </section>
-</article>
projects / systemd / commitdiff