A handul of simple utilities for viewing the contents of ARTS files
are included with arts++. These tools simply read the
contents of ARTS files and produce output on stdout. They're
really just simple examples of using the class library. However,
some users may find them useful in their own right, particularly when
working with aggregate data.
usage: artdsump infile(s)
artsdump is a general utility for viewing the contents of
an ARTS file. artsdump reads all ARTS data from the files
specified on the command line and dumps it to stdout in a
human-readable form.
Note that the output format is verbose and not amenable to post
processing. The output is not intended to be fed to other programs.
artsdump is intended only to aid the user in quickly verifying
or viewing the entire contents of an ARTS file.
See the manpage (artsdump(l)) for more information.
usage: artstoc infile(s)
artstoc is a utility that reads ARTS objects from ARTS files
and displays a one-line summary for each object on stdout. This utility
is typically used to quickly check the type and quantity of objects
stored in an ARTS file. See the manpage (artstoc(l)) for more
information.
Example output:
% artstoc arts.19980817 192.172.226.1 08/17/1998 05:30:44 - 08/17/1998 05:37:42 EDT protocol table 192.172.226.1 08/17/1998 05:30:44 - 08/17/1998 05:37:42 EDT port table 192.172.226.1 08/17/1998 05:30:44 - 08/17/1998 05:37:42 EDT AS matrix 192.172.226.1 08/17/1998 05:38:00 - 08/17/1998 05:48:03 EDT protocol table 192.172.226.1 08/17/1998 05:38:00 - 08/17/1998 05:48:03 EDT port table 192.172.226.1 08/17/1998 05:38:00 - 08/17/1998 05:48:03 EDT net matrix 192.172.226.1 08/17/1998 05:38:00 - 08/17/1998 05:48:03 EDT AS matrix 192.172.226.1 08/17/1998 05:48:03 - 08/17/1998 05:52:54 EDT protocol table 192.172.226.1 08/17/1998 05:48:03 - 08/17/1998 05:52:54 EDT port table 192.172.226.1 08/17/1998 05:48:03 - 08/17/1998 05:52:54 EDT net matrix 192.172.226.1 08/17/1998 05:48:03 - 08/17/1998 05:52:54 EDT AS matrix
usage: artsases [-p] [-s srcAS] [-d dstAS] infile(s)
artsases displays a summary of each AS matrix object in ARTS
files. Example output:
% artsases arts.19980817
router: 192.172.226.1
period: 08/17/1998 05:30:44 - 08/17/1998 05:37:42 EDT
Src AS Dst AS Pkts Pkts/sec Bytes Bits/sec
------ ------ ------------- ------------- ------------- -------------
195 195 70784 169.34 18301728 350272
87 195 55445 132.644 12702754 243115
3 195 53667 128.39 5130268 98186.9
1224 195 8764 20.9665 4746527 90842.6
3967 195 4514 10.799 3230531 61828.3
7220 195 2073 4.95933 3066911 58696.9
195 234 2151 5.14593 3056251 58492.8
7050 195 3546 8.48325 2382911 45606
33 195 3616 8.65072 2315453 44314.9
297 195 1613 3.85885 2197017 42048.2
194 195 10483 25.0789 2124627 40662.7
7224 195 1674 4.00478 1979142 37878.3
usage: artsnets [-p] [-s srcNet/mask] [-d dstNet/mask] infile(s)
artsnets displays a summary of each net matrix object in ARTS files.
See the manpage (artsnets(l)) for more information.
Example output:
% artsnets arts.19980817
router: 192.172.226.1
period: 08/17/1998 05:38:00 - 08/17/1998 05:48:03 EDT
Src Network Dst Network Pkts Bytes
------------------ ------------------ ------------- -------------
205.189.33.75/32 224.2.202.41/32 77168 62334623
130.149.0.0/16 224.2.231.31/32 30179 24064955
164.58.0.0/16 224.2.131.215/32 18146 4852665
128.223.83.204/32 224.2.246.13/32 12265 4397400
131.188.34.134/32 224.2.172.238/32 2568 2047808
164.58.0.0/16 224.2.131.215/32 17987 1913904
133.82.241.137/32 224.2.172.238/32 6485 1683392
204.123.0.0/16 192.172.226.146/32 959 1427774
209.1.0.0/16 192.172.226.145/32 1231 1362956
205.216.162.0/23 192.172.226.145/32 828 1162127
129.89.143.30/32 224.2.172.238/32 3633 1019726
206.204.0.0/16 192.172.226.145/32 687 1016236
134.102.218.45/32 227.6.5.7/32 771 818813
192.76.157.71/32 224.2.204.172/32 781 810713
192.76.157.71/32 224.2.204.172/32 676 698131
192.76.157.71/32 224.2.204.172/32 641 662238
209.1.0.0/16 192.172.226.128/25 459 483147
203.8.105.0/24 192.172.226.128/25 4450 482959
192.172.226.0/25 204.212.44.0/22 580 460780
192.76.157.71/32 224.2.204.172/32 440 447540
193.174.75.166/32 227.6.5.7/32 374 401422
192.150.12.0/24 192.172.226.145/32 168 367235
204.152.184.0/21 192.172.226.0/25 223 327102
usage: artsportms [-p] [-s srcPort] [-d dstPort] infile(s)
artsportms displays a summary of each port matrix object in ARTS
files. See the manpage (artsportms(l)) for more information.
Example output:
% artsportms arts.19981005
router: 192.172.226.1
ifIndex: 1
period: 10/04/1998 23:55:06 - 10/05/1998 23:56:09 CUT
srcPort dstPort Pkts Pkts/sec Bytes Bits/sec
------- ------- ------------- ------------- ------------- -------------
22 47164 1564950 17.3762 2133171600 189483
22 47762 897360 9.96369 1343973900 119381
1029 10000 1041240 11.5612 1070394720 95079.6
22 47591 378600 4.20372 567690210 50426.1
22 47365 31536 0.350155 47102464 4183.96
6000 22041 516041 5.72978 43601192 3872.95
979 22 461500 5.12419 39132700 3476.03
80 21777 28500 0.316445 37517700 3332.57
80 1193 28080 0.311782 37169280 3301.62
80 1799 29040 0.322441 36595200 3250.63
22 47169 26340 0.292462 36525240 3244.42
80 1137 25020 0.277806 34630200 3076.09
55678 53 483652 5.37015 30862702 2741.43
80 2006 22320 0.247827 27806760 2469.98
usage: artsports [-p] [-t] infile(s)
artsports displays a summary of each port table object and
selected port table object in ARTS files. See the manpage
(artsports(l)) for more information.
Example output:
% artsports artsagg.19981005
router: 192.172.226.1
ifIndex: 1
period: 10/04/1998 19:55:06 - 10/05/1998 19:56:09 EDT
selected ports: 1-2048,6000,7070
Port InPkts InBytes OutPkts OutBytes
----- ------------- ------------- ------------- -------------
22 1200549 88829504 3200619 4163947490
1029 0 0 1041240 1070394720
80 1260232 106367970 848827 765735423
53 501944 32169952 147542 30033536
6000 0 0 516041 43601192
0 527376 43382817 0 0
20 874012 34961888 0 0
513 177475 7224754 0 0
25 25514 3993236 41671 2807293
139 156654 6690843 0 0
515 2457 3002610 0 0
137 0 0 20257 2386046
110 39438 1778969 0 0
1017 0 0 20558 1502200
443 14730 1452375 0 0
23 21810 887940 0 0
123 0 0 11428 868528
113 9224 394818 2103 84120
138 0 0 1089 254810
750 0 0 1238 224052
1772 2400 167040 0 0
1025 0 0 1680 113040
1033 0 0 600 82320
1822 900 62640 0 0
usage: artsprotos [-p] infile(s)
artsprotos is a utility that reads protocol table objects
from ARTS files and displays a summary of their contents on stdout.
See the manpage (artsprotos(l)) for more information.
Example output:
% artsprotos arts.19981005
router: 192.172.226.1
ifIndex: 1
period: 10/04/1998 23:55:06 - 10/05/1998 23:56:09 CUT
Protocol Pkts Pkts/sec Bytes Bits/sec
-------- ------------- ------------- ------------- -------------
6 8466492 94 5237854239 465261
17 2207792 24 1175888232 104450
1 5785338 64 324733568 28845
router: 192.172.226.1
ifIndex: 8
period: 10/04/1998 23:55:06 - 10/05/1998 23:56:09 CUT
Protocol Pkts Pkts/sec Bytes Bits/sec
-------- ------------- ------------- ------------- -------------
6 154258552 1712 120841663280 10733967
17 19487284 216 1921468060 170677
1 3662818 40 222174954 19735
artsintfms displays a summary of each interface matrix object
in ARTS files. Example output:
% artsintfms arts.19981207
router: 204.212.46.1
ifIndex: 4
period: 12/06/1998 18:58:37 - 12/06/1998 19:03:37 EST
SrcIntf DstIntf Pkts Pkts/sec Bytes Bits/sec
------- ------- ------------- ------------- ------------- -------------
4 5 108272 360.907 5694529 151854
4 0 157 0.523333 11932 318.187
router: 204.212.46.1
ifIndex: 5
period: 12/06/1998 18:58:37 - 12/06/1998 19:03:37 EST
SrcIntf DstIntf Pkts Pkts/sec Bytes Bits/sec
------- ------- ------------- ------------- ------------- -------------
5 4 36845 122.817 2191172 58431.3
5 0 11 0.0366667 616 16.4267
See the manpage (artsintfms(l)) for more information.
artsnexthops is a utility that reads nexthop table objects
from ARTS files and displays a summary of their contents on stdout.
Example ouptut:
% artsnexthops arts.19981207
router: 204.212.46.1
ifIndex: 4
period: 12/06/1998 18:58:37 - 12/06/1998 19:03:37 EST
NextHop Pkts Pkts/sec Bytes Bits/sec
------------- ------------- ------------- ------------- -------------
0.0.0.0 108429 361 5706461 152172
router: 204.212.46.1
ifIndex: 5
period: 12/06/1998 18:58:37 - 12/06/1998 19:03:37 EST
NextHop Pkts Pkts/sec Bytes Bits/sec
------------- ------------- ------------- ------------- -------------
204.212.46.2 35918 119 2008940 53571
204.212.46.6 617 2 154368 4116
204.212.46.3 310 1 27864 743
0.0.0.0 11 0 616 16
See the manpage (artsnexthops(l)) for more information.
It is often useful to reduce the time domain granularity of ARTS
data, to produce summary reports of traffic over long time intervals.
The arts++ package contains a handful of utilities to
aggregate some types of ARTS data in the time domain. While these
are primarily examples of using features in the class library, they
are often useful utilities in their own right.
usage: artsasagg [-h hours] [-o] [-q] outfile infile(s)
artsasagg reads AS matrix objects from ARTS files
(infile(s)) and aggregates them in the time domain, placing the
resulting AS matrix object(s) into an output file (outfile).
See the manpage (artsasagg(l)) for more information.
usage: artsnetagg [-h hours] [-o] [-q] outfile infile(s)
artsnetagg reads net matrix objects from ARTS files
(infile(s)) and aggregates them in the time domain, placing the
resulting net matrix object(s) into an output file (outfile).
See the manpage (artsnetagg(l)) for more information.
usage: artsportmagg [-s portlist] [-h hours] [-o] [-q] outfile infile(s)
artsportmagg reads port matrix objects from ARTS files
(infile(s)) and aggregates them in the time domain, placing the
resulting port matrix object(s) or selected port table objects into an
output file (outfile). See the manpage
(artsportmagg(l)) for more information.
usage: artsprotoagg [-h hours] [-o] [-q] outfile infile(s)
artsprotoagg 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). See the manpage (artsprotoagg(l)) for more
information.
usage: artsintfmagg [-v] [-h hours] [-o] [-q] outfile infile(s)
artsintfmagg 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). See the manpage (artsintfmagg(l)) for more
information.
usage: artsnexthopagg [-v] [-q] [-o] [-h hours] outfile infile(s)
artsnexthopagg reads nexthop table objects from ARTS files
(infile(s)) and aggregates them in the time domain, placing the
resulting nexthop table object(s) into an output file
(outfile). See the manpage (artsnexthopagg(l)) for more
information.