169 lines
5.3 KiB
HTML
169 lines
5.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XKBEVD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XKBEVD</H1>
|
|
Section: User Commands (1)<BR>Updated: xkbevd 1.1.4<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xkbevd - XKB event daemon
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xkbevd</B>
|
|
|
|
[ options ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
This command is very raw and is therefore only partially implemented; we
|
|
present it here as a rough prototype for developers, not as a general purpose
|
|
tool for end users. Something like this might make a suitable replacement
|
|
for xev; I'm not signing up, mind you, but it's an interesting idea.
|
|
<P>
|
|
|
|
The
|
|
<I>xkbevd</I>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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: Bell events match using the name of the bell, message events
|
|
match on the contents of the message string and slow key events accept
|
|
any of <I>press</I>, <I>release</I>, <I>accept</I>, or <I>reject</I>. No
|
|
other events are currently recognized.
|
|
<P>
|
|
|
|
An action consists of an optional keyword followed by an optional string
|
|
argument. Currently, <I>xkbev</I> recognizes the actions: <I>none</I>,
|
|
<I>ignore</I>, <I>echo</I>, <I>printEvent</I>, <I>sound</I>, and <I>shell</I>.
|
|
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.
|
|
<P>
|
|
|
|
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 $<I>c</I> or $(<I>str</I>), where <I>c</I> is a single character and
|
|
<I>str</I> is a string of arbitrary length. All parameters have both
|
|
single-character and long names.
|
|
<P>
|
|
|
|
The list of recognized parameters varies from event to event and is too long
|
|
to list here right now. This is a developer release anyway, so you can
|
|
be expected to look at the source code (evargs.c is of particular interest).
|
|
<P>
|
|
|
|
The <I>ignore</I>, <I>echo</I>, <I>printEvent</I>, <I>sound</I>,and <I>shell</I>
|
|
actions do what you would expect commands named <I>ignore</I>, <I>echo</I>,
|
|
<I>printEvent</I>, <I>sound</I>, and <I>shell</I> to do, except that the sound
|
|
command has only been implemented and tested for SGI machines. It launches
|
|
an external program right now, so it should be pretty easy to adapt,
|
|
especially if you like audio cues that arrive about a half-second after you
|
|
expect them.
|
|
<P>
|
|
|
|
The only currently recognized variables are <I>soundDirectory</I> and
|
|
<I>soundCmd</I>. I'm sure you can figure out what they do.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-help</B>
|
|
|
|
<DD>
|
|
Prints a usage message that is far more up-to-date than anything in this
|
|
man page.
|
|
<DT id="2"><B>-cfg </B><I>file</I>
|
|
|
|
<DD>
|
|
Specifies the configuration file to read. If no configuration file is
|
|
specified, <I>xkbevd</I> looks for ~/.xkb/xkbevd.cf and $(LIBDIR)/xkb/xkbevd.cf
|
|
in that order.
|
|
<DT id="3"><B>-sc </B><I>cmd</I>
|
|
|
|
<DD>
|
|
Specifies the command used to play sounds.
|
|
<DT id="4"><B>-sd </B><I>directory</I>
|
|
|
|
<DD>
|
|
Specifies a top-level directory for sound files.
|
|
<DT id="5"><B>-display </B><I>display</I>
|
|
|
|
<DD>
|
|
Specifies the display to use. If not present, <I>xkbevd</I> uses $DISPLAY.
|
|
<DT id="6"><B>-bg</B>
|
|
|
|
<DD>
|
|
Tells <I>xkbevd</I> to fork itself (and run in the background).
|
|
<DT id="7"><B>-synch</B>
|
|
|
|
<DD>
|
|
Forces synchronization of all X requests. Slow.
|
|
<DT id="8"><B>-v</B>
|
|
|
|
<DD>
|
|
Print more information, including debugging messages. Multiple
|
|
specifications of <I>-v</I> cause more output, to a point.
|
|
<DT id="9"><B>-version</B>
|
|
|
|
<DD>
|
|
Prints the program version and exits.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xev">xev</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xkbwatch">xkbwatch</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+X">X</A></B>(7).
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright 1995, Silicon Graphics Computer Systems
|
|
<BR>
|
|
|
|
Copyright 1995, 1998 The Open Group
|
|
<BR>
|
|
|
|
See <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I> for a full statement of rights and permissions.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Erik Fortune, Silicon Graphics
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="13"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="14"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
<DT id="16"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|