mdoc(7) police: markup, spelling, and grammar fixes.
PR: docs/32955
This commit is contained in:
Ruslan Ermilov
parent
48fd1f38ee
commit
8dc4780698
@ -28,7 +28,7 @@
|
||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
|
||||
.\" THE POSSIBILITY OF SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd April 11, 1999
|
||||
.Dt UKBD 4
|
||||
@ -42,106 +42,105 @@
|
||||
The
|
||||
.Nm
|
||||
driver provides support for keyboards that attach to the USB port.
|
||||
.Nm usb
|
||||
.Xr usb 4
|
||||
and one of
|
||||
.Nm uhci
|
||||
.Xr uhci 4
|
||||
or
|
||||
.Nm ohci
|
||||
.Xr ohci 4
|
||||
must be configured in the kernel as well.
|
||||
.Sh CONFIGURATION
|
||||
By default the keyboard subsystem does not create the appropriate devices yet.
|
||||
By default, the keyboard subsystem does not create the appropriate devices yet.
|
||||
Make sure you reconfigure your kernel with the following option in the kernel
|
||||
config file:
|
||||
.Bd -literal -offset indent
|
||||
options KBD_INSTALL_CDEV
|
||||
.Ed
|
||||
.Pp
|
||||
Go to /dev and make device nodes kbd*:
|
||||
.Bd -literal -offset indent
|
||||
sh MAKEDEV kbd0 kbd1
|
||||
.Ed
|
||||
.Dl "options KBD_INSTALL_CDEV"
|
||||
.Pp
|
||||
Go to
|
||||
.Pa /dev
|
||||
and make device nodes
|
||||
.Pa kbd* :
|
||||
.Pp
|
||||
.Dl "sh MAKEDEV kbd0 kbd1"
|
||||
.Pp
|
||||
If both an AT keyboard as well as USB keyboards are used at the same time, the
|
||||
AT keyboard will appear as kbd0 in /dev.
|
||||
The USB keyboards will be kbd1, kbd2,
|
||||
AT keyboard will appear as
|
||||
.Pa kbd0
|
||||
in
|
||||
.Pa /dev .
|
||||
The USB keyboards will be
|
||||
.Pa kbd1 , kbd2 ,
|
||||
etc.
|
||||
You can see some information about the keyboard with the following command:
|
||||
.Bd -literal -offset indent
|
||||
kbdcontrol -i < /dev/kbd1
|
||||
.Ed
|
||||
.Pp
|
||||
.Dl "kbdcontrol -i < /dev/kbd1"
|
||||
.Pp
|
||||
or load a keymap with
|
||||
.Bd -literal -offset indent
|
||||
kbdcontrol -l keymaps/pt.iso < /dev/kbd1
|
||||
.Ed
|
||||
.Pp
|
||||
.Dl "kbdcontrol -l keymaps/pt.iso < /dev/kbd1"
|
||||
.Pp
|
||||
See
|
||||
.Nm kbcontrol
|
||||
.Xr kbdcontrol 1
|
||||
for more possible options.
|
||||
.Pp
|
||||
You can swap console keyboards by using the command
|
||||
.Bd -literal -offset indent
|
||||
kbdcontrol -k /dev/kbd1
|
||||
.Ed
|
||||
.Pp
|
||||
From this point on onwards the first USB keyboard will be the keyboard
|
||||
.Dl "kbdcontrol -k /dev/kbd1"
|
||||
.Pp
|
||||
From this point on onwards, the first USB keyboard will be the keyboard
|
||||
to be used as the console.
|
||||
.Pp
|
||||
If you want to use a USB keyboard as your default and not use an AT keyboard at
|
||||
all, you will have to remove the
|
||||
.Nm atkbd
|
||||
from the kernel configuration file.
|
||||
.Cd "device atkbd"
|
||||
line from the kernel configuration file.
|
||||
Because of the order of the device
|
||||
initialisation, the USB keyboard will be detected AFTER the console driver
|
||||
initialises itself and you have to explicitly tellthe console
|
||||
initialization, the USB keyboard will be detected
|
||||
.Em after
|
||||
the console driver
|
||||
initializes itself and you have to explicitly tell the console
|
||||
driver to use the existence of the USB keyboard. This can be done in
|
||||
one of the following two ways.
|
||||
.Pp
|
||||
Run the following command as a part of system initialization:
|
||||
.Bd -literal -offset indent
|
||||
kbdcontrol -k /dev/kbd0 < /dev/ttyv0 > /dev/null
|
||||
.Ed
|
||||
.Pp
|
||||
.Dl "kbdcontrol -k /dev/kbd0 < /dev/ttyv0 > /dev/null"
|
||||
.Pp
|
||||
(Note that as the USB keyboard is the only keyboard, it is accessed as
|
||||
/dev/kbd0) or otherwise tell the console driver to periodically look for a
|
||||
.Pa /dev/kbd0 )
|
||||
or otherwise tell the console driver to periodically look for a
|
||||
keyboard by setting a flag in the kernel configuration file:
|
||||
.Bd -literal -offset indent
|
||||
device sc0 at isa? flags 0x100
|
||||
.Ed
|
||||
.Pp
|
||||
.Dl "device sc0 at isa? flags 0x100"
|
||||
.Pp
|
||||
With the above flag, the console driver will try to detect any
|
||||
keyboard in the system if it didn't detect one while it was
|
||||
keyboard in the system if it did not detect one while it was
|
||||
initialized at boot time.
|
||||
.Sh DRIVER CONFIGURATION
|
||||
.Bd -literal -offset indent
|
||||
options KBD_INSTALL_CDEV
|
||||
.Ed
|
||||
.D1 Cd "options KBD_INSTALL_CDEV"
|
||||
.Pp
|
||||
Make the keyboards available through a character device in /dev
|
||||
.Bd -literal -offset indent
|
||||
options UKBD_DFLT_KEYMAP
|
||||
makeoptions "UKBD_DFLT_KEYMAP=fr.iso"
|
||||
.Ed
|
||||
Make the keyboards available through a character device in
|
||||
.Pa /dev .
|
||||
.Pp
|
||||
.D1 Cd options UKBD_DFLT_KEYMAP
|
||||
.D1 Cd makeoptions \&"UKBD_DFLT_KEYMAP=fr.iso"
|
||||
.Pp
|
||||
The above lines will put the French ISO keymap in the ukbd driver.
|
||||
You can specify any keymap in /usr/share/syscons/keymaps with this
|
||||
option.
|
||||
.Bd -literal -offset indent
|
||||
options KBD_DISABLE_KEYMAP_LOADING
|
||||
.Ed
|
||||
You can specify any keymap in
|
||||
.Pa /usr/share/syscons/keymaps
|
||||
with this option.
|
||||
.Pp
|
||||
Don't allow the user to change the keymap.
|
||||
Note that these options also affect the AT keyboard driver
|
||||
.D1 Cd "options KBD_DISABLE_KEYMAP_LOADING"
|
||||
.Pp
|
||||
Do not allow the user to change the keymap.
|
||||
Note that these options also affect the AT keyboard driver,
|
||||
.Xr atkbd 4 .
|
||||
.Sh FILES
|
||||
.Bl -tag -width /dev/kbd0 -compact
|
||||
.Bl -tag -width ".Pa /dev/kbd*" -compact
|
||||
.It Pa /dev/kbd*
|
||||
blocking device nodes
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
.Bd -literal -offset indent
|
||||
device ukbd
|
||||
.Ed
|
||||
.D1 Cd "device ukbd"
|
||||
.Pp
|
||||
Add the
|
||||
.Nm
|
||||
@ -153,7 +152,6 @@ driver to the kernel.
|
||||
.Xr uhci 4 ,
|
||||
.Xr usb 4 ,
|
||||
.Xr config 8
|
||||
.\".Sh HISTORY
|
||||
.Sh AUTHORS
|
||||
.An -nosplit
|
||||
The
|
||||
|
||||
Loading…
Reference in New Issue
Block a user