NAME

speckeysd.map - Sun Special Keys to service map file for speckeysd

SYNOPSIS

/usr/openwin/lib/speckeysd.map

AVAILABILITY

SUNWpmow

DESCRIPTION

The speckeysd.map file is used by the speckeysd(1M) daemon to determine which Sun Special Keys to look for in the X Windows environment, and which service to spawn off to handle the keys.

The file is composed of entries for Sun Special Keys that are position-dependent and have the following format:

Sun Special Key Keysym

Repeatable

Service

Each entry is delimited by a newline. Each field is delimited by white-space (either a space or a tab). The whole entry must come before a newline, ie. you cannot extend lines by putting a backslash () preceding the newline.

The fields are:

Sun Special Key Keysym

Which Sun Special Key keysym should the speckeysd(1M)

look for? Each key has a keysym associated with it in the X

Windows environment. The Sun Special Keys and the

Keysyms associated with them are:

Degauss Key

SunVideoDegauss

Mute Key

SunAudioMute

LowerVolume Key

SunAudioLowerVolume

LowerBrightness Key

SunVideoLowerBrightness

RaiseVolume Key

SunAudioRaiseVolume

RaiseBrightness Key

SunVideoRaiseBrightness

Power Key

SunPowerSwitch

Shift-Power Key

SunPowerSwitchShift

Repeatable

Is the Sun Special Key that speckeysd (1m) is supposed to

look for repeatable? The valid options are:

r

the key is repeatable

-

the key is not repeatable

Service

Which service should be spawned off if one of the Sun Spe-

cial Keys are pressed and what arguments should be passed

to it? The service field is always considered to be everything

after the Repeatable field and white-spaces following it to the newline character. To ensure that there are no PATH issues,

specify the service with the complete path.

Comments are allowed in the file. However, the comments are full line entries, from an initial hash character (#) to the newline.

EXAMPLES

The following is a sample speckeysd.map file.

# This is the special keys service map file.
#
# This file will let speckeysd know what special keys (represented by X
# Windows Keysyms) to expect and what services to spawn off to handle the
# keys.
#
SunVideoRaiseBrightness                 r       $OPENWINHOME/bin/contrast -k -u 1
SunVideoLowerBrightness                 r       $OPENWINHOME/bin/contrast -k -d 1
SunPowerSwitch                          -       $OPENWINHOME/bin/sys-suspend
SunPowerSwitchShift             -       $OPENWINHOME/bin/sys-suspend -n

NOTES

If the file is changed and the system is already in X Windows, the speckeysd (1M) daemon must be restarted to pick up the changes.

SEE ALSO

speckeysd(1M)