2024-05-23 21:12:44 +03:00
|
|
|
Keymap file description
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
The keymap files are used by the xrdp login screen, and also when
|
|
|
|
sending keyboard input to a VNC server.
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2014-01-18 20:48:16 +04:00
|
|
|
The names of the files are of the format;
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2024-05-23 21:12:44 +03:00
|
|
|
km-xxxxxxxx.toml
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2016-10-11 04:59:54 +03:00
|
|
|
where the xxxxxxxx is replaced by the hex number of the layout of interest.
|
2014-01-18 20:44:08 +04:00
|
|
|
|
2024-05-23 22:04:29 +03:00
|
|
|
The contents of the files are documented in xrdp-km.toml(5)
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2024-05-23 22:04:29 +03:00
|
|
|
See also xrdp-genkeymap(8) which describes the utility used to
|
|
|
|
generate these files.
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2024-05-23 21:12:44 +03:00
|
|
|
Creating a new file
|
|
|
|
-------------------
|
2014-01-18 20:44:08 +04:00
|
|
|
|
2024-05-23 21:12:44 +03:00
|
|
|
To create a new file:-
|
|
|
|
1) Start an X server
|
|
|
|
2) Use the 'setxkbmap' command to get the keyboard configured
|
2024-05-23 22:04:29 +03:00
|
|
|
for the X server.
|
2024-05-23 21:12:44 +03:00
|
|
|
3) Run the 'xrdp-genkeymap' command to extract the keyboard
|
|
|
|
mappings
|
|
|
|
|
2024-05-23 22:04:29 +03:00
|
|
|
Example: ./xrdp-genkeymap ./km-00000409.toml
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2024-05-23 22:04:29 +03:00
|
|
|
4) Copy the generated file to /etc/xrdp/
|
2009-08-12 10:33:55 +04:00
|
|
|
|
2024-05-23 21:12:44 +03:00
|
|
|
Using the X server of your current session may not be a good idea, as
|
|
|
|
session and window managers can interfere with key bindings. A good option
|
|
|
|
is to use an 'Xvfb' dummy X server to do this.
|
|
|
|
|
2024-05-23 22:04:29 +03:00
|
|
|
Getting a file added to xrdp
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
The file dump-keymaps.sh in this directory is used to auto-generate
|
|
|
|
all keymap files. It runs on Linux currently, but will generate
|
|
|
|
keymap files suitable for any xrdp platform.
|
|
|
|
|
|
|
|
1) Add a line towards the end of this file which causes your mapping to
|
|
|
|
be generated. Use the other lines in this file as a guide.
|
|
|
|
2) Run the dump-keymaps.sh script to generate a new file in
|
|
|
|
instfiles/
|
|
|
|
3) Add your mapping to the list in instfiless/Makefile.am
|
|
|
|
4) Submit a pull request to the project containing the above three
|
|
|
|
changes.
|