man 1 ATOPSAR

ATOPSAR(1)                  General Commands Manual                 ATOPSAR(1)

NAME
       atopsar - Advanced System Activity Report (atop related)

SYNOPSIS
       atopsar  [-flags...]   [-r file|date|- ] [-R cnt ] [-b [YYYYMMDD]hhmm ]
       [-e [YYYYMMDD]hhmm ]
       atopsar [-flags...]  interval [ samples ]

DESCRIPTION
       The program atopsar can be used to report statistics on system level.

       In the first synopsis line (no sampling  interval  specified),  atopsar
       extracts  data  from a raw logfile that has been recorded previously by
       the program atop (option -w of the atop program).
       You can specify the name of the logfile with the -r option of the atop-
       sar   program.    When   a   daily  logfile  of  atop  is  used,  named
       /var/log/atop/atop_YYYYMMDD (where YYYYMMDD reflects the date), the re-
       quired  date  of  the form YYYYMMDD can be specified with the -r option
       instead of the filename, or the symbolic name 'y' can be used for  yes-
       terday's  daily  logfile  (this can be repeated so 'yyyy' indicates the
       logfile of four days ago), or the filename '-' can be used to read  raw
       data  from  stdin.   If  the -r option is not specified at all, today's
       daily logfile is used by default.
       The starting and ending times of the report can be  defined  using  the
       options  -b  and  -e  followed  by  a time argument of the form [YYYYM-
       MDD]hhmm.

       In the second synopsis line, atopsar  reads  actual  activity  counters
       from the kernel with the specified interval (in seconds) and the speci-
       fied number of samples (optionally).  When atopsar is activated in this
       way it immediately sends the output for every requested report to stan-
       dard output.  If only one type of report is requested,  the  header  is
       printed  once and after every interval seconds the statistical counters
       are shown for that period.  If several reports are requested, a  header
       is printed per sample followed by the statistical counters for that pe-
       riod.

       Some generic flags can be specified to influence the behaviour  of  the
       atopsar program:

       -S   By  default the timestamp at the beginning of a line is suppressed
            if more lines are shown for one interval. With this flag  a  time-
            stamp is given for every output-line (easier for post-processing).

       -a   By  default  certain resources as disks and network interfaces are
            only shown when they were active during the interval.   With  this
            flag  all  resources  of a given type are shown, even if they were
            inactive during the interval.

       -x   By default atopsar only uses colors if output  is  directed  to  a
            terminal  (window).   These  colors might indicate that a critical
            occupation percentage has been reached (red) or  has  been  almost
            reached  (cyan)  for  a  particular resource.  See the man-page of
            atop for a detailed description of this feature (section COLORS).
            With the flag -x the use of colors is suppressed unconditionally.

       -C   By default atopsar only uses colors if output  is  directed  to  a
            terminal  (window).   These  colors might indicate that a critical
            occupation percentage has been reached (red) or  has  been  almost
            reached  (cyan)  for  a  particular resource.  See the man-page of
            atop for a detailed description of this feature (section COLORS).
            With the flag -C colors will always be used, even if output is not
            directed to a terminal.

       -M   Use markers at the end of a line to indicate that a critical occu-
            pation percentage has  been  reached  ('*')  or  has  been  almost
            reached  ('+') for particular resources. The marker '*' is similar
            to the color red and the marker '+' to the  color  cyan.  See  the
            man-page  of atop for a detailed description of these colors (sec-
            tion COLORS).

       -H   Repeat the header line within a report for every N  detail  lines.
            The  value  of  N is determined dynamically in case of output to a
            tty/window (depending on the number of lines);  for  output  to  a
            file or pipe this value is 23.

       -R   Summarize  cnt  samples into one sample. When the logfile contains
            e.g. samples of 10 minutes, the use of the flag '-R 6' shows a re-
            port with one sample for every hour.

       Other flags are used to define which reports are required:

       -A   Show all possible reports.

       -c   Report about CPU utilization (in total and per cpu).

       -g   Report about GPU utilization (per GPU).

       -p   Report  about  processor-related  matters,  like load-averages and
            hardware interrupts.

       -P   Report about processes.

       -m   Current memory- and swap-occupation.

       -s   Report about paging- and swapping-activity, and overcommitment.

       -B   Report about Pressure Stall Information (PSI).

       -l   Report about utilization of logical volumes.

       -f   Report about utilization of multiple devices.

       -d   Report about utilization of disks.

       -n   Report about NFS mounted filesystems on NFS client.

       -j   Report about NFS client activity.

       -J   Report about NFS server activity.

       -i   Report about the network interfaces.

       -I   Report about errors for network-interfaces.

       -w   Report about IP version 4 network traffic.

       -W   Report about errors for IP version 4 traffic.

       -y   General report about ICMP version 4 layer activity.

       -Y   Per-type report about ICMP version 4 layer activity.

       -u   Report about UDP version 4 network traffic.

       -z   Report about IP version 6 network traffic.

       -Z   Report about errors for IP version 6 traffic.

       -k   General report about ICMP version 6 layer activity.

       -K   Per-type report about ICMP version 6 layer activity.

       -U   Report about UDP version 6 network traffic.

       -t   Report about TCP network traffic.

       -T   Report about errors for TCP-traffic.

       -h   Report about Infiniband utilization.

       -O   Report about top-3 processes consuming  most  processor  capacity.
            This  report  is  only  available  when using a log file (not when
            specifying an interval).

       -G   Report about top-3 processes consuming most resident memory.  This
            report  is only available when using a log file (not when specify-
            ing an interval).

       -D   Report about top-3 processes issueing most disk  transfers.   This
            report  is only available when using a log file (not when specify-
            ing an interval).

       -N   Report about top-3 processes issueing most IPv4/IPv6 socket trans-
            fers.   This  report  is only available when using a log file (not
            when specifying an interval).

