NAME¶
th-cmd -- triggerhappy commander
SYNOPSIS¶
th-cmd --socket
<socket> [
--passfd] [
--tag
<foo>] [
--clear|
--enable|
--disable|
--mode
<mode>|
--quit|
--udev|
--add
<devices...>|
--remove <devices...>]
DESCRIPTION¶
This program is used to issue commands to a running triggerhappy daemon. It
utilizes an unix domain socket bound by the daemon.
OPTIONS¶
- --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.
AUTHOR¶
Stefan Tomanek <stefan.tomanek+th@wertarbyte.de>