# # Argus Client Software. Tools to read, analyze and manage Argus data. # Copyright (c) 2000-2003 QoSient, LLC # All rights reserved. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # # Example .rarc # # Ra* clients will open this file if its in the users HOME directory, # or in the $ARGUSHOME directory, and parse it to set common configuration # options. All of these values will be overriden by those options # set on the command line, or in the file specified using the -f option. # # Values can be quoted to make string denotation easier, however, the # parser does not require that string values be quoted. To support this, # the parse will remove '\"' characters from input strings, so do not # use this character in strings themselves. # # Values specified as "" will be treated as a NULL string, and the parser # will ignore the variable setting. # # All ra* clients can attach to a remote server, and collect argus data # in real time. This variable can be a name or a dot notation IP address. # #RA_ARGUS_SERVER=localhost # All ra* clients can read Cicso Netflow records directly from Cisco # routers. Specifying this value will alert the ra* client to open # a UDP based socket listening for data on this port number. # #RA_CISCONETFLOW_PORT= # Whether the remote data source is an Argus Server or a Cisco router, # the port number that will be used to bind to is specified using this # variable. For Argus Servers, the default is 561, the "experimental # monitor" port. For Cisco Netflow records, the default is 9995. # RA_ARGUS_SERVERPORT=561 # When argus is compiled with SASL support, ra* clients may be # required to authenticate to the argus server before the argus # will accept the connection. This variable will allow one to # set the user and authorization id's, if needed. Although # not recommended you can provide a password through the # RA_AUTH_PASS variable. The format for this variable is: # # RA_USER_AUTH="user_id/authorization_id" # #RA_USER_AUTH="user/user" #RA_AUTH_PASS="password" # All ra* clients can support writing its output as Argus Records into # a file. Stdout can be specified using "-". # #RA_OUTPUT_FILE="" # All ra* clients can support filtering its input based on a time # range. The format is: # timeSpecification[-timeSpecification] # # where the format of a timeSpecification can be one of these: # [mm/dd[/yy].]hh[:mm[:ss]] # mm/dd[/yy] # #RA_TIMERANGE="" # All ra* clients can support running for a number of seconds, # while attached to a remote source of argus data. This is a type # of polling. The default is zero (0), which means run indefinately. # RA_RUN_TIME=0 # Most ra* clients are designed to print argus records out in ASCII, # with each client supporting its own output formats. For ra() like # clients, this variable will generate column headers as labels. # The number is the number of lines between repeated header output. # Setting this value to zero (0) will cause the labels to be printed # once. If you don't want labels, then comment this line out or # delete it. # # RA_PRINT_LABELS=0 # All ra* clients are designed to provide flexibility in what data # is printed when configured to generate ASCII output. # For ra() like clients, this variable overide the default field # printing specification. This is the equivalent to the "-s option". # The below example is the default field definition. # RA_FIELD_SPECIFIER="startime ind proto saddr sport dir daddr dport pkts bytes status" # Most ra* clients are designed to print argus records out in ASCII, # with each client supporting its own output formats. For ra() like # clients, this variable can overide the default field delimiter, # which are variable spans of space (' '), to be any character. # The most common are expected to be '\t' for tabs, and ',' for # comma separated fields. # RA_FIELD_DELIMITER='' # # For ra() like clients, this variable will printout Summary data # for the client session, at the termination of the program. # RA_PRINT_SUMMARY=no # # For ra() like clients, this variable will suppress resolving # hostnames, and print the dot notation IP address, or ':' notation # ethernet address. There is a huge performance impact with # name lookup, so the default is to not resolve hostnames. # RA_PRINT_HOSTNAMES=no # For ra() like clients, this variable will include the response # data that is provided by Argus. This is protocol and state # specific. # RA_PRINT_RESPONSE_DATA=no # For ra() like clients, this variable will force the timestamp # to be in Unix time format, which is an integer representing the # number of elapsed seconds since the epoch. # RA_PRINT_UNIX_TIME=no # For ra() like clients, this variable is used to override the # time format of the timestamp. This string must conform to # the format specified in strftime(). Malformed strings can # generate fatal errors, so be careful with this one. # RA_TIME_FORMAT="%y/%m/%d %T" # For ra() like clients, this variable is used to override the # time format of the timestamp. This variable specifies the # number of decimal places that will be printed as the fractional # part of the time. Argus collects usec precision, and so a # maximum value of 6 is supported. To not print the fractional # part, specify the value zero (0). # RA_USEC_PRECISION=0 # Argus can capture user data. When printing out the user data # contents, using tools such as raxml(), the type of encoding # can be specified here. Supported values are "Ascii", "Encode64", # or "Encode32". # #RA_USERDATA_ENCODE=Encode32 #RA_USERDATA_ENCODE=Encode64 RA_USERDATA_ENCODE=Ascii # If compiled to support this option, ra* clients are capable # of generating a lot of use [full | less | whatever] debug # information. The default value is zero (0). # RA_DEBUG_LEVEL=0 # You can provide a filter expression here, if you like. # It should be limited to 2K in length. The default is to # not filter. # #RA_FILTER="" # When you intend to print hostnames and port service names # rather than the numbers, these variables will help to # avoid truncating of hostnames, and provide pretty printing # with tools such as ra(), ragator() and rasort(). # These values are simple suggestions. # RA_HOST_FIELD_LENGTH=15 RA_PORT_FIELD_LENGTH=6