keytables(4)							   File Formats 						      keytables(4)

NAME

       keytables - keyboard table descriptions for loadkeys and dumpkeys

DESCRIPTION

       These  files are used by loadkeys(1) to modify the translation tables used by the keyboard streams module and generated from those transla-
       tion tables. See loadkeys(1).

       Any line in the file beginning with # is a comment, and is ignored. # is treated specially only at the beginning of a line.

       Other lines specify the values to load into the tables for a particular keystation.  The format is either:

	 key number list_of_entries

       or

	 swap number1 with number2

       or

	 key number1 same as number2

       or a blank line, which is ignored.

	 key number list_of_entries

       sets the entries for keystation number from the list given.  An entry in that list is of the form

	 tablename code

       where tablename is the name of a particular translation table, or all. The translation tables are:

       base	entry when no shifts are active

       shift	entry when "Shift" key is down

       caps	entry when "Caps Lock" is in effect

       ctrl	entry when "Control" is down

       altg	entry when "Alt Graph" is down

       numl	entry when "Num Lock" is in effect

       up	entry when a key goes up

       All tables other than up refer to the action generated when a key goes down.  Entries in the up table are used only for shift  keys,  since
       the  shift in question goes away when the key goes up, except for keys such as "Caps Lock" or "Num Lock"; the keyboard streams module makes
       the key look as if it were a latching key.

       A table name of all indicates that the entry for all tables should be set to the specified value, with the following exception: for entries
       with a value other than hole, the entry for the numl table should be set to nonl, and the entry for the up table should be set to nop.

       The code specifies the effect of the key in question when the specified shift key is down. A code consists of either:

	   o	  A  character, which indicates that the key should generate the given character.  The character can either be a single character,
		  a single character preceded by ^ which refers to a "control character" (for instance, ^c is control-C), or a	C-style  character
		  constant  enclosed in single quote characters ('), which can be expressed with C-style escape sequences such as 
 for RETURN or
		  00 for the null character.	Note that the single character may be any character in an 8-bit character set, such as ISO 8859/1.

	   o	  A string, consisting of a list of characters enclosed in double quote characters ("). Note that the  use  of	the  double  quote
		  character means that a code of double quote must be enclosed in single quotes.

	   o	  One of the following expressions:

		  shiftkeys+leftshift

		      the key is to be the left-hand "Shift" key

		  shiftkeys+rightshift

		      the key is to be the right-hand "Shift" key

		  shiftkeys+leftctrl

		      the key is to be the left-hand "Control" key

		  shiftkeys+rightctrl

		      the key is to be the right-hand "Control" key

		  shiftkeys+alt

		      the key is to be the "Alt" shift key

		  shiftkeys+altgraph

		      the key is to be the "Alt Graph" shift key

		  shiftkeys+capslock

		      the key is to be the "Caps Lock" key

		  shiftkeys+shiftlock

		      the key is to be the "Shift Lock" key

		  shiftkeys+numlock

		      the key is to be the "Num Lock" key

		  buckybits+systembit

		      the key is to be the "Stop" key in SunView; this is normally the L1 key, or the SETUP key on the VT100 keyboard

		  buckybits+metabit

		      the  key	is to be the "meta" key. That is, the "Left" or "Right" key on a Sun-2 or Sun-3 keyboard or the "diamond" key on a
		      Sun-4 keyboard

		  compose

		      the key is to be the "Compose" key

		  ctrlq

		      on the "VT100" keyboard, the key is to transmit the control-Q character (this would be the entry for the "Q" key in the ctrl
		      table)

		  ctrls

		      on the "VT100" keyboard, the key is to transmit the control-S character (this would be the entry for the "S" key in the ctrl
		      table)

		  noscroll

		      on the "VT100" keyboard, the key is to be the "No Scroll" key

		  string+uparrow

		      the key is to be the "up arrow" key

		  string+downarrow

		      the key is to be the "down arrow" key

		  string+leftarrow

		      the key is to be the "left arrow" key

		  string+rightarrow

		      the key is to be the "right arrow" key

		  string+homearrow

		      the key is to be the "home" key

		  fa_acute

		      the key is to be the acute accent "floating accent" key

		  fa_cedilla

		      the key is to be the cedilla "floating accent" key

		  fa_cflex

		      the key is to be the circumflex "floating accent" key

		  fa_grave

		      the key is to be the grave accent "floating accent" key

		  fa_tilde

		      the key is to be the tilde "floating accent" key

		  fa_umlaut

		      the key is to be the umlaut "floating accent" key

		  nonl

		      this is used only in the Num Lock table; the key is not to be affected by the state of Num Lock

		  pad0

		      the key is to be the "0" key on the numeric keypad

		  pad1

		      the key is to be the "1" key on the numeric keypad

		  pad2

		      the key is to be the "2" key on the numeric keypad

		  pad3

		      the key is to be the "3" key on the numeric keypad

		  pad4

		      the key is to be the "4" key on the numeric keypad

		  pad5

		      the key is to be the "5" key on the numeric keypad

		  pad6

		      the key is to be the "6" key on the numeric keypad

		  pad7

		      the key is to be the "7" key on the numeric keypad

		  pad8

		      the key is to be the "8" key on the numeric keypad

		  pad9

		      the key is to be the "9" key on the numeric keypad

		  paddot

		      the key is to be the "." key on the numeric keypad

		  padenter

		      the key is to be the "Enter" key on the numeric keypad

		  padplus

		      the key is to be the "+" key on the numeric keypad

		  padminus

		      the key is to be the "-" key on the numeric keypad

		  padstar

		      the key is to be the "*" key on the numeric keypad

		  padslash

		      the key is to be the "/" key on the numeric keypad

		  padequal

		      the key is to be the "=" key on the numeric keypad

		  padsep

		      the key is to be the "," (separator) key on the numeric keypad

		  lf(n)

		      the key is to be the left-hand function key n

		  rf(n)

		      the key is to be the right-hand function key n

		  tf(n)

		      the key is to be the top function key n

		  bf(n)

		      the key is to be the "bottom" function key n

		  nop

		      the key is to do nothing

		  error

		      this code indicates an internal error; to be used only for keystation 126, and must be used there

		  idle

		      this code indicates that the keyboard is idle (that is, has no keys down); to be used only for all entries  other  than  the
		      numl and up table entries for keystation 127, and must be used there

		  oops

		      this key exists, but its action is not defined; it has the same effect as nop

		  reset

		      this  code  indicates  that the keyboard has just been reset; to be used only for the up table entry for keystation 127, and
		      must be used there.

		  swap number1 with number2

		      exchanges the entries for keystations number1 and number2.

		  key number1 same as number2

		      sets the entries for keystation number1 to be the same as those for keystation number2. If the file does not specify entries
		      for  keystation  number2,  the  entries  currently  in  the translation table are used; if the file does specify entries for
		      keystation number2, those entries are used.

EXAMPLES

       Example 1 Example of setting multiple keystations.

       The following entry sets keystation 15 to be a "hole" (that is, an entry indicating that there is no keystation 15); sets keystation 30	to
       do  nothing when Alt Graph is down, generate "!" when Shift is down, and generate "1" under all other circumstances; and sets keystation 76
       to be the left-hand Control key.

	 key 15   all hole
	 key 30   base 1 shift ! caps 1 ctrl 1 altg nop
	 key 76   all shiftkeys+leftctrl up shiftkeys+leftctrl

       Example 2 Exchange DELETE and BACKSPACE keys

       The following entry exchanges the Delete and Back Space keys on the Type 4 keyboard:

	 swap 43 with 66

       Keystation 43 is normally the Back Space key, and keystation 66 is normally the Delete key.

       Example 3 Disable CAPS LOCK key

       The following entry disables the Caps Lock key on the Type 3 and U.S. Type 4 keyboards:

	 key 119 all nop

       Example 4 Standard translation tables for the U.S. Type 4 keyboard

       The following specifies the standard translation tables for the U.S. Type 4 keyboard:

	 key 0	  all hole
	 key 1	  all buckybits+systembit up buckybits+systembit
	 key 2	  all hole
	 key 3	  all lf(2)
	 key 4	  all hole
	 key 5	  all tf(1)
	 key 6	  all tf(2)
	 key 7	  all tf(10)
	 key 8	  all tf(3)
	 key 9	  all tf(11)
	 key 10   all tf(4)
	 key 11   all tf(12)
	 key 12   all tf(5)
	 key 13   all shiftkeys+altgraph up shiftkeys+altgraph
	 key 14   all tf(6)
	 key 15   all hole
	 key 16   all tf(7)
	 key 17   all tf(8)
	 key 18   all tf(9)
	 key 19   all shiftkeys+alt up shiftkeys+alt
	 key 20   all hole
	 key 21   all rf(1)
	 key 22   all rf(2)
	 key 23   all rf(3)
	 key 24   all hole
	 key 25   all lf(3)
	 key 26   all lf(4)
	 key 27   all hole
	 key 28   all hole
	 key 29   all ^[
	 key 30   base 1 shift ! caps 1 ctrl 1 altg nop
	 key 31   base 2 shift @ caps 2 ctrl ^@ altg nop
	 key 32   base 3 shift # caps 3 ctrl 3 altg nop
	 key 33   base 4 shift $ caps 4 ctrl 4 altg nop
	 key 34   base 5 shift % caps 5 ctrl 5 altg nop
	 key 35   base 6 shift ^ caps 6 ctrl ^^ altg nop
	 key 36   base 7 shift & caps 7 ctrl 7 altg nop
	 key 37   base 8 shift * caps 8 ctrl 8 altg nop
	 key 38   base 9 shift ( caps 9 ctrl 9 altg nop
	 key 39   base 0 shift ) caps 0 ctrl 0 altg nop
	 key 40   base - shift _ caps - ctrl ^_ altg nop
	 key 41   base = shift + caps = ctrl = altg nop
	 key 42   base ` shift ~ caps ` ctrl ^^ altg nop
	 key 43   all ''
	 key 44   all hole
	 key 45   all rf(4) numl padequal
	 key 46   all rf(5) numl padslash
	 key 47   all rf(6) numl padstar
	 key 48   all bf(13)
	 key 49   all lf(5)
	 key 50   all bf(10) numl padequal
	 key 51   all lf(6)
	 key 52   all hole
	 key 53   all '	'
	 key 54   base q shift Q caps Q ctrl ^Q altg nop
	 key 55   base w shift W caps W ctrl ^W altg nop
	 key 56   base e shift E caps E ctrl ^E altg nop
	 key 57   base r shift R caps R ctrl ^R altg nop
	 key 58   base t shift T caps T ctrl ^T altg nop
	 key 59   base y shift Y caps Y ctrl ^Y altg nop
	 key 60   base u shift U caps U ctrl ^U altg nop
	 key 61   base i shift I caps I ctrl '	' altg nop
	 key 62   base o shift O caps O ctrl ^O altg nop
	 key 63   base p shift P caps P ctrl ^P altg nop
	 key 64   base [ shift { caps [ ctrl ^[ altg nop
	 key 65   base ] shift } caps ] ctrl ^] altg nop
	 key 66   all '177'
	 key 67   all compose
	 key 68   all rf(7) numl pad7
	 key 69   all rf(8) numl pad8
	 key 70   all rf(9) numl pad9
	 key 71   all bf(15) numl padminus
	 key 72   all lf(7)
	 key 73   all lf(8)
	 key 74   all hole
	 key 75   all hole
	 key 76   all shiftkeys+leftctrl up shiftkeys+leftctrl
	 key 77   base a shift A caps A ctrl ^A altg nop
	 key 78   base s shift S caps S ctrl ^S altg nop
	 key 79   base d shift D caps D ctrl ^D altg nop
	 key 80   base f shift F caps F ctrl ^F altg nop
	 key 81   base g shift G caps G ctrl ^G altg nop
	 key 82   base h shift H caps H ctrl '' altg nop
	 key 83   base j shift J caps J ctrl '
' altg nop
	 key 84   base k shift K caps K ctrl 'v' altg nop
	 key 85   base l shift L caps L ctrl ^L altg nop
	 key 86   base ; shift : caps ; ctrl ; altg nop
	 key 87   base ''' shift '"' caps ''' ctrl ''' altg nop
	 key 88   base '\' shift | caps '\' ctrl ^ altg nop
	 key 89   all '
'
	 key 90   all bf(11) numl padenter
	 key 91   all rf(10) numl pad4
	 key 92   all rf(11) numl pad5
	 key 93   all rf(12) numl pad6
	 key 94   all bf(8) numl pad0
	 key 95   all lf(9)
	 key 96   all hole
	 key 97   all lf(10)
	 key 98   all shiftkeys+numlock
	 key 99   all shiftkeys+leftshift up shiftkeys+leftshift
	 key 100  base z shift Z caps Z ctrl ^Z altg nop
	 key 101  base x shift X caps X ctrl ^X altg nop
	 key 102  base c shift C caps C ctrl ^C altg nop
	 key 103  base v shift V caps V ctrl ^V altg nop
	 key 104  base b shift B caps B ctrl ^B altg nop
	 key 105  base n shift N caps N ctrl ^N altg nop
	 key 106  base m shift M caps M ctrl '
' altg nop
	 key 107  base , shift < caps , ctrl , altg nop
	 key 108  base . shift > caps . ctrl . altg nop
	 key 109  base / shift ? caps / ctrl ^_ altg nop
	 key 110  all shiftkeys+rightshift up shiftkeys+rightshift
	 key 111  all '
'
	 key 112  all rf(13) numl pad1
	 key 113  all rf(14) numl pad2
	 key 114  all rf(15) numl pad3
	 key 115  all hole
	 key 116  all hole
	 key 117  all hole
	 key 118  all lf(16)
	 key 119  all shiftkeys+capslock
	 key 120  all buckybits+metabit up buckybits+metabit
	 key 121  base ' ' shift ' ' caps ' ' ctrl ^@ altg ' '
	 key 122  all buckybits+metabit up buckybits+metabit
	 key 123  all hole
	 key 124  all hole
	 key 125  all bf(14) numl padplus
	 key 126  all error numl error up hole
	 key 127  all idle numl idle up reset

SEE ALSO

       loadkeys(1)

SunOS 5.11							    18 Feb 2003 						      keytables(4)