git: 9front

ref: b143811a53bf25824e74b7e6e6c2ee7af8c7a954
dir: /sys/man/1/kbmap/

View raw version
.TH KBMAP 1
.SH NAME
kbmap, kbremap \- show a list of available keyboard maps and switch between them.
.SH SYNOPSIS
.B kbmap
[
.IR file ...
]
.PP
.B kbremap
[
.B -m
.I mod
]
[
.B -k
.I scancode
]
map1 map2 ...
.SH DESCRIPTION
.I Kbmap
shows a single column consisting of the names of keyboard maps for different
alphabets available on the system. With no arguments 
.B kbmap
will look for files in 
.BR /sys/lib/kbmap .
.PP
Clicking the right mouse button will highlight the entry and force the
keyboard mapping defined in the corresponding file to become current
for the system; typing 'q' quits.
.PP
.I Kbremap
reads keyboard events from standard input, filters out a shortcut
to change the keyboard map, and writes the result to standard
output. The shortcut cycles through the keyboard maps provided
as arguments. By default this shortcut is mapped to
.LR Ctrl
+
.LR Space .
The
.B -m
and
.B -k
flags change the default mod and key used respectfully.
.I Mod
is given as a numeric shift layer as understood by
.IR kbdfs (8).
.PP
.I Kbmap
and
.I kbremap
require that the file
.B /dev/kbmap
served by 
.IR kbdfs (8)
exists and is writable.
.SH EXAMPLES
Use
.I kbremap
with
.B /dev/kbdtap
provided by
.IR rio (4):
.IP
.EX
kbremap us de uk </dev/kbdtap >/dev/kbdtap
.EE
.PP
.SH FILES
.B /sys/lib/kbmap/*
.SH SOURCE
.B /sys/src/cmd/kbmap.c
.br
.B /sys/src/cmd/kbremap.c
.SH "SEE ALSO"
.IR kbdfs (8)