*** UNIX MANUAL PAGE BROWSER ***

dtoc(1) General Commands Manual dtoc(1) 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 exter- nally 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 con- tent 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 sequen- tial number appended to its name. For example, if one of the DOTS sub- files 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 up- dated 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 modi- fied, the references in the unpacked DDIF or DTIF are updated. The han- dling 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 ex- ternal 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 re- turns an error status. SEE ALSO ctod(1), ddifanls(1), dtifanls(1), cda(4), ddif(4), dtif(4), dots(4), ddis(4) dtoc(1)