NAME

na.layers - network layers statistics for SunOS 4.1.x

DESCRIPTION

na.layers returns information about the various network layers on the host where the agent is running. By default, the agent reads /vmunix to get the kernel name list.

This agent only runs on 4.x systems. A new agent, na.layers2(8), runs on SunOS 5.x systems.

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.layers 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:

bad_hdr - number of incomplete headers (counter)

bad_len - number of bad data length fields (counter)

bad_cksum - number of bad checksums (counter)

sock_oflow - number of socket overflows (counter)

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

in_pkts - number of packets received (counter)

bad_hdr_cksum - number of bad header checksums (counter)

size_min - number of less than minimum size packets (counter)

bad_size - number of packets with less data than shown in the data length field (counter)

hdr_len - number of packets with improper header length (counter)

data_len - number of packets with data length less than header length (counter)

frags - number of fragments received (counter)

frags_drop - number of fragments dropped due to duplication or being out of space (counter)

drop_time - number of fragments dropped after timeout (counter)

forward - number of packets forwarded (counter)

bad_forward - number of packets not forwardable (counter)

redirects - number of redirects sent (counter)

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

icmp_error - number of calls to icmp_error (counter)

err_short - number of errors not generated because old message was too short (counter)

err_icmp - number of errors not generated because old message was ICMP (counter)

bad_code - number of times icmp_code out of range (counter)

icmp_min_len - number of less than minimum length messages (counter)

icmp_cksum - number of bad checksums (counter)

icmp_bad_len - number of calculated bound mismatches (counter)

out_dst_unreachable - number of ICMP destination unreachables sent (counter)

out_time_exceeded - number of ICMP time exceeded sent (counter)

out_parameter - number of ICMP parameter problems sent (counter)

out_src_quench - number of ICMP source quenches sent (counter)

out_redirect - number of ICMP redirects sent (counter)

out_echo - number of ICMP echo requests sent (counter)

out_echo_reply - number of ICMP echo replies sent (counter)

out_time_stamp - number of ICMP timestamp requests sent (counter)

out_time_stamp_reply - number of ICMP timestamp replies sent (counter)

out_addr_mask_rqst - number of ICMP address mask requests sent (counter)

out_addr_mask_rqst_reply - number of ICMP address mask replies sent (counter)

out_info_rqst - number of ICMP information requests sent (counter)

out_info_rqst_reply - number of ICMP information request replies sent (counter)

in_dst_unreachable - number of ICMP destination unreachables received (counter)

in_time_exceeded - number of ICMP time exceededs received (counter)

in_parameter - number of ICMP parameter problems received (counter)

in_src_quench - number of ICMP source quenches received (counter)

in_redirect - number of ICMP redirects received (counter)

in_echo - number of ICMP echo requests received (counter)

in_echo_reply - number of ICMP echo replies received (counter)

in_time_stamp - number of ICMP timestamp requests received (counter)

in_time_stamp_reply - number of ICMP timestamp replies received (counter)

in_add_mask_rqst - number of ICMP address mask requests received (counter)

in_add_mask_rqst_rply - number of ICMP address mask replies received (counter)

in_info_rqst - number of ICMP information requests received (counter)

in_info_rqst_reply - number of ICMP information request replies received (counter)

out_unknown_type_1 - number of times unknown code #1 in outgoing type field (counter)

out_unknown_type_2 - number of times unknown code #2 in outgoing type field (counter)

out_unknown_type_6 - number of times unknown code #6 in outgoing type field (counter)

out_unknown_type_7 - number of times unknown code #7 in outgoing type field (counter)

out_unknown_type_9 - number of times unknown code #9 in outgoing type field (counter)

out_unknown_type_10 - number of times unknown code #10 in outgoing type field (counter)

in_unknown_type_1 - number of times unknown code #1 in incoming type field (counter)

in_unknown_type_2 - number of times unknown code #2 in incoming type field (counter)

in_unknown_type_6 - number of times unknown code #6 in incoming type field (counter)

in_unknown_type_7 - number of times unknown code #7 in incoming type field (counter)

in_unknown_type_9 - number of times unknown code #9 in incoming type field (counter)

in_unknown_type_10 - number of times unknown code #10 in incoming type field (counter)

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

pkts_sent - number of packets sent (counter)

snd_data_pkts - number of data packets sent (counter)

snd_data_bytes - number of data bytes sent (counter)

snd_retransmit_pkts - number of data packets retransmitted (counter)

snd_retransmit_bytes - number of data bytes retransmitted (counter)

snd_ack_only - number of acknowledgement-only packets sent (counter)

snd_delayed_ack - number of delayed acknowledgements sent (counter)

snd_URG _only_pkts- number of packets sent with the URGENT flag only (counter)

snd_window_probe_pkts - number of window probes sent (counter)

snd_window_update_pkts - number of window update only packets sent (counter)

snd_control_pkts - number of control -- SYN, FIN or RST -- packets sent (counter)

rcv_pkts - number of packets received (counter)

rcv_ack - number of acknowledgement packets received (counter)

rcv_ack_bytes - number of bytes acknowledged by received acknowledgement packets (counter)

duplicate_acks - number of duplicate acknowledgements received (counter)

acks_unsent_data - number of acknowledgements received for unsent data (counter)

rcv_pkts_in_seq - number of packets received in sequence (counter)

rcv_bytes_in_seq - number of bytes received in sequence (counter)

rcv_dub_pkts - number of completely duplicate packets received (counter)

rcv_dup_bytes - number of completely duplicate bytes received (counter)

rcv_part_dup_pkts - number of packets with some duplicate data (counter)

rcv_part_dup_bytes - number of duplicate bytes received in packets with some duplicate data (counter)

rcv_out_order_pkts - number of packets received outfrder (counter)

rcv_out_order_bytes - number of bytes received in out of order packets (counter)

rcv_pkts_after_win - number of packets received with data after window (counter)

rcv_bytes_after_win - number of bytes received after window (counter)

rcv_window_probes - number of window probe packets received (counter)

rcv_window_update_pkts - number of window update packets received (counter)

rcv_pkts_after_close - number of packets received after closing connection (counter)

rcv_disc_for_bad_cksums - number of packets received with checksum errors (counter)

rcv_disc_bad_hdr_offset - number of packets received with bad header offset (counter)

rcv_disc_pkts_too_short - number of too short packets received (counter)

conns_requests - number of connections initiated (counter)

conns_accepts - number of connections accepted (counter)

conns_established - number of connections established (counter)

conns_closed - number of connections closed - including drops (counter)

conns_dropped - number of connections dropped (counter)

embryo_conns_dropped - number of embryonic connections dropped (counter)

segments_updated_rtt - number of times successful at getting round trip time (counter)

updated_rtt_attempts - number of times attempted to get round trip time (counter)

retransmit_timeouts - number of retransmission timeouts (counter)

conns_drop_by_rexmit_timeout - number of connections dropped due to retransmission timeout (counter)

persist_timeouts - number of persist timeouts (counter)

keepalive_timeouts - number of keep alive timeouts (counter)

keepalive_probes_sent - number of keep alive probes sent (counter)

conns_drop_by_keepalive - number of connections dropped in keep alive (counter)

OPTIONS

One option is accepted: the name of an alternate file to use to get the kernel name list.

ERRORS

can't read kernel memory

The agent uid does not have permission to read kernel memory, /dev/kmem. 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.

The error message can also occur if the agent can't find or read the file containing the kernel name list.