IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > sar man page

sar man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





User Commands                                              sar(1)



NAME
     sar - system activity reporter

SYNOPSIS
     sar [-aAbcdgkmpqruvwy] [-o filename] t [n]

     sar [-aAbcdgkmpqruvwy] [-e time] [-f filename]  [-i sec]  [-
     s time]

DESCRIPTION
     In the first instance, the sar  utility  samples  cumulative
     activity  counters in the operating system at n intervals of
     t seconds, where t should be 5 or greater. If t is specified
     with  more than one option, all headers are printed together
     and the output can be difficult to read.  (If  the  sampling
     interval  is  less  than  5,  the activity of sar itself can
     affect the sample.) If the -o option is specified, it  saves
     the  samples in filename in binary format. The default value
     of n is 1.

     In the second instance, no sampling interval  is  specified.
     sar  extracts  data  from  a  previously  recorded filename,
     either the one specified by the -f option  or,  by  default,
     the    standard    system    activity    daily   data   file
     /var/adm/sa/sadd for the current day dd.  The  starting  and
     ending  times  of the report can be bounded using the -e and
     -s arguments with time specified in the  form  hh[:mm[:ss]].
     The  -i option selects records at sec second intervals. Oth-
     erwise, all intervals found in the data file are reported.

OPTIONS
     The following options  modify  the  subsets  of  information
     reported by sar.

     -a              Reports use of file access system  routines:
                     iget/s, namei/s, dirblk/s



     -A              Reports    all    data.    Equivalent     to
                     -abcdgkmpqruvwy.



     -b              Reports buffer activity:

                     bread/s, bwrit/s

                         transfers per  second  of  data  between
                         system  buffers  and disk or other block
                         devices.




SunOS 5.10          Last change: 24 Jul 2004                    1






User Commands                                              sar(1)



                     lread/s, lwrit/s

                         accesses of system buffers.



                     %rcache, %wcache

                         cache    hit    ratios,     that     is,
                         (1-bread/lread) as a percentage.



                     pread/s, pwrit/s

                         transfers using  raw  (physical)  device
                         mechanism.



                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -c              Reports system calls:

                     scall/s

                         system calls of all types.




                     sread/s, swrit/s, fork/s, exec/s

                         specific system calls.



                     rchar/s, wchar/s

                         characters transferred by read and write
                         system  calls.  No  incoming or outgoing
                         exec(2) and fork(2) calls are reported.



                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor



SunOS 5.10          Last change: 24 Jul 2004                    2






User Commands                                              sar(1)



                     set of the pool to which the zone is bound.


     -d              Reports activity for each block device  (for
                     example, disk or tape drive) with the excep-
                     tion of XDC disks and tape drives. When data
                     is  displayed, the device specification dsk-
                     is generally used to represent a disk drive.
                     The device specification used to represent a
                     tape  drive  is   machine   dependent.   The
                     activity data reported is:

                     %busy, avque

                         portion of time device was busy  servic-
                         ing  a  transfer request, average number
                         of  requests  outstanding  during   that
                         time.




                     read/s, write/s, blks/s

                         number of read/write transfers  from  or
                         to  device,  number of bytes transferred
                         in 512-byte units.



                     avwait

                         average wait time in milliseconds.



                     avserv

                         average service time in milliseconds.



                     For  more  general  system  statistics,  use
                     iostat(1M), sar(1M), or vmstat(1M).

                     See System  Administration  Guide:  Advanced
                     Administration  for  naming  conventions for
                     disks.


     -e time         Selects data up to time. Default is 18:00.




SunOS 5.10          Last change: 24 Jul 2004                    3






User Commands                                              sar(1)



     -f filename     Uses filename as the data  source  for  sar.
                     Default  is  the  current  daily  data  file
                     /var/adm/sa/sadd.



     -g              Reports paging activities:

                     pgout/s         page-out    requests     per
                                     second.




                     ppgout/s        pages paged-out per second.



                     pgfree/s        pages per second  placed  on
                                     the  free  list  by the page
                                     stealing daemon.



                     pgscan/s        pages per second scanned  by
                                     the page stealing daemon.



                     %ufs_ipf        the percentage of UFS inodes
                                     taken  off  the  freelist by
                                     iget  which   had   reusable
                                     pages  associated with them.
                                     These pages are flushed  and
                                     cannot   be   reclaimed   by
                                     processes. Thus, this is the
                                     percentage   of  igets  with
                                     page flushes.



                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -i sec          Selects data at intervals as close as possi-
                     ble to sec seconds.






SunOS 5.10          Last change: 24 Jul 2004                    4






User Commands                                              sar(1)



     -k              Reports  kernel  memory   allocation   (KMA)
                     activities:

                     sml_mem, alloc, fail

                         information  about   the   memory   pool
                         reserving and allocating space for small
                         requests: the amount of memory in  bytes
                         KMA  has  for the small pool, the number
                         of bytes allocated to  satisfy  requests
                         for  small  amounts  of  memory, and the
                         number of requests for small amounts  of
                         memory that were not satisfied (failed).




                     lg_mem, alloc, fail

                         information for the  large  memory  pool
                         (analogous  to  the  information for the
                         small memory pool).



                     ovsz_alloc, fail

                         the amount of memory allocated for over-
                         size requests and the number of oversize
                         requests which could  not  be  satisfied
                         (because  oversized  memory is allocated
                         dynamically, there is not a pool).




     -m              Reports message and semaphore activities:

                     msg/s, sema/s   primitives per second.




                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -o filename     Saves samples in file, filename,  in  binary
                     format.




