|
PLUTO:
Usage
Pluto
| Download | Usage
| Error Codes
| Reports
Execution of pluto
does not require super-user privileges.
Type pluto
-h for complete information on command line options.
Typically you will
just invoke pluto without any options or with the -a
command line option, and it will reschedule itself from then on. Without
command line options rescheduling is done via sleep while
the -a option causes rescheduling via at.
The second method is probably more robust but the at command
is disabled on some systems.
An important different
scenario is invokation of pluto for the analysis of PLUTO's
log files. This is done by invoking pluto -l. This will
cause the logfile(s) to be read and processed and reports to be e-mailed.
Since this is probably a regular task it might be easiest to schedule
it via crontab, i.e., add a crontab entry like:
0 0 1 * * /path/to/pluto/pluto -l
Typically, PLUTO's
actions will be dependent on the contents of the conf file.
However, command line switches to influence virtually every facet of
PLUTO's behavior are available:
-
-s
- run pluto only
once
-
-l
- analyze log
file(s)
-
-v
- display version
-
-h
- display usage
message
-
-b
- do not reset
the log file (see Note 1)
-
-a
- use the at command
for rescheduling (see Note 2)
-
-u <URL>
- test <URL>,
don't read configuration file
-
-c <conf>
- set configuration
file to <conf>
-
-f <file>
- log test results
in <file>, use - for STDOUT
-
-m <email>
- send error reports
or summaries to <email>
-
-i <number>
- set average
test interval to <number> minutes
- Command line
options override those specified in configuration file.
- At most one
of
-s and -l may be specified, absence of
both indicates the default continuous testing.
- At most one
of
-c and -u may be specified, absence of
both indicates configuration via the default configurationm file.
- The arguments
to
-u, -c, -f, -i
are mandatory.
- The argument
to
-m is optional, if absent or "none" no e-mail notifications
will be sent.
Notes:
- By default the
log file is moved to a back-up file and the log file reset. This option
is ignored if not used in conjunction with
-l.
- By default pluto
is rescheduled via a shell sleep. This option is ignored if the
-s
option is also given.
|
