Content-type: text/html Man page of dtoc

dtoc

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

NAME

dtoc - unpacks a DOTS file after transfer of DDIF or DTIF documents with links  

SYNOPSIS

dtoc [-f] [-p] [object.dots [directory]]


 

OPTIONS

Suppresses output of unpacked file names. Causes only the name of the primary output file to be written to standard output.
 

DESCRIPTION

The dtoc command unpacks the contents of a DOTS (Data Object Transport Syntax) file or standard input after transfer of the DOTS file from one location to another, usually via mail. The contents of the DOTS file typically are a DDIF compound document or DTIF file and their externally linked subfiles.

The object.dots input can be either a file name or a minus sign (-) for the standard input. If you specify a minus sign (-), or if no file name is present, the dtoc command reads from the standard input. If you specify directory, the content of the DOTS file is unpacked and stored in the specified directory. If you do not specify directory, the content of the DOTS file is unpacked into the current directory. The names of the files created are written to standard output.

If the dtoc command encounters duplicate file or directory names while unpacking the DOTS file, a new output file is generated with a sequential number appended to its name. For example, if one of the DOTS subfiles has the same name as the existing file foo.ddif, the dtoc command unpacks and names the subfile foo.ddif.1.

References to externally linked subfiles and their file names are updated and modified during unpacking, particularly if the DOTS file originated on a non-UNIX system.
 

IMPLEMENTATION


 

STANDARD INPUT

If a minus sign (-) is specified, or if no parameters are specified, dtoc reads from standard input until it encounters a Ctrl/D or EOF (end of file), which can be specified no more than once. The contents of the standard input must conform to the syntax of a single DOTS file.
 

RECONSTITUTION OF NAMES

DDIF or DTIF file names and the file names of referenced subfiles may be modified as objects are extracted or unpacked. If names are modified, the references in the unpacked DDIF or DTIF are updated. The handling of files names depends in part on the name-type of the object, as follows:

UNIX file names

Names are unmodified, except that any path or directory is removed since the primary document and its references are unpacked into the same directory. A period and unique number are applied to any file name that would duplicate an existing file.

VMS file names

The set of rules is as follows:

Convert uppercase letters to lowercase.

Convert dollar signs ($) to underscores (_).

Ignore disk volume and directory specifications, if they are present, because they are not likely to be meaningful on UNIX systems.

Append duplicate file names with a period and a unique number.

All other characters are unmodified.
 

RESTRICTIONS

A DOTS file is expected to contain only a single primary DDIF or DTIF object in this release. Any subsequent objects in the DOTS file are external references of the primary object.
 

DIAGNOSTICS

If all files were unpacked successfully, the exit status is 0. If any of the files could not be unpacked, the exit status is 1. Consult your standard error location for a description of why the files could not be unpacked.

If a nonexistent target directory is specified, the dtoc command returns an error status.
 

SEE ALSO

ctod(1), ddifanls(1), dtifanls(1), cda(4), ddif(4), dtif(4), dots(4), ddis(4)


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
IMPLEMENTATION
STANDARD INPUT
RECONSTITUTION OF NAMES
RESTRICTIONS
DIAGNOSTICS
SEE ALSO

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