1*7c568831SAndroid Build Coastguard Worker<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmllint</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="idm1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>xmllint — command line <acronym class="acronym">XML</acronym> tool</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">xmllint</code> [ <code class="option">--version</code> | <code class="option">--debug</code> | <code class="option">--quiet</code> | <code class="option">--shell</code> | <code class="option">--xpath "<em class="replaceable"><code>XPath_expression</code></em>"</code> | <code class="option">--debugent</code> | <code class="option">--copy</code> | <code class="option">--recover</code> | <code class="option">--nodict</code> | <code class="option">--noent</code> | <code class="option">--noout</code> | <code class="option">--nonet</code> | <code class="option">--path "<em class="replaceable"><code>PATH(S)</code></em>"</code> | <code class="option">--load-trace</code> | <code class="option">--htmlout</code> | <code class="option">--nowrap</code> | <code class="option">--valid</code> | <code class="option">--postvalid</code> | <code class="option">--dtdvalid <em class="replaceable"><code>URL</code></em></code> | <code class="option">--dtdvalidfpi <em class="replaceable"><code>FPI</code></em></code> | <code class="option">--timing</code> | <code class="option">--output <em class="replaceable"><code>FILE</code></em></code> | <code class="option">--repeat</code> | <code class="option">--insert</code> | <code class="option">--compress</code> | <code class="option">--html</code> | <code class="option">--xmlout</code> | <code class="option">--push</code> | <code class="option">--memory</code> | <code class="option">--max-ampl <em class="replaceable"><code>INTEGER</code></em></code> | <code class="option">--maxmem <em class="replaceable"><code>NBBYTES</code></em></code> | <code class="option">--nowarning</code> | <code class="option">--noblanks</code> | <code class="option">--nocdata</code> | <code class="option">--format</code> | <code class="option">--encode <em class="replaceable"><code>ENCODING</code></em></code> | <code class="option">--dropdtd</code> | <code class="option">--nsclean</code> | <code class="option">--testIO</code> | <code class="option">--catalogs</code> | <code class="option">--nocatalogs</code> | <code class="option">--auto</code> | <code class="option">--xinclude</code> | <code class="option">--noxincludenode</code> | <code class="option">--loaddtd</code> | <code class="option">--dtdattr</code> | <code class="option">--stream</code> | <code class="option">--walker</code> | <code class="option">--pattern <em class="replaceable"><code>PATTERNVALUE</code></em></code> | <code class="option">--relaxng <em class="replaceable"><code>SCHEMA</code></em></code> | <code class="option">--schema <em class="replaceable"><code>SCHEMA</code></em></code> | <code class="option">--c14n</code> | <code class="option">--pedantic</code> ] { <em class="replaceable"><code>XML-FILE(S)</code></em>... | - }</p></div><div class="cmdsynopsis"><p><code class="command">xmllint</code> <code class="option">--help</code> </p></div></div><div class="refsect1"><a name="description"></a><h2>DESCRIPTION</h2><p> 2*7c568831SAndroid Build Coastguard Worker The <span class="command"><strong>xmllint</strong></span> program parses one or more <acronym class="acronym">XML</acronym> files, 3*7c568831SAndroid Build Coastguard Worker specified on the command line as <em class="replaceable"><code>XML-FILE</code></em> 4*7c568831SAndroid Build Coastguard Worker (or the standard input if the filename provided 5*7c568831SAndroid Build Coastguard Worker is <span class="bold"><strong>-</strong></span> ). It prints various types of 6*7c568831SAndroid Build Coastguard Worker output, depending upon the options selected. It is useful for detecting 7*7c568831SAndroid Build Coastguard Worker errors both in <acronym class="acronym">XML</acronym> code and in 8*7c568831SAndroid Build Coastguard Worker the <acronym class="acronym">XML</acronym> parser itself. 9*7c568831SAndroid Build Coastguard Worker </p><p><span class="command"><strong>xmllint</strong></span> is included in <span class="citerefentry"><span class="refentrytitle">libxml</span>(3)</span>.</p></div><div class="refsect1"><a name="options"></a><h2>OPTIONS</h2><p> 10*7c568831SAndroid Build Coastguard Worker <span class="command"><strong>xmllint</strong></span> accepts the following options (in alphabetical order): 11*7c568831SAndroid Build Coastguard Worker </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">--auto</code></span></dt><dd><p>Generate a small document for testing purposes.</p></dd><dt><span class="term"><code class="option">--catalogs</code></span></dt><dd><p> 12*7c568831SAndroid Build Coastguard Worker Use the <acronym class="acronym">SGML</acronym> catalog(s) from <code class="envar">SGML_CATALOG_FILES</code>. 13*7c568831SAndroid Build Coastguard Worker Otherwise <acronym class="acronym">XML</acronym> catalogs starting 14*7c568831SAndroid Build Coastguard Worker from <code class="filename">/etc/xml/catalog</code> or, more specifically, 15*7c568831SAndroid Build Coastguard Worker <code class="filename">${sysconfdir}/xml/catalog</code> are used by default. 16*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--compress</code></span></dt><dd><p> 17*7c568831SAndroid Build Coastguard Worker Turn on <span class="citerefentry"><span class="refentrytitle">gzip</span>(1)</span> compression of output. 18*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--copy</code></span></dt><dd><p>Test the internal copy implementation.</p></dd><dt><span class="term"><code class="option">--c14n</code></span></dt><dd><p> 19*7c568831SAndroid Build Coastguard Worker Use the W3C <acronym class="acronym">XML</acronym> Canonicalisation (<acronym class="acronym">C14N</acronym>) to 20*7c568831SAndroid Build Coastguard Worker serialize the result of parsing to <code class="filename">stdout</code>. 21*7c568831SAndroid Build Coastguard Worker It keeps comments in the result. 22*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--dtdvalid <em class="replaceable"><code>URL</code></em></code></span></dt><dd><p> 23*7c568831SAndroid Build Coastguard Worker Use the <acronym class="acronym">DTD</acronym> specified by 24*7c568831SAndroid Build Coastguard Worker an <em class="replaceable"><code>URL</code></em> for validation. 25*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--dtdvalidfpi <em class="replaceable"><code>FPI</code></em></code></span></dt><dd><p> 26*7c568831SAndroid Build Coastguard Worker Use the <acronym class="acronym">DTD</acronym> specified by a Formal Public 27*7c568831SAndroid Build Coastguard Worker Identifier <em class="replaceable"><code>FPI</code></em> for validation, note that this 28*7c568831SAndroid Build Coastguard Worker will require a catalog exporting that Formal Public Identifier to work. 29*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--debug</code></span></dt><dd><p> 30*7c568831SAndroid Build Coastguard Worker Parse a file and output an annotated tree of the 31*7c568831SAndroid Build Coastguard Worker in-memory version of the document. 32*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--debugent</code></span></dt><dd><p>Debug the entities defined in the document.</p></dd><dt><span class="term"><code class="option">--dropdtd</code></span></dt><dd><p>Remove <acronym class="acronym">DTD</acronym> from output.</p></dd><dt><span class="term"><code class="option">--dtdattr</code></span></dt><dd><p> 33*7c568831SAndroid Build Coastguard Worker Fetch external <acronym class="acronym">DTD</acronym> and populate the tree with 34*7c568831SAndroid Build Coastguard Worker inherited attributes. 35*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--encode <em class="replaceable"><code>ENCODING</code></em></code></span></dt><dd><p>Output in the given encoding. Note that this works for full document not fragments or result from XPath queries.</p></dd><dt><span class="term"><code class="option">--format</code></span></dt><dd><p> 36*7c568831SAndroid Build Coastguard Worker Reformat and reindent the output. The <code class="envar">XMLLINT_INDENT</code> 37*7c568831SAndroid Build Coastguard Worker environment variable controls the indentation. The default value is two 38*7c568831SAndroid Build Coastguard Worker spaces " "). 39*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--help</code></span></dt><dd><p>Print out a short usage summary for <span class="command"><strong>xmllint</strong></span>.</p></dd><dt><span class="term"><code class="option">--html</code></span></dt><dd><p>Use the <acronym class="acronym">HTML</acronym> parser.</p></dd><dt><span class="term"><code class="option">--htmlout</code></span></dt><dd><p> 40*7c568831SAndroid Build Coastguard Worker Output results as an <acronym class="acronym">HTML</acronym> file. This 41*7c568831SAndroid Build Coastguard Worker causes <span class="command"><strong>xmllint</strong></span> to output the necessary <acronym class="acronym">HTML</acronym> 42*7c568831SAndroid Build Coastguard Worker tags surrounding the result tree output so the results can be 43*7c568831SAndroid Build Coastguard Worker displayed/viewed in a browser. 44*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--insert</code></span></dt><dd><p>Test for valid insertions.</p></dd><dt><span class="term"><code class="option">--loaddtd</code></span></dt><dd><p>Fetch an external <acronym class="acronym">DTD</acronym>.</p></dd><dt><span class="term"><code class="option">--load-trace</code></span></dt><dd><p> 45*7c568831SAndroid Build Coastguard Worker Display all the documents loaded during the processing 46*7c568831SAndroid Build Coastguard Worker to <code class="filename">stderr</code>. 47*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--max-ampl <em class="replaceable"><code>INTEGER</code></em></code></span></dt><dd><p> 48*7c568831SAndroid Build Coastguard Worker Set the maximum amplification factor which protects against 49*7c568831SAndroid Build Coastguard Worker exponential entity expansion ("billion laughs"). The default value 50*7c568831SAndroid Build Coastguard Worker is 5. Documents making heavy use of entity expansion may require a 51*7c568831SAndroid Build Coastguard Worker higher value. 52*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--maxmem <em class="replaceable"><code>NNBYTES</code></em></code></span></dt><dd><p> 53*7c568831SAndroid Build Coastguard Worker Test the parser memory support. <em class="replaceable"><code>NNBYTES</code></em> 54*7c568831SAndroid Build Coastguard Worker is the maximum number of bytes the library is allowed to allocate. 55*7c568831SAndroid Build Coastguard Worker This can also be used to make sure batch processing 56*7c568831SAndroid Build Coastguard Worker of <acronym class="acronym">XML</acronym> files will not exhaust the virtual memory 57*7c568831SAndroid Build Coastguard Worker of the server running them. 58*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--memory</code></span></dt><dd><p>Parse from memory.</p></dd><dt><span class="term"><code class="option">--noblanks</code></span></dt><dd><p>Drop ignorable blank spaces.</p></dd><dt><span class="term"><code class="option">--nocatalogs</code></span></dt><dd><p>Do not use any catalogs.</p></dd><dt><span class="term"><code class="option">--nocdata</code></span></dt><dd><p>Substitute CDATA section by equivalent text nodes.</p></dd><dt><span class="term"><code class="option">--nodict</code></span></dt><dd><p> 59*7c568831SAndroid Build Coastguard Worker Don't use dictionaries (parser option XML_PARSE_NODICT). 60*7c568831SAndroid Build Coastguard Worker Only for debugging. 61*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--noent</code></span></dt><dd><p> 62*7c568831SAndroid Build Coastguard Worker Substitute entity values for entity references. By default, <span class="command"><strong>xmllint</strong></span> 63*7c568831SAndroid Build Coastguard Worker leaves entity references in place. 64*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--nonet</code></span></dt><dd><p> 65*7c568831SAndroid Build Coastguard Worker Do not use the Internet to fetch <acronym class="acronym">DTD</acronym>s or entities. 66*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--noout</code></span></dt><dd><p> 67*7c568831SAndroid Build Coastguard Worker Suppress output. By default, <span class="command"><strong>xmllint</strong></span> outputs the result tree. 68*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--nowarning</code></span></dt><dd><p>Do not emit warnings from the parser and/or validator.</p></dd><dt><span class="term"><code class="option">--nowrap</code></span></dt><dd><p>Do not output <acronym class="acronym">HTML</acronym> doc wrapper.</p></dd><dt><span class="term"><code class="option">--noxincludenode</code></span></dt><dd><p> 69*7c568831SAndroid Build Coastguard Worker Do XInclude processing but do not generate XInclude start and end nodes. 70*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--nsclean</code></span></dt><dd><p>Remove redundant namespace declarations.</p></dd><dt><span class="term"><code class="option">--output <em class="replaceable"><code>FILE</code></em></code></span></dt><dd><p> 71*7c568831SAndroid Build Coastguard Worker Define a file path where <span class="command"><strong>xmllint</strong></span> will save the result of parsing. 72*7c568831SAndroid Build Coastguard Worker Usually the programs build a tree and save it 73*7c568831SAndroid Build Coastguard Worker on <code class="filename">stdout</code>, with this option 74*7c568831SAndroid Build Coastguard Worker the result <acronym class="acronym">XML</acronym> instance will be saved onto a file. 75*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--path "<em class="replaceable"><code>PATH(S)</code></em>"</code></span></dt><dd><p> 76*7c568831SAndroid Build Coastguard Worker Use the (space- or colon-separated) list of filesystem paths specified 77*7c568831SAndroid Build Coastguard Worker by <em class="replaceable"><code>PATHS</code></em> to load <acronym class="acronym">DTD</acronym>s or 78*7c568831SAndroid Build Coastguard Worker entities. Enclose space-separated lists by quotation marks. 79*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--pattern <em class="replaceable"><code>PATTERNVALUE</code></em></code></span></dt><dd><p> 80*7c568831SAndroid Build Coastguard Worker Used to exercise the pattern recognition engine, which can be used 81*7c568831SAndroid Build Coastguard Worker with the reader interface to the parser. It allows to select some 82*7c568831SAndroid Build Coastguard Worker nodes in the document based on an XPath (subset) expression. Used 83*7c568831SAndroid Build Coastguard Worker for debugging. 84*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--pedantic</code></span></dt><dd><p>Enable additional warnings.</p></dd><dt><span class="term"><code class="option">--postvalid</code></span></dt><dd><p>Validate after parsing has completed.</p></dd><dt><span class="term"><code class="option">--push</code></span></dt><dd><p>Use the push mode of the parser.</p></dd><dt><span class="term"><code class="option">--quiet</code></span></dt><dd><p>Don't print informational messages to stderr.</p></dd><dt><span class="term"><code class="option">--recover</code></span></dt><dd><p>Output any parsable portions of an invalid document.</p></dd><dt><span class="term"><code class="option">--relaxng <em class="replaceable"><code>SCHEMA</code></em></code></span></dt><dd><p> 85*7c568831SAndroid Build Coastguard Worker Use RelaxNG file named <em class="replaceable"><code>SCHEMA</code></em> 86*7c568831SAndroid Build Coastguard Worker for validation. 87*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--repeat</code></span></dt><dd><p>Repeat 100 times, for timing or profiling.</p></dd><dt><span class="term"><code class="option">--schema <em class="replaceable"><code>SCHEMA</code></em></code></span></dt><dd><p> 88*7c568831SAndroid Build Coastguard Worker Use a W3C <acronym class="acronym">XML</acronym> Schema file 89*7c568831SAndroid Build Coastguard Worker named <em class="replaceable"><code>SCHEMA</code></em> for validation. 90*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--shell</code></span></dt><dd><p> 91*7c568831SAndroid Build Coastguard Worker Run a navigating shell. Details on available commands in shell mode 92*7c568831SAndroid Build Coastguard Worker are below (see <a class="xref" href="#shell" title="SHELL COMMANDS">the section called “SHELL COMMANDS”</a>). 93*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--xpath "<em class="replaceable"><code>XPath_expression</code></em>"</code></span></dt><dd><p> 94*7c568831SAndroid Build Coastguard Worker Run an XPath expression given as argument and print the 95*7c568831SAndroid Build Coastguard Worker result. In case of a nodeset result, each node in the 96*7c568831SAndroid Build Coastguard Worker node set is serialized in full in the output. In case 97*7c568831SAndroid Build Coastguard Worker of an empty node set the "XPath set is empty" result 98*7c568831SAndroid Build Coastguard Worker will be shown and exit code 11 will be returned.. 99*7c568831SAndroid Build Coastguard Worker This feature is EXPERIMENTAL. Implementation details can 100*7c568831SAndroid Build Coastguard Worker change without futher notice. 101*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--stream</code></span></dt><dd><p> 102*7c568831SAndroid Build Coastguard Worker Use streaming <acronym class="acronym">API</acronym> - useful when used in combination 103*7c568831SAndroid Build Coastguard Worker with <code class="option">--relaxng</code> or <code class="option">--valid</code> options 104*7c568831SAndroid Build Coastguard Worker for validation of files that are too large to be held in memory. 105*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--testIO</code></span></dt><dd><p>Test user input/output support.</p></dd><dt><span class="term"><code class="option">--timing</code></span></dt><dd><p> 106*7c568831SAndroid Build Coastguard Worker Output information about the time it takes <span class="command"><strong>xmllint</strong></span> to perform the 107*7c568831SAndroid Build Coastguard Worker various steps. 108*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--valid</code></span></dt><dd><p> 109*7c568831SAndroid Build Coastguard Worker Determine if the document is a valid instance of the included 110*7c568831SAndroid Build Coastguard Worker Document Type Definition (<acronym class="acronym">DTD</acronym>). 111*7c568831SAndroid Build Coastguard Worker A <acronym class="acronym">DTD</acronym> to be validated against also can be 112*7c568831SAndroid Build Coastguard Worker specified at the command line using the <code class="option">--dtdvalid</code> 113*7c568831SAndroid Build Coastguard Worker option. By default, <span class="command"><strong>xmllint</strong></span> also checks to determine if the 114*7c568831SAndroid Build Coastguard Worker document is well-formed. 115*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p> 116*7c568831SAndroid Build Coastguard Worker Display the version of <span class="citerefentry"><span class="refentrytitle">libxml</span>(3)</span> used. 117*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--walker</code></span></dt><dd><p> 118*7c568831SAndroid Build Coastguard Worker Test the walker module, which is a reader interface but for a 119*7c568831SAndroid Build Coastguard Worker document tree, instead of using the reader <acronym class="acronym">API</acronym> on 120*7c568831SAndroid Build Coastguard Worker an unparsed document it works on an existing in-memory tree. Used for 121*7c568831SAndroid Build Coastguard Worker debugging. 122*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">--xinclude</code></span></dt><dd><p>Do XInclude processing.</p></dd><dt><span class="term"><code class="option">--xmlout</code></span></dt><dd><p> 123*7c568831SAndroid Build Coastguard Worker Used in conjunction with <code class="option">--html</code>. Usually 124*7c568831SAndroid Build Coastguard Worker when <acronym class="acronym">HTML</acronym> is parsed the document is saved with 125*7c568831SAndroid Build Coastguard Worker the <acronym class="acronym">HTML</acronym> serializer. But with this option the 126*7c568831SAndroid Build Coastguard Worker resulting document is saved with the <acronym class="acronym">XML</acronym> 127*7c568831SAndroid Build Coastguard Worker serializer. This is primarily used to 128*7c568831SAndroid Build Coastguard Worker generate <acronym class="acronym">XHTML</acronym> from <acronym class="acronym">HTML</acronym> input. 129*7c568831SAndroid Build Coastguard Worker </p></dd></dl></div></div><div class="refsect1"><a name="shell"></a><h2>SHELL COMMANDS</h2><p> 130*7c568831SAndroid Build Coastguard Worker <span class="command"><strong>xmllint</strong></span> offers an interactive shell mode invoked with 131*7c568831SAndroid Build Coastguard Worker the <code class="option">--shell</code> command. Available commands in shell mode 132*7c568831SAndroid Build Coastguard Worker include (in alphabetical order): 133*7c568831SAndroid Build Coastguard Worker </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="command"><strong>base</strong></span></span></dt><dd><p>Display <acronym class="acronym">XML</acronym> base of the node.</p></dd><dt><span class="term"><span class="command"><strong>bye</strong></span></span></dt><dd><p>Leave the shell.</p></dd><dt><span class="term"><span class="command"><strong>cat <em class="replaceable"><code>NODE</code></em></strong></span></span></dt><dd><p>Display the given node or the current one.</p></dd><dt><span class="term"><span class="command"><strong>cd <em class="replaceable"><code>PATH</code></em></strong></span></span></dt><dd><p> 134*7c568831SAndroid Build Coastguard Worker Change the current node to the given path (if unique) or root if no 135*7c568831SAndroid Build Coastguard Worker argument is given. 136*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><span class="command"><strong>dir <em class="replaceable"><code>PATH</code></em></strong></span></span></dt><dd><p> 137*7c568831SAndroid Build Coastguard Worker Dumps information about the node (namespace, attributes, content). 138*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><span class="command"><strong>du <em class="replaceable"><code>PATH</code></em></strong></span></span></dt><dd><p> 139*7c568831SAndroid Build Coastguard Worker Show the structure of the subtree under the given path or the current node. 140*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><span class="command"><strong>exit</strong></span></span></dt><dd><p>Leave the shell.</p></dd><dt><span class="term"><span class="command"><strong>help</strong></span></span></dt><dd><p>Show this help.</p></dd><dt><span class="term"><span class="command"><strong>load <em class="replaceable"><code>FILENAME</code></em></strong></span></span></dt><dd><p>Load a new document with the given filename.</p></dd><dt><span class="term"><span class="command"><strong>ls <em class="replaceable"><code>PATH</code></em></strong></span></span></dt><dd><p>List contents of the given path or the current directory.</p></dd><dt><span class="term"><span class="command"><strong>pwd</strong></span></span></dt><dd><p>Display the path to the current node.</p></dd><dt><span class="term"><span class="command"><strong>quit</strong></span></span></dt><dd><p>Leave the shell.</p></dd><dt><span class="term"><span class="command"><strong>save <em class="replaceable"><code>FILENAME</code></em></strong></span></span></dt><dd><p> 141*7c568831SAndroid Build Coastguard Worker Save the current document to the given filename or to the original name. 142*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="option">validate</code></span></dt><dd><p>Check the document for errors.</p></dd><dt><span class="term"><span class="command"><strong>write <em class="replaceable"><code>FILENAME</code></em></strong></span></span></dt><dd><p>Write the current node to the given filename.</p></dd></dl></div></div><div class="refsect1"><a name="environment"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">SGML_CATALOG_FILES</code></span></dt><dd><p><acronym class="acronym">SGML</acronym> catalog behavior can be changed by redirecting 143*7c568831SAndroid Build Coastguard Worker queries to the user's own set of catalogs. This can be done by setting 144*7c568831SAndroid Build Coastguard Worker the <code class="envar">SGML_CATALOG_FILES</code> environment variable to a list 145*7c568831SAndroid Build Coastguard Worker of catalogs. An empty one should deactivate loading the 146*7c568831SAndroid Build Coastguard Worker default catalog. 147*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="envar">XML_CATALOG_FILES</code></span></dt><dd><p><acronym class="acronym">XML</acronym> catalog behavior can be changed by redirecting 148*7c568831SAndroid Build Coastguard Worker queries to the user's own set of catalogs. This can be done by setting 149*7c568831SAndroid Build Coastguard Worker the <code class="envar">XML_CATALOG_FILES</code> environment variable to a space-separated 150*7c568831SAndroid Build Coastguard Worker list of catalogs. Use percent-encoding to escape spaces or other characters. 151*7c568831SAndroid Build Coastguard Worker An empty variable should deactivate loading the default catalog. 152*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="envar">XML_DEBUG_CATALOG</code></span></dt><dd><p>Setting the environment variable <code class="envar">XML_DEBUG_CATALOG</code> 153*7c568831SAndroid Build Coastguard Worker to <em class="parameter"><code>non-zero</code></em> using the <span class="command"><strong>export</strong></span> 154*7c568831SAndroid Build Coastguard Worker command outputs debugging information related to catalog operations. 155*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><code class="envar">XMLLINT_INDENT</code></span></dt><dd><p>Setting the environment variable <code class="envar">XMLLINT_INDENT</code> 156*7c568831SAndroid Build Coastguard Worker controls the indentation. The default value is two spaces " ". 157*7c568831SAndroid Build Coastguard Worker </p></dd></dl></div></div><div class="refsect1"><a name="diagnostics"></a><h2>DIAGNOSTICS</h2><p> 158*7c568831SAndroid Build Coastguard Worker <span class="command"><strong>xmllint</strong></span> return codes provide information that can be used when 159*7c568831SAndroid Build Coastguard Worker calling it from scripts. 160*7c568831SAndroid Build Coastguard Worker </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="errorcode">0</span></span></dt><dd><p>No error</p></dd><dt><span class="term"><span class="errorcode">1</span></span></dt><dd><p>Unclassified</p></dd><dt><span class="term"><span class="errorcode">2</span></span></dt><dd><p>Error in <acronym class="acronym">DTD</acronym></p></dd><dt><span class="term"><span class="errorcode">3</span></span></dt><dd><p>Validation error</p></dd><dt><span class="term"><span class="errorcode">4</span></span></dt><dd><p>Validation error</p></dd><dt><span class="term"><span class="errorcode">5</span></span></dt><dd><p>Error in schema compilation</p></dd><dt><span class="term"><span class="errorcode">6</span></span></dt><dd><p>Error writing output</p></dd><dt><span class="term"><span class="errorcode">7</span></span></dt><dd><p> 161*7c568831SAndroid Build Coastguard Worker Error in pattern (generated when <code class="option">--pattern</code> option is used) 162*7c568831SAndroid Build Coastguard Worker </p></dd><dt><span class="term"><span class="errorcode">9</span></span></dt><dd><p>Out of memory error</p></dd><dt><span class="term"><span class="errorcode">10</span></span></dt><dd><p>XPath evaluation error</p></dd><dt><span class="term"><span class="errorcode">11</span></span></dt><dd><p>XPath result is empty</p></dd></dl></div></div><div class="refsect1"><a name="seealso"></a><h2>SEE ALSO</h2><p><span class="citerefentry"><span class="refentrytitle">libxml</span>(3)</span> 163*7c568831SAndroid Build Coastguard Worker </p><p> 164*7c568831SAndroid Build Coastguard Worker More information can be found at 165*7c568831SAndroid Build Coastguard Worker </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="citerefentry"><span class="refentrytitle">libxml</span>(3)</span> web page <a class="ulink" href="https://gitlab.gnome.org/GNOME/libxml2" target="_top">https://gitlab.gnome.org/GNOME/libxml2</a> 166*7c568831SAndroid Build Coastguard Worker </p></li></ul></div><p> 167*7c568831SAndroid Build Coastguard Worker </p></div></div></body></html> 168