ctod(1)								       ctod(1)

Name
       ctod  - creates a DOTS file for transfer of DDIF or DTIF documents with
       links

Syntax
       ctod [ -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 Also
       ddifanls(1),   dtifanls(1),   dtoc(1),	CDA(5),	 cda_msg(5),  DDIF(5),
       DOTS(5), DTIF(5)

								       ctod(1)

Vote for polarhome