udevplug - device cold-plugging tool

udevplug [-Iattr=value]... [-Xattr=value]... [-b] [-c] [-Bbus]... [-Cclass]... [-F] [-s] [-v] [devpath]...

udevplug -W

udevplug is a tool to ease the cold-plugging of system devices. It examines sysfs for devices already present on the system, for which the events may have been missed, and writes to the uevent attribute to cause the kernel to replay the event. It does not process the events themselves, udevd(8) should be run before calling this tool to do that.

Both before and after requesting the events, it waits for the udevd(8) event queue to be empty. This provides some synchrony and prevents most but not all, race conditions.

When called without any arguments udevplug replays the events for all currently connected devices on the system. Options can be given to alter this list, limiting it to devices on a particular bus, in a particular class or those with or without specified attributes.

Any non-option arguments given should be paths to individual devices that need to be replayed, instead of all connected devices.

All options are accumulative and may be specified multiple times.

-Iattr=value only events for those devices for which the attr attribute matches value are replayed. value may include wildcards and globbing, as with the udev(8) configuration file format.

-Xattr=value only events for those devices for which the attr attribute DOES NOT MATCH value are replayed. value may include wildcards and globbing, as with the udev(8) configuration file format.

-b

events for all block devices are replayed.

-c

events for all class devices are replayed.

-Bbus

only events for those devices on the bus bus are replayed.

-Cclass

only events for those devices in the class class are replayed.

-F

causes events for devices that have previously failed to be replayed. When combined with the -B or -C options it acts as a union, rather than an exclusion, e.g. all pci devices and anything previously failed will be replayed.

-s

plugs each device in serial, waiting afterwards for the event to complete before moving on to the next device.

-v

prints the sysfs path of each device being plugged.

-W

causes udev to simply wait for the udevd(8) queue to empty, exiting immediately if there is nothing in the queue. This can not be used in combination with other arguments.

udev(8) udevd(8)

Scott James Remnant <scott@ubuntu.com>