Content-type: text/html Man page of ctod

ctod

Section: User Commands (1)
Index Return to Main Contents
 

NAME

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

SYNOPSIS

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


 

OPTIONS

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


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
RESTRICTIONS
DIAGNOSTICS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:58 GMT, October 02, 2010