
********************************************************
**************  NetLogger Toolkit  *********************
**************     NLV Source Code *********************
********************************************************


This is the official distribution of the NLV source
code, part of the NetLogger Toolkit.

More detailed information on its use is available at:
http://www-didc.lbl.gov/NetLogger


Questions should be sent to: DKGunter@lbl.gov


System requirements:

A relatively modern UNIX (X-Windows, etc.) with the following
versions of TCL, TK, and BLT installed:
TCL : 8.1
TK  : 8.1
BLT : 2.4i
You may have other versions installed as well, just use the
appropriate configure options (type configure --help to list)
to set the path to these versions when you build NLV.

Contents of this package:

Directory       Description
---------------------------------------------
build/       Build directory
examples/    Examples for nlv testing
src/         All sources
src/nlv/     NLV Sources
src/tcllib/  Tcl, TK and BLT header files

=====================================================

Building NLV:

1. Untar the distribution into directory,
   for example ~/download/NetLogger

2. If you want to build for multiple architectures,
make a copy of the 'build' tree for each architecture,
It will be cleaner if you rename the build tree for the
last architecture.
e.g. for Linux and Solaris:
% cd ~/download/NetLogger
% cp -R build Linux
% mv build Solaris
Then repeat steps 3-6 below for each directory you
created (substituting its name for 'build').

3. 'cd' to the build directory
% cd ~/download/NetLogger/build

4. Configure NLV
% ../configure

5. Build NLV
% make

6. Install NLV.  This simply copies the nlv binary to
build/bin. You need to copy it to your favorite spot (e.g.
/usr/local/bin or $NLHOME/bin.solaris) by hand.
% make install

=====================================================

Using NLV

** In order to run an nlv example **
(0) Let's say you untarred netlogger to
   ${HOME}/download/netlogger
(1) Set NLHOME to toplevel.
   setenv NLHOME $HOME/download/netlogger [csh]
   export NLHOME=$HOME/download/netlogger [bash]
(2) Add to your PATH the location of the nlv binary
%  setenv PATH ${PATH}:${NLHOME}/Solaris/bin
(3) cd to examples dir.
   cd $NLHOME/examples/nlv/tv
(4) Run an example.
   nlv -c . tv.log

Repeat steps (3) and (4) for other examples.
More detailed help on nlv is available from the DIDC
web pages or by emailing Dan Gunter with questions.


/*****************************************************************

Copyright notice:


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)

*******************************************************/

