Add a kbdmux(4) manual page (taken from FreeBSD).
[dragonfly.git] / share / man / man4 / kbdmux.4
blob975ed9685efd03fc364488e8e2d8b18dccaafc11
1 .\" $Id: kbdmux.4,v 1.1 2005/07/14 20:32:10 max Exp $
2 .\" $FreeBSD: src/share/man/man4/kbdmux.4,v 1.5 2006/05/17 09:33:06 phk Exp $
3 .\"
4 .Dd September 12, 2009
5 .Os
6 .Dt KBDMUX 4
7 .Sh NAME
8 .Nm kbdmux
9 .Nd "keyboard multiplexer"
10 .Sh SYNOPSIS
11 To compile this driver into the kernel,
12 place the following line in your
13 kernel configuration file:
14 .Bd -ragged -offset indent
15 .Cd "device kbdmux"
16 .Pp
17 Alternatively, to load the driver as a
18 module at boot time, place the following line in
19 .Xr loader.conf 5 :
20 .Bd -literal -offset indent
21 kbdmux_load="YES"
22 .Ed
23 .\".Pp
24 .\"In
25 .\".Pa /boot/device.hints :
26 .\".Cd hint.kbdmux.0.disabled="1"
27 .Sh DESCRIPTION
28 The
29 .Nm
30 keyboard driver provides support for basic keyboard multiplexing.
31 It is built around the idea of a
32 .Dq "super keyboard" .
33 The
34 .Nm
35 driver
36 acts as a master keyboard consuming input from all slave keyboards attached to
37 it.
38 .Pp
39 Slave keyboards can be attached to or detached from the
40 .Nm
41 keyboard driver with the
42 .Xr kbdcontrol 1
43 utility.
44 .Sh SEE ALSO
45 .Xr kbdcontrol 1 ,
46 .Xr atkbd 4 ,
47 .Xr syscons 4 ,
48 .Xr ukbd 4
49 .Sh CAVEATS
50 The
51 .Nm
52 keyboard driver switches all slave keyboards into
53 .Dv K_RAW
54 mode.
55 Thus all slave keyboards attached to the
56 .Nm
57 keyboard share the same state.
58 The
59 .Nm
60 keyboard is logically equivalent to one keyboard with lots of duplicated keys.
61 .Sh HISTORY
62 The
63 .Nm
64 module was implemented in
65 .Fx 6.0 .
66 .Pp
67 It was imported into
68 .Dx 2.3 .
69 .Sh AUTHORS
70 .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com