Provided by: udev_079-0ubuntu34_i386 bug

NAME

       udevplug - device cold-plugging tool

SYNOPSIS

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

       udevplug -W

DESCRIPTION

       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.

USAGE

       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.

OPTIONS

       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.

SEE ALSO

       udev(8) udevd(8)

AUTHORS

       Scott James Remnant <scott@ubuntu.com>