xref: /aosp_15_r20/external/libxkbcommon/tools/xkbcli-interactive-evdev.1 (revision 2b949d0487e80d67f1fda82db69e101e761f8064)
1*2b949d04SAndroid Build Coastguard Worker.Dd July 27, 2020
2*2b949d04SAndroid Build Coastguard Worker.Dt XKBCLI\-INTERACTIVE\-EVDEV 1
3*2b949d04SAndroid Build Coastguard Worker.Os
4*2b949d04SAndroid Build Coastguard Worker.
5*2b949d04SAndroid Build Coastguard Worker.Sh NAME
6*2b949d04SAndroid Build Coastguard Worker.Nm "xkbcli interactive\-evdev"
7*2b949d04SAndroid Build Coastguard Worker.Nd interactive debugger for XKB keymaps
8*2b949d04SAndroid Build Coastguard Worker.
9*2b949d04SAndroid Build Coastguard Worker.Sh SYNOPSIS
10*2b949d04SAndroid Build Coastguard Worker.Nm
11*2b949d04SAndroid Build Coastguard Worker.Op Ar options
12*2b949d04SAndroid Build Coastguard Worker.
13*2b949d04SAndroid Build Coastguard Worker.Sh DESCRIPTION
14*2b949d04SAndroid Build Coastguard Worker.Nm
15*2b949d04SAndroid Build Coastguard Workeris a commandline tool to interactively debug XKB keymaps by listening to
16*2b949d04SAndroid Build Coastguard Worker.Pa /dev/input/eventX
17*2b949d04SAndroid Build Coastguard Workerevdev devices.
18*2b949d04SAndroid Build Coastguard Worker.
19*2b949d04SAndroid Build Coastguard Worker.Pp
20*2b949d04SAndroid Build Coastguard Worker.Nm
21*2b949d04SAndroid Build Coastguard Workerrequires permission to open the evdev device nodes.
22*2b949d04SAndroid Build Coastguard WorkerThis usually requires being the
23*2b949d04SAndroid Build Coastguard Worker.Dq root
24*2b949d04SAndroid Build Coastguard Workeruser or belonging to the
25*2b949d04SAndroid Build Coastguard Worker.Dq input
26*2b949d04SAndroid Build Coastguard Workergroup.
27*2b949d04SAndroid Build Coastguard Worker.
28*2b949d04SAndroid Build Coastguard Worker.Pp
29*2b949d04SAndroid Build Coastguard WorkerPress the
30*2b949d04SAndroid Build Coastguard Worker.Aq Escape
31*2b949d04SAndroid Build Coastguard Workerkey to exit.
32*2b949d04SAndroid Build Coastguard Worker.
33*2b949d04SAndroid Build Coastguard Worker.Pp
34*2b949d04SAndroid Build Coastguard WorkerThis is a debugging tool, its behavior or output is not guaranteed to be stable.
35*2b949d04SAndroid Build Coastguard Worker.
36*2b949d04SAndroid Build Coastguard Worker.Bl -tag -width Ds
37*2b949d04SAndroid Build Coastguard Worker.It Fl \-help
38*2b949d04SAndroid Build Coastguard WorkerPrint help and exit
39*2b949d04SAndroid Build Coastguard Worker.
40*2b949d04SAndroid Build Coastguard Worker.It Fl \-rules Ar rules
41*2b949d04SAndroid Build Coastguard WorkerThe XKB ruleset
42*2b949d04SAndroid Build Coastguard Worker.
43*2b949d04SAndroid Build Coastguard Worker.It Fl \-model Ar model
44*2b949d04SAndroid Build Coastguard WorkerThe XKB model
45*2b949d04SAndroid Build Coastguard Worker.
46*2b949d04SAndroid Build Coastguard Worker.It Fl \-layout Ar layout
47*2b949d04SAndroid Build Coastguard WorkerThe XKB layout
48*2b949d04SAndroid Build Coastguard Worker.
49*2b949d04SAndroid Build Coastguard Worker.It Fl \-variant Ar variant
50*2b949d04SAndroid Build Coastguard WorkerThe XKB layout variant
51*2b949d04SAndroid Build Coastguard Worker.
52*2b949d04SAndroid Build Coastguard Worker.It Fl \-option Ar options
53*2b949d04SAndroid Build Coastguard WorkerThe XKB options
54*2b949d04SAndroid Build Coastguard Worker.
55*2b949d04SAndroid Build Coastguard Worker.It Fl \-keymap Ar file
56*2b949d04SAndroid Build Coastguard WorkerSpecify a keymap path.
57*2b949d04SAndroid Build Coastguard WorkerThis option is mutually exclusive with the RMLVO options.
58*2b949d04SAndroid Build Coastguard Worker.
59*2b949d04SAndroid Build Coastguard Worker.It Fl \-report\-state\-changes
60*2b949d04SAndroid Build Coastguard WorkerReport changes to the keyboard state
61*2b949d04SAndroid Build Coastguard Worker.
62*2b949d04SAndroid Build Coastguard Worker.It Fl \-enable\-compose
63*2b949d04SAndroid Build Coastguard WorkerEnable Compose functionality
64*2b949d04SAndroid Build Coastguard Worker.
65*2b949d04SAndroid Build Coastguard Worker.It Fl \-consumed\-mode Brq xkb|gtk
66*2b949d04SAndroid Build Coastguard WorkerSet the consumed modifiers mode (default: xkb)
67*2b949d04SAndroid Build Coastguard Worker.
68*2b949d04SAndroid Build Coastguard Worker.It Fl \-without\-x11\-offset
69*2b949d04SAndroid Build Coastguard WorkerDon't add an offset of 8 when converting an evdev keycode to an XKB keycode.
70*2b949d04SAndroid Build Coastguard WorkerYou probably don't want this option.
71*2b949d04SAndroid Build Coastguard Worker.El
72*2b949d04SAndroid Build Coastguard Worker.
73*2b949d04SAndroid Build Coastguard Worker.Sh SEE ALSO
74*2b949d04SAndroid Build Coastguard Worker.Xr xkbcli 1 ,
75*2b949d04SAndroid Build Coastguard Worker.Xr xkbcli\-interactive\-wayland 1 ,
76*2b949d04SAndroid Build Coastguard Worker.Xr xkbcli\-interactive\-x11 1 ,
77*2b949d04SAndroid Build Coastguard Worker.Lk https://xkbcommon.org "The libxkbcommon online documentation"
78