th-cmd (1)

th-cmd --socket <socket> [--passfd] [--tag <foo>] [--clear|--enable|--disable|--mode <mode>|--quit|--udev|--add <devices...>|--remove <devices...>]

This program is used to issue commands to a running triggerhappy daemon. It utilizes an unix domain socket bound by the daemon.

--socket socket

The socket file opened by the running triggerhappy daemon instance.

--add <devices...>

Instruct the running daemon to open the input devices specified on the command line

--remove <devices...>

Remove specified devices from the running daemon.

--clear

Remove all devices from the running daemon.

--udev

Deduce operation and device name from udev environment (for use in udev rules).

--disable

Disable the execution of triggers.

--enable

Re-enable the execution of triggers.

--mode <newmode>

Change the mode of the triggerhappy daemon to <newmode>. If no new mode is specified, the daemon switches to default mode.

--quit

Terminate the triggerhappy daemon.

--passfd

Instead of instructing the daemon to open the device, open the device and pass the file descriptor to the daemon. This allows the adding of new devices to a daemon having dropped its privileges, however the th-cmd process must have access to the device file.

--grab

Grab the device; the triggerhappy daemon will try to get exclusive access to the device, other applications will not receive the events emitted by it.

--tag foo

Label the added device with the tag <foo>; this can be used to limit the scope of event handlers to a subset of input devices.

Stefan Tomanek <[email protected]>