labiv							  labiv
 
NAME
     labiv - produce WAT lab device inventory reports
 
SYNOPSIS
     labiv
     labiv [ -D ] 
     labiv [ -t testbed-name ] [-d device ] [ -f feature ] [ -q quality ]
           [ -x ]

DESCRIPTION
     labiv is used to take inventory of lab devices.  Reports
     can be generated for the entire lab based on testbed,
     device, or device feature.
 
OPTIONS
    (none)        full lab inventory

     -D           Display all currently supported devices, features
                  and qualities.
 
     -t [name]    Real-time testbed inventory probes [name] and 
                  outputs results to STDOUT. Mulitple testbeds may be
                  listed as a list and/or by using regexp wildcards in
                  the [name]. These wildcards include "." for any one char,
                  [0-4] for a range of digits, and (ar|cs|gd)01 for a
                  list of choices. See examples for more details.
                  If this option is ommited, labiv will default to
                  "[^gd].." to search all testbeds except Goldens.
                  Note: This default will also exclude dg, dd, & gg testbeds.

     -d [device]  Select which devices to probe. Use -D flag to view a
                  list of currently supported devices. Multiple
                  devices may be listed in the same way as testbeds.
                  See examples.

     -f [feature] Select which features to probe. Features are equated
                  to physical pieces of hardware such as a PAM, CPU,
                  Switch Card, Backplane, etc. Multiple features may
                  be listed in the same way as testbeds. Use -D flag to
                  view a list of currently supported features for each
                  device. See examples.

     -q [quality] Select which qualities to probe. Qualities exist on
                  features such as qualities of a CPU card are:
                  hardware version, memory size, FPGA version, etc.
                  Use -D flag to view a list of currently supported
                  qualities for each feature on each device.

     -x           Enable console login.
                  By default, labiv will only attempt to login via
                  the ethernet port. Giving the -x flag will allow
                  labiv to attempt to login via the console port if
                  loging in via the ethernet port fails. This will
                  NOT clear current console connections.

     When either the -t -d -f or -q options are omitted, labiv will
     automatically fill in all appropriate values.

Examples:

   Generate full summary (probe every testbed)

	labiv

   Display summary of sbr1 testbed

	labiv -t sbr1

   View all qualities of ethernet pams on 8540 and 8510 in all testbeds

	labiv -d 8540,8510 -f eth_pam

   View cpu memory in fs01 and sbr1 testbeds

	labiv -t fs01,sbr1 -q mem -f cpu

   View 2 port Gigabit Ethernet PAM FPGA versions in cs01 and fs10 testbeds

	labiv -t cs01,fs10 -f 2gig_pam -q fpga_ver

   View cpu hardware version for all AR testbeds, and CS testbeds
      cs01 through cs08, and gd30.

        laviv -t "ar..","cs0[1-8]",gd30 -f cpu -q hw_ver

   View 2 port Gigabit Ethernet PAM cam sizes on cs01, ar01 and gs01

        labiv -d 8540 -t "(cs|ar|gd)01" -f 2gig_pam -q cam_size

FILES

     hosts		hosts file maintained by lab admin.
			this file is parsed by labiv and devices
			listed must retain the basic format of:
			<ip address> <device name> <termserver connection>
			where device name conforms to a four-letter testbed
			name, followed by an underscore, followed by an 
			approved three-letter device name, followed by an
			underscore, followed by a two-digit number and
			the termserver connection is a comment indicating
			which port on the termserver the device is connected to

     labiv.conf         includes required libraries.
                        defines host file/ftp parameters.

     device_profile.pl  Define characteristics of different hardware.

AUTHOR

     Philip Shuman                         Cisco Systems, Inc. 1999
     pshuman@cisco.com
     pshuman@calpoly.edu  (for any questions after I leave)
