Package: udev-monitor
udev_monitorMonitor linux udev events and execute actions on detectionDesigned to execute actions when USB devices are plugged-in / removedudev_monitor works with Linux udev and monitors it's events.
Upon a specific event for a given device (in VENDOR_ID:PRODUCT_ID format), it will execute an action.udev_monitor has been used to:Re-attach USB devices to virtual machines after they're unplugged - plugged in againRun a full USB reset when device is plugged in (fixes some of the USB UPS that identify as Cypress Semiconductor USB to Serial)Setuppip install udev_monitorQuickstart exampleThis is a realworld example to detect most USB UPS and execute a script upon plug-in.Run script/usr/local/bin/restart_nut_driver.shwith argument0665:5161everytime USB device with vendor id 0665 and product id 5161 is added or removedudev_monitor --devices 0665:5161 --udev-actions add,remove --filters=usb --action /usr/local/bin/restart_nut_driver.shFull usage--devices           List of comma separated devices to monitor. Example:
                    '0665:5161, 8086:1234'
                    If no devices are given, all devices are monitored.
--udev-actions      List of udev events which should trigger and action
                    Valid actions are: 'add', 'remove', 'change', 'online', 'offline'. Defaults to 'add, change, online'
--filters           List of comma separated udev monitor filters. Filters are applied with OR logic. Example:
                    'usb,tty'
--action            Path to script. Script will get detected device as only argument.
--timeout           Maximum execution time for script
--config            Optional path to config fileOptional configuration file layout[UDEV_MONITOR]
devices = '0665:5161'
filters = 'usb'
action = '/path/to/script.sh'
udev_events = 'add'
timeout = 3600Setting monitor up as a servicecopy filescripts/udev_monitor@.serviceto/etc/systemd/systemReload daemonsCreate configuration file in/etc/udev_monitorfrom example config inscripts/udev_monitor.conf.exampleLaunch serviceExample:cp scripts/udev_monitor\@.service to /etc/systemd/system
systemctl daemon-reload

mkdir /etc/udev_monitor
cat << EOF > /etc/udev_monitor/udev_monitor1.conf
devices = '0665:5161'
filters = 'usb'
action = '/path/to/script.sh'
udev_events = 'add'
timeout = 3600
EOF

systemctl enable --now udev_monitor@udev_monitor1.confYou can launch multiple udev_monitor instances by creating multiple conf files and loading them with:systemctl enable --now udev_monitor@umy_ups.conf
systemctl enable --now udev_monitor@my_modem.conf
systemctl enable --now udev_monitor@my_harddrive.confFurther examplesAutomatically attach an USB device (4G modem) to a KVM virtual machine with libvirt and udev_monitorLet's imagine we have a Sierra 4G model that identifies as 1199:9097, and we would like to attach it to VM modem.vm.localGrab yourself a copy of usb_reset viapip install usb_resetCreate the following script as/usr/local/bin/attach_modem.shand make it executable withchmod +x /usr/local/bin/attach_modem.sh#!/usr/bin/env bash

# /usr/local/bin/usb_reset.py --reset-device --device 1199:9071

virsh detach-device sms.badmin.local /root/4G_modem.xml
virsh attach-device sms.badmin.local /root/4G_modem.xmlCreate the file/root/4G_modem.xmlcontaining:<hostdev mode='subsystem' type='usb' managed='yes'>
      <source>
        <vendor id='0x1199'/>
        <product id='0x9071'/>
      </source>
    </hostdev>Now we must execute that script everytime the USB 4G modem is plugged-in, so we get to re-attach it to the VM.In order to do so, let's create the following conf file in/etc/udev_monitor/modem.conf[UDEV_MONITOR]
devices = 1199:9071
filters = usb
action = /usr/local/bin/attach_modem.sh
udev_events = add
timeout = 300Now let's create a systemd service by copyingudev_monitor@.servicefrom this git repo to/etc/systemd/systemOnce this is done, we just can activate the service withsystemctl enable --now udev_monitor@modem.confReset a lawless UPS USBSome of the USB uninterrupted power supplies (smaller devices) have a quite unreliable USB/Serial interface.
Sometimes it's needed to restart the usb port for the device to work properly.In that case, we can use udev_monitor to trigger a usb reset on device plug-in.