xkbevd Daemon

Purpose

XKB event daemon.

Syntax

xkbevd [ -help ] [ -cfg File ] [ -sc Command ] [ -sd Directory ] [ -display Display ] [ -bg ] [ -synch ] [ -v ]

Description

The xkbevd event daemon listens for specified XKB events and executes requested commands if they occur. The configuration file consists of a list of event specification/action pairs and/or variable definitions.

An event specification consists of a short XKB event name followed by a string or identifier which serves as a qualifier in parentheses; empty parenthesis indicate no qualification and serve to specify the default command which is applied to events which do not match any of the other specifications. The interpretation of the qualifier depends on the type of the event:

No other events are recognized.

An action consists of an optional keyword followed by an optional string argument. xkbevd recognizes the following actions:

If the action is not specified, the string is taken as the name of a sound file to be played unless it begins with an exclamation point, in which case it is taken as a shell command.

Variable definitions in the argument string are expanded with fields from the event in question before the argument string is passed to the action processor. The general syntax for a variable is either:

$c

or

$(str)

where c is a single character and str is a string of arbitrary length. All parameters have both single-character and long names. The list of recognized parameters varies from event to event.

The ignore, echo, printEvent, sound, and shell actions do what you would expect commands named ignore, echo, printEvent, sound, and shell to do, except that the sound command has only been implemented and tested for SGI machines.

The only currently recognized variables are soundDirectory and soundCommand.

Flags

Item Description
-bg Tells xkbevd to fork itself and run in the background.
-cfg File Specifies the configuration file to read. If no configuration file is specified, xkbevd looks for ~/.xkb/xkbevd.cf and $(LIBDIR)/xkb/xkbevd.cf in that order.
-display Display Specifies the display to use. If not present, xkbevd uses $DISPLAY.
-help Prints a usage message.
-sc Command Specifies the command used to play sounds.
-sd Directory Specifies a top-level directory for sound files.
-synch Forces synchronization of all X requests. Slow.
-v Prints more information, including debugging messages. Multiple specifications of -v causes more output.