NAME

ripxrtmetric − RIP route metric monitor

SYNOPSIS

ripxrtmetric gw [options]

DESCRIPTION

ripxrtmetric is a graphical route metric monitor compatible with X-Windows Version 11.  ripxrtmetric will query an agent agent for route metric information and display the metrics for a set of networks in the form of a bar graph.  gw the gateway to be monitored may be specified as a dot notation address such as ’128.213.1.2’.  The networks whose route metrics are to be monitored are specified in a configuration file (see Configuration File below). Note that in the event that  agent agent does not have a route metric for a certain net that is to be monitored, the net will be indicated as unreachable on the display. Also, a net will be indicated as unreachable if no response containing metric information for that net is ever received by agent.  The maximum number of nets supported by any single ripxrtmetric process is determined by the MAXNETS constant compiled into the application.  Currently MAXNETS is set at 256.  ripxrtmetric has a threshold capability - metric lines will change color from green to red (if the application was compiled to display in color) or from solid to dashed (if the application was compiled to display on a monochrome device) if metrics reach MAXMETRIC (16). 

OPTIONS

--f configfile: read the networks whose route metrics are to be monitored from the configuration file configfile. 

--i interval: query for routing information at intervals of interval seconds.  The default is 60 seconds. 

X-WINDOW OPTIONS

The following are the X-window options.  These options follow the X-window convention as closely as possible.  -display host:display

This option allows ripxrtmetric to be run on a remote X server.  In specifying the display, use the standard X format.  For example, rebel:0.0. 

Using X Resources

Ripxrtmetric reads the command line arguments, then passes through the users $HOME/.Xdefaults file and creates a local resource database.  Any command line option will take precedence over the .Xdefaults parameter.  Here are a list of all settable ripxrtmetric parameters in .Xdefaults format, the values given are the default values if nothing is specified:

ripxrtmetric.display:1:0.0
ripxrtmetric.font:6x10
ripxrtmetric.geometry:NULL  (as big as font dictates)
ripxrtmetric.borderwidth:2
ripxrtmetric.name:ripxrtmetric
ripxrtmetric.reverseVideo:off
ripxrtmetric.color:on
ripxrtmetric.background:NavyBlue
ripxrtmetric.foreground:white
ripxrtmetric.bordercolor:red
ripxrtmetric.graphcolor:white
ripxrtmetric.badcolor:red
ripxrtmetric.goodcolor:green
ripxrtmetric.interval:60
ripxrtmetric.community:"public"
ripxrtmetric.bell:on

CONFIGURATION FILE

The format of the ripxrtmetric configuration file is lines of the form:

net_name        ipaddress

Lines beginning with ’#’ are treated as comments. 

FILES

configfile           config file for the application

BUGS

ripxrtmetric is extremely RIP-centric.  To query the metric, RIP poll/request commands are used.  ripxrtmetric is intended to be used as a tool for debugging RIP gateways, not for network management.  snmpxrtmetric is the prefered for management. 

SEE ALSO

routed(8) gated(8) ripquery(1) snmpxrtmetric(1) snmprtmetric(1) J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.1C