.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "xml\-validate" "1" "2020\-07\-07" "" "xml\-utils"
.hy
.SH NAME
.PP
xml\-validate \- Validate XML documents against their schemas
.SH SYNOPSIS
.IP
.nf
\f[C]
xml\-validate\ [\-s\ <path>]\ [\-F|\-f]\ [\-loqvh?]\ [<file>...]
\f[]
.fi
.SH DESCRIPTION
.PP
The \f[I]xml\-validate\f[] utility validates XML documents, checking
whether they are valid XML files and if they are valid against a
referenced or specified schema.
.SH OPTIONS
.TP
.B \-F, \-\-valid\-filenames
List valid files.
.RS
.RE
.TP
.B \-f, \-\-filenames
List invalid files.
.RS
.RE
.TP
.B \-h, \-?, \-\-help
Show help/usage message.
.RS
.RE
.TP
.B \-l, \-\-list
Treat input as a list of XML documents names to validate, rather than an
XML document itself.
.RS
.RE
.TP
.B \-q, \-\-quiet
Quiet mode.
The utility will not output anything to stdout or stderr.
Success/failure will only be indicated through the exit status.
.RS
.RE
.TP
.B \-s, \-\-schema <path>
Validate the XML documents against the specified schema, rather than the
one that they reference.
.RS
.RE
.TP
.B \-v, \-\-verbose
Verbose mode.
Success/failure will be explicitly reported on top of any errors.
.RS
.RE
.TP
.B \-\-version
Show version information.
.RS
.RE
.TP
.B <file>...
Any number of XML documents to validate.
If none are specified, input is read from stdin.
.RS
.RE
.PP
In addition, the following options allow configuration of the XML
parser:
.TP
.B \-\-dtdload
Load the external DTD.
.RS
.RE
.TP
.B \-\-huge
Remove any internal arbitrary parser limits.
.RS
.RE
.TP
.B \-\-net
Allow network access to load external DTD and entities.
.RS
.RE
.TP
.B \-\-noent
Resolve entities.
.RS
.RE
.TP
.B \-\-xinclude
Do XInclude processing.
.RS
.RE
.TP
.B \-\-xml\-catalog <file>
Use an XML catalog when resolving entities.
Multiple catalogs may be loaded by specifying this option multiple
times.
.RS
.RE
.SH EXIT STATUS
.TP
.B 0
No errors.
.RS
.RE
.TP
.B 1
Some XML documents are not well\-formed or valid.
.RS
.RE
.TP
.B 2
The number of schemas cached exceeded the available memory.
.RS
.RE
.TP
.B 3
A specified schema could not be read.
.RS
.RE
.SH EXAMPLE
.IP
.nf
\f[C]
$\ xml\-validate\ doc.xml
\f[]
.fi
.SH AUTHORS
khzae.net.