Table of Contents
dumpseed - dump SEED records from a file or telemetry channel.
dumpseed -t -d -e -q -I -b size -p tcpport -r buffer -f format -c channel
-s selectfile -P pidfile file/host
Contents are dumped onto
the standard output. It can decode blockettes and several other internal
data formats such as Steim-1 and Steim-2. Dumpseed is also capable of attaching
to LISS-1 data ports and receive incoming telemetry and process it as well.
The different flags specify various decoding options and specify
if a file will be decoded or a telemetry port will be read.
- -t
- Read from
a telemetry port. Main argument becomes a host name (an ip address is
acceptable too). Otherwise a filename will be expected.
- -d
- Data records
will be decoded into samples and printed out. The decoder type is determined
automatically if a SEED blockette 1000 is present. If there is no blockette
1000, dumpseed will use the default supplied to the -f option. If this
is not used, dumpseed will default to Steim-1 format. If the -I switch
is used (ignore blockettes), any blockette 1000s present will be ignored
and the other defaults will be used.
- -e
- Output will not be presented in
a report format, but instead will be produced in an easily parsable ASCII
file (the ASL BDF format).
- -q
- dumpseed will quiet some chatty text which
is written to the terminal during operations. This helps with program
which want to parse the output.
- -I
- Ignore any blockettes present in the
record and do not dump them out. This is helpful if the decoding of a
particular blockette causes the program to break.
- -b
- size
Override the
default record sizes. This corresponds with the SEED logical record size.
The default record size for files is 4096, the default for telemetry is
512.
- -r
- buffer-size
Override the default buffer sizes. This corresponds
with the SEED physical record size. This affects how much data can be read
on one read operation. This is usually only useful on tape type devices
which have physical block sizes. The default for this is also 4096.
- -p
- port
The port number on the LISS-1 compatible server that dumpseed will
attach to. This port is a TCP socket. The default if unspecified is 4000.
- -f
- format
Change the default format from STEIM1. Possible values are
ASRO, SRO, RSTN, CDSN, 16-BIT, 32-BIT, HARV, SEED, SEEDS1, STEIM, STEIM1,
SEEDS2, STEIM2, SEEDS3, STEIM3 and LOG.
- -c
- channel
This permits the user
to select a given SEED channel to be processed. Network, Station and Location
are ignored in this comparison. For more detail selection, use -s below.
- -s
- selectfile
Allows complex selection to be performed on the input data
stream. Combinations of Network, Station, Location, Channel and time-range
can be used. Please see the selectfile(4)
manual page for information
on how to construct a select file.
- -P
- pidfile
Keep a watchdog file. When
selected, a filename of /tmp/pidfile.tmp (where pidfile is the value specified
here) is written out every time a record is processed. This is usually
only useful when running in telemetry mode. There are several pathological
socket I/O situations that dumpseed might not be able to recover from.
A separate watchdog process can keep an eye on a dumpseed process via
this file and kill it and restart it if it becomes hung. The pidfile contains
the pid of the process and the epochal time when a record was last processed.
An initial entry is placed in the file when the program is started. This
will keep the watchdog from killing the program before any input comes
in.
The argument is either a host name (or IP address) or a list of files.
If multiple files are specified, dumpseed will process each file in sequence.
An argument of a single hyphen (-) will cause dumpseed to read its input
from its standard-in.
Get data from a file and display to the
screen: example% dumpseed data.seed
Get data from the COLA LISS-1 server:
example% dumpseed -t -p 4060 asl2.cr.usgs.gov
dumpseed evolved from
a SEED test program on the VAX and then to a general utility on the Sun
DCC system. Later the telemetry support was added.
getpid(2)
,
time(2)
, selectfile(4)
, BDF(4)
, SEED(4)
Public Domain Software
by Scott Halbert - Allied Signal Technical Services Corporation under contract
to the Albuquerque Seismological Laboratory - United States Geological
Survey - Department of Interior, United States, North American Continent,
Earth/Sol 3, Sagitarius Arm of Milky Way Galaxy.
Table of Contents