NAME

ctod − combine DDIS objects into DOTS format

SYNTAX

ctod [ −x ] object.ddis

DESCRIPTION

The ctod command combines a DDIS encoded object into a Data Object Transport Syntax (DOTS) format, which is written to standard output.  The object may contain references to other DDIS files.  The purpose of ctod is to create a single file from multiple references to other files, in order to transfer or move DDIS objects from one location to another.

object.ddis is a file name, or an en dash (−) for standard input.  If a dash is specified, or if no file name is present, standard input is read.  The named object and its external references, if any, are combined into a DOTS data stream which is written to standard output. 

Because a DOTS stream contains binary data, ctod output should be redirected to a file or a pipe.

OPTIONS

−x Specifies that ctod is to DOTS encode the input file without resolving any external references present in the file.  This option is for use only with files containing no external references.

RESTRICTIONS

The only DDIS object type supported in this release is DDIF. 

DIAGNOSTICS

The exit status is 0 if all files were combined successfully and 1 if any of the files could not be combined.  Consult ‘standard error’ to see what files failed, and why. 

If the −x option is used and object.ddis contains any external references, ctod returns an error status of 1, and writes an error message to ‘standard error’.

SEE ALSO

dtoc(1), DDIS(5), DDIF(5), DOTS(5)

Commands