Index for Section 1

Alphabetical listing for C

ctod(1)
NAME
  ctod - creates a DOTS file for transfer of DDIF or DTIF documents with
  links

SYNOPSIS
  ctod [-x] [-s] [-c] object.[ddif,dtif]

OPTIONS
  -x  Specifies that ctod 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.

  -s  Specifies that ctod 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.

  -c  Specifies that ctod 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 control.

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

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 message
  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(4), cda_msg(4), ddif(4), dots(4),
  dtif(4)