embedaddon/libxml2/doc/xmlcatalog_man.html - view

File: [ELWIX - Embedded LightWeight unIX -] / embedaddon / libxml2 / doc / xmlcatalog_man.html
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Mon Jul 22 01:22:24 2013 UTC (10 years, 11 months ago) by misho
Branches: libxml2, MAIN
CVS tags: v2_9_1p0, v2_9_1, v2_8_0p0, v2_8_0, HEAD

2.8.0

1: <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmlcatalog</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="id2431614"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>xmlcatalog — Command line tool to parse and manipulate <span class="acronym">XML</span> or 2: <span class="acronym">SGML</span> catalog files.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">xmlcatalog</tt> [[--shell] | [--create] | [--add <i class="replaceable"><tt>type</tt></i> 3: <i class="replaceable"><tt>orig</tt></i> <i class="replaceable"><tt>replace</tt></i>] | [--del <i class="replaceable"><tt>values</tt></i>] | [--noout] | [--verbose]] [<tt class="option"><i class="replaceable"><tt>catalogfile</tt></i></tt>] [<tt class="option"><i class="replaceable"><tt>entities</tt></i></tt>]</p></div></div><div class="refsect1" lang="en"><a name="introduction"></a><h2>Introduction</h2><p> 4: <span class="application">xmlcatalog</span> is a command line application 5: allowing users to monitor and manipulate <span class="acronym">XML</span> and 6: <span class="acronym">SGML</span> catalogs. It is included in 7: <span class="application">libxml2</span>. 8: </p><p> 9: Its functions can be invoked from a single command from the command line, 10: or it can perform multiple functions in interactive mode. It can operate 11: on both <span class="acronym">XML</span> and <span class="acronym">SGML</span> files. 12: </p></div><div class="refsect1" lang="en"><a name="cloptions"></a><h2>Command Line Options</h2><div class="variablelist"><dl><dt><span class="term"><tt class="option">--shell</tt> <i class="replaceable"><tt>filename</tt></i></span></dt><dd> 13: Run a shell 14: allowing interactive queries on catalog file 15: <i class="replaceable"><tt>filename</tt></i>. 16: </dd><dt><span class="term"><tt class="option">--create</tt> <i class="replaceable"><tt>filename</tt></i></span></dt><dd> 17: Create a new 18: <span class="acronym">XML</span> catalog. Outputs to stdout, ignoring 19: <i class="replaceable"><tt>filename</tt></i> unless <tt class="option">--noout</tt> is 20: used, in which case it creates a new catalog file 21: <i class="replaceable"><tt>filename</tt></i>. 22: </dd><dt><span class="term"><tt class="option">--add</tt> <i class="replaceable"><tt>'type'</tt></i> <i class="replaceable"><tt>'orig'</tt></i> <i class="replaceable"><tt>'replace'</tt></i> <i class="replaceable"><tt>filename</tt></i></span></dt><dd><p> 23: Add an entry to catalog file 24: <tt class="filename">filename</tt>. <i class="replaceable"><tt>type</tt></i> 25: indicates the type of entry. Possible types are 'public', 'system', 'uri', 26: 'rewriteSystem', 'rewriteURI', 'delegatePublic', 'delegateSystem', 27: 'delegateURI' and 'nextCatalog'. <i class="replaceable"><tt>'orig'</tt></i> is the original 28: reference to be replaced, and <i class="replaceable"><tt>'replace'</tt></i> 29: is the <span class="acronym">URI</span> of the replacement entity to be 30: used. The <tt class="option">--add</tt> option will not overwrite 31: <i class="replaceable"><tt>filename</tt></i>, outputing to stdout, unless 32: <tt class="option">--noout</tt> is used. The <tt class="option">--add</tt> will 33: always take three parameters even if some of the 34: <span class="acronym">XML</span> catalog constructs will have only a single 35: argument. 36: 37: </p><p> 38: If the <tt class="option">--add</tt> option is used following the 39: <tt class="option">--sgml</tt> option, only a single argument, a 40: <i class="replaceable"><tt>filename</tt></i>, is used. This is used to add 41: the name of a catalog file to an <span class="acronym">SGML</span> 42: supercatalog, a file that contains references to other included 43: <span class="acronym">SGML</span> catalog files. 44: </p></dd><dt><span class="term"><tt class="option">--del</tt> <i class="replaceable"><tt>'values'</tt></i> <i class="replaceable"><tt>filename</tt></i></span></dt><dd> 45: Remove entries from the catalog file 46: <i class="replaceable"><tt>filename</tt></i> matching 47: <i class="replaceable"><tt>'values'</tt></i>. The <tt class="option">--del</tt> option 48: will not overwrite <i class="replaceable"><tt>filename</tt></i>, outputing to 49: stdout, unless <tt class="option">--noout</tt> is used. 50: </dd><dt><span class="term"><tt class="option">--noout</tt></span></dt><dd> 51: Save output to the named file rather than 52: outputing to stdout. 53: </dd><dt><span class="term"><tt class="option">--sgml</tt></span></dt><dd> 54: Uses SGML Super catalogs for --add and --del options 55: </dd><dt><span class="term"><tt class="option">-v</tt> or <tt class="option">--verbose</tt></span></dt><dd> 56: output debugging 57: information. 58: </dd></dl></div></div><div class="refsect1" lang="en"><a name="shell"></a><h2>Shell Commands</h2><p>Invoking <span class="application">xmlcatalog</span> with the 59: <tt class="option">--shell</tt> <i class="replaceable"><tt>filename</tt></i> option opens 60: a command line shell allowing interactive access to the catalog file 61: identified by <i class="replaceable"><tt>filename</tt></i>. Invoking the shell 62: provides a command line prompt after which commands can be entered. 63: </p><div class="variablelist"><dl><dt><span class="term"><tt class="option">public</tt> <i class="replaceable"><tt>'PublicID'</tt></i></span></dt><dd> 64: Execute a 65: public identifier lookup of the catalog entry for 66: <i class="replaceable"><tt>'PublicID'</tt></i>. The corresponding entry will be 67: output to the command line. 68: </dd><dt><span class="term"><tt class="option">system</tt> <i class="replaceable"><tt>'SystemID'</tt></i></span></dt><dd> 69: Execute a 70: public identifier lookup of the catalog entry for 71: <i class="replaceable"><tt>'SystemID'</tt></i>. The corresponding entry will be 72: output to the command line. 73: </dd><dt><span class="term"><tt class="option">add </tt> <i class="replaceable"><tt>'type'</tt></i> <i class="replaceable"><tt>'orig'</tt></i> <i class="replaceable"><tt>'replace'</tt></i></span></dt><dd> 74: Add an entry to the catalog 75: file. <i class="replaceable"><tt>type</tt></i> indicates the type of 76: entry. Possible types are 'public', 'system', 'uri', 'rewriteSystem', 'rewriteURI', 77: 'delegatePublic', 'delegateSystem', 'delegateURI' and 'nextCatalog'. <i class="replaceable"><tt>'orig'</tt></i> 78: is the original reference to be replaced, and 79: <i class="replaceable"><tt>'replace'</tt></i> is the <span class="acronym">URI</span> of the 80: replacement entity to be used. 81: </dd><dt><span class="term"><tt class="option">del</tt> <i class="replaceable"><tt>'values'</tt></i></span></dt><dd> 82: Remove the 83: catalog entry corresponding to <i class="replaceable"><tt>'values'</tt></i>. 84: </dd><dt><span class="term"><tt class="option">dump</tt></span></dt><dd> 85: Print the current catalog. 86: </dd><dt><span class="term"><tt class="option">debug</tt></span></dt><dd> 87: Print debugging statements showing the steps 88: <span class="application">xmlcatalog</span> is executing. 89: </dd><dt><span class="term"><tt class="option">quiet</tt></span></dt><dd> 90: Stop printing debugging statements. 91: </dd><dt><span class="term"><tt class="option">exit</tt></span></dt><dd> 92: Quit the shell. 93: </dd></dl></div></div><div class="refsect1" lang="en"><a name="return"></a><h2>Return values</h2><p><span class="application">xmlcatalog</span>'s return codes provide 94: information that can be used when calling it from scripts.</p><p>0: normal</p><p>1: Failed to remove an entry from the catalog</p><p>2: Failed to save to the catalog, check file permissions</p><p>3: Failed to add an entry to the catalog</p><p>4: Failed to lookup and entry in the catalog</p></div><div class="refsect1" lang="en"><h2>Catalogs</h2><p>Catalog behavior can be changed by redirecting 95: queries to the user's own set of catalogs. This can be done by setting the 96: <tt class="varname">XML_CATALOG_FILES</tt> environment variable to a list of 97: catalogs. An empty one should deactivate loading the default 98: <tt class="filename">/etc/xml/catalog</tt> default catalog.</p></div><div class="refsect1" lang="en"><h2>References</h2><p><a href="http://www.xmlsoft.org/" target="_top">libxml web page</a></p><p><a href="http://www.xmlsoft.org/catalog.html" target="_top"><span class="application">libxml</span> 99: catalog support web page:</a></p><p><a href="http://www.jclark.com/sp/catalog.htm" target="_top">James Clark's 100: <span class="acronym">SGML</span> catalog page:</a></p><p><a href="http://www.oasis-open.org/committees/entity/spec.html" target="_top"><span class="acronym">OASIS</span> 101: <span class="acronym">XML</span> catalog specification: </a></p></div></div></body></html>