xmllint.xml

xml开源解析代码.版本为libxml2-2.6.29,可支持GB3212.网络消息发送XML时很有用.

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl"
   href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
    
    <!ENTITY xmllint "<command>xmllint</command>">
]>

<refentry>

<refentryinfo>
	<title>xmllint Manual</title>
	<productname>libxml2</productname>
	<copyright>
		<year>2001</year>
		<year>2004</year>
	</copyright>
	<authorgroup>
		<author>
			<firstname>John</firstname>
			<surname>Fleck</surname>
			<affiliation>
				<address>
					<email>[e-mail]</email>
				</address>
			</affiliation>
		</author>
		<author>
			<firstname>Ziying</firstname>
			<surname>Sherwin</surname>
			<affiliation>
				<address>
					<email>[e-mail]</email>
				</address>
			</affiliation>
		</author>
		<author>
			<firstname>Heiko</firstname>
			<surname>Rupp</surname>
			<affiliation>
				<address>
					<email>[e-mail]</email>
				</address>
			</affiliation>
		</author>
	</authorgroup>
	<!-- date should be the date of the latest change or the release version -->
	<date>$Date: 2006-08-21 10:34:11 +0200 (Mon, 21 Aug 2006) $</date>
	<!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
	<!-- <releaseinfo>This is release 0.5 of the xmllint Manual.</releaseinfo> -->
	<!-- <edition>0.5</edition> -->
</refentryinfo>

<refmeta>
	<refentrytitle>xmllint</refentrytitle>
	<manvolnum>1</manvolnum>
</refmeta>

<refnamediv>
	<refname>xmllint</refname>
	<refpurpose>command line <acronym>XML</acronym> tool</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
	<command>xmllint</command>
		<group choice="opt">
			<arg choice="plain"><option>--version</option></arg>
			<arg choice="plain"><option>--debug</option></arg>
			<arg choice="plain"><option>--shell</option></arg>
			<arg choice="plain"><option>--debugent</option></arg>
			<arg choice="plain"><option>--copy</option></arg>
			<arg choice="plain"><option>--recover</option></arg>
			<arg choice="plain"><option>--noent</option></arg>
			<arg choice="plain"><option>--noout</option></arg>
			<arg choice="plain"><option>--nonet</option></arg>
			<arg choice="plain"><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></arg>
			<arg choice="plain"><option>--load-trace</option></arg>
			<arg choice="plain"><option>--htmlout</option></arg>
			<arg choice="plain"><option>--nowrap</option></arg>
			<arg choice="plain"><option>--valid</option></arg>
			<arg choice="plain"><option>--postvalid</option></arg>
			<arg choice="plain"><option>--dtdvalid <replaceable class="option">URL</replaceable></option></arg>
			<arg choice="plain"><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></arg>
			<arg choice="plain"><option>--timing</option></arg>
			<arg choice="plain"><option>--output <replaceable class="option">FILE</replaceable></option></arg>
			<arg choice="plain"><option>--repeat</option></arg>
			<arg choice="plain"><option>--insert</option></arg>
			<arg choice="plain"><option>--compress</option></arg>
			<arg choice="plain"><option>--html</option></arg>
			<arg choice="plain"><option>--xmlout</option></arg>
			<arg choice="plain"><option>--push</option></arg>
			<arg choice="plain"><option>--memory</option></arg>
			<arg choice="plain"><option>--maxmem <replaceable class="option">NBBYTES</replaceable></option></arg>
			<arg choice="plain"><option>--nowarning</option></arg>
			<arg choice="plain"><option>--noblanks</option></arg>
			<arg choice="plain"><option>--nocdata</option></arg>
			<arg choice="plain"><option>--format</option></arg>
			<arg choice="plain"><option>--encode <replaceable class="option">ENCODING</replaceable></option></arg>
			<arg choice="plain"><option>--dropdtd</option></arg>
			<arg choice="plain"><option>--nsclean</option></arg>
			<arg choice="plain"><option>--testIO</option></arg>
			<arg choice="plain"><option>--catalogs</option></arg>
			<arg choice="plain"><option>--nocatalogs</option></arg>
			<arg choice="plain"><option>--auto</option></arg>
			<arg choice="plain"><option>--xinclude</option></arg>
			<arg choice="plain"><option>--noxincludenode</option></arg>
			<arg choice="plain"><option>--loaddtd</option></arg>
			<arg choice="plain"><option>--dtdattr</option></arg>
			<arg choice="plain"><option>--stream</option></arg>
			<arg choice="plain"><option>--walker</option></arg>
			<arg choice="plain"><option>--pattern <replaceable class="option">PATTERNVALUE</replaceable></option></arg>
			<arg choice="plain"><option>--chkregister</option></arg>
			<arg choice="plain"><option>--relaxng <replaceable class="option">SCHEMA</replaceable></option></arg>
			<arg choice="plain"><option>--schema <replaceable class="option">SCHEMA</replaceable></option></arg>
			<arg choice="plain"><option>--c14n</option></arg>
		</group>
		<group choice="req">
			<arg choice="plain" rep="repeat"><replaceable>XML-FILE(S)</replaceable></arg>
			<arg choice="plain" rep="norepeat">-</arg>
		</group>
	</cmdsynopsis>
	<cmdsynopsis>
		<command>xmllint</command>
		<arg choice="plain"><option>--help</option></arg>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="description">
	<title>DESCRIPTION</title>
	<para>
		The &xmllint; program parses one or more <acronym>XML</acronym> files,
		specified on the command line as <replaceable>XML-FILE</replaceable>
		(or the standard input if the filename provided
		is <emphasis role="bold">-</emphasis> ). It prints various types of
		output, depending upon the options selected. It is useful for detecting
		errors both in <acronym>XML</acronym> code and in
		the <acronym>XML</acronym> parser itself.
	</para>
	<para>&xmllint; is included in <citerefentry>
		<refentrytitle>libxml</refentrytitle>
		<manvolnum>3</manvolnum>
	</citerefentry>.</para>
