Synopsis

datalinkclient [-vV] [--help] [-h=<host>] [-m=<match>] [--max=<maxRecords>] [-o=<outputFile>] [-p=<port>] [--timeout=<timeoutSec>]

Description

Datalinkclient is an example client that can connect to a datalink service and stream miniseed to a file. View source code here.

The datalink protocol is specified here:

https://iris-edu.github.io/libdali/datalink-protocol.html

Options

-h, --host=<host>

host to connect to, defaults to IRIS, rtserve.iris.washington.edu

--help

display a help message

-m, --match=<match>

match pattern, as a regular expression. For miniseed the conventions is NN_SSS_LL_CCC/MSEED

--max=<maxRecords>

number of packets to receive before ending the connection, defaults to 10

-o, --out=<outputFile>

Output file (default: print to console)

-p, --port=<port>

port to connect to, defaults to IRIS, 18000

--timeout=<timeoutSec>

timeout seconds, defaults to 120

-v, --verbose

Verbose

-V, --version

Print version and exit

Examples

Ask for a few packets of HH. data from station CO.BIRD, and output to a file.

> datalinkclient -m CO_BIRD_00_HH./MSEED --max 3 -o bird.mseed -v
initConnection to rtserve.iris.washington.edu:18000
Connection made
sendId
send 'ID seisFile:unknown:42:java | '
not bytes available 0
readPacket
readPacket(): blocking read for 3 bytes, available=53
Server ID: ID DataLink 2020.075 :: DLPROTO:1.0 PACKETSIZE:512
send 'MATCH | CO_BIRD_00_HH./MSEED'
send 'STREAM | '
readPacket(): blocking read for 3 bytes, available=0
Response: OK
readPacket(): blocking read for 3 bytes, available=0
D CO.BIRD.00.HHE 2023,213,15:40:36.9700  3.37 337
readPacket(): blocking read for 3 bytes, available=6666
D CO.BIRD.00.HHE 2023,213,15:40:40.3400  3.27 327
send 'ENDSTREAM | '
readPacket(): blocking read for 3 bytes, available=6060
D CO.BIRD.00.HHE 2023,213,15:40:43.6100  3.22 322
readPacket(): blocking read for 3 bytes, available=5454
D CO.BIRD.00.HHE 2023,213,15:40:46.8300  3.25 325
readPacket(): blocking read for 3 bytes, available=4848
D CO.BIRD.00.HHE 2023,213,15:40:50.0800  3.28 328
readPacket(): blocking read for 3 bytes, available=4242
D CO.BIRD.00.HHE 2023,213,15:40:53.3600  3.25 325
readPacket(): blocking read for 3 bytes, available=3636
D CO.BIRD.00.HHE 2023,213,15:40:56.6100  3.26 326
readPacket(): blocking read for 3 bytes, available=3030
D CO.BIRD.00.HHE 2023,213,15:40:59.8700  3.26 326
readPacket(): blocking read for 3 bytes, available=2424
D CO.BIRD.00.HHE 2023,213,15:41:03.1300  3.37 337
readPacket(): blocking read for 3 bytes, available=1818
D CO.BIRD.00.HHE 2023,213,15:41:06.5000  3.32 332
readPacket(): blocking read for 3 bytes, available=1212
D CO.BIRD.00.HHE 2023,213,15:41:09.8200  3.45 345
readPacket(): blocking read for 3 bytes, available=606
D CO.BIRD.00.HHN 2023,213,15:40:37.6700  3.22 322
readPacket(): blocking read for 3 bytes, available=0
D CO.BIRD.00.HHN 2023,213,15:40:40.8900  3.21 321
readPacket(): blocking read for 3 bytes, available=12120
D CO.BIRD.00.HHN 2023,213,15:40:44.1000  3.18 318
readPacket(): blocking read for 3 bytes, available=11514
D CO.BIRD.00.HHN 2023,213,15:40:47.2800  3.15 315
readPacket(): blocking read for 3 bytes, available=10908
D CO.BIRD.00.HHN 2023,213,15:40:50.4300  3.27 327
readPacket(): blocking read for 3 bytes, available=10302
D CO.BIRD.00.HHN 2023,213,15:40:53.7000  3.25 325
readPacket(): blocking read for 3 bytes, available=9696
D CO.BIRD.00.HHN 2023,213,15:40:56.9500  3.2 320
readPacket(): blocking read for 3 bytes, available=9090
D CO.BIRD.00.HHN 2023,213,15:41:00.1500  3.22 322
readPacket(): blocking read for 3 bytes, available=8484
D CO.BIRD.00.HHN 2023,213,15:41:03.3700  3.29 329
readPacket(): blocking read for 3 bytes, available=7878
D CO.BIRD.00.HHN 2023,213,15:41:06.6600  3.28 328
readPacket(): blocking read for 3 bytes, available=7272
D CO.BIRD.00.HHN 2023,213,15:41:09.9400  3.29 329
readPacket(): blocking read for 3 bytes, available=6666
D CO.BIRD.00.HHZ 2023,213,15:40:36.5200  3.38 338
readPacket(): blocking read for 3 bytes, available=6060
D CO.BIRD.00.HHZ 2023,213,15:40:39.9000  3.33 333
readPacket(): blocking read for 3 bytes, available=5454
D CO.BIRD.00.HHZ 2023,213,15:40:43.2300  3.24 324
readPacket(): blocking read for 3 bytes, available=4848
D CO.BIRD.00.HHZ 2023,213,15:40:46.4700  3.28 328
readPacket(): blocking read for 3 bytes, available=4242
D CO.BIRD.00.HHZ 2023,213,15:40:49.7500  3.19 319
readPacket(): blocking read for 3 bytes, available=3636
D CO.BIRD.00.HHZ 2023,213,15:40:52.9400  3.22 322
readPacket(): blocking read for 3 bytes, available=3030
D CO.BIRD.00.HHZ 2023,213,15:40:56.1600  3.25 325
readPacket(): blocking read for 3 bytes, available=2424
D CO.BIRD.00.HHZ 2023,213,15:40:59.4100  3.23 323
readPacket(): blocking read for 3 bytes, available=1818
D CO.BIRD.00.HHZ 2023,213,15:41:02.6400  3.25 325
readPacket(): blocking read for 3 bytes, available=1212
D CO.BIRD.00.HHZ 2023,213,15:41:05.8900  3.31 331
readPacket(): blocking read for 3 bytes, available=606
D CO.BIRD.00.HHZ 2023,213,15:41:09.2000  3.38 338
readPacket(): blocking read for 3 bytes, available=0