Copyright 1994, 1998 The Open Group

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation.

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Except as contained in this notice, the name of The Open Group shall not
be used in advertising or otherwise to promote the sale, use or other
dealing in this Software without prior written authorization from the
The Open Group.


xconsole - monitor system console messages with X

xconsole [-toolkitoption ...] [-file file-name]
 [-notify|-nonotify] [-daemon] [-verbose]
 [-exitOnFail] [-stripNonprint] [-saveLines count]
xconsole -help
xconsole -version

The xconsole program displays messages which are usually sent to /dev/console. Xconsole accepts all of the standard X Toolkit command line options along with the additional options listed below:

8 -file file-name To monitor some other device, use this option to specify the device name. This does not work on regular files as they are always ready to be read from.

8 -notify -nonotify When new data are received from the console and the notify option is set, the icon name of the application has " *" appended, so that it is evident even when the application is iconified. -notify is the default.

8 -daemon This option causes xconsole to place itself in the background, using fork/exit.

8 -verbose When set, this option directs xconsole to display an informative message in the first line of the text buffer.

8 -exitOnFail When set, this option directs xconsole to exit when it is unable to redirect the console output.

8 -stripNonprint When set, this option directs xconsole to not include any non-printable characters in the current locale in the displayed output.

8 -saveLines count When set, xconsole only preserves count lines of message history instead of growing the text buffer without bound (a count of zero - the default - is treated as placing no limit on the history).

8 -help This option indicates that xconsole should print a usage message and exit.

8 -version This option indicates that xconsole should print its version and exit.

This program uses the Athena Text widget, look in the Athena Widget Set documentation for controlling it.

Xconsole otherwise accepts resources of the same names as the command-line options (without the leading dash). "file" is a string type, "saveLines" an integer, and the remaining options are booleans.

In order to specify resources, it is useful to know the hierarchy of the widgets which compose xconsole. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

XConsole xconsole
 XConsole text

8 DISPLAY to get the default host and display number.

8 XENVIRONMENT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

__apploaddir__/XConsole specifies required resources

X(__miscmansuffix__), xrdb(__appmansuffix__), Athena Text widget Keith Packard (MIT X Consortium)