</refsect1>

<refsect1 id="options">
	<title>OPTIONS</title>
	<para>
		&xmllint; accepts the following options (in alphabetical order):
	</para>

	<variablelist>

		<varlistentry>
	<term><option>--auto</option></term>
	<listitem>
		<para>Generate a small document for testing purposes.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--catalogs</option></term>
	<listitem>
		<para>
			Use the <acronym>SGML</acronym> catalog(s) from <envar>SGML_CATALOG_FILES</envar>.
			Otherwise <acronym>XML</acronym> catalogs starting
			from <filename>/etc/xml/catalog</filename> are used by default.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--chkregister</option></term>
	<listitem>
		<para>
			Turn on node registration. Useful for developers testing <citerefentry>
		<refentrytitle>libxml</refentrytitle>
		<manvolnum>3</manvolnum>
	</citerefentry> node tracking code.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--compress</option></term>
	<listitem>
		<para>
			Turn on <citerefentry>
		<refentrytitle>gzip</refentrytitle>
		<manvolnum>1</manvolnum>
	</citerefentry> compression of output.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--copy</option></term>
	<listitem>
		<para>Test the internal copy implementation.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--c14n</option></term>
	<listitem>
		<para>
			Use the W3C <acronym>XML</acronym> Canonicalisation (<acronym>C14N</acronym>) to
			serialize the result of parsing to <filename class="devicefile">stdout</filename>.
			It keeps comments in the result.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--dtdvalid <replaceable class="option">URL</replaceable></option></term>
	<listitem>
		<para>
			Use the <acronym>DTD</acronym> specified by
			an <replaceable>URL</replaceable> for validation.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></term>
	<listitem>
		<para>
			Use the <acronym>DTD</acronym> specified by a Formal Public
			Identifier <replaceable>FPI</replaceable> for validation, note that this
			will require a catalog exporting that Formal Public Identifier to work.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--debug</option></term>
	<listitem>
		<para>
			Parse a file and output an annotated tree of the
			in-memory version of the document.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--debugent</option></term>
	<listitem>
		<para>Debug the entities defined in the document.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--dropdtd</option></term>
	<listitem>
		<para>Remove <acronym>DTD</acronym> from output.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--dtdattr</option></term>
	<listitem>
		<para>
			Fetch external <acronym>DTD</acronym> and populate the tree with
			inherited attributes.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--encode <replaceable class="option">ENCODING</replaceable></option></term>
	<listitem>
		<para>Output in the given encoding.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--format</option></term>
	<listitem>
		<para>
			Reformat and reindent the output. The <envar>XMLLINT_INDENT</envar>
			environment variable controls the indentation. The default value is two
			spaces &quot;  &quot;).
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--help</option></term>
	<listitem>
		<para>Print out a short usage summary for &xmllint;.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--html</option></term>
	<listitem>
		<para>Use the <acronym>HTML</acronym> parser.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--htmlout</option></term>
	<listitem>
		<para>
			Output results as an <acronym>HTML</acronym> file. This
			causes &xmllint; to output the necessary <acronym>HTML</acronym>
			tags surrounding the result tree output so the results can be
			displayed/viewed in a browser.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--insert</option></term>
	<listitem>
		<para>Test for valid insertions.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--loaddtd</option></term>
	<listitem>
		<para>Fetch an external <acronym>DTD</acronym>.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--load-trace</option></term>
	<listitem>
		<para>
			Display all the documents loaded during the processing
			to <filename class="devicefile">stderr</filename>.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--maxmem <replaceable class="option">NNBYTES</replaceable></option></term>
	<listitem>
		<para>
			Test the parser memory support. <replaceable>NNBYTES</replaceable>
			is the maximum number of bytes the library is allowed to allocate.
			This can also be used to make sure batch processing
			of <acronym>XML</acronym> files will not exhaust the virtual memory
			of the server running them.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--memory</option></term>
	<listitem>
		<para>Parse from memory.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--noblanks</option></term>
	<listitem>
		<para>Drop ignorable blank spaces.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nocatalogs</option></term>
	<listitem>
		<para>Do not use any catalogs.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nocdata</option></term>
	<listitem>
		<para>Substitute CDATA section by equivalent text nodes.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--noent</option></term>
	<listitem>
		<para>
			Substitute entity values for entity references. By default, &xmllint;
			leaves entity references in place.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nonet</option></term>
	<listitem>
		<para>
			Do not use the Internet to fetch <acronym>DTD</acronym>s or entities.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--noout</option></term>
	<listitem>
		<para>
			Suppress output. By default, &xmllint; outputs the result tree.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nowarning</option></term>
	<listitem>
		<para>Do not emit warnings from the parser and/or validator.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nowrap</option></term>
	<listitem>
		<para>Do not output <acronym>HTML</acronym> doc wrapper.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--noxincludenode</option></term>
	<listitem>
		<para>
			Do XInclude processing but do not generate XInclude start and end nodes.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--nsclean</option></term>
	<listitem>
		<para>Remove redundant namespace declarations.</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--output <replaceable class="option">FILE</replaceable></option></term>
	<listitem>
		<para>
			Define a file path where &xmllint; will save the result of parsing.
			Usually the programs build a tree and save it
			on <filename class="devicefile">stdout</filename>, with this option
			the result <acronym>XML</acronym> instance will be saved onto a file.
		</para>
	</listitem>
		</varlistentry>

		<varlistentry>
	<term><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></term>
	<listitem>
		<para>
			Use the (space- or colon-separated) list of filesystem paths specified
			by <replaceable>PATHS</replaceable> to load <acronym>DTD</acronym>s or
			entities. Enclose space-separated lists by quotation marks.
		</para>
	</listitem>
		</varlistentry>