LogMon
http://www.edespot.com/plaidhat/code/LogMon/
Andrew MacKenzie (amackenz@edespot.com)


Compiling
---------

NOTE: FreeBSD (and other non-Linux systems) must use gmake

./configure
make

Program will be called logmon.

'make install' will install to /usr/local/bin by default.

Usage
-----

    logmon [-b buffer_size] [-f conf_file] <file1> <file2> ...

    Each file listed will create a new 'frame' in the terminal.

Key Commands
------------
    Arrows      - Scroll text one 'character' in that direction.
    Page_Up     - Scroll text one page 'UP'.
    Page_Down   - Scroll text one page 'DOWN'.
    Home        - Scroll all the way to the LEFT.
    End         - Scroll all the way to the BOTTOM.
    Space/G     - will set the window in the BOTTOM-LEFT.
    g           - Scroll to the top of the buffer.
    k           - Scroll one line up.
    j           - Scroll one line down.
    h           - Scroll character line left.
    l           - Scroll character line right.
    <tab>       - Select next frame.
    w           - Select next frame.
    W           - Select previous frame.
    a           - Select all frames.

Config File
-----------

LogMon will search for a config file if one is not specified
as $HOME/.logmonrc or (failing that) /etc/logmon.conf.  The file 
format is as follows:

    operation:basefilename:regex,regex,...

Operation can be one of:
    ignore - ignore lines with 'regex' in 'basefilename' (similar to
             'grep -v')
    color - Any one of black,red,green,yellow,blue,magenta,cyan,white
        
Example (see also logmon.conf.example):

# This is a comment.

# Ignore localhost in my web log.
ignore:combined_log:localhost,localdomain

Color
----

New addition in 0.4.  Order of colors *does* matter, as the first expression to
match a string will be chosen.


BUGS
----
Resizing works now, but only if you hit a key (like 'space') after the
window resizes.  This seems to be a limitation of ncurses.  

logrotated files are not yet handled properly.  logmon *may* consume lots
of CPU trying to handle a file that has been rotated out.

Not a bug per se, but logmon will continue to load all new lines from a
file into memory.  Keep this in mind if running logmon for a long time.  I
intend for a future release to have a 'max' size the buffer will grow to.

Please report any bugs found, or suggestions, to amackenz@edespot.com.