OUTPUT DESCRIPTION
       Depending on the requested report, a number of columns with output val-
       ues  are  produced.   The  values  are  mostly presented as a number of
       events per second.

       The output for the flag -c contains the following columns per cpu:

       usr%        Percentage of cpu-time consumed in user mode (program text)
                   for  all active processes running with a nice value of zero
                   (default) or a negative nice value (which  means  a  higher
                   priority  than usual).  The cpu consumption in user mode of
                   processes with a nice value larger than zero (lower  prior-
                   ity) is indicated in the nice%-column.

       nice%       Percentage  of cpu time consumed in user mode (i.e. program
                   text) for all processes running witn a  nice  value  larger
                   than zero (which means with a lower priority than average).

       sys%        Percentage  of  cpu  time  consumed  in system mode (kernel
                   text) for all active processes. A high  percentage  usually
                   indicates a lot of system calls being issued.

       irq%        Percentage  of cpu time consumed for handling of device in-
                   terrupts.

       softirq%    Percentage of cpu time consumed  for  soft  interrupt  han-
                   dling.

       steal%      Percentage  of  cpu  time  stolen by other virtual machines
                   running on the same hardware.

       guest%      Percentage of cpu time used by other virtual machines  run-
                   ning on the same hardware (overlaps with usr%/nice%).

       wait%       Percentage  of  unused  cpu  time while at least one of the
                   processes in wait-state awaits completion of disk I/O.

       idle%       Percentage of unused cpu time because all processes are  in
                   a wait-state but not waiting for disk-I/O.

       The output for the flag -g contains the following columns per GPU:

       busaddr     GPU number and bus-ID (separated by '/').

       gpubusy     GPU busy percentage during interval.

       membusy     GPU  memory  busy  percentage during interval, i.e. time to
                   issue read and write accesses on memory.

       memocc      Percentage of memory occupation at this moment.

       memtot      Total memory available.

       memuse      Used GPU memory at this moment.

       gputype     Type of GPU.

       The output for the flag -p contains the following values:

       pswch/s     Number of process switches (also called  context  switches)
                   per  second on this cpu. A process switch occurs at the mo-
                   ment that an active thread (i.e.  the thread using  a  cpu)
                   enters  a wait state or has used its time slice completely;
                   another thread will then be chosen to use the cpu.

       devintr/s   Number of hardware interrupts handled per  second  on  this
                   cpu.

       clones/s    The number of new threads started per second.

       loadavg1    Load  average  reflecting  the average number of threads in
                   the runqueue or in non-interruptible  wait  state  (usually
                   waiting for disk or tape I/O) during the last minute.

       loadavg5    Load  average  reflecting  the average number of threads in
                   the runqueue or in non-interruptible  wait  state  (usually
                   waiting for disk or tape I/O) during the last 5 minutes.

       loadavg15   Load  average  reflecting  the average number of threads in
                   the runqueue or in non-interruptible  wait  state  (usually
                   waiting for disk or tape I/O) during the last 15 minutes.

       The output for the flag -P contains information about the processes and
       threads:

       clones/s    The number of new threads started per second.

       pexit/s

       curproc     Total number of processes present in the system.

       curzomb     Number of zombie processes present in the system.

       thrrun      Total number of threads present  in  the  system  in  state
                   'running'.

       thrslpi     Total number of threads present in the system in state 'in-
                   terruptible sleeping'.

       thrslpu     Total number of threads present in the system in state 'un-
                   interruptible sleeping'.

       The  output  for the flag -m contains information about the memory- and
       swap-utilization:

       memtotal    Total usable main memory size.

       memfree     Available main memory size at this moment (snapshot).

       buffers     Main memory used at this moment  to  cache  metadata-blocks
                   (snapshot).

       cached      Main memory used at this moment to cache data-blocks (snap-
                   shot).

       dirty       Amount of memory in the page cache that  still  has  to  be
                   flushed to disk at this moment (snapshot).

       slabmem     Main  memory  used at this moment for dynamically allocated
                   memory by the kernel (snapshot).

       swptotal    Total swap space size at this moment (snapshot).

       swpfree     Available swap space at this moment (snapshot).

       The output for the flag -s contains information about the frequency  of
       swapping:

       pagescan/s  Number  of  scanned  pages  per second due to the fact that
                   free memory drops below a particular threshold.

       swapin/s    The number of memory-pages the system read from  the  swap-
                   device per second.

       swapout/s   The number of memory-pages the system wrote to the swap-de-
                   vice per second.

       oomkill     The number of processes being killed during the last inter-
                   val  due  to  lack  of memory/swap. The value -1 means that
                   this counter is not supported by the  current  kernel  ver-
                   sion.

       commitspc   The  committed virtual memory space i.e.  the reserved vir-
                   tual space for all allocations of private memory space  for
                   processes.

       commitlim   The  maximum limit for the committed space, which is by de-
                   fault swap size plus 50% of memory size.  The  kernel  only
                   verifies  whether  the committed space exceeds the limit if
                   strict  overcommit  handling  is  configured   (vm.overcom-
                   mit_memory is 2).

       The  output  for  the  flag  -B contains the Pressure Stall Information
       (PSI):

       cpusome     Average pressure percentage during  the  interval  for  the
                   category 'CPU some'.

       memsome     Average  pressure  percentage  during  the interval for the
                   category 'memory some'.

       memfull     Average pressure percentage during  the  interval  for  the
                   category 'memory full'.

       iosome      Average  pressure  percentage  during  the interval for the
                   category 'I/O some'.

       iofull      Average pressure percentage during  the  interval  for  the
                   category 'I/O full'.

       The output for the flags -l (LVM), -f (MD), and -d (hard disk) contains
       the following columns per active unit:

       disk        Name.

       busy        Busy-percentage of the unit (i.e. the portion of time  that
                   the device was busy handling requests).

       read/s      Number of read-requests issued per second on this unit.

       KB/read     Average  number  of Kbytes transferred per read-request for
                   this unit.

       writ/s      Number of write-requests (including discard  requests)  is-
                   sued per second on this unit.

       KB/writ     Average  number of Kbytes transferred per write-request for
                   this unit.

       avque       Average number of requests outstanding in the queue  during
                   the time that the unit is busy.

       avserv      Average  number of milliseconds needed by a request on this
                   unit (seek, latency and data-transfer).

       The output for the flag -n contains information about activity  on  NFS
       mounted filesystems (client):

       mounted_device
                   Mounted  device containing server name and server directory
                   being mounted.

       physread/s  Kilobytes data physically read from the NFS server by  pro-
                   cesses running on the NFS client.

       KBwrite/s   Kilobytes data physically written to the NFS server by pro-
                   cesses running on the NFS client.
                   When the NFS filesystem was mounted  during  the  interval,
                   the state 'M' is shown.

       The output for the flag -j contains information about NFS client activ-
       ity:

       rpc/s       Number of RPC calls per second issued to NFS server(s).

       rpcread/s   Number  of  read  RPC  calls  per  second  issued  to   NFS
                   server(s).

       rpcwrite/s  Number  of  write  RPC  calls  per  second  issued  to  NFS
                   server(s).

       retrans/s   Number of retransmitted RPC calls per second.

       autrefresh/s
                   Number of authorization refreshes per second.

       The output for the flag -J contains information about NFS server activ-
       ity:

       rpc/s       Number of RPC calls per second received from NFS client(s).

       rpcread/s   Number  of  read  RPC  calls  per  second received from NFS
                   client(s).

       rpcwrite/s  Number of write RPC calls  per  second  received  from  NFS
                   client(s).

       MBcr/s      Number of Megabytes per second returned to read requests by
                   clients.

       MBcw/s      Number of Megabytes per second passed in write requests  by
                   clients.

       nettcp/s    Number of requests per second handled via TCP.

       netudp/s    Number of requests per second handled via UDP.

       The  output  for  the flag -i provides information about utilization of
       network interfaces:

       interf      Name of interface.

       busy        Busy percentage for this interface.  If  the  linespeed  of
                   this  interface could not be determined (for virtual inter-
                   faces or in case that atop or atopsar  had  no  root-privi-
                   leges), a question mark is shown.

       ipack/s     Number of packets received from this interface per second.

       opack/s     Number of packets transmitted to this interface per second.

       iKbyte/s    Number of Kbytes received from this interface per second.

       oKbyte/s    Number of Kbytes transmitted via this interface per second.

       imbps/s     Effective number of megabits received per second.

       ombps/s     Effective number of megabits transmitted per second.

       maxmbps/s   Linespeed  as  number of megabits per second.  If the line-
                   speed could not be determined (for virtual interfaces or in
                   case  that atop or atopsar had no root-privileges), value 0
                   is shown.
                   The linespeed is followed by the indication 'f'  (full  du-
                   plex) or 'h' (half duplex).

       The output for the flag -I provides information about the failures that
       were detected for network interfaces:

       interf      Name of interface.

       ierr/s      Number of bad packets received from this interface per sec-
                   ond.

       oerr/s      Number  of times that packet transmission to this interface
                   failed per second.

       coll/s      Number of collisions encountered per second while transmit-
                   ting packets.

       idrop/s     Number  of  received packets dropped per second due to lack
                   of buffer-space in the local system.

       odrop/s     Number of transmitted packets dropped  per  second  due  to
                   lack of buffer-space in the local system.

       iframe/s    Number  of frame alignment-errors encountered per second on
                   received packets.

       ocarrier/s  Number of carrier-errors encountered per second  on  trans-
                   mitted packets.

       The  output  for the flag -w provides information about the utilization
       of the IPv4-layer (formal SNMP-names between brackets):

       inrecv/s    Number of IP datagrams received from interfaces per second,
                   including those received in error (ipInReceives).

       outreq/s    Number  of  IP  datagrams that local higher-layer protocols
                   supplied to IP in  requests  for  transmission  per  second
                   (ipOutRequests).

       indeliver/s Number of received IP datagrams that have been successfully
                   delivered to higher protocol-layers per second  (ipInDeliv-
                   ers).

       forward/s   Number  of  received IP datagrams per second for which this
                   entity was not their final IP destination, as a  result  of
                   which an attempt was made to forward (ipForwDatagrams).

       reasmok/s   Number  of IP datagrams successfully reassembled per second
                   (ipReasmOKs).

       fragcreat/s Number of IP datagram fragments  generated  per  second  at
                   this entity (ipFragCreates).

       The output for the flag -W provides information about the failures that
       were detected in the IPv4-layer (formal SNMP-names between brackets):

       in: dsc/s   Number of input IP datagrams per second for which no  prob-
                   lems were encountered to prevent their continued processing
                   but that were discarded, e.g.  for  lack  of  buffer  space
                   (ipInDiscards).

       in: hder/s  Number  of  input  IP datagrams per second discarded due to
                   errors in the IP header (ipInHdrErrors).

       in: ader/s  Number of input IP datagrams per second  discarded  because
                   the IP address in the destination field was not valid to be
                   received by this entity (ipInAddrErrors).

       in: unkp/s  Number of inbound packets per second  that  were  discarded
                   because of an unknown or unsupported protocol (ipInUnknown-
                   Protos).

       in: ratim/s Number of timeout-situations per second while  other  frag-
                   ments were expected for successful reassembly (ipReasmTime-
                   out).

       in: rfail/s Number of failures detected per second by the IP reassembly
                   algorithm (ipReasmFails).

       out: dsc/s  Number of output IP datagrams per second for which no prob-
                   lems were encountered to prevent their continued processing
                   but  that  were  discarded,  e.g.  for lack of buffer space
                   (ipOutDiscards).

       out: nrt/s  Number of IP datagrams  per  second  discarded  because  no
                   route could be found (ipOutNoRoutes).

       The  output for the flag -y provides information about the general uti-
       lization of the ICMPv4-layer and some information per type of ICMP-mes-
       sage (formal SNMP-names between brackets):

       intot/s     Number  of  ICMP messages (any type) received per second at
                   this entity (icmpInMsgs).

       outtot/s    Number of ICMP messages (any type) transmitted  per  second
                   from this entity (icmpOutMsgs).

       inecho/s    Number  of ICMP Echo (request) messages received per second
                   (icmpInEchos).

       inerep/s    Number of ICMP  Echo-Reply  messages  received  per  second
                   (icmpInEchoReps).

       otecho/s    Number of ICMP Echo (request) messages transmitted per sec-
                   ond (icmpOutEchos).

       oterep/s    Number of ICMP Echo-Reply messages transmitted  per  second
                   (icmpOutEchoReps).

       The  output  for  the flag -Y provides information about other types of
       ICMPv4-messages (formal SNMP-names between brackets):

       ierr/s      Number of ICMP messages received per second but  determined
                   to have ICMP-specific errors (icmpInErrors).

       isq/s       Number  of  ICMP Source Quench messages received per second
                   (icmpInSrcQuenchs).

       ird/s       Number of ICMP Redirect messages received per second (icmp-
                   InRedirects).

       idu/s       Number  of  ICMP  Destination Unreachable messages received
                   per second (icmpInDestUnreachs).

       ite/s       Number of ICMP Time Exceeded messages received  per  second
                   (icmpOutTimeExcds).

       oerr/s      Number  of  ICMP messages transmitted per second but deter-
                   mined to have ICMP-specific errors (icmpOutErrors).

       osq/s       Number of ICMP Source Quench messages transmitted per  sec-
                   ond (icmpOutSrcQuenchs).

       ord/s       Number  of  ICMP  Redirect  messages transmitted per second
                   (icmpOutRedirects).

       odu/s       Number of ICMP Destination Unreachable messages transmitted
                   per second (icmpOutDestUnreachs).

       ote/s       Number  of ICMP Time Exceeded messages transmitted per sec-
                   ond (icmpOutTimeExcds).

       The output for the flag -u provides information about  the  utilization
       of the UDPv4-layer (formal SNMP-names between brackets):

       indgram/s   Number  of  UDP datagrams per second delivered to UDP users
                   (udpInDatagrams).

       outdgram/s  Number of UDP datagrams transmitted per  second  from  this
                   entity (udpOutDatagrams).

       inerr/s     Number  of received UDP datagrams per second that could not
                   be delivered for reasons other than the lack of an applica-
                   tion at the destination port (udpInErrors).

       noport/s    Number of received UDP datagrams per second for which there
                   was no application at the destination port (udpNoPorts).

       The output for the flag -z provides information about  the  utilization
       of the IPv6-layer (formal SNMP-names between brackets):

       inrecv/s    Number of input IPv6-datagrams received from interfaces per
                   second, including those received in error (ipv6IfStatsInRe-
                   ceives).

       outreq/s    Number of IPv6-datagrams per second that local higher-layer
                   protocols supplied  to  IP  in  requests  for  transmission
                   (ipv6IfStatsOutRequests).   This  counter  does not include
                   any forwarded datagrams.

       inmc/s      Number of multicast packets per second that have  been  re-
                   ceived by the interface (ipv6IfStatsInMcastPkts).

       outmc/s     Number  of  multicast  packets  per  second  that have been
                   transmitted to the interface (ipv6IfStatsOutMcastPkts).

       indeliv/s   Number of IP datagrams successfully delivered per second to
                   IPv6  user-protocols,  including  ICMP (ipv6IfStatsInDeliv-
                   ers).

       reasmok/s   Number of IPv6 datagrams successfully reassembled per  sec-
                   ond (ipv6IfStatsReasmOKs).

       fragcre/s   Number  of  IPv6 datagram fragments generated per second at
                   this entity (ipv6IfStatsOutFragCreates).

       The output for the flag -Z provides information about the failures that
       were detected in the IPv6-layer (formal SNMP-names between brackets):

       in: dsc/s   Number  of  input  IPv6  datagrams  per second for which no
                   problems were encountered to prevent their  continued  pro-
                   cessing  but  that  were discarded, e.g. for lack of buffer
                   space (ipv6IfStatsInDiscards).

       in: hder/s  Number of input datagrams per second discarded due  to  er-
                   rors in the IPv6 header (ipv6IfStatsInHdrErrors).

       in: ader/s  Number  of input datagrams per second discarded because the
                   IPv6 address in the destination field was not valid  to  be
                   received by this entity (ipv6IfStatsInAddrErrors).

       in: unkp/s  Number  of locally-addressed datagrams per second that were
                   discarded because of an  unknown  or  unsupported  protocol
                   (ipv6IfStatsInUnknownProtos).

       in: ratim/s Number  of  timeout-situations  per second while other IPv6
                   fragments   were   expected   for   successful   reassembly
                   (ipv6ReasmTimeout).

       in: rfail/s Number of failures detected per second by the IPv6 reassem-
                   bly-algorithm (ipv6IfStatsReasmFails).

       out: dsc/s  Number of output IPv6 datagrams per  second  for  which  no
                   problems  were  encountered to prevent their continued pro-
                   cessing but that were discarded, e.g. for  lack  of  buffer
                   space (ipv6IfStatsOutDiscards).

       out: nrt/s  Number  of  IPv6  datagrams per second discarded because no
                   route could be found (ipv6IfStatsInNoRoutes).

       The output for the flag -k provides information about the general  uti-
       lization of the ICMPv6-layer and some information per type of ICMP-mes-
       sage (formal SNMP-names between brackets):

       intot/s     Number of ICMPv6 messages (any type) received per second at
                   the interface (ipv6IfIcmpInMsgs).

       outtot/s    Number of ICMPv6 messages (any type) transmitted per second
                   from this entity (ipv6IfIcmpOutMsgs).

       inerr/s     Number of ICMPv6 messages  received  per  second  that  had
                   ICMP-specific  errors,  such  as  bad  ICMP  checksums, bad
                   length, etc (ipv6IfIcmpInErrors).

       innsol/s    Number of ICMP Neighbor Solicit messages received per  sec-
                   ond (ipv6IfIcmpInNeighborSolicits).

       innadv/s    Number of ICMP Neighbor Advertisement messages received per
                   second (ipv6IfIcmpInNeighborAdvertisements).

       otnsol/s    Number of ICMP Neighbor Solicit  messages  transmitted  per
                   second (ipv6IfIcmpOutNeighborSolicits).

       otnadv/s    Number  of ICMP Neighbor Advertisement messages transmitted
                   per second (ipv6IfIcmpOutNeighborAdvertisements).

       The output for the flag -K provides information about  other  types  of
       ICMPv6-messages (formal SNMP-names between brackets):

       iecho/s     Number  of ICMP Echo (request) messages received per second
                   (ipv6IfIcmpInEchos).

       ierep/s     Number of ICMP  Echo-Reply  messages  received  per  second
                   (ipv6IfIcmpInEchoReplies).

       oerep/s     Number  of  ICMP Echo-Reply messages transmitted per second
                   (ipv6IfIcmpOutEchoReplies).

       idu/s       Number of ICMP Destination  Unreachable  messages  received
                   per second (ipv6IfIcmpInDestUnreachs).

       odu/s       Number of ICMP Destination Unreachable messages transmitted
                   per second (ipv6IfIcmpOutDestUnreachs).

       ird/s       Number  of  ICMP  Redirect  messages  received  per  second
                   (ipv6IfIcmpInRedirects).

       ord/s       Number  of  ICMP  Redirect  messages transmitted per second
                   (ipv6IfIcmpOutRedirect).

       ite/s       Number of ICMP Time Exceeded messages received  per  second
                   (ipv6IfIcmpInTimeExcds).

       ote/s       Number  of ICMP Time Exceeded messages transmitted per sec-
                   ond (ipv6IfIcmpOutTimeExcds).

       The output for the flag -U provides information about  the  utilization
       of the UDPv6-layer (formal SNMP-names between brackets):

       indgram/s   Number of UDPv6 datagrams per second delivered to UDP users
                   (udpInDatagrams),

       outdgram/s  Number of UDPv6 datagrams transmitted per second from  this
                   entity (udpOutDatagrams),

       inerr/s     Number  of  received  UDPv6 datagrams per second that could
                   not be delivered for reasons other than the lack of an  ap-
                   plication at the destination port (udpInErrors).

       noport/s    Number  of  received  UDPv6  datagrams per second for which
                   there was no application at the  destination  port  (udpNo-
                   Ports).

       The  output  for the flag -t provides information about the utilization
       of the TCP-layer (formal SNMP-names between brackets):

       insegs/s    Number of received segments per second, including those re-
                   ceived in error (tcpInSegs).

       outsegs/s   Number  of transmitted segments per second, excluding those
                   containing only retransmitted octets (tcpOutSegs).

       actopen/s   Number of active opens per second that have been  supported
                   by this entity (tcpActiveOpens).

       pasopen/s   Number of passive opens per second that have been supported
                   by this entity (tcpPassiveOpens).

       nowopen     Number of connections currently open (snapshot), for  which
                   the  state  is  either  ESTABLISHED  or CLOSE-WAIT (tcpCur-
                   rEstab).

       The output for the flag -T provides information about the failures that
       were detected in the TCP-layer (formal SNMP-names between brackets):

       inerr/s     Number  of  received  segments per second received in error
                   (tcpInErrs).

       retrans/s   Number  of  retransmitted  segments  per   second   (tcpRe-
                   transSegs).

       attfail/s   Number  of  failed connection attempts per second that have
                   occurred at this entity (tcpAttemptFails).

       estabreset/s
                   Number of resets per second that have occurred at this  en-
                   tity (tcpEstabResets).

       outreset/s  Number  of  transmitted  segments per second containing the
                   RST flag (tcpOutRsts).

       The output for the flag -h provides information  about  utilization  of
       Infiniband ports:

       controller  Name of controller.

       port        Controller port.

       busy        Busy percentage for this port.

       ipack/s     Number of packets received from this port per second.

       opack/s     Number of packets transmitted to this port per second.

       igbps/s     Effective number of gigabits received per second.

       ogbps/s     Effective number of gigabits transmitted per second.

       maxgbps/s   Maximum rate as number of gigabits per second.

       lanes       Number of lanes.

       The output for the flag -O provides information about the top-3 of pro-
       cesses with the highest processor consumption:

       pid         Process-id (if zero, the process has exited while  the  pid
                   could not be determined).

       command     The name of the process.

       cpu%        The  percentage of cpu-capacity being consumed.  This value
                   can exceed 100% for a multithreaded process  running  on  a
                   multiprocessor machine.

       The output for the flag -G provides information about the top-3 of pro-
       cesses with the highest memory consumption:

       pid         Process-id (if zero, the process has exited while  the  pid
                   could not be determined).

       command     The name of the process.

       mem%        The  percentage  of  resident  memory-utilization  by  this
                   process.

       The output for the flag -D provides information about the top-3 of pro-
       cesses that issue the most read and write accesses to disk:

       pid         Process-id  (if  zero, the process has exited while the pid
                   could not be determined).

       command     The name of the process.

       dsk%        The percentage of read and write accesses  related  to  the
                   total  number  of read and write accesses issued on disk by
                   all processes, so a high percentage does not imply  a  high
                   disk load on system level.

       The output for the flag -N provides information about the top-3 of pro-
       cesses that issue the most socket transfers for IPv4/IPv6:

       pid         Process-id (if zero, the process has exited while  the  pid
                   could not be determined).

       command     The name of the process.

       net%        The  percentage  of  socket  transfers related to the total
                   number of transfers issued by all processes, so a high per-
                   centage does not imply a high network load on system level.

