ctod(1)ctod(1)Namectod - creates a DOTS file for transfer of DDIF or DTIF documents with
links
Syntaxctod [ -x ] [ -s ] [ -c ] object.[ddif,dtif]
Description
The ctod command creates a single DOTS (Data Object Transport Syntax)
file from a DDIF compound document or DTIF file having external links
to multiple subfiles for the purpose of transferring or mailing the
DOTS file from one location to another.
By default, the ctod command writes the DOTS format to standard output.
However, because DOTS is a binary format, you should redirect the out‐
put to a file or pipe.
The object.[ddif,dtif] input can be either a file name or a minus sign
(-) for standard input. If you specify a minus sign, or if no file name
is present, the ctod command reads from standard input.
Options-x Specifies that ctod is to encode the input file in DOTS for‐
mat. Links to externally referenced subfiles are not
resolved. Use this option only with files containing no
external references.
-s Specifies that ctod is to pack the input file or object and
its externally linked references, even if some of the refer‐
ences are missing. Normally, missing references cause a
fatal error.
-c Specifies that ctod is to pack the reference only if the
ExternalReference reference-control item is set to copy-ref‐
erence. By default, all references are packed regardless of
the value of the reference control.
Restrictions
The only DDIS object types supported in this release are DDIF compound
documents and DTIF files.
Diagnostics
If all files were combined successfully, the exit status is 0. If any
of the files could not be combined, the exit status is 1. Consult your
standard error location for a description of the files that could not
be combined.
If you specify the -x option and object.[ddif,dtif] contains external
references, ctod returns an error status of 1 and writes an error mes‐
sage to standard error.
If you specify the -s option, diagnostic messages containing the names
of the missing references are written to standard error. If the DOTS
packing operation is successful, but missing references are skipped,
ctod returns a success status of 0.
See Alsoddifanls(1), dtifanls(1), dtoc(1), CDA(5), cda_msg(5), DDIF(5),
DOTS(5), DTIF(5)ctod(1)
