xlogmaster(1)

NAME

xlogmaster - quick & easy monitoring of logfiles and de

vices

SYNOPSIS

xlogmaster  [-activate  <n>] [-alertcolor <r,g,b>] [-audio
<on/off>] [-audio-alert <filename>/<off>]  [-audio-notice  <filename>/<off>]    [-audio-uniconify    <filename>/<off>]   [-buffer
<n>[bkm]] [-config <file>] [-fadeseconds  <n>]  [-fadesteps  <n>]
[-geometry  widthxheight+x+y] [-gtkrc <file>] [-help] [-mlockall]
[-notice-follows-mouse <yes/no>] [-silent] [-smallicon  <yes/no>]
[-terse] [-version] [-wordwrap <yes/no>]

DESCRIPTION

Xlogmaster displays logfiles and/or devices that can be

read via cat. It allows for quick and easy control of all log

files and most of the hardware/device status within one program.

Filters allow to highlight/lowlight/hide lines of high

er/lower/no interest. Click right mouse button in text window to

bring up the menu.

OPTIONS

-activate <n>

Activate entry nr <n> at startup

-alertcolor <r,g,b>

The color a logfile button should flash to when an

alert has been triggered for this particular logfile. The color

is in GTK+ standard, this means values between 0 and 1 for

red,green,blue.

Example: A commandline option of -alertcolor

0,1.0,0 would mean that the button will flash bright green.
IMPORTANT: While values have to be seperated by a

comma, the values themselves have to be given with a decimal

point (so 0.45 and NOT 0,45 for instance).

-audio <on/off>

Generally turns audio support for the xlogmaster

on/off. For audio support you must have the OSS installed

(/dev/dsp must exist).

-audio-alert <filename>/<off>

Selects file to play whenever an "alert" filter has

been triggered (see tutorial). The file must be playable via "cat

filename > /dev/dsp" ( about 8KHz and a standard (WAVE, ULaw...)

format ).

If you give "off" as the filename, there will be

no sound for alert events.

-audio-notice <filename>/<off>

Same as "-audio-alert", only for "notice" events

(see tutorial).

-audio-uniconify <filename>/<off>

Same as "-audio-alert", only for "uniconify" events

(see tutorial).

-buffer <n>[bkm]

Set the size of the buffered text to

<n>[bytes/kilobytes/megabytes]. This gives the maximum number of

bytes that can be reviewed at any point.

-config <file>

Use <file> as the config file for Xlogmaster

-fadeseconds <n>

Amount of seconds it takes an alert-highlighted

button to fade back to normal. Something like 300 seconds is usu

ally a good value.

-fadesteps <n>

Number of steps taken when fading back from alert

color to standard background color of a button. Depending on how

different the colors are and how fast you letthe buttons fade

back something between 20 and 200 should be a sane value.

-geometry widthxheight+x+y

Standard X11 geometry statement

-gtkrc <file>

Use <file> as the GTK+ rc file (controlling the

color selection & look). See GTK+ toolkit for details.

-help Prints short help message and exits.

-mlockall

Try to lock the pages of the Xlogmaster in memory

so they don't get swapped out.

This function is meant for admins of machines with

heavy memory usage and logfiles that are considered extremely im

portant (like some servers). It *only* works on machines that

support the mlockall() call and usually *only for root*. If the

system allows locking and you use more memory pages than the sys

tem likes to see locked a segfault is pretty likely. This is def

initely something that has to be called a superuser feature !
Usual users could request the locking but nothing

would happen. You could of course make the xlogmaster suid root,

but *I TELL YOU: DON'T !!!!!!!* You would allow everyone who

could start it to save the xlogmaster configuration over anything

- even the kernel image, for instance. The only clean way is

probably a little wrapper that only you have access to and if you

don't know how to set that up you definitely don't know enough to

use this feature. Most people won't need it, anyways - so once

again: USE WITH EXTREME CAUTION AND ONLY IF YOU KNOW WHAT YOU

ARE DOING ! THIS IS A SUPERUSER FEATURE !

-notice-follows-mouse [YES/no]

Determines whether the notice box (see Class1 fil

ters in tutorial) should follow the mouse around. This doesn't

mean the notice dialog sticks to the mouse pointer, it rather

lets the notice box move to the current mouse position every time

a new entry is added to the notice dialog.

Since most people will probably find it annoying

this feature is disabled as the default.

-silent

Same as "-audio off".

-smallicon [YES/no]

If set to yes Xlogmaster will use a standard 64x64

pixel icon instead of the logo for iconify.

-terse Assume user know's what he's doing - no "are you

sure ?" questions for possibly critical tasks like leaving the

Xlogmaster.

-version

Prints version information and exits.

-wordwrap [YES/no]

Should the words be cut in half or wrapped properly

? Give yes for proper wrapping.

FILES

$HOME/.xlogmaster

Configuration file loaded by xlogmaster at startup.

/etc/xlogmaster/xlogmaster.gtkrc

Standard GTK rc-file. This file defines the look

(colors etc.) of xlogmaster.

/etc/xlogmaster/config

Autogenerated configfile. Debian packages register

their logfiles into this file by using the update-xlogmaster pro

gramm.

/etc/xlogmaster/scripts

Scripts you can use as a reaction to a trigger.

/etc/xlogmaster/sound

Sounds played on a triggered event.

/etc/xlogmaster/database

Directory with entries for the intern database.

/etc/xlogmaster/entries

Directory to place override files for the Debian

logfile database. See update-xlogmaster(1).

SEE ALSO

update-xlogmaster(1), /usr/doc/xlogmaster/xlogmaster.html

BUGS

Send all bug reports to:

xlogmaster-bugs@gnu.org

AUTHORS

Xlogmaster was written by Georg C. F. Greve.

COPYING

The Xlogmaster

Copyright (C) 1998 by Georg C. F. Greve <greve@gnu.org>
This is a GNU program

This program is free software; you can redistribute it

and/or modify it under the terms of the GNU General Public Li

cense as published by the Free Software Foundation; either ver

sion 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be

useful, but WITHOUT ANY WARRANTY; without even the implied war

ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the GNU General Public License for more details.
You should have received a copy of the GNU General Public

License along with this program; if not, write to the Free Soft

ware Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA

02111-1307 USA

XLOG

MASTER(1)