.TH PADV 1
\"
\"	perfd adviser -- Chris Bertin
\"
.SH NAME
padv \- perfd remote adviser
.SH SYNOPSIS
.B padv
[options]
.SH DESCRIPTION
.PP
This program allows a performance expert to run \fBglance adviser\fR
scripts on remote systems where the \fIperfd\fR daemon is running.
.PP
The options are:
.PP
.TP 8
.B \-i iterations\fR
This option limits the number of iterations to be performed. By
default that value is 0 (zero), meaning a continuous run.
.TP
.B \-n system\fR
This specifies which system to run the \fBadviser\fR script on. The
system name may be in the form \fBsystem:port\fR where \fBport\fR is the
port \fIperfd\fR is listening on.
.TP
.B \-s script\fR
This option specifies which script to run. See \fBFILES\fR below for
default script and locations.
.TP
.B \-S\fR
If this option is present, each symptom defined in the script is
displayed along with its value (probability) at each pass.
.TP
.B \-?\fR
Print option list and defaults.
.SH FILES
If a script is not specified, \fIpadv\fR will use the appropriate default
script if one is present. The default script name is \fBadv\fR and the
search order is:
.P
.nf
$HOME/.perfd/system/<system name>/adv
$HOME/.perfd/os/<os type>/adv
$HOME/.perfd/default/adv
<CONFIGDIR>/perfd/os/<os type>/adv
<CONFIGDIR>/perfd/default/adv (found)
.fi
.P
On HPUX, Linux, Solaris and AIX, the default configuration directory
(<CONFIGDIR> above) is
\fB/var/opt/perf\fR, on Windows, the configuration location is specified
when the software is installed and the information is placed in the
registry.
.P
<system name> is the name of the system, <os type> is the OS type as
returned by \fIglance\fR in the metric \fBGBL_OSNAME\fR  (currently one of
.B AIX\fR,
.B HP-UX\fR,
.B Linux\fR,
.B NT\fR or
.B SunOS\fR).
.SH EXAMPLES
This will return the current values for the default 4 bottlenecks on the
current system:
.P
.nf
$ padv -S -i1
Symptom 0: CPU bottleneck     = 0.00%
Symptom 1: Disk bottleneck    = 0.60%
Symptom 2: Memory bottleneck  = 0.00%
Symptom 3: Network bottleneck = 0.00%
.fi
.P
This will return the current values for the same default 4 bottlenecks on the
system \fBsunzone\fR:
.P
.nf
$ padv -S -i 1 -n sunzone  
Symptom 0: CPU bottleneck     = 0.00%
Symptom 1: Disk bottleneck    = 0.00%
Symptom 2: Memory bottleneck  = 0.00%
Symptom 3: Network bottleneck = 0.00%
.fi
.P
This command:
.P
$ padv -s advisersyntaxfile -n system41
.P
will produce the same result as:
.P
$ glance -aos advisersyntaxfile
.P
invoked on \fBsystem41\fR.
.SH CAVEATS
Running complex scripts involving nested loops (for
instance summing up all the virtual sizes of all memory regions in all
processes) may provide inconsistent data if the requests cannot be
completed in a single \fIperfd\fR interval and may even result in script
termination. For such scripts, using \fBglance\fR is recommended. Scripts
with one level of loop (or no loops) are guaranteed to return data for
the same interval.
.P
Process-level system calls are not supported in remote adviser scripts.
For such scripts, \fBglance\fR should also be used.
.SH "SEE ALSO"
.PP
\fBglance\fR(1), \fBxglance\fR(1), \fBcpsh\fR(1), \fBmpadv\fR(1), \fBperfd\fR(1M).