ctod - creates a DOTS file for transfer of DDIF or DTIF documents with links
ctod [-x] [-s] [-c] object.[ddif,dtif]
is to encode the input
file in DOTS format. Links to externally referenced subfiles are not resolved.
Use this option only with files containing no external references.
is to pack the input
file or object and its externally linked references, even if some of the
references are missing. Normally, missing references cause a fatal error.
is to pack the reference
only if the ExternalReference reference-control item is set to copy-reference.
By default, all references are packed regardless of the value of the reference
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 output to a file or pipe.
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
command reads from standard input.
The only DDIS object types supported in this release are DDIF compound
documents and DTIF files.
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 message to standard error.
If you specify the
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
returns a success status of 0.
ddifanls(1), dtifanls(1), dtoc(1), cda(4), cda_msg(4), ddif(4), dots(4), dtif(4)