Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
artsintfmagg(l)						       artsintfmagg(l)

NAME
       artsintfmagg  -	utility	 to aggregate interface	matrix objects in time
       domain

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

DESCRIPTION
       artsintfmagg is a utility that reads interface matrix objects from ARTS
       files  (infile(s))  and aggregates them in the time domain, placing the
       resulting interface matrix object(s) into  an  output  file  (outfile).
       For  example,  you may use artsintfmagg to aggregate 5-minute interface
       matrix data to 1-hour interface matrix data.

OPTIONS
       -v     The -v option causes artsintfmagg	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 par-
	      ticular interfaces or sets of interfaces.	 ifIndexList may  con-
	      tain  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 con-
	      tains an interface index attribute  in  ifIndexList.   In	 other
	      words,  the -I ifIndexList option	lets you aggregate data	across
	      a	set of interfaces.  ifIndexList	may contain hyphens  (indicat-
	      ing  an  inclusive  range)  and commas.  For example, -I 1,2,5-8
	      would aggregate all data 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	aggre-
	      gation, in hours.	 The hours argument accepts a decimal value to
	      permit aggregation by fractional hour values.  When the -h hours
	      option  is  not used, artsintfmagg will write a single interface
	      matrix object for	the entire time	interval seen in infile(s)  to
	      outfile.

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

       -q     By  default, artsintfmagg	prints a '.' for each interface	matrix
	      object it	reads and prints a '+' for each	object it writes.  You
	      may suppress this	behavior using the -q (quiet) option.

EXAMPLES
       artsintfmagg -h 1.0 /tmp/intfmagg1hr.19980821 arts.19980821

NOTES
SEE ALSO
       artsagg(l),  artsintfms(l),  artsintfmagg(l), artsnexthops(l), artsnex-
       thopagg(l), artsases(l),	artsasagg(l), artsnets(l), artsnetagg(l), art-
       sportmagg(l),  artsportms(l),  artsports(l),  artsprotoagg(l), artspro-
       tos(l), artstos(l), artstoc(l), artsdump(l)

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

				     LOCAL		       artsintfmagg(l)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | NOTES | SEE ALSO | ACKNOWLEDGEMENTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=artsintfmagg&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help