usb-ks

USB Killswitch
git clone git://git.laack.co/usb-ks.git
Log | Files | Refs | README | LICENSE

README (824B)


      1 usb-ks
      2 ======
      3 usb-ks is a USB killswitch program. usb-ks executes the specified command on all USB device changes, not just disconnects. When governments seize devices they often use USB devices to exfiltrate data and to ensure systems with FDE don't shutdown. It is thusly evident shutdown behaviors should be initiated on connection and disconnection.
      4 
      5 Requirements
      6 ============
      7 go, libudev, /bin/sh
      8 
      9 Installation
     10 ============
     11 Run the following commands:
     12     git clone git://git.laack.co/usb-ks.git
     13     cd usb-ks
     14     go install
     15 
     16 Optionally:
     17     sudo install ~/go/bin/usb-ks /usr/local/bin/
     18 
     19 Ensure your go installation directory is on your path if you don't perform the optional step.
     20 
     21 Usage
     22 =====
     23 Execute xscreensaver on USB device change:
     24     usb-ks
     25 
     26 Execute arbitrary command on USB device change:
     27     usb-ks {command}