na.layers2 manual page
Table of Contents

NAME

na.layers2 - network layers statistics for Solaris 2.x

DESCRIPTION

na.layers2 returns information about the various network layers on the host where the agent is running.

A reporting interval is specified by the management application. If a reporting interval is not specified, the agent will send a report every 30 seconds.

ATTRIBUTES

na.layers2 has four attribute groups: udp, ip, icmp, and tcp.

The udp group reports statistics about the UDP protocol. (See RFC768 for information about UDP.) The group includes:

udp_indatagrams - number of datagrams received (counter) udp_outdatagrams - number of datagrams sent (counter) udp_inerrors - number of errors on input datagrams (counter)

The ip group reports statistics about the IP protocol. (See RFC791 for information about IP.) The group includes:

ip_forwarding - determines if the node is a gateway: 1=gateway, 2= NOT gateway (int)
ip_default_ttl - default time-to-live for iph (int) ip_in_receives - number of input datagrams (counter) ip_in_hdr_errors - number of discards for header errors (counter)
ip_in_addr_errors - number of discards for bad address (counter)
ip_forw_datagrams - number of datagrams being forwarded (counter)
ip_unknown_protos - number of discards for unknown protocol (counter)
ip_in_discards - number of discards of good datagrams (counter)
ip_in_delivers - number of datagrams sent upstream (counter) ip_out_requests - number of datagrams received from upstream (counter)
ip_out_discards - number of good outgoing datagrams discarded (counter)
ip_out_no_routes - number of outgoing discards because no route found (counter)

ip_reasm_timout - number of seconds received fragments are held for reassembly (int)
ip_reasm_reqds - number of IP fragments needing reassembly (counter)
ip_frags_ok - number of datagrams fragmented (counter) ip_frag_fails - number of datagrams discarded for no fragment set (counter)
ip_frag_creates - number of datagram fragments from fragmentation (counter)
ip_addr_entry - (int)
ip_route_entry_size - (int)
ip_net_to_media_size - (int)
ip_routing_discards - (int)
tcp_in_errs - number of segments received with errors (counter)
ip_routing_discards - number of received datagrams not delivered (counter)

The icmp group reports statistics about the ICMP protocol. (See RFC792 for information about ICMP.) The group includes:

icmp_in_msgs - number of ICMP messages received (counter) icmp_in_errors - number of ICMP errors on receive (counter) icmp_in_dest_unreachs - number of received ``dest unreachable'' messages (counter)
icmp_in_time_excds - number of received ``time exceeded'' messages (counter)
icmp_in_param_probs - number of received ``parameter problem'' messages (counter)
icmp_in_src_quenchs - number of received ``src quench'' messages (counter)
icmp_in_redirects - number of received ``icmp redirect'' messages (counter)
icmp_in_echos - number of received ``echo request'' messages (counter)
icmp_in_echo_reps - number of received ``echo reply'' messages (counter)
icmp_in_timestamps - number of received ``timestamp'' messages (counter)
icmp_in_timestamp_reps - number of received ``timestamp reply'' messages (counter)

icmp_in_addr_masks - number of received ``addr mask request'' messages (counter)
icmp_in_addr_mask_reps - number of received ``addr mask reply'' messages (counter)
icmp_out_msgs- total number of ICMP messages sent (counter) icmp_out_errors - number of messages not sent because of internal ICMP errors (counter)
icmp_out_dest_unreachs - number of ``dest unreachable'' messages sent (counter)
icmp_out_time_excds - number of ``timeout exceeded'' messages sent (counter)
icmp_out_param_probs - number of ``parameter problems'' messages sent (counter)
icmp_out_src_quench - number of ``src quench'' messages sent (counter)
icmp_out_redirects - number of ``ICMP redirect'' messages sent (counter)
icmp_out_echos - number of ``echo request'' messages sent (counter)
icmp_out_echo_reps - number of ``echo reply'' messages sent (counter)
icmp_out_timestamps - number of ``timestamp request'' messages sent (counter)
icmp_out_timestamp_reps - number of ``timestamp reply'' messages sent (counter)
icmp_out_addr_mask - number of ``addr mask request'' messages sent (counter)
icmp_out_addr_mask_reps - number of ``addr mask reply'' messages sent (counter)

The tcp group reports statistics about the TCP protocol. (See RFC793 for information about TCP.) The group includes:

tcp_r_to_algorithm - algorithm used for transmit timeout value (int)
tcp_r_to_min - minimum retransmit timeout (ms) (int) tcp_r_to_max - maximum retransmit timeout (ms) (int) tcp_max_conn - maximum number of connections supported (int) tcp_active_opens - number of direct transitions CLOSED -> SYN-SENT (counter)
tcp_passive_opens - number of direct transitions LISTEN -> SYN_RCVD (counter)

tcp_attempt_fails - number of direct SIN-SENT/RCVD -> CLOSED/LISTEN (counter)
tcp_estab_resets - number of direct ESTABLISHED/CLOSED-WAIT -> CLOSED (counter)
tcp_curr_estab - number of connections ESTABLISHED or CLOSE WAIT (counter)
tcp_in_segs - number of of segments received (counter) tcp_out_segs - number of segments sent (counter) tcp_retrans_segs - number of segments retransmitted (counter)
tcp_conn_table_size - table size (int)
tcp_out_rsts - segments sent with RST flag (counter)

OPTIONS

na.layers2 has no options:

ERRORS

can't read kernel memory
The agent uid does not have permission to read kernel statistics, /dev/kstat. Run the agent as root-the default when inetd (1M) starts the agent-or give read permission to the uid the agent is running under.


Table of Contents