vlog

Section: Misc. Reference Manual Pages (0.9.9)
Updated: 19 Dec 2004
Index

NAME

vlog - log monitoring utility. Connect to a server running LogMod or monitor logs by stdin.

SYNOPSIS

vlog [-h] [-v] [ -C config file ] [-S] [-s n] [-c] [-w <config file> ]

DESCRIPTION

vlog Is a game log monitoring tool. For Half-Life based games, it can connect to a server that is running LogMod and return the logs in realtime. For other games, logs can be piped to vlog via stdin. Vlog will use a config file to filter the incoming data stream, so you only see what is relevant. vlog is part of the vrcon package.

OPTIONS

C <config file>: Use config file instead of default ~/.vrcon
-s n: Overide the default server. n is a numeric value.
1 would be the first server listed in your config file
2 would be the next one. etc etc.
-S: Show severs from config file (and numbers for use with -s)
-c: Color output
-w <config file>: Watch a stream of data from stdin and use a config file to filter what gets outputed.
-h: list help
-v: show version

USAGE

To use vlog with a Half-Life based game running logmod, you need to have a server setup in your vrcon config file. See the man page for vrcon on how to set up the config file.

To use vlog to monitor data streams from stdin, you will need to have a config file setup for filtering and a data stream piped to stdin.

Once vlog has been started, use Control-C will exit.

FILES

config file

The config file can be named whatever you like, but must be the argument to the -w command line option. Currently, the config file is just a text file containing word(s) that you would like matched and outputed to stdout. Each line is a seperate string or 'match'. No regular expressions or wildcards are accepted yet. An example config file might look like this for a Medal of Honor server;

# Watch list for MOHAA
primarydmweapon
Rcon
dmmessage
_team
broadcast

This will tell vlog to only output lines containing either 'primarydmweapon', 'Rcon', 'dmmessage', '_team', and 'broadcast'. Vlog will output the whole line containing the match. Spaces are permitted and will be used in the match. So for example you wanted to see when a player selects a rocket launcher in MOH (heavy weapon class) you could change the 'primarydmweapon' to 'primarydmweapon heavy' and it will output those lines that match.

EXAMPLES

vlog

Will connect to the default server and return log messages to stdout.

vlog -s 2

Will connect to the second server listed in your .vrcon file

vlog -c

The output to stdout will be in color.

tail -f gamelogfile | vlog -w /path/to/configfile.cfg

vlog will monitor the output of the tail command and based on the config file, output matching lines. If the log file is on a remote host and you have ssh installed, you could also do something like this;

ssh gamehost "tail -f gamelogfile" | vlog -w /path/to/configfile.cfg

BUGS

Send bugs to yamaneko@centurytel.net

AUTHOR

Sam "Jack Bauer" Vaughan yamaneko@centurytel.net

Index

config file

This document was created by man2html, using the manual pages.
Time: 20:14:28 GMT, December 19, 2004