s1kd-newimf(1)                    s1kd-tools                    s1kd-newimf(1)

NAME
       s1kd-newimf - Create a new S1000D ICN metadata file

SYNOPSIS
              s1kd-newimf [options] <ICNs>...

DESCRIPTION
       The  s1kd-newimf tool creates a new S1000D ICN metadata file for speci‐
       fied ICN files.

OPTIONS
       -$, --issue <issue>
              Specify which issue of S1000D to use.  Currently  supported  is‐
              sues are:

              · 5.0 (default)

              · 4.2

       -@, --out <path>
              Save the new IMF to <path>.  If <path> is an existing directory,
              the IMF will be created in it instead of the current  directory.
              Otherwise,  the IMF will be saved as the filename <path> instead
              of being automatically named.

       -%, --templates <dir>
              Use the XML template in <dir> instead of the built-in  template.
              The template must be named icnmetadata.xml inside <dir> and must
              conform to the default S1000D issue (5.0).

       -~, --dump-templates <dir>
              Dump the built-in XML template to the specified directory.

       -b, --brex <BREX>
              BREX data module code.

       -c, --security <sec>
              The security classification of the new ICN metadata file.

       -d, --defaults <file>
              Specify the .defaults file name.

       -f, --overwrite
              Overwrite existing file.

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

       -I, --date <date>
              The issue date of the new ICN metadata file in the form of YYYY-
              MM-DD.

       -m, --remarks <remarks>
              Set the remarks for the new ICN metadata file.

       -n, --issno <issue>
              The issue number of the new ICN metadata file.

       -O, --origcode <CAGE>
              The CAGE code of the originator.

       -o, --origname <orig>
              The originator enterprise name of the new ICN metadata file.

       -p, --prompt
              Prompts the user for any values left unspecified.

       -q, --quiet
              Do not report an error when the file already exists.

       -R, --rpccode <CAGE>
              The CAGE code of the responsible partner company.

       -r, --rpcname <RPC>
              The  responsible  partner company enterprise name of the new ICN
              metadata file.

       -t, --title <title>
              The ICN title (if creating multiple ICNs, they will all use this
              title).

       -v, --verbose
              Print the file name of the newly created IMF.

       -w, --inwork <inwork>
              The inwork issue of the new ICN metadata file.

       --version
              Show version information.

       In addition, the following options allow configuration of the XML pars‐
       er:

       --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.

   .defaults file
       Refer  to  s1kd-newdm(1)  for information on the .defaults file used by
       all the s1kd-new* tools.

EXAMPLE
              $ s1kd-newimf ICN-EX-00001-001-01.PNG

AUTHORS
       khzae.net.

                                  2021-04-16                    s1kd-newimf(1)