NAME
na.ping - machine reachability information
DESCRIPTION
na.ping is a proxy agent that reports machine reachability information. The information is gathered by sending ICMP ECHO request packets to the target machine from the specified proxy and getting the round-trip time of replies.
A reporting interval is specified by the management application. If a reporting interval is not specified, the proxy agent will report every 30 seconds.
ATTRIBUTES
na.ping has two attribute groups, reach and stats.
The reach group reports host reachability information and packet round trip time. The group includes:
hostname - name of the target system (string[32]) size - datagram packet size, in bytes, sent to target system (int). If the datagram passes through a gateway, the packet might be split into fragments. (Fragment size is the maximum packet size (MTU) any given gateway can handle.) triptime - round trip time, in milliseconds, to send a packet from the proxy agent system to the target system and back (gauge). If the host is unreachable, this value is set to the number of milliseconds before the request timed out. reachable - an enumerated type indicating whether the host is reachable using ICMP ECHO. The value ``true'' means that the host is reachable while ``false'' indicates that the host is unreachable.
The stats group reports statistics for packets sent to a particular machine. These statistics include the average round-trip time, maximum round-trip time, percent of lost packets, and so on. The group includes:
hostname - name of the target system (string[32]) size - datagram packet size, in bytes, sent to target system (int). If the datagram passes through a gateway, the packet might be split into fragments. (Fragment size is the maximum packet size (MTU) that any given gateway can handle.) sent - number of packets sent (gauge)
dropped - number of packets dropped (gauge) dups - number of duplicate ECHO REPLY messages received (gauge)
pktloss - packet loss percentage (gauge)
tripmin - minimum round trip time, in milliseconds (gauge). If the host is unreachable, this value is set to the number of milliseconds before the request timed out. tripmax - maximum round trip time, in milliseconds (gauge). If the host is unreachable, this value is set to the number of milliseconds before the request timed out. tripavg - average round trip time, in milliseconds (gauge). If the host is unreachable, this value is set to the number of milliseconds before the request timed out. reachable - an enumerated type indicating whether the host is reachable using ICMP ECHO. The value ``true'' means that the host is reachable, while ``false'' indicates that the host is unreachable.
ERRORS
cannot create new subprocess; would exceed maximum: maximum The proxy agent cannot start a new request because creating a new subprocess would exceed the maximum number of proxy agent subprocesses allowed. Either terminate some requests and then resubmit the request or modify the value associated with the ``na.ping.maxsubprocs'' keyword in /etc/opt/SUNWconn/snm/snm.conf for Solaris 2.x and in /etc/snm.conf for Solaris 1.x. If you change the ``na.ping.max-subprocs'' value, you must terminate all na.ping requests, kill all na.ping processes, and then restart the ping requests.
send(3n) call failed
The target system may not be reachable due to routing or other network problems. See send(3n).
bad option string specified
The option string was not formatted correctly.
socket(3n) call failed
This message could be due to permission problems, system resource limits reached, or a number of other reasons. See socket(3n).