kbd(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES | BUGS

NAME

kbd- Manipulate the state of keyboard or display the type of keyboard or change the default keyboard abort sequence effect

SYNOPSIS

kbd [-r] [-t] [-c on| off] [-a enable| disable] [-d keyboarddevice]
kbd -i [-d keyboarddevice]

DESCRIPTION

The kbd utility manipulates the state of the keyboard, or displays the keyboard type or allows the default keyboard abort sequence effect to be changed. The default keyboard device being set is /dev/kbd.

The -i option reads and processes default values for the keyclick and keyboard abort settings from the keyboard default file, /etc/default/kbd, as described below.

Only keyboards that support a clicker respond to the -c option. If you want to turn clicking on by default, add or change the current value of the KEYCLICK variable to the value on in the keyboard default file, /etc/default/kbd, as shown here:

KEYCLICK=on

Then, run the command kbd -i to change the current setting. Valid settings for this variable are the values on and off. Other values are ignored. If the variable is not specified in the default file, the setting is unchanged.

To enable or disable the keyboard abort sequence (L1-A or STOP-A on the keyboard and BREAK on the serial console input device on most systems) effect using the -a option requires the sys_devices privilege.

On most systems, the default effect of the keyboard abort sequence is to suspend the operating system and enter the debugger or the monitor. Some systems have key switches with a 'secure' position. On these systems, the key switch in the 'secure' position, overrides any software default set with this command.

If you want to permanently change the software default effect of the keyboard abort sequence, you can add or change the current value of the KEYBOARD_ABORT variable to the value disable in the keyboard default file, /etc/default/kbd, as shown here:

KEYBOARD_ABORT=disable

Then, run the command kbd -i to change the current setting. Valid settings for this value are the values enable and disable. Other values are ignored. If the variable is not specified in the default file, the setting is unchanged.

OPTIONS

The following options are supported:

-i

Set keyboard defaults from the keyboard default file. This option is mutually exclusive with all other options except for the -d keyboard device option. This option instructs the keyboard command to read and process keyclick and keyboard abort default values from the /etc/default/kbd file. This option requires the sys_devices privilege.

-r

Reset the keyboard as if power-up.

-t

Return the type of the keyboard being used.

-c on/off state

Turn the clicking of the keyboard on or off.

on

Enable clicking.

off

Disable clicking.

-a enable/disable state

Enable or disable the keyboard abort sequence effect. By default, a keyboard abort sequence (typically, Stop-A or L1-A on the keyboard and BREAK on the serial console device) suspends the Operating System on most systems. This default behavior can be changed using this option. This option requires the sys_devices privilege.

enable

Enable the default effect of the keyboard abort sequence, which is to suspend the operating system and enter the debugger or the monitor.

disable

Disable the default effect and ignore keyboard abort sequences.

-d keyboard device

Specify the keyboard device being set. The default is /dev/kbd.

EXAMPLES

---

Example 1 Displaying the keyboard type




The following example displays the keyboard type.

example% kbd -ttype 4 Sun keyboard

---

---

Example 2 Setting keyboard defaults




The following example sets keyboard defaults as specified in the keyboard default file.

example$ kbd -i

---

FILES

/etc/rcS

Shell script containing commands necessary to get the system to single-user mode.

/dev/kbd

Keyboard device file.

/etc/default/kbd

Keyboard default file containing software defaults for keyboard configurations.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWcsu

SUMMARY OF TRUSTED SOLARIS CHANGES

The kbd utility must have DAC access to /dev/kbd, or may use the privileges file_dac_read and file_dac_write to override access restrictions. In addition, the -a and -i options require the sys_devices privilege.

SEE ALSO

Trusted Solaris 7 Reference Manual

kb(7M)

SunOS 5.7 Reference Manual

loadkeys(1), kadb(1M), keytables(4), attributes(5)

NOTES

Some server systems have key switches with a 'secure' key position that can be read by system software. This key position overrides the normal default of the keyboard abort sequence effect, and changes the default so the effect is 'disabled'. On these systems, when the key switch is in the secure position, the keyboard abort sequence effect cannot be overridden by the software default which is settable with this command.

BUGS

There is no way to determine the state of the keyboard click setting.

Trusted Solaris 7  Last Revised 30 Sep 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES | BUGS