artsprotoagg

artsprotoagg()                                                    artsprotoagg()



NAME
       artsprotoagg - utility to aggregate protocol table objects in time domain

SYNOPSIS
       artsprotoagg [-v] [-i ifIndexList] [-I ifIndexList]
                    [-h hours] [-o] [-q] outfile infile(s)

DESCRIPTION
       artsprotoagg is a utility that reads protocol table objects from ARTS
       files (infile(s)) and aggregates them in the time domain, placing the
       resulting protocol table object(s) into an output file (outfile).

OPTIONS
       -v     The -v option causes artsprotoagg to print version information and
              exit immediately.

       -i ifIndexList
              The -i ifIndexList option may be used to select only data which
              contains an interface index attribute in ifIndexList.  In other
              words, the -i ifIndexList option lets you select data from
              particular interfaces or sets of interfaces.  ifIndexList may
              contain hyphens (indicating an inclusive range) and commas.  For
              example, -i 1,2,5-8 would select data with an interface index
              attribute of 1, 2, 5, 6, 7 or 8.

       -I ifIndexList
              The -I ifIndexList option may be used to combine data which
              contains an interface index attribute in ifIndexList.  In other
              words, the -I ifIndexList option lets you combine data across a
              set of interfaces.  ifIndexList may contain hyphens (indicating an
              inclusive range) and commas.  For example, -I 1,2,5-8 would
              combine all data with an interface index attribute of 1, 2, 5, 6,
              7 or 8.  The resulting aggregate objects will contain an interface
              index attribute of 0.

       -h hours
              The -h hours option may be used to specify the period of
              aggregation, in hours.  The hours argument accepts a decimal value
              to permit aggregation by fractional hour values.  When the -h
              hours option is not used, artsprotoagg will write a single
              protocol table object for the entire time interval seen in
              infile(s) to outfile.

       -o     By default, artsprotoagg appends to the output file, so you may
              accumlate aggregate protocol table objects in a single file over
              multiple invocations of artsprotoagg.  You may override this
              behavior with the -o option.  This will cause artsprotoagg to
              overwrite the output file instead of appending to it.

       -q     By default, artsprotoagg prints a '.' for each protocol table
              object it reads and prints a '+' for each object it writes.  You
              may suppress this behavior with the -q (quiet) option.

EXAMPLES
       artsprotoagg -h 1.0 /tmp/proto1hr.19980821 arts.19980821

SEE ALSO
       artsagg(l), artsprotos(l), artsdump(l), artsases(l), artsasagg(l),
       artsnets(l), artsnetagg(l), artsportmagg(l), artsportms(l), artsports(l),
       artsintfms(l), artsintfmagg(l), artsnexthops(l), artsnexthopagg(l),
       artstos(l), artstoc(l)

ACKNOWLEDGEMENTS
       artsprotoagg and documentation written by Daniel W. McRobb
       CAIDA, August 1998




                                                                  artsprotoagg()