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 74 75 76 77 78 79 80
|
.Dd Mon, 06 Feb 2006 17:42:25 +0100
.Dt INPUTLIRCD 8
.Sh NAME
.Nm inputlircd
.Nd zeroconf LIRC daemon using input event devices
.Sh SYNOPSIS
.Nm
.Op Fl d Ar socket
.Op Fl f
.Op Fl m Ar keycode
.Op Fl u Ar username
.Ar device
.Op Ar device Li ...
.Sh DESCRIPTION
.Nm
is a small LIRC daemon that reads from
.Pa /dev/input/event Ns X
devices and sends the received keycodes to connecting LIRC clients.
.Nm
needs no configuration,
it uses the standardised names for the keycodes as used by the kernel.
Many USB remote controls that present HID devices, as well as multimedia keyboards
should work out of the box.
.Pp
.Nm
expects a list of input event devices as commandline parameters.
It will only read events from those devices.
.Sh OPTIONS
.Bl -tag -width flag
.It Fl d Ar socket
Location of the UNIX socket to which LIRC clients can connect.
The default is
.Pa /dev/lircd .
.It Fl f
Run in the foreground.
.It Fl g
Grab the input device(s).
This gives
.Nm
exclusive access to the input devices and stops events from propagating any further.
.It Fl m Ar keycode
Minimum keycode to send to LIRC clients.
Keycodes lower than this number are filtered out.
The default is 88, this filters out the alphanumeric section and the keypad section of normal keyboards,
but allows all extended keys.
The rationale is that clients should not be able to grab normal keypresses, this could be a security risk.
.It Fl u Ar username
Set user and group id to that of
.Ar username
after opening the devices and UNIX socket as root.
The default is nobody.
.It Ar device
One or more input event devices.
If you want to use
.Nm
to process multimedia keys on the keyboard,
then
.Pa /dev/input/event0
is the most likely choice.
If you have other input devices, such as USB remote controllers that act like a HID device,
then you probably need one of the other event devices present.
See
.Pa /proc/bus/input/devices
for a list of available input devices.
If unsure, you can add all available input event devices.
.El
.Sh FILES
.Bl -tag -width indent
.It Pa /dev/lircd
Default location of the UNIX socket to which LIRC clients can connect.
.It Pa /dev/input/event Ns X
The kernel input layer's event device files.
.It Pa /proc/bus/input/devices
List of all input devices.
.El
.Sh SEE ALSO
.Xr irw 1 ,
.Xr input-events 8 ,
.Xr setkeycodes 8 ,
.Pa /usr/include/linux/input.h .
|