Next Previous Up Contents
Next: Task Names
Up: The stilts command
Previous: The stilts command
Some flags are common to all the tasks in the STILTS package,
and these are specified after the stilts
invocation itself
and before the task name. They generally have the same effect
regardless of which task is running. These generic flags are as
follows:
-
-help
- Prints a usage message for the
stilts
command
itself and exits. The message contains a listing of all the
known tasks.
-
-version
- Prints the STILTS version number and exits.
-
-verbose
- Causes more verbose information to be written during operation.
Specifically, what this does is to boost the logging level by
one notch. It may be specified multiple times to increase verbosity
further.
-
-disk
- Encourages the command to use temporary files on disk for caching
large amounts of data rather than doing it in memory.
This is a good flag to try if you are running out of memory.
This flag is in most cases equivalent to specifying the system
property
-Dstartable.storage=disk
.
-
-debug
- Sets up output suitable for debugging. The most visible consequence
of this is that if an error occurs then a full stacktrace is output,
rather than just a user-friendly report.
-
-prompt
- Most of the STILTS commands have a number of parameters which
will assume sensible defaults if you do not give them explicit
values on the command line. If you use the
-prompt
flag,
then you will be prompted for every parameter you have not
explicitly specified to give you an opportunity to enter a value
other than the default.
-
-batch
- Some parameters will prompt you for their values, even if they
offer legal defaults. If you use the
-batch
flag,
then you won't be prompted at all.
-
-bench
- Outputs the elapsed time taken by the task to standard error on
successful completion.
-
-checkversion <vers>
- Requires that the version is exactly as given by the string
<vers>
. If it is not, STILTS will exit with
an error. This can be useful when executing in certain controlled
environments to ensure that the correct version of the application
is being picked up.
-
-stdout <file>
- Sends all normal output from the run to the given file.
By default this goes to the standard output stream.
Supplying an empty string or "
-
" for <file>
will restore this default behaviour.
-
-stderr <file>
- Sends all error output from the run to the given file.
By default this goes to the standard error stream.
Supplying an empty string or "
-
" for <file>
will restore this default behaviour.
If you are submitting an error report, please include the result of
running stilts -version
and the output of the troublesome
command with the -debug
flag specified.
Next Previous Up Contents
Next: Task Names
Up: The stilts command
Previous: The stilts command
STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page:
http://www.starlink.ac.uk/stilts/
Author email:
m.b.taylor@bristol.ac.uk