atoprc man page on Alpinelinux

Man page or keyword search:  
man Server   18016 pages
apropos Keyword Search (all sections)
Output format
Alpinelinux logo
[printable version]

ATOPRC(5)							     ATOPRC(5)

NAME
       atoprc - atop/atopsar related rcfile

DESCRIPTION
       This manual page documents the rcfile of the atop and atopsar commands.
       These commands can be used to monitor the system and process load on  a
       Linux system.

       The  atoprc file contains the default settings. These settings are read
       during startup, first from the system-wide rcfile /etc/atoprc and after
       that  from  the user-specific rcfile ~/.atoprc (so system-wide settings
       can be overruled by an individual user).	 The options in	 both  rcfiles
       are identical.

OPTIONS
       The rcfile contains keyword-value pairs, one on every line (blank lines
       and lines starting with a #-sign are ignored).
       The following keywords can be specified:

       flags
	   A list of default flags for atop can be  defined  here.  The	 flags
	   which  are allowed are 'g', 'm', 'd', 'n', 'u', 'p', 's', 'c', 'v',
	   'C', 'M', 'D', 'N', 'A', 'a', 'y', 'f', 'F', '1' and 'x'.

       interval
	   The default interval value in seconds.

       linelen
	   The length of a screen line when sending output to a file  or  pipe
	   (default 80).

       username
	   The	default regular expression for the users for which active pro‐
	   cesses will be shown.

       procname
	   The default regular expression for the process names to be shown.

       maxlinecpu
	   The maximum number of active CPU's that will be shown.

       maxlinelvm
	   The maximum number of active logical volumes that will be shown.

       maxlinemdd
	   The maximum number of active multiple devices that will be shown.

       maxlinedisk
	   The maximum number of active disks that will be shown.

       maxlineintf
	   The maximum number of active network interfaces that will be shown.

       cpucritperc
	   The busy percentage considered critical for a processor  (see  sec‐
	   tion	 COLORS in the man-page of the atop command).  This percentage
	   is used to determine a weighted percentage for  line	 coloring  and
	   sorting of active processes.	 When this value is zero, no line col‐
	   oring or automatic sorting is performed for this resource.

       dskcritperc
	   The busy percentage considered critical for	a  disk	 (see  section
	   COLORS  in  the  man-page of the atop command).  This percentage is
	   used to determine a weighted percentage for line coloring and sort‐
	   ing of active processes.  When this value is zero, no line coloring
	   or automatic sorting is performed for this resource.

       netcritperc
	   The busy percentage considered critical  for	 a  network  interface
	   (see	 section  COLORS  in  the man-page of the atop command).  This
	   percentage is used to determine a weighted percentage for line col‐
	   oring and sorting of active processes.  When this value is zero, no
	   line coloring or automatic sorting is performed for this resource.

       memcritperc
	   The percentage considered critical for memory utilization (see sec‐
	   tion	 COLORS in the man-page of the atop command).  This percentage
	   is used to determine a weighted percentage for  line	 coloring  and
	   sorting of active processes.	 When this value is zero, no line col‐
	   oring or automatic sorting is performed for this resource.

       swpcritperc
	   The occupation percentage considered critical for swap  space  (see
	   section COLORS in the man-page of the atop command).	 This percent‐
	   age is used to determine a weighted percentage  for	line  coloring
	   and	sorting of active processes.  When this value is zero, no line
	   coloring or automatic sorting is performed for this resource.

       swoutcritsec
	   The number of pages swapped out per second considered critical  for
	   for	memory	utilization (see section COLORS in the man-page of the
	   atop command).  This threshold is used in  combination  with	 'mem‐
	   critperc'  to determine a weighted percentage for line coloring and
	   sorting of active processes.	 When this value is zero, no line col‐
	   oring or automatic sorting is performed for this resource.

       almostcrit
	   A  percentage  of  the  critical  percentage	 to  determine	if the
	   resource is almost critical (see section COLORS in the man-page  of
	   the	atop  command).	 When this value is zero, no line coloring for
	   `almost critical' is performed.

       atopsarflags
	   A list of default flags for atopsar can be defined here. The	 flags
	   that	 are  allowed  are  'S',  'x', 'C', 'M', 'H', 'a', 'A' and the
	   flags to select one or more specific reports.

       An example of the /etc/atoprc or ~/.atoprc file:

	       flags	     Aaf
	       interval	     5
	       username
	       procname
	       maxlinecpu    4
	       maxlinedisk   10
	       maxlineintf   5
	       cpucritperc   80
	       almostcrit    90
	       atopsarflags  CMH
	       ownprocline   PID:50 VGROW:40 RGROW:45 COMMAND-LINE:50
	       ownpagline    PAGSCAN:3 BLANKBOX:0 PAGSWIN:3 PAGSWOUT:7

       The keywords 'ownprocline' and 'ownpagline' are explained in the subse‐
       quent section.

OWN DEFINITION OF OUTPUT LINE
       Via  the rcfile it is possible to define the layout of the output lines
       yourself, i.e. you can define the  layout  of  one  line	 with  process
       information with the keyword 'ownprocline' (to be selected with the key
       'o' or the flag -o) and you can redefine all lines with system informa‐
       tion.

       The  layout  of	an  output-line can be defined as follows (notice that
       this should be specified as one line in the rcfile):

	  keyword   <columnid>:<prio> [<columnid>:<prio> ...]

       The columnid is the symbolic name of a column that should shown at this
       position in the output line.
       The prio is a positive integer value that determines which columns have
       precedence whenever not all specified  columns  fit  into  the  current
       screen-width.  The higher value, the higher priority.
       The  column-specifications should be separated by a space. The order in
       which columns have been specified is the order in which	they  will  be
       shown, with respect to their priority (columns that do not fit, will be
       dropped dynamically).

       A special columnid for system lines is 'BLANKBOX'. This indicates  that
       an  empty column is required at this position. Also this special colum‐
       nid is followed by a priority (usually low).

       The following definition can be specified for process information:

       ownprocline
	   The columnid's are the names of the columns that are shown  in  the
	   normal  output  of the process-related lines that are shown by atop
	   such as 'PID', 'CMD', 'S', ....  The only exception is the  special
	   columnid  'SORTITEM'	 that  is  used	 to  show  one	of the columns
	   CPU%/DSK%/MEM%/NET%, depending on the chosen sort-criterium.
	   An example of a user-defined process line:

	       ownprocline   PID:20  PPID:10  SYSCPU:15	  USRCPU:15   VGROW:14
	       VSIZE:12 RGROW:14 RSIZE:12 ST:8 EXC:7 S:11 SORTITEM:18 CMD:20

       The  following  definitions  are used internally by atop as the default
       system lines (you can redefine each of them in the rcfile as one line):

       ownsysprcline
	   Redefinition of line labeled with 'PRC':

	       ownsysprcline   PRCSYS:8 PRCUSER:8 BLANKBOX:0 PRCNPROC:7	 PRCN‐
	       ZOMBIE:5 PRCCLONES:4 BLANKBOX:0 PRCNNEXIT:6

       ownallcpuline
	   Redefinition of line labeled with 'CPU' for total CPU-utilization:

	       ownallcpuline   CPUSYS:8	 CPUUSER:7  CPUIRQ:4  BLANKBOX:0 CPUI‐
	       DLE:5 CPUWAIT:6 BLANKBOX:0 CPUSTEAL:1 CPUGUEST:3

       ownonecpuline
	   Redefinition of line labeled with 'CPU' for utilization of one CPU:

	       ownonecpuline   CPUISYS:8 CPUIUSER:7 CPUIIRQ:4 BLANKBOX:0 CPUI‐
	       IDLE:5 CPUIWAIT:6 BLANKBOX:0 CPUISTEAL:1 CPUIGUEST:3

       owncplline
	   Redefinition of line labeled with 'CPL':

	       owncplline   CPLAVG1:4 CPLAVG5:3 CPLAVG15:2 BLANKBOX:0 CPLCSW:6
	       CPLINTR:5 BLANKBOX:0 CPLNUMCPU:1

       ownmemline
	   Redefinition of line labeled with 'MEM':

	       ownmemline   MEMTOT:2  MEMFREE:5	 MEMCACHE:3  MEMDIRTY:1	  MEM‐
	       BUFFER:3 MEMSLAB:3 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0

       ownswpline
	   Redefinition of line labeled with 'SWP':

	       ownswpline   SWPTOT:3	 SWPFREE:4    BLANKBOX:0    BLANKBOX:0
	       BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 SWPCOMMITTED:5 SWP‐
	       COMMITLIM:6

       ownpagline
	   Redefinition of line labeled with 'PAG':

	       ownpagline   PAGSCAN:3	 PAGSTALL:1    BLANKBOX:0    PAGSWIN:4
	       PAGSWOUT:3

       owndskline
	   Redefinition of lines labeled with 'LVM', 'MDD' and 'DSK':

	       owndskline   DSKNAME:8	DSKBUSY:7    DSKNREAD:6	   DSKNWRITE:6
	       DSKKBPERRD:4   DSKKBPERWR:4   DSKMBPERSECRD:5   DSKMBPERSECWR:5
	       DSKAVQUEUE:1 DSKAVIO:5

       ownnettrline
	   Redefinition of line labeled with 'NET' for transport:

	       ownnettrline   NETTRANSPORT:9  NETTCPI:8	 NETTCPO:8   NETUDPI:8
	       NETUDPO:8   NETTCPACTOPEN:6   NETTCPPASVOPEN:5  NETTCPRETRANS:4
	       NETTCPINERR:3 NETTCPORESET:20 NETUDPNOPORT:1 NETUDPINERR:3

       ownnetnetline
	   Redefinition of line labeled with 'NET' for network:

	       ownnetnetline   NETNETWORK:5   NETIPI:4	 NETIPO:4   NETIPFRW:4
	       NETIPDELIV:4  BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 NETICMPIN:1 NET‐
	       ICMPOUT:1

       ownnetifline
	   Redefinition of line labeled with 'NET' for interfaces:

	       ownnetifline   NETNAME:8 NETPCKI:7 NETPCKO:7 NETSPEEDIN:6  NET‐
	       SPEEDOUT:6 NETCOLLIS:3 NETMULTICASTIN:2 NETRCVERR:5 NETSNDERR:5
	       NETRCVDROP:4 NETSNDDROP:4

       The lines above are shown in the order as shown by atop in  combination
       with  the  -f flag (in a very wide window you should be able to see all
       of the columns).

SEE ALSO
       atop(1), atopsar(1), netatop(4), netatopd(8), logrotate(8)
       http://www.atoptool.nl

AUTHOR
       Gerlof Langeveld (gerlof.langeveld@atoptool.nl)
       JC van Winkel

Linux				 October 2012			     ATOPRC(5)
[top]

List of man pages available for Alpinelinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net