SCRUG-NA/2025
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[installation] Change to nightly

Browse Source
This commit is contained in:
Dirk Rössler
2025-10-30 12:04:59 +01:00
parent 2ff097f9d1
commit a31bc45cce
1441 changed files with 60368 additions and 56360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

111
share/man/man1/fdsnws.1
View File

@ -27,19 +27,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "FDSNWS" "1" "Sep 22, 2025" "6.9.0" "SeisComP"
.TH "FDSNWS" "1" "Oct 29, 2025" "7.0.0" "SeisComP"
.SH NAME
fdsnws \- SeisComP Documentation
.sp
\fBProvide FDSN Web Services.\fP
.SH DESCRIPTION
.sp
fdsnws is a server that provides event and station information by FDSN Web Services
(\fIFDSNWS\fP [\fI\%8\fP])
from a SeisComP database and waveforms from a \fI\%RecordStream\fP source.
Also it may be configured to serve data
availability information as described in the IRIS DMC FDSNWS availability Web
Service Documentation (\fIIRIS DMC\fP [\fI\%12\fP]).
fdsnws is a server that provides event, station and data availability
information by FDSN Web Services (\fIFDSNWS\fP [\fI\%8\fP]) from a SeisComP database and
waveforms from a \fI\%RecordStream\fP source.
.sp
\fBCAUTION:\fP
.INDENT 0.0
@ -356,10 +353,6 @@ The data availability web service returns detailed time span information of
what time series data is available at the DMC archive. The availability information
can be created by \fI\%scardac\fP in the \fISeisComP\fP database from where it is
fetched by fdsnws.
.sp
The availability service is no official standard yet. This implementation aims
to be compatible with the IRIS DMC availability FDSN Web Service
(\fIIRIS DMC\fP [\fI\%12\fP]) implementation.
.INDENT 0.0
.IP \(bu 2
request type: HTTP\-GET, HTTP\-POST
@ -738,8 +731,8 @@ temporary account can be requested using one of the following commands:
.sp
.nf
.ft C
sysop@host:~$ wget \-\-post\-file token.asc https://geofon.gfz\-potsdam.de/fdsnws/dataselect/1/auth \-O cred.txt
sysop@host:~$ curl \-\-data\-binary @token.asc https://geofon.gfz\-potsdam.de/fdsnws/dataselect/1/auth \-o cred.txt
sysop@host:~$ wget \-\-post\-file token.asc https://geofon.gfz.de/fdsnws/dataselect/1/auth \-O cred.txt
sysop@host:~$ curl \-\-data\-binary @token.asc https://geofon.gfz.de/fdsnws/dataselect/1/auth \-o cred.txt
.ft P
.fi
.UNINDENT
@ -752,8 +745,8 @@ a colon, so one can conveniently use a shell expansion:
.sp
.nf
.ft C
sysop@host:~$ wget \(dqhttp://\(gacat cred.txt\(ga@geofon.gfz\-potsdam.de/fdsnws/dataselect/1/queryauth?starttime=2015\-12\-15T16:00:00Z&endtime=2015\-12\-15T16:10:00Z&network=IA&station=AAI\(dq \-O data.mseed
sysop@host:~$ curl \-\-digest \(dqhttp://\(gacat cred.txt\(ga@geofon.gfz\-potsdam.de/fdsnws/dataselect/1/queryauth?starttime=2015\-12\-15T16:00:00Z&endtime=2015\-12\-15T16:10:00Z&network=IA&station=AAI\(dq \-o data.mseed
sysop@host:~$ wget \(dqhttp://\(gacat cred.txt\(ga@geofon.gfz.de/fdsnws/dataselect/1/queryauth?starttime=2015\-12\-15T16:00:00Z&endtime=2015\-12\-15T16:10:00Z&network=IA&station=AAI\(dq \-O data.mseed
sysop@host:~$ curl \-\-digest \(dqhttp://\(gacat cred.txt\(ga@geofon.gfz.de/fdsnws/dataselect/1/queryauth?starttime=2015\-12\-15T16:00:00Z&endtime=2015\-12\-15T16:10:00Z&network=IA&station=AAI\(dq \-o data.mseed
.ft P
.fi
.UNINDENT
@ -967,10 +960,11 @@ Type: \fIint\fP
Unit: \fIs\fP
.sp
Restrict end time of requests to current time \- realtimeGap
seconds. Negative values allowed. Used in fdsnws\-dataselect.
WARNING: If this value is unset and a realtime recordsource
(e.g. slink) is used, requests may block if end time in future
is requested.
seconds. Negative values are allowed. Used in fdsnws\-dataselect.
.sp
WARNING: If this value is unset and a real\-time RecordStream
(e.g. slink) is used, requests may block if end times in the
future are requested.
.UNINDENT
.INDENT 0.0
.TP
@ -993,7 +987,7 @@ Unit: \fIbytes\fP
Set the number of bytes to buffer for each chunk of waveform data
served to the client. The lower the buffer the higher the overhead
of Python Twisted. The higher the buffer the higher the memory
usage per request. 100kB seems to be a good trade\-off.
usage per request. 100 kB seems to be a good trade\-off.
.UNINDENT
.INDENT 0.0
.TP
@ -1012,14 +1006,14 @@ specification, the passwords have to be stored in plain text.
.B accessLog
Type: \fIstring\fP
.sp
Path to access log file. If unset no access log is created.
Path to access log file. If unset, no access log is created.
.UNINDENT
.INDENT 0.0
.TP
.B requestLog
Type: \fIstring\fP
.sp
Path to request log file. If unset no request log is created.
Path to request log file. If unset, no request log is created.
.UNINDENT
.INDENT 0.0
.TP
@ -1038,7 +1032,10 @@ Type: \fIlist:string:\fP
List of domain names Cross\-Origin Resource Sharing (CORS)
request may originate from. A value of \(aq*\(aq allows any web page
to embed your service. An empty value will switch of CORS
requests entirely. An example of multiple domains might be:
requests entirely.
.sp
Example of multiple domains:
.sp
\(aq\fI\%https://test.domain.de\fP, \fI\%https://production.domain.de\fP\(aq.
.UNINDENT
.INDENT 0.0
@ -1095,6 +1092,8 @@ If enabled, event comment elements are no longer accessible.
.B evaluationMode
Type: \fIstring\fP
.sp
Values: \fB,automatic,manual\fP
.sp
If set, the event service will only return events having a
preferred origin with a matching evaluationMode property.
.UNINDENT
@ -1103,6 +1102,8 @@ preferred origin with a matching evaluationMode property.
.B eventFormats
Type: \fIlist:string\fP
.sp
Values: \fBcsv,qml,qml\-rt,sc3ml,text,xml\fP
.sp
List of enabled event formats. If unspecified, all supported
formats are enabled.
.UNINDENT
@ -1146,14 +1147,14 @@ standard FDSNWS extension served under fdsnws/ext/availability.
.INDENT 0.0
.TP
.B stationFilter
Type: \fIstring\fP
Type: \fIfile\fP
.sp
Path to station inventory filter file.
.UNINDENT
.INDENT 0.0
.TP
.B dataSelectFilter
Type: \fIstring\fP
Type: \fIfile\fP
.sp
Path to dataselect inventory filter file.
.UNINDENT
@ -1299,6 +1300,60 @@ Type: \fIlist:string\fP
.sp
List of revoked token IDs.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.enable
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Enable JWT extension.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.issuers
Default: \fBhttps://geofon.gfz.de/eas2,https://login.earthscope.org/\fP
.sp
Type: \fIlist:string\fP
.sp
List of issuer URLs.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.audience
Default: \fBeas,fdsn\fP
.sp
Type: \fIlist:string\fP
.sp
List of valid audience.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.algorithms
Default: \fBRS256\fP
.sp
Type: \fIlist:string\fP
.sp
List of allowed algorithms.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.updateMinSeconds
Default: \fB300\fP
.sp
Type: \fIint\fP
.sp
Minimum time to wait between requesting updated keys from a key server.
.UNINDENT
.INDENT 0.0
.TP
.B jwt.updateMaxSeconds
Default: \fB86400\fP
.sp
Type: \fIint\fP
.sp
Maximum time to cache received keys.
.UNINDENT
.SH COMMAND-LINE OPTIONS
.sp
\fBfdsnws [options]\fP
@ -1446,12 +1501,12 @@ List all supported record stream drivers.
.INDENT 0.0
.TP
.B \-I, \-\-record\-url arg
The recordstream source URL, format:
The RecordStream source URL. Format:
[\fI\%service://\fP]location[#type].
\(dqservice\(dq is the name of the recordstream driver
\(dqservice\(dq is the name of the RecordStream driver
which can be queried with \(dq\-\-record\-driver\-list\(dq.
If \(dqservice\(dq is not given, \(dq\fI\%file://\fP\(dq is
used.
used and simply the name of a miniSEED file can be given.
.UNINDENT
.INDENT 0.0
.TP