Table of Contents

NAME

dumpseed - dump SEED records from a file or telemetry channel.

SYNOPSIS

dumpseed -t -d -e -q -I -b size -p tcpport -r buffer -f format -c channel -s selectfile -P pidfile file/host

DESCRIPTION

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.

OPTIONS

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.

EXAMPLES

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

HISTORY

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.

SEE ALSO

getpid(2) , time(2) , selectfile(4) , BDF(4) , SEED(4)

AUTHOR

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