~ubuntu-branches/ubuntu/gutsy/sysstat/gutsy-backports

« back to all changes in this revision

Viewing changes to man/sadc.8

  • Committer: Bazaar Package Importer
  • Author(s): Robert Luberda
  • Date: 2007-05-03 11:05:07 UTC
  • mfrom: (1.1.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20070503110507-myx4tgq3em3dndbb
Tags: 7.1.4-1
New upstream version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH SADC 8 "JUNE 2006" Linux "Linux User's Manual" -*- nroff -*-
2
 
.SH NAME
3
 
sadc \- System activity data collector.
4
 
.SH SYNOPSIS
5
 
.B /usr/lib/sa/sadc [ -d ] [ -F ] [ -I ] [ -L ] [ -V ] [
6
 
.I interval
7
 
.B [
8
 
.I count
9
 
.B ] ] [
10
 
.I outfile
11
 
.B ]
12
 
.SH DESCRIPTION
13
 
The
14
 
.B sadc
15
 
command samples system data a specified number of times (
16
 
.I count
17
 
) at a specified interval measured in seconds (
18
 
.I interval
19
 
). It writes in binary format to the specified
20
 
.I outfile
21
 
or to the standard output. If
22
 
.I outfile
23
 
is set to -, then
24
 
.B sadc
25
 
uses the standard system activity daily data file, the
26
 
.IR /var/log/sa/sa dd
27
 
file, where the dd parameter indicates the current day.
28
 
By default
29
 
.B sadc
30
 
collects all the data available from the kernel.
31
 
Exceptions are interrupts and disks data, for which the
32
 
relevant options must be explicitly passed to
33
 
.B sadc
34
 
(see options below).
35
 
 
36
 
When the
37
 
.I count
38
 
parameter is not specified,
39
 
.B sadc
40
 
writes its data endlessly.
41
 
When both
42
 
.I interval
43
 
and
44
 
.I count
45
 
are not specified, a dummy record, which is used at system startup to mark
46
 
the time when the counter restarts from 0, will be written.
47
 
For example, one of the system startup script may write the restart mark to
48
 
the daily data file by the command entry:
49
 
 
50
 
.B "/usr/lib/sa/sadc -"
51
 
 
52
 
The
53
 
.B sadc
54
 
command is intended to be used as a backend to the
55
 
.B sar
56
 
command.
57
 
 
58
 
Note: The
59
 
.B sadc
60
 
command only reports on local activities.
61
 
 
62
 
.SH OPTIONS
63
 
.IP -d
64
 
Tell
65
 
.B sadc
66
 
to report statistics for disks. By default
67
 
.B sadc
68
 
does not report disks activity to prevent data files from growing too large.
69
 
.IP -F
70
 
The creation of
71
 
.I outfile
72
 
will be forced. If the file already exists and has not the format expected by
73
 
.B sadc
74
 
then it will be truncated. This may be particularly useful for daily data files
75
 
created by an older version of sadc and whose format is no longer compatible
76
 
with current one.
77
 
.IP -I
78
 
Tell
79
 
.B sadc
80
 
to report statistics for all system interrupts. By default
81
 
.B sadc
82
 
only reports statistics for the total number of interrupts.
83
 
.IP -L
84
 
.B sadc
85
 
will try to get an exclusive lock on the
86
 
.I outfile
87
 
before writing to it or truncating it. Failure to get the lock is fatal,
88
 
except in the case of trying to write a normal (i.e. not a dummy and not
89
 
a header) record to an existing file, in which case
90
 
.B sadc
91
 
will try again at the next interval. Usually, the only reason a lock
92
 
would fail would be if another
93
 
.B sadc
94
 
process were also writing to the file. This can happen when cron is used
95
 
to launch
96
 
.B sadc .
97
 
If the system is under heavy load, an old
98
 
.B sadc
99
 
might still be running when cron starts a new one. Without locking,
100
 
this situation can result in a corrupted system activity file.
101
 
.IP -V
102
 
Print version number then exit.
103
 
 
104
 
.SH ENVIRONMENT
105
 
The
106
 
.B sadc
107
 
command takes into account the following environment variable:
108
 
 
109
 
.IP S_TIME_DEF_TIME
110
 
If this variable exists and its value is
111
 
.BR UTC
112
 
then
113
 
.B sadc
114
 
will save its data in UTC time.
115
 
.B sadc
116
 
will also use UTC time instead of local time to determine the current
117
 
daily data file located in the
118
 
.IR /var/log/sa
119
 
directory.
120
 
.SH EXAMPLES
121
 
.B /usr/lib/sa/sadc 1 10 /tmp/datafile
122
 
.RS
123
 
Write 10 records of one second intervals to the /tmp/datafile binary file.
124
 
.SH BUGS
125
 
.I /proc
126
 
filesystem must be mounted for the
127
 
.B sadc
128
 
command to work.
129
 
 
130
 
All the statistics are not necessarily available, depending on the kernel version used.
131
 
.SH FILES
132
 
.IR /var/log/sa/sa dd
133
 
.RS
134
 
Indicate the daily data file, where the
135
 
.B dd
136
 
parameter is a number representing the day of the month.
137
 
 
138
 
.RE
139
 
.IR /proc
140
 
contains various files with system statistics.
141
 
.SH AUTHOR
142
 
Sebastien Godard (sysstat <at> wanadoo.fr)
143
 
.SH SEE ALSO
144
 
.BR sar (1),
145
 
.BR sa1 (8),
146
 
.BR sa2 (8),
147
 
.BR sadf (1),
148
 
.BR mpstat (1),
149
 
.BR iostat (1),
150
 
.BR vmstat (8)
151
 
 
152
 
.I http://perso.orange.fr/sebastien.godard/