# NAME

s1kd-syncrefs - Synchronize references in a data module

# SYNOPSIS

   s1kd-syncrefs [-dflqvh?] [-o <out>] [<data module>...]

# DESCRIPTION

The *s1kd-syncrefs* tool copies all external references (dmRef, pmRef,
externalPubRef) within the content of a data module and uses them to
generate the \<refs\> element. Each unique reference is copied, sorted,
and placed in to the \<refs\> element. If a \<refs\> element already
exists, it is overwritten.

# OPTIONS

 - \-d, --delete
   Delete the \<refs\> element.

 - \-f, --overwrite
   Overwrite the data modules automatically.

 - \-h, -?, --help
   Show help/usage message.

 - \-l, --list
   Treat input (stdin or arguments) as lists of data modules to
   synchronize references in, rather than data modules themselves.

 - \-o, --out \<out\>
   The resulting XML is written to \<out\> instead of stdout.

 - \-q, --quiet
   Quiet mode. Errors are not printed.

 - \-v, --verbose
   Verbose output.

 - \--version
   Show version information.

 - \<data module\>...
   The data module(s) to synchronize references in. Default is to read
   from stdin.

In addition, the following options allow configuration of the XML
parser:

 - \--dtdload
   Load the external DTD.

 - \--huge
   Remove any internal arbitrary parser limits.

 - \--net
   Allow network access to load external DTD and entities.

 - \--noent
   Resolve entities.

 - \--parser-errors
   Emit errors from parser.

 - \--parser-warnings
   Emit warnings from parser.

 - \--xinclude
   Do XInclude processing.

 - \--xml-catalog \<file\>
   Use an XML catalog when resolving entities. Multiple catalogs may be
   loaded by specifying this option multiple times.

# EXIT STATUS

 - 0
   No errors.

 - 1
   Invalid data module.

 - 2
   Number of references in a data module exceeded the available memory.

# EXAMPLE

   $ s1kd-syncrefs -f DMC-EX-A-00-00-00-00A-040A-D_000-01_EN-CA.XML