NAME

xevent - event monitor for X window system

SYNOPSIS

xevent [ option ] ...

DESCRIPTION

xevent lets you interactively monitor events on several windows simultaneously. You are able to selectively monitor only those events of interest on a per window basis. These can be changed at any time. Output is sent to stdout and optionally to a log file.

Event and window selection is done interactively using the xevent window which is comprised of a set of command buttons and event buttons. The format of these buttons is controlled using the options described below. There are 6 command buttons and 25 event buttons (one for each possible event mask). When you start up xevent you will be asked to select an initial window to monitor. This window is referred to as the current window. The xevent window highlights the event buttons for those events being monitored on the current window. Events to monitor can be selected/unselected for the current window by clicking on the corresponding event button.

There are 3 event masks that can be selected by at most 1 client for a given window. These events are ButtonPress, ResizeRedirect, and SubstructureRedirect. If you attempt to select one of these event masks and it is already selected, xevent will beep at you.

The command buttons allow you to select additional windows to monitor, or control the output of the monitor. There are 6 command buttons:

Window Interactively change the current window. The cursor is changed and you are prompted to select a new window. The event buttons for those events being monitored on the selected window (if any) are highlighted and can be changed.

Parent Set the current window to the parent of the presently current window. This allows you to select windows fully obscured by their subwindows. The event buttons for those events being monitored on the selected window (if any) are highlighted and can be changed.

Clear Clear all monitored events for the current window. This is provided as a quick way of unselecting all monitored events from the current window.

LogOff/LogOn

Turn off/on the monitor output. This temporarily suspends/resumes output from all events on all windows being monitored.

Long/Short

Display the events in long/short form. In long form all members of the event structure are displayed. In short form only the event type and window are given.

Quit    Exit xevent.

OPTIONS

xevent understands to following options:

-abbrev The command/event button names are abbreviated.  The
        default is to use the entire name.

-bd color

Specify the border color. The default border color is ``black''.

-bg color

Specify the background color. The default background color is ``white''.

-bw pixels

Specify the width in pixels of the border. The default value is 4 pixels.

-c columns

Specify the number of columns of event buttons. The default value is 2 columns.

-center The event buttons are centered.  The default is left
        justification.

-colmajor

The event buttons are displayed in column major order. This is the default.

-fg color

Specify the foreground color. The default foreground color is ``black''.

-fn fontname

        Specify the font.  The default font is ``8x13''.

-left The event buttons are left justified. This is the default.

-log logfile

If this option is specified, the monitor events are written to the given file as well as to standard output.

-normal The command/event button names are not  abbreviated.
        This is the default.

-pad padding

The given padding (in pixels) is used to pad the text. The default value is 3 pixels.

-rowmajor

The event buttons are displayed in row major order. The default is column major order.

-geometry geometry

The xevent window is created in the specified location. See X(1) for a full explanation.

-display [host]:[display]

Normally, xevent gets the host and display number to use from the environment variable ``DISPLAY''. Either or both can be specified with this option. host specifies which machine to create the xevent window on, and display specifies the display number.

X DEFAULTS

Abbreviate

Abbreviate event button names. The default is to use the entire name.

Background

Set the background color. The default background color is ``white''.

Border Set the border color. The default border color is ``black''.

BorderWidth

Set the border width of the window. The default value is 4 pixels.

Center Center event buttons. The default is left justification.

ColMajor

Display event buttons in column major order. This is the default.

Columns Display event buttons using this many columns.   The
        default value is 2 columns.

Font    Set the font.  The default font is ``8x13''.

Foreground

Set the foreground color. The default foreground color is ``black''.

Left    Left justify event buttons.  This is the default.

Log Set the log file name. Log events to this file as well as standard output.

Normal Display entire event button names. This is the default.

Padding Padding around text.  The default is 3 pixels.

RowMajor

Display event buttons in row major order. The default is column major order.