setkey(1) UNIX System V setkey(1)
NAME
setkey - assigns the function keys
SYNOPSIS
setkey keynum string
DESCRIPTION
The setkey command assigns the given ANSI string to be the output of the
computer function key given by keynum. For example, the command:
setkey 1 date
assigns the string date as the output of function key 1. The string can
contain control characters, such as a newline character, and should be
quoted to protect it from processing by the shell. For example, the
command:
setkey 2 "pwd ; lc\n"
assigns the command sequence pwd ; lc to function key 2. Notice how the
newline character is embedded in the quoted string. This causes the
commands to be carried out when function key 2 is pressed. Otherwise,
the Enter key would have to be pressed after pressing the function key,
as in the previous example.
setkey translates ^ into ^^, which, when passed to the screen driver, is
interpreted as a right angle bracket (>), or greater than key.
NOTES
setkey works only on the console keyboard.
The string mapping table is where the function keys are defined. It is
an array of 512 bytes (typedef strmapt) where null terminated strings
can be put to redefine the function keys. The first null terminated
string is assigned to the first string key, the second to the second
string key, and so on. There is one string mapping table per
multiscreen.
Although the size of the setkey string mapping table is 512 bytes, there
is a limit of 30 characters that can be assigned to any individual
function key.
Assigning more than 512 characters to the string mapping table causes the
function key buffer to overflow. When this happens, the sequences sent by
the arrow keys are overwritten, effectively disabling them. Once the
function key buffer overflows, the only way to enable the arrow keys is
to reboot the system.
The table below lists the keynum values for the function keys:
10/89 Page 1
setkey(1) UNIX System V setkey(1)
____________________________________________________________
| Function key keynum| Function key keynum|
|___________________________|_______________________________|
| | |
| F1 1 | Ctrl-F10 34 |
| F2 2 | Ctrl-F11 35 |
| F3 3 | Ctrl-F12 36 |
| F4 4 | Ctrl-Shift-F1 37 |
| F5 5 | Ctrl-Shift-F2 38 |
| F6 6 | Ctrl-Shift-F3 39 |
| F7 7 | Ctrl-Shift-F4 40 |
| F8 8 | Ctrl-Shift-F5 41 |
| F9 9 | Ctrl-Shift-F6 42 |
| F10 10 | Ctrl-Shift-F7 43 |
| F11 11 | Ctrl-Shift-F8 44 |
| F12 12 | Ctrl-Shift-F9 45 |
| Shift-F1 13 | Ctrl-Shift-F10 46 |
| Shift-F2 14 | Ctrl-Shift-F11 47 |
| Shift-F3 15 | Ctrl-Shift-F12 48 |
| Shift-F4 16 | ______________________________|
| Shift-F5 17 | Numeric Key-Pad keynum|
| Shift-F6 18 | ______________________________|
| Shift-F7 19 | 7 49 |
| Shift-F8 20 | 8 50 |
| Shift-F9 21 | 9 51 |
| Shift-F10 22 | - 52 |
| Shift-F11 23 | 4 53 |
| Shift-F12 24 | 5 54 |
| Ctrl-F1 25 | 6 55 |
| Ctrl-F2 26 | + 56 |
| Ctrl-F3 27 | 1 57 |
| Ctrl-F4 28 | 2 58 |
| Ctrl-F5 29 | 3 59 |
| Ctrl-F6 30 | 0 60 |
| Ctrl-F7 31 | |
| Ctrl-F8 32 | |
| Ctrl-F9 33 | |
| | |
|___________________________|_______________________________|
For a table of the escape sequences, see keyboard(7) in the System
Page 2 10/89
setkey(1) UNIX System V setkey(1)
Administrator's Guide.
FILES
/bin/setkey
SEE ALSO
keyboard(7)
10/89 Page 3