'\"macro stdmacro
.if n .pH g1a.sadp @(#)sadp	40.5 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} sadp 1M "System Performance Analysis Utilities" "\&"
.if \nX=1 .ds x} sadp 1M "System Performance Analysis Utilities"
.if \nX=2 .ds x} sadp 1M "" "\&"
.if \nX=3 .ds x} sadp "" "" "\&"
.TH \*(x}
.SH NAME
\f4sadp\f1 \- disk access profiler
.SH SYNOPSIS
\f4sadp\f1
[
\f4\-th\f1
] [
\f4\-d\f1
\f2device\f1[\-\|\f2drive\f1] ]
\f2s\f1 [ \f2n\f1 ]
.SH DESCRIPTION
\f4sadp\fP
reports disk access location and seek distance,
in tabular or histogram form.
It samples disk activity once every second during
an interval of
.I s
seconds.
This is done
.I n
times if
.I n
is specified.
Cylinder usage and disk distance are recorded in units
of 8 cylinders.
.PP
Valid values of
.I device
are
\f4hdsk\f1
for integral disk,
\f4sdsk\f1
for the Small Computer Systems Interface (SCSI) disk,
and
\f4fdsk\f1
for integral floppy.
Neither XDC disks nor SCSI Release 1.0 disks
can be profiled using \f4sadp\fP.
\f4sadp\fP
can profile only one device type per invocation.
The
\f4\-d\f1
option may be omitted
if the system has only one device type.
.PP
.I Drive
specifies the disk drives
and it
may be:
.PP
.RS
a drive number in the range supported by
.IR device ,
.br
two numbers separated by a minus (indicating an inclusive range),
.RE
or
.RS
a list of drive numbers separated by commas.
.RE
.PP
Up to 8 disk drives may be reported for device type
\f4hdsk\f1
or
\f4fdsk\f1,
and up to 56 for
\f4sdsk\f1.
If
.I drive
is not specified,
\f4sadp\fP
profiles all the disk drives specified by
.IR device ,
up to the maximum of 8 for
\f4hdsk\f1
and
\f4fdsk\f1,
or 56 for
\f4sdsk\f1.
.PP
The
\f4\-t\f1
flag causes the data to be reported in 
tabular form.
The
\f4\-h\f1
flag produces a histogram of the data.
The default is
\f4\-t\f1.
.SH EXAMPLE
The command:
.PP
.RS
\f4sadp \|\-d hdsk\-\|0 900 4 \f1
.RE
.PP
will generate four tabular reports,
each describing cylinder usage 
and seek distance of \f4hdsk\f1 disk drive 0
during a 15-minute interval.
.SH FILES
\f4/dev/kmem\fP
.SH SEE ALSO
\f4mem\fP(7).
.\"	@(#)sadp.1m	6.2 of 9/6/83
.Ee