EXAMPLES
       To  see  today's  cpu-activity so far (supposed that atop is logging in
       the background):

         atopsar

       To see the memory occupation for June 5, 2018 between 10:00  and  12:30
       (supposed that atop has been logging daily in the background):

         atopsar -m -r /var/log/atop_20180605 -b 10:00 -e 12:30

                       or

         atopsar -m -r 20180605 -b 10:00 -e 12:30

                       or, suppose it is June 8, 2018 at this moment

         atopsar -m -r yyy -b 10:00 -e 12:30

       Write a logfile with atop to record the system behaviour for 30 minutes
       (30 samples of one minute) and produce  all  available  reports  after-
       wards:

         atop -w /tmp/atoplog 60 30

         atopsar -A -r /tmp/atoplog

       To  watch  TCP  activity  evolve for ten minutes (10 samples with sixty
       seconds interval):

         atopsar -t 60 10

       To watch the header-lines ('_' as last character) of all  reports  with
       only the detail-lines showing critical resource consumption (marker '*'
       or '+' as last character):

         atopsar -AM | grep '[_*+]$'

FILES
       /etc/atoprc
            Configuration file containing system-wide default  values  (mainly
            flags).  See related man-page.

       ~/.atoprc
            Configuration  file  containing  personal  default  values (mainly
            flags).  See related man-page.

       /var/log/atop/atop_YYYYMMDD
            Daily data file, where YYYYMMDD are digits representing the date.

SEE ALSO
       atop(1),  atopconvert(1),  atopcat(1),  atoprc(5),  atopacctd(8),   ne-
       tatop(4), netatopd(8)
       https://www.atoptool.nl

AUTHOR
       Gerlof Langeveld (gerlof.langeveld@atoptool.nl)

Linux                            December 2021                      ATOPSAR(1)