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 [-v] 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 [-v] 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 [-v] [-p] [-i ifIndexList] [-l maxEntries] [-t AS] [-r] [-s srcAS]
[-d dstAS] infile(s)
artsases
displays a summary of each AS matrix object in ARTS
files. See the manpage (artsases(l)) for more information.
Example output:
% artsases arts.19990819 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Src AS Dst AS Pkts Pkts/sec Bytes Bits/sec ------ ------ ------------- ------------- ------------- ------------- 0 0 37034 96.4427 34022843 708809 194 1909 15806 41.1615 10086355 210132 3967 1909 9051 23.5703 8395655 174909 1224 1909 10086 26.2656 7195383 149904 6461 1909 4537 11.8151 4977144 103690 5050 1909 12347 32.1536 4374027 91125.6 3549 1909 5532 14.4062 3264083 68001.7 10487 1909 2348 6.11458 2102355 43799.1 1740 1909 8332 21.6979 1419569 29574.4 38 1909 11848 30.8542 1308203 27254.2 297 1909 592 1.54167 1229825 25621.4 6227 1909 826 2.15104 1168984 24353.8
usage:
artsnets [-v] [-r] [-p] [-i ifIndexList] [-l maxEntries] [-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.19990819 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Src Network Dst Network Pkts Bytes ------------------ ------------------ ------------- ------------- 128.223.161.22/32 224.2.128.143/32 16407 21366381 192.52.106.0/24 192.172.226.128/27 15606 9822154 141.142.0.0/16 192.172.226.128/27 9874 6936648 209.1.0.0/16 192.172.226.128/27 4523 4434591 128.182.64.0/18 192.172.226.128/27 12347 4374027 209.249.0.0/16 192.172.226.128/27 2332 2926264 209.133.123.90/32 224.2.172.238/32 3532 2365867 128.197.160.29/32 224.2.177.155/32 3740 2310318 128.223.215.225/32 224.2.176.111/32 1924 2218562 209.132.0.0/17 192.172.226.128/27 2282 2096629 128.174.0.0/16 192.172.226.128/27 11841 1307811 216.200.0.0/16 192.172.226.128/27 1137 1220639 204.71.192.0/20 192.172.226.128/27 1733 1206023 63.224.64.0/19 192.172.226.0/26 826 1168984 216.32.160.0/19 192.172.226.64/26 771 978894 206.132.128.0/18 192.172.226.128/27 1004 939426 192.215.0.0/16 192.172.226.128/27 844 926372 192.203.230.0/24 192.172.226.128/27 326 904292 216.184.128.0/17 192.172.226.128/27 680 856372 192.92.126.0/24 192.172.226.128/27 6920 827154 204.212.128.0/19 192.172.226.128/27 6863 815667 216.121.96.0/19 192.172.226.128/27 543 791862 205.253.57.105/32 224.2.177.155/32 783 771311 209.133.0.0/17 192.172.226.128/27 773 725231 163.178.0.0/16 192.172.226.128/27 5471 724441 130.235.133.92/32 224.2.172.238/32 717 704138 128.223.161.21/32 224.2.244.41/32 620 682022 207.246.128.0/20 192.172.226.128/27 738 680724 62.81.0.0/16 192.172.226.128/27 5493 665011 130.240.60.42/32 224.2.172.238/32 1887 655525 216.33.160.0/19 192.172.226.128/27 516 645244 216.49.0.0/18 192.172.226.128/27 680 602690 141.142.220.101/32 224.2.177.155/32 792 579586 209.100.0.0/16 192.172.226.0/26 523 530971 207.82.250.0/23 192.172.226.128/27 792 503945 203.176.0.0/18 192.172.226.128/27 4477 463073
usage:
artsportms [-v] [-p] [-i ifIndexList] [-l maxEntries] [-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.19990819 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT srcPort dstPort Pkts Pkts/sec Bytes Bits/sec ------- ------- ------------- ------------- ------------- ------------- 1038 50562 16318 42.4948 21357457 444947 3128 4104 2071 5.39323 3057562 63699.2 3128 4023 1851 4.82031 2731545 56907.2 2293 51482 3452 8.98958 2351575 48991.1 1058 62268 1921 5.0026 2218278 46214.1 1103 55524 2462 6.41146 2014681 41972.5 3130 3130 12752 33.2083 1317970 27457.7 80 3373 798 2.07812 1179520 24573.3 30385 515 778 2.02604 1166636 24304.9 3128 4125 217 0.565104 875645 18242.6 80 3599 680 1.77083 856372 17841.1 80 1495 836 2.17708 853562 17782.5 80 2133 540 1.40625 791643 16492.6 80 4089 785 2.04427 778601 16220.9 1058 55524 783 2.03906 771311 16069 1071 51482 717 1.86719 704138 14669.5 1040 52382 614 1.59896 681386 14195.5 8081 3130 6134 15.974 639488 13322.7 38566 51482 1796 4.67708 637849 13288.5 80 1664 538 1.40104 625192 13024.8 3128 1088 167 0.434896 550598 11470.8 80 1458 384 1 547682 11410 80 1501 436 1.13542 513379 10695.4 7213 55524 542 1.41146 502022 10458.8 80 1204 415 1.08073 455316 9485.75 3128 3983 375 0.976562 377234 7859.04 3100 42616 250 0.651042 368798 7683.29 80 2824 287 0.747396 349265 7276.35 80 2488 268 0.697917 332975 6936.98 8888 1974 320 0.833333 329596 6866.58 80 4981 247 0.643229 323687 6743.48 1057 28262 248 0.645833 321873 6705.69 3128 3101 131 0.341146 300211 6254.4 1616 55524 389 1.01302 287638 5992.46 80 2568 208 0.541667 278268 5797.25
usage: artsports [-v] [-n] [-p] [-t] [-i ifIndexList] [-l maxEntries] 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.19990819 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 15:38:09 EDT selected ports: 1-1024,6000,7070 Port InPkts InBytes OutPkts OutBytes ----- ------------- ------------- ------------- ------------- 0 3842538 1558961934 183 135428 http 108412 7767342 1156629 1213921483 printer 103687 154890263 0 0 ssh 36314 1861912 163627 54043036 domain 741 47626 24727 6272662 snmp 37196 3746994 93 15813 ftp-data 7017 280892 1352 1991027 svrloc 0 0 5153 831957 6000 4513 753016 0 0 smtp 1996 445836 2036 135266 gopher 0 0 776 418897 ftp 2805 161339 2290 188024 pop3 0 0 668 347934 netbios-ns 0 0 4230 329940 ntp 0 0 2349 189996 xfer 0 0 85 96798 88 0 0 145 70664 bgp 849 56001 79 3160 sunrpc 434 58380 0 0 1024 78 34979 117 17802 nntp 0 0 60 41470 auth 189 9250 312 15075 bootps 74 24272 0 0 https 10 976 84 23028 hosts2-ns 0 0 33 21952 ctf 0 0 17 18517 nicname 0 0 20 9064 dnsix 0 0 48 8920 nameserver 0 0 149 7031 shell 0 0 37 3718 login 0 0 25 2992 ocs_amu 12 756 0 0 kerberos 4 432 0 0 7070 0 0 4 339 netbios-ssn 5 296 0 0
usage: artsprotos [-v] [-n] [-p] [-i ifIndexList] 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.19990819 router: 192.172.226.1 ifIndex: 1 (Ethernet0/0/0 192.172.226.1) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Protocol Pkts Pkts/sec Bytes Bits/sec -------- ------------- ------------- ------------- ------------- udp 10155 26 7278343 151632 icmp 34042 88 1776480 37010 tcp 3344 8 361827 7538 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Protocol Pkts Pkts/sec Bytes Bits/sec -------- ------------- ------------- ------------- ------------- tcp 128780 335 62367956 1299332 udp 66574 173 37321072 777522 icmp 20913 54 1267518 26406 igmp 3 0 612 12 router: 192.172.226.1 ifIndex: 7 (FastEthernet2/0/0 192.172.226.65) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Protocol Pkts Pkts/sec Bytes Bits/sec -------- ------------- ------------- ------------- ------------- tcp 16977 44 2235522 46573 udp 112 0 11541 240 icmp 9 0 556 11 router: 192.172.226.1 ifIndex: 8 (Fddi2/1/0 192.172.226.129) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT Protocol Pkts Pkts/sec Bytes Bits/sec -------- ------------- ------------- ------------- ------------- tcp 137215 357 98659010 2055396 udp 27301 71 2878374 59966 icmp 1803 4 133854 2788
usage: artstos [-v] [-n] [-p] [-i ifIndexList] infile(s)
artstos
is a utility that reads TOS table objects
from ARTS files and displays a summary of their contents on stdout.
See the manpage (artstos(l)) for more information.
Example output:
% artstos arts.19990819 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:23:13 - 08/19/1999 13:28:10 EDT TOS Pkts Pkts/sec Bytes Bits/sec -------- ------------- ------------- ------------- ------------- 0 179070 602 83042852 2236844 8 1751 5 1040714 28032 16 4377 14 689586 18574 192 10593 35 600186 16166 160 79 0 108484 2922 136 6 0 682 18 41 12 0 656 17 224 8 0 616 16 96 3 0 164 4
usage: artsintfms [-v] [-p] [-i ifIndexList] [-s srcIntfList] [-d dstIntfList] infile(s)
artsintfms
displays a summary of each interface matrix object
in ARTS files. See the manpage (artsintfms(l)) for more information.
Example output:
% artsintfms -i 1,5 arts.19990819 router: 192.172.226.1 ifIndex: 1 (Ethernet0/0/0 192.172.226.1) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT SrcIntf DstIntf Pkts Pkts/sec Bytes Bits/sec ------- ------- ------------- ------------- ------------- ------------- 1 0 8135 21.1849 7076762 147433 1 5 38898 101.297 2245081 46772.5 1 8 508 1.32292 94807 1975.15 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT SrcIntf DstIntf Pkts Pkts/sec Bytes Bits/sec ------- ------- ------------- ------------- ------------- ------------- 5 8 147173 383.263 60293921 1.25612e+06 5 0 38888 101.271 34223634 712992 5 1 23364 60.8438 3248003 67666.7 5 7 6845 17.8255 3191600 66491.7
usage: artsnexthops [-v] [-p] [-i ifIndexList] [-l maxEntries] infile(s)
artsnexthops
is a utility that reads nexthop table objects
from ARTS files and displays a summary of their contents on stdout. See the
manpage (artsnexthops(l)) for more information.
Example output:
% artsnexthops arts.19990819 router: 192.172.226.1 ifIndex: 1 (Ethernet0/0/0 192.172.226.1) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT NextHop Pkts Pkts/sec Bytes Bits/sec ------------- ------------- ------------- ------------- ------------- 0.0.0.0 8135 21 7076762 147432 198.17.46.10 37602 97 2052755 42765 198.17.46.205 702 1 145110 3023 192.172.226.145 495 1 91916 1914 198.17.46.43 507 1 40304 839 198.17.46.110 67 0 5442 113 192.172.226.147 11 0 2625 54 198.17.46.112 10 0 564 11 198.17.46.1 4 0 483 10 198.17.46.33 6 0 423 8 192.172.226.130 2 0 266 5 router: 192.172.226.1 ifIndex: 5 (Fddi0/1/0 198.17.46.56) period: 08/19/1999 13:16:46 - 08/19/1999 13:23:10 EDT NextHop Pkts Pkts/sec Bytes Bits/sec ------------- ------------- ------------- ------------- ------------- 192.172.226.145 123285 321 53931898 1123581 0.0.0.0 38886 101 34222814 712975 192.172.226.146 23865 62 6359117 132481 192.172.226.62 812 2 1168086 24335 192.172.226.110 918 2 1160614 24179 192.172.226.24 18843 49 1109530 23115 192.172.226.82 913 2 995412 20737 192.172.226.35 1612 4 736684 15347 192.172.226.112 1780 4 500747 10432 192.172.226.99 203 0 250952 5228 192.172.226.30 1993 5 211179 4399 192.172.226.89 2405 6 150416 3133 192.172.226.107 125 0 87562 1824 192.172.226.122 286 0 21316 444 192.172.226.113 174 0 20025 417 192.172.226.16 68 0 19684 410 192.172.226.147 23 0 3558 74 192.172.226.104 21 0 2268 47 192.172.226.44 16 0 1400 29 192.172.226.105 9 0 1384 28
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:
artsagg [-v] [-i ifIndexList] [-I ifIndexList] [-s portlist] [-T objectTypes]
[-h hours] [-o] [-q] outfile infile(s)
artsagg
reads AS matrix, net matrix, port matrix, protocol
table, TOS table, interface matrix and IP nexthop table objects from
ARTS files (infile(s)
) and aggregates them in the time domain,
placing the resulting object(s) into an output file (outfile
).
See the manpage (artsagg(l)) for more information.
usage:
artsasagg [-v] [-i ifIndexList] [-I ifIndexList] [-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 [-v] [-i ifIndexList] [-I ifIndexList] [-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 [-v] [-i ifIndexList] [-I ifIndexList] [-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 [-v] [-i ifIndexList] [-I ifIndexList] [-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] [-i ifIndexList] [-I ifIndexList] [-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] [-i ifIndexList] [-I ifIndexList] [-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.