SunOS 5.10          Last change: 24 Jul 2004                    5






User Commands                                              sar(1)



     -p              Reports paging activities:

                     atch/s          page faults per second  that
                                     are  satisfied by reclaiming
                                     a page currently  in  memory
                                     (attaches per second).




                     pgin/s          page-in requests per second.



                     ppgin/s         pages paged-in per second.



                     pflt/s          page faults from  protection
                                     errors  per  second (illegal
                                     access to  page)  or  "copy-
                                     on-writes".



                     vflt/s          address   translation   page
                                     faults   per  second  (valid
                                     page not in memory).



                     slock/s         faults per second caused  by
                                     software    lock    requests
                                     requiring physical I/O.



                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -q              Reports average queue length while occupied,
                     and percent of time occupied:

                     runq-sz, %runocc        Run queue of  kernel
                                             threads   in  memory
                                             and runnable






SunOS 5.10          Last change: 24 Jul 2004                    6






User Commands                                              sar(1)



                     swpq-sz, %swpocc        Swap    queue     of
                                             processes




     -r              Reports unused memory pages and disk blocks:

                     freemem                 average pages avail-
                                             able     to     user
                                             processes.




                     freeswap                disk  blocks  avail-
                                             able  for page swap-
                                             ping.




     -s time         Selects data later than  time  in  the  form
                     hh[:mm]. Default is 08:00.



     -u              Reports CPU utilization (the default):

                     %usr, %sys, %wio, %idle

                         portion of time running  in  user  mode,
                         running  in  system mode, idle with some
                         process waiting for block I/O, and  oth-
                         erwise idle.




                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -v              Reports  status  of  process,  i-node,  file
                     tables:

                     proc-sz, inod-sz, file-sz, lock-sz

                         entries/size for each  table,  evaluated
                         once at sampling point.



SunOS 5.10          Last change: 24 Jul 2004                    7






User Commands                                              sar(1)



                     ov

                         overflows that  occur  between  sampling
                         points for each table.




     -w              Reports  system   swapping   and   switching
                     activity:

                     swpin/s, swpot/s, bswin/s, bswot/s

                         number of transfers and number  of  512-
                         byte  units  transferred for swapins and
                         swapouts (including initial  loading  of
                         some programs).




                     pswch/s

                         process switches.



                     If run in a non-global zone  and  the  pools
                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


     -y              Reports TTY device activity:

                     rawch/s, canch/s, outch/s

                         input character  rate,  input  character
                         rate  processed by canon, output charac-
                         ter rate.




                     rcvin/s, xmtin/s, mdmin/s

                         receive, transmit  and  modem  interrupt
                         rates.



                     If run in a non-global zone  and  the  pools



SunOS 5.10          Last change: 24 Jul 2004                    8






User Commands                                              sar(1)



                     facility  is  active,  these  values reflect
                     activity on the processors of the  processor
                     set of the pool to which the zone is bound.


EXAMPLES
     Example 1: Viewing System Activity

     The following example displays today's CPU activity so far:

     example% sar

     Example 2: Watching System Activity Evolve

     To watch CPU activity evolve for 10 minutes and save data:

     example% sar -o temp 60 10

     Example 3: Reviewing Disk and Tape Activity

     To later review disk and tape activity from that period:

     example% sar -d -f temp

FILES
     /var/adm/sa/sadd        daily data file, where dd are digits
                             representing the day of the month



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWaccu                    |
    |_____________________________|_____________________________|


SEE ALSO
     sag(1), iostat(1M), sar(1M), vmstat(1M),  exec(2),  fork(2),
     attributes(5)

     System Administration Guide: Advanced Administration

NOTES
     The sum of CPU utilization  might  vary  slightly  from  100
     because of rounding errors in the production of a percentage
     figure.




SunOS 5.10          Last change: 24 Jul 2004                    9





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:25:22 GMT 2007

Your favourite pages:

No pages logged yet...

Top 10 most popular pages:

prstat man page (24541 hits)
(Solaris 10 11_06)

netcat man page (17692 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (13521 hits)
(Solaris 10 11_06)

signal man page (12550 hits)
(Suse Linux 10.1)

startproc man page (11987 hits)
(Suse Linux 10.1)

raidctl man page (11353 hits)
(Solaris 10 11_06)

adv_cap_autoneg man page (10283 hits)
(Solaris 10 11_06)

sqlite3 man page (9728 hits)
(openSUSE 10.2)

CPAN man page (8947 hits)
(Suse Linux 10.1)

BusyBox man page (7698 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Cambridge Plus :: Pyrenees Ski Holidays :: Electronic Consultancy, UK :: Classic Motorbike Piston Rings
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum