Table of Contents

NAME

seedport - connect to a LISS1 or LISS2 server and output SEED to stdout

SYNOPSIS

seedport -x -v -b size -s selectfile -p tcpport -L -c mask -f secs -i sequence -P pidfile host

DESCRIPTION

Connect to a LISS-1 (netport) or a LISS-2 (extended mode) port and pull a real-time data stream from it.

OPTIONS

The different flags specify the method for connecting to a port.

-x
Output data to the standard output in LISS-2 (extended mode). Extended mode is comprised simply of SEED records enclosed in a representation which automatically specifies the source, format, and size of the data. If this flag is not used, data will be send to standard output in raw SEED.
-v
Emit diagnostic messages to standard error. Otherwise seedport will be quiet.
-L
Connect into the LISS-2 network automatically. There is no need with this option to specify host names or port numbers. Seedport will query information servers on the internet to service your request.
-b
size
Override the default record sizes. This corresponds with the SEED logical record size. The default record size for files is 512.
-p
port
The port number on the LISS-1 (or LISS-2) compatible server that seedport will attach to. This port is a TCP socket. The default if unspecified is 4000.
-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. If seedport is connecting to a bi-directional LISS-2 port, the filter will be sent up the server. This can greatly lower the network load by transmitting only the desired data, instead of sending it all and throwing away undesired data at the client end.
-E
Ignore End of Files, or network errors on the port. Will automatically reconnect if the port is dropped. Note that if this option is set, the program will never exit.
-c
filemask
Instead of sending the data received to the standard output, and series of files will be created with the name specified in the filemask. The mask must contain the %d (C printf format) characters, such as data%d or data%04d (must be able to hold a 4 digit number). These will be substituted with the file number. A new file will be created with the next sequence number each time the timer expires. The file that is current being written will have the string _live appended to it.
-f
seconds
Flush and start a new capture file (-c above) after this number of seconds (the timer value). Defaults to 3600 (1 hour).
-i
sequence
Set the file number of the initial capture file to this number. The default is 1.
-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. There may be some pathological socket I/O situations that seedport might not be able to recover from (hopefully we've found and fixed most of these). A separate watchdog process can keep an eye on a seedport 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 the host name (or IP address) of the LISS-1 or LISS-2 server.

EXAMPLES

Get data from the COLA LISS-1 server:
example% seedport -p 4060 asl6.cr.usgs.gov

HISTORY

seedport was extracted from dumpseed(1) to form a standalone program to permit users to receive raw seed from a LISS.

SEE ALSO

dumpseed(1) , getpid(2) , time(2) , selectfile(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