seiscomp-training/share/man/man1/scxmlmerge.1

.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SCXMLMERGE" "1" "Oct 14, 2025" "6.9.1" "SeisComP"
.SH NAME
scxmlmerge \- SeisComP Documentation
.sp
\fBMerge the content of multiple XML files in SCML format.\fP
.SH DESCRIPTION
.sp
scxmlmerge reads all \fISeisComP\fP elements from one or more XML files in \fI\%SCML\fP
format. It merges the content and prints the result to standard output. The
input can contain and \fI\%SeisComP element\fP and the
content can be filtered to print only some elements such as EventParameters.
The output can be redirected into one single file and used by other applications.
.sp
The supported \fI\%SeisComP elements\fP are:
.INDENT 0.0
.IP \(bu 2
Config
.IP \(bu 2
DataAvailability
.IP \(bu 2
EventParameters
.IP \(bu 2
Inventory
.IP \(bu 2
Journaling
.IP \(bu 2
QualityControl
.IP \(bu 2
Routing
.UNINDENT
.sp
By default all supported elements will be parsed and merged. Duplicates are
removed. Use options to restrict the element types.
.sp
There are alternative modules for processing inventory XML files:
.INDENT 0.0
.IP \(bu 2
\fI\%scinv\fP: Merge inventory XML files, extract inventory information.
.IP \(bu 2
\fI\%invextr\fP: Extract and filter inventory information.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.IP 1. 3
Merge the all SeisComP elements from 2 XML files into a single XML file:
.INDENT 3.0
.INDENT 3.5
.sp
.nf
.ft C
scxmlmerge file1.xml file2.xml > file.xml
.ft P
.fi
.UNINDENT
.UNINDENT
.IP 2. 3
Merge the all EventParameters and all Config elements from 2 XML files into a
single XML file. Other element types will be ignored:
.INDENT 3.0
.INDENT 3.5
.sp
.nf
.ft C
scxmlmerge \-E \-C file1.xml file2.xml > file.xml
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.SH MODULE CONFIGURATION
.nf
\fBetc/defaults/global.cfg\fP
\fBetc/defaults/scxmlmerge.cfg\fP
\fBetc/global.cfg\fP
\fBetc/scxmlmerge.cfg\fP
\fB~/.seiscomp/global.cfg\fP
\fB~/.seiscomp/scxmlmerge.cfg\fP
.fi
.sp
.sp
scxmlmerge inherits \fI\%global options\fP\&.
.SH COMMAND-LINE OPTIONS
.sp
\fBscxmlmerge [options] inputFiles\fP
.SS Generic
.INDENT 0.0
.TP
.B \-h, \-\-help
Show help message.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-version
Show version information.
.UNINDENT
.SS Verbosity
.INDENT 0.0
.TP
.B \-\-verbosity arg
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
4:debug.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-v
Increase verbosity level (may be repeated, eg. \-vv).
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
Quiet mode: no logging output.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-print\-component arg
For each log entry print the component right after the
log level. By default the component output is enabled
for file output but disabled for console output.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-component arg
Limit the logging to a certain component. This option can
be given more than once.
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-syslog
Use syslog logging backend. The output usually goes to
/var/lib/messages.
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-lockfile arg
Path to lock file.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-console arg
Send log output to stdout.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug
Execute in debug mode.
Equivalent to \-\-verbosity=4 \-\-console=1 .
.UNINDENT
.INDENT 0.0
.TP
.B \-\-trace
Execute in trace mode.
Equivalent to \-\-verbosity=4 \-\-console=1 \-\-print\-component=1
\-\-print\-context=1 .
.UNINDENT
.INDENT 0.0
.TP
.B \-\-log\-file arg
Use alternative log file.
.UNINDENT
.SS Dump
.INDENT 0.0
.TP
.B \-Y, \-\-availability
Include DataAvailability specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-E, \-\-event
Include EventParameters specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-I, \-\-inventory
Include Inventory specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-J, \-\-journaling
Include QualityControl specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-C, \-\-config
Include Config specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-Q, \-\-quality
Include QualityControl specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-routing
Include Routing specifically. If no specfic object
type is given, all supported objects are included.
.UNINDENT
.SS Options
.INDENT 0.0
.TP
.B \-\-ignore\-bad\-files
Tolerate empty or corrupted input files and continue without
interruption. Otherwise, the application stops if corrupt
or empty files are processed.
.UNINDENT
.SH AUTHOR
gempa GmbH, GFZ Potsdam
.SH COPYRIGHT
gempa GmbH, GFZ Potsdam
.\" Generated by docutils manpage writer.
.