xtrapreset, xtrapinfo, xtrapstats, xtrapout, xtrapin, xtrapchar, xtrapproto - XTrap sample clients


xtrapreset [ −d[isplay] display ]

xtrapinfo [ −d[isplay] display ]

xtrapstats [ −d[isplay] display ]

xtrapout [ −f script ] [ −e ] [ −d[isplay] display ] [ −v ]

xtrapin [ −f script ] [ −d[isplay] display ]

xtrapchar [ −v ] [ −d[isplay] display ]

xtrapproto [ −d[isplay] display ]


These commands are SAMPLE CLIENTS provided with the XTrap X Server Extension Sources, Version 3.3. XTrap is an X Server extension which facilitates the capturing of server protocol and synthesizing core input events. Information on how to obtain these sources can be found in the SOURCES section below.

The xtrapreset command is the simplest XTrap client in that it merely performs an XQueryExtension() against XTrap. The name "reset" is historical. The display argument is parsed by the X Toolkit and specifies the display where XTrap is to be loaded; see X(1).

xtrapinfo displays general configuration information as a result of an GetAvailable XTrap request to the specified server. It is simply designed to test the request/response mechanism of the XTrap extension and client library as well as display the configuration information that it finds.

xtrapstats tests the event and request vectoring of the server extension by configuring XTrap to collect usage statistics on all core input events and requests. It has a primitive command-line interface for showing the counters, zeroing out the counters, and quitting the program.

xtrapout tests the output transport from the XTrap extension to the XTrap client library. As an aside, since xtrapout has the capability of "recording" events and requests it receives, xtrapout is ideal for providing input to test xtrapin. Since events are the only concern for the input transport, the −e flag can be specified to indicate that all input events (and only events) should be recorded by xtrapout. script is specified primarily for non-U*IX machines which don’t support I/O re-direction easily. The −v flag is used to force recording of all requests and input events.

xtrapin is used to test the input transport to the XTrap server extension. As stated earlier, it’s input can be provided by xtrapout using the −e qualifier. While it’s primary function is for testing XTrap and serving as an example for XTrap functionality, it can reasonably used as a primitive "playback" client for X sessions.

xtrapchar parses ANSI character sequences including application program sequences to synthesize input events to X Window servers using the XTrap server extension. The intent of this program is to serve as a sample implementation for interfacing character-based alternative input sources into X servers (e.g. voice recognition systems). Another application might be "remote keyboards". The -v flag causes the program to display XTrap configuration information and echo’s characters processed to stdout. If present, this must be the first argument.

Note: xtrapchar has only been used with Digital Workstations using the LK201 compatible keyboard. Though reasonable effort was done to maintain portability, no claims are made as to the current level of portability to non-DEC servers for this program.

The xtrapproto command is a regression test designed to test the basic XTrap protocol between a client and server. If a given implementation is suspect, the results of this test should be sent to an XTrap implementor and/or developer.


-d[isplay] display

Specifies the server to record from or playback to; see


Record only (and all) events. Should be used when creating input for

-f script

The pathname of the script to be recorded / played back.


Verbose mode.


X Toolkit Error: Can’t load DEC-XTRAP extension

The XTrap X server extension has not been linked into the specified X server.


Sources have been posted on UseNet systems via anonymous ftp.
They are:
East Coast (USA):   export@lcs.mit.edu:contrib/XTrap_v32*.tar.Z
West Coast (USA):   gatekeeper@pa.dec.com:X11/contrib/XTrap_v32*.tar.Z


Digital participated in the X Consortium’s xtest working group which
chose to evolve XTrap functionality into a new extension for X11/R6
known as the RECORD extension (XTrap input synthesis functionality is
currently covered by the XTEST extension).  It is strongly suggested
that users of XTrap technology begin developing against RECORD/XTEST
as it is the intention of the X Consortium to drive these two extensions
in the standards process for providing the protocol capturing/synthesis
functionality.  Some members of the xtest working group are actively
researching migration issues between XTrap and RECORD.  If you’d like
to contribute, please participate!  Contact your local X Consortium Rep
for details on how to be added to the xtest mailing list.

If you encounter problems, have questions, etc. with XTrap, please contact
via mail, phone, etc. at:

        Ken Miller
     (VOICE) 603-881-6221
        (FAX)   603 881-2257

or paper mail at:

        Digital Equipment Corp.
        Ken Miller @ ZKO3-3/Y25
        110 Spitbrook Rd.
        Nashua, NH 03062

Naturally email is preferred and will get the fastest response.



More Linux Commands

Tcl_FSGetNormalizedPath(3) - procedures to interact with any
There are several reasons for calling the Tcl_FS API functions (e.g. Tcl_FSAccess and Tcl_FSStat) rather than calling system level functions like access and sta

cameratopam(1) - convert raw camera image to PAM (Man Page)
This program is part of Netpbm(1) cameratopam converts from any of dozens of raw camera image formats to PAM. Digital still cameras often can produce images in

keyname(3ncurses) - miscellaneous curses utility routines...
The unctrl routine returns a character string which is a printable representation of the character c, ignoring attributes. Control characters are displayed in t

mkdir(1) - make directories (Commands - Linux man page).....
Create the DIRECTORY(ies), if they do not already exist. Mandatory arguments to long options are mandatory for short options too. -m, --mode=MODE set file mode

setarch(8) - change reported architecture in new program env
setarch currently only affects the output of uname -m. For example, on an AMD64 system, running setarch i386 program will cause program to see i686 instead of x

glutGameModeString(3) - sets the game mode configuration via
XXX fix me SEE ALSO glutGameModeGet, glutEnterGameMode, glutLeaveGameMode, glutInitDisplayString AUTHOR Mark J. Kilgard (mjk@nvidia.com) glutGameModeString.3 (L

XQueryFont(3) - load or unload fonts and font metric structu
The XLoadFont function loads the specified font and returns its associated font ID. If the font name is not in the Host Portable Character Encoding, the result

tuned.conf(5) Tuned profile definition - Linux manual page
This man page documents format of Tuned 2.0 profile definition files. Profile is stored in /etc/tuned/<profile_name>/tuned.conf or in /usr/lib/tuned/<profile_na

XSaveContext(3) - associative look-up routines (Man Page)...
If an entry with the specified resource ID and type already exists, XSaveContext overrides it with the specified context. The XSaveContext function returns a no

netsnmp_agent_api(3) - embedding an agent into a external ap
Our goal is to create a easy to use interface to the Net-SNMP package such that you can take code that you have written that has been designed to be a Net-SNMP

XLowerWindow(3) - change window stacking order (Man Page)...
The XRaiseWindow function raises the specified window to the top of the stack so that no sibling window obscures it. If the windows are regarded as overlapping

glPointSize(3gl) - specify the diameter of rasterized points
glPointSize specifies the rasterized diameter of both aliased and antialiased points. Using a point size other than 1 has different effects, depending on whethe

We can't live, work or learn in freedom unless the software we use is free.