------------------------------------------------------------------
         N E T L O G G E R    V I S U A L I Z A T I O N
------------------------------------------------------------------

This is the source code distribution of nlv, NetLogger Visualization,
part of the NetLogger toolkit developed at LBNL.

For updates, news, and help with NetLogger, please refer to the LBNL
NetLogger web site at:

http://www-didc.lbl.gov/NetLogger/

-----------------------
I. System requirements
-----------------------
nlv is supported on Linux (2.2.x), Solaris (5.6), and IRIX (6.4).

To compile and install nlv from source, you must have the
following installed on your system: 

(1) Tcl/Tk version 8.1 -- Shared or static libraries 
(2) BLT version 2.4i   -- Static/shared library BLT24.a
(3) GNU make (gmake), bison, and flex 

For the GNU binaries, refer to any mirror of the GNU source code.

You can get a precompiled copy of the relevant Tcl, Tk and BLT libraries at:
http://www-didc.lbl.gov/NetLogger/download.html

----------------------
II. Build and install
----------------------

Please read the instructions at the top level of the NetLogger distribution.

----------------------
III. Running
----------------------

For more complete instructions, refer to the web pages at:

http://www-didc.lb.gov/NetLogger/nlv/

Briefly, nlv is invoked on the command-line with the name of the log file.
An important detail is the location of the configuration files, nlv-main.cfg and
nlv-keys.cfg . They may be in different places, and in fact the common arrangement
is to keep nlv-main.cfg in a central place and specify nlv-keys.cfg on the command-line.
The NetLogger distribution comes with nlv-main.cfg in cfg/nlv/ ; you can set NLHOME to the
root of the distribution and then nlv will be able to find it. Then, when you want to
look at a log file, create or copy your nlv-keys.cfg file into the same directory as
the file and run nlv thus:

% nlv -k . logfile

The "-k ." option tells nlv to look in the current directory for the nlv-keys.cfg file,
instead of $NLHOME/cfg/nlv, which is the default.

Confused? Please refer to the web pages for a (hopefully) more complete explanation of
this process. Remember, direct questions to Dan Gunter at the email address in (IV.).

-------------------------
IV. Contact information
-------------------------
Please direct comments and queries to either Brian Tierney (as
indicated in the copyright notice) or Dan Gunter, the maintainer of
this distribution. Thank you.

Dan Gunter
DKGunter@lbl.gov

*****************************************************************

This software is copyright (C) by the Lawrence Berkeley National Laboratory.
Permission is granted to reproduce this software for non-commercial
purposes provided that this notice is left intact.

It is acknowledged that the U.S. Government has rights to this software
under Contract DE-AC03-76SF00098 between the U.S.  Department of Energy
and the University of California.

This software is provided as a professional and academic contribution
for joint exchange. Thus, it is experimental, and is provided ``as is'',
with no warranties of any kind whatsoever, no support, no promise of
updates, or printed documentation. By using this software, you
acknowledge that the Lawrence Berkeley Laboratory and Regents of the
University of California shall have no liability with respect to the
infringement of other copyrights by any part of this software.

For further information about this notice, contact Brian L. Tierney
Bld. 50B, Rm. 2239, Lawrence Berkeley National Laboratory, Berkeley, CA, 94720
(bltierney@lbl.gov)

***************************************************************
