NAME
  upc - UPS Product Census

SYNOPSIS
  upc     [-z db]                # list of ups databases to examine
          [-h template|+]        # HTML template; "+" for default formatting
          [-a] [-g chain]        # chains to include; "-g!chain" to exclude
          [-q quals]             # qualifiers to include
          [-f flavor]            # flavors to include
          [-K keywords]          # additional keywords to include
          [-v[vvv]]              # debugging verbosity level
          [product [version] [, product [version] ...] ]

  special syntax for remote dbs:
          database@node

  special chain names:
          "userchain" for user-defined chains
          "nochain" for unchained instances

  default values:
          -z $PRODUCTS    # use databases listed in $PRODUCTS
          -g current      # report on only the current chains
          -K+             # product, version, flavor, qualifiers

  default output format: text


DESCRIPTION
  upc reformats the information contained in a ups database into readable
  reports.  These help to determine if you have installed and chained all
  flavors of a product correctly.  upc helps in maintaining ups databases by
  formatting the output of "ups list" so that mere mortals can tell if they
  have the correct versions installed and declared for all flavors, etc.

  Additionally, upc allows you to compare the information from your local ups
  database with the information in one or more remote distribution servers.
  In this way, you can easily compare what is "current" on your system with
  what has been declared "current" on your favorite distribution hosts.

EXAMPLES
          upc -h+ -a -g!nochain:!userchain:!development exmh
          upc -h $UPC_DIR/www/index.html -g current:old ftt, ocs, rbio
          upc -z /ftp/upsdb@fnkits.fnal.gov:/fnal/ups/db -aK@table_file upd
          upc -f NULL:OSF1:OSF1+V3:OSF1+V4 -a -g!userchain

  If no products are specified, then all products will be listed in the
  report.  Note, this can be rather slow, especially if you're examining a
  remote database.




  where upc_command is any legal upc command with all spaces replaced by
  ampersands, as in

          http://www.fnal.gov/cgi-bin/upc.cgi?upc&-a&-K+&tk

  In this example, we have issued the command

          upc -a -K+ tk

  The default values used by the upc.cgi script when none are specified are
  to write HTML-formatted output (-h+), to use the AFS and FNKITS ups data-
  bases (-z /ftp/upsdb@fnkits.fnal.gov:/afs/fnal/ups/db) and to report on all
  chains (-a).  Note that these are slightly different than the commandline
  upc defaults.