File: th-cmd.pod

package info (click to toggle)
triggerhappy 0.5.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 264 kB
  • sloc: ansic: 1,449; sh: 81; makefile: 53
file content (73 lines) | stat: -rw-r--r-- 1,946 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
=pod

=head1 NAME

th-cmd -- triggerhappy commander

=head1 SYNOPSIS

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

=head1 DESCRIPTION

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

=head1 OPTIONS

=over

=item B<--socket> F<socket>

The socket file opened by the running triggerhappy daemon instance.

=item B<--add> F<< <devices...> >>

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

=item B<--remove> F<< <devices...> >>

Remove specified devices from the running daemon.

=item B<--clear>

Remove all devices from the running daemon.

=item B<--udev>

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

=item B<--disable>

Disable the execution of triggers.

=item B<--enable>

Re-enable the execution of triggers.

=item B<--mode> I<< <newmode> >>

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

=item B<--quit>

Terminate the triggerhappy daemon.

=item B<--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.

=item B<--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.

=item B<--tag> F<foo>

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

=back

=head1 AUTHOR

Stefan Tomanek E<lt>stefan.tomanek+th@wertarbyte.deE<gt>