sadc(8) [opendarwin man page]

sadc(8) 						    BSD System Manager's Manual 						   sadc(8)

NAME

     sadc -- system activity data collector

SYNOPSIS

     /usr/lib/sa/sadc [-m mode] [t n] [ofile]

DESCRIPTION

     The sadc tool is used to collect cumulative system activity data.	The sample system data is collected at intervals t seconds apart, in a
     loop n times.  The binary sample data is written to ofile if specified.  Otherwise, the binary data is written to stdout.	If the ofile file
     does not exist, it is created, otherwise it is truncated.

     sadc is intended to be used as the engine behind the sar(1) command, and is not typically invoked on the command line.  Two shell scripts,
     sa1 and sa2 are provided to drive the typical sampling, saving, and reporting process.

OPTIONS

     The following options modify the way data is collected by sadc.

     -m mode  Modify the collection of system statistics as specified by mode.	Currently only one mode is supported.

	      PPP      By default, the collection of ppp network interface statistics is turned off.  This is because the number of ppp connec-
		       tions can be very high, causing the raw data file to grow unexpectedly large, especially  when samples are collected at
		       short intervals.  Use the PPP mode to turn the collection back on.

EXAMPLES

     /usr/lib/sa/sadc 15 20 /tmp/sample.out

     This call collects 20 samples at 15 second intervals.  The binary data is written to the /tmp/sample.out file

FILES

     /var/log/sa/sadd  Default daily activity file that holds the binary sampling data.  dd are digits that represent the day of the month.
     /usr/lib/sa/sa1   Shell script used to drive the sar data collection.
     /usr/lib/sa/sa2   Shell script used to drive the sar data reporting.

SEE ALSO

     sa1(8), sa2(8), sar(1), iostat(8), vm_stat(1), netstat(1), top(1), sc_usage(1), fs_usage(1)

Mac OS X							    Jul 25 2003 							  Mac OS X

sar(1M) 						  System Administration Commands						   sar(1M)

NAME

       sar, sa1, sa2, sadc - system activity report package

SYNOPSIS

       /usr/lib/sa/sadc [t n] [ofile]

       /usr/lib/sa/sa1 [t n]

       /usr/lib/sa/sa2 [-aAbcdgkmpqruvwy] [-e time] [-f filename]
	    [-i sec] [-s time]

DESCRIPTION

       System  activity  data  can  be	accessed at the special request of a user (see sar(1)) and automatically, on a routine basis, as described
       here. The operating system contains several counters that are incremented as various system actions occur. These include counters  for  CPU
       utilization,  buffer  usage, disk and tape I/O activity, TTY device activity, switching and system-call activity, file-access, queue activ-
       ity, inter-process communications, and paging. For more general system statistics, use iostat(1M), sar(1), or vmstat(1M).

       sadc and two shell procedures, sa1 and sa2, are used to sample, save, and process this data.

       sadc, the data collector, samples system data n times, with an interval of t seconds between samples, and writes in binary format to  ofile
       or to standard output. The sampling interval t should be greater than 5 seconds; otherwise, the activity of sadc itself may affect the sam-
       ple. If t and n are omitted, a special record is written. This facility can be used at system boot  time,  when	booting  to  a	multi-user
       state,  to mark the time at which the counters restart from zero. For example, when accounting is enabled, the svc:/system/sar:default ser-
       vice writes the restart mark to the daily data file using the command entry:

	 su sys -c "/usr/lib/sa/sadc /var/adm/sa/sa'date +%d'"

       The shell script sa1, a variant of sadc, is used to collect and store data in the binary file /var/adm/sa/sadd, where  dd  is  the  current
       day.  The  arguments  t and n cause records to be written n times at an interval of t seconds, or once if omitted. The following entries in
       /var/spool/cron/crontabs/sys will produce records every 20 minutes during working hours and hourly otherwise:

	 0 * * * 0-6 /usr/lib/sa/sa1
	 20,40 8-17 * * 1-5 /usr/lib/sa/sa1

       See crontab(1) for details.

       The shell script sa2, a variant of sar, writes a daily report in the file /var/adm/sa/sardd. See the  OPTIONS  section  in  sar(1)  for	an
       explanation  of the various options. The following entry in /var/spool/cron/crontabs/sys will report important activities hourly during the
       working day:

	 5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A

FILES

       /tmp/sa.adrfl

	   address file

       /var/adm/sa/sadd

	   Daily data file

       /var/adm/sa/sardd

	   Daily report file

       /var/spool/cron/crontabs/sys

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWaccu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       crontab(1), sag(1), sar(1), svcs(1), timex(1), iostat(1M), svcadm(1M), vmstat(1M), attributes(5), smf(5)

NOTES

       The sar service is managed by the service management facility, smf(5), under the service identifier:

	 svc:/system/sar

       Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed  using  svcadm(1M).  The  ser-
       vice's status can be queried using the svcs(1) command.

SunOS 5.11							    20 Aug 2004 							   sar(1M)