logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

setkeycodes.8 (2330B)

    

  1. .\" @(#)man/man8/setkeycodes.8	1.0 Nov  8 22:30:48 MET 1994
  2. .TH SETKEYCODES 8 "8 Nov 1994" "kbd"
  3. .SH NAME
  4. setkeycodes \- load kernel scancode-to-keycode mapping table entries
  5. .SH SYNOPSIS
  6. .B setkeycodes
  7. .I "scancode keycode ..."
  8. .SH DESCRIPTION
  9. The
  10. .I setkeycodes
  11. command reads its arguments two at a time, each pair of arguments
  12. consisting of a scancode (given in hexadecimal) and a keycode (given
  13. in decimal). For each such pair, it tells the kernel keyboard driver
  14. to map the specified scancode to the specified keycode.
  16. This command is useful only for people with slightly unusual keyboards,
  17. that have a few keys which produce scancodes that the kernel does not
  18. recognize.
  20. .SH THEORY
  21. The usual PC keyboard produces a series of scancodes for each
  22. key press and key release. (Scancodes are shown by
  23. \fBshowkey \-s\fP, see
  24. .BR showkey (1)
  25. ) The kernel parses this stream of scancodes, and converts it to
  26. a stream of keycodes (key press/release events).
  27. (Keycodes are shown by \fBshowkey\fP.)
  28. Apart from a few scancodes with special meaning, and apart from
  29. the sequence produced by the Pause key, and apart from shiftstate
  30. related scancodes, and apart from the key up/down bit,
  31. the stream of scancodes consists of unescaped
  32. scancodes xx (7 bits) and escaped scancodes e0 xx (8+7 bits).
  33. To these scancodes or scancode pairs, a corresponding keycode can be
  34. assigned (in the range 1-127).
  35. For example, if you have a Macro key that produces e0 6f according
  36. to
  37. .BR showkey (1),
  38. the command
  39. .RS
  40. .B "setkeycodes e06f 112"
  41. .RE
  42. will assign the keycode 112 to it, and then
  43. .BR loadkeys (1)
  44. can be used to define the function of this key.
  45. .LP
  46. Some older kernels might hardwire a low scancode range to the
  47. equivalent keycodes; setkeycodes will fail when you try to remap
  48. these.
  50. .SH "2.6 KERNELS"
  51. In 2.6 kernels key codes lie in the range 1-255, instead of 1-127.
  52. (It might be best to confine oneself to the range 1-239.)
  53. .LP
  54. In 2.6 kernels raw mode, or scancode mode, is not very raw at all.
  55. The code returned by showkey \-s will change after use of setkeycodes.
  56. A kernel bug. See also
  57. .BR showkey (1).
  58. .SH OPTIONS
  59. None.
  60. .SH BUGS
  61. The keycodes of X have nothing to do with those of Linux.
  62. Unusual keys can be made visible under Linux, but not under X.
  63. .SH "SEE ALSO"
  64. .BR dumpkeys (1),
  65. .BR loadkeys (1),
  66. .BR showkey (1),
  67. .BR getkeycodes (8)