ddif(5) [ultrix man page]

DDIF(5) 							File Formats Manual							   DDIF(5)

Name
       DDIF - Digital Document Interchange Format (DDIF) files

Description
       Digital	Document Interchange Format (DDIF) is a DDIS/ASN.1 encoding for the interchange of revisable compound documents with document pro-
       cessing systems.  DDIF is also a document output format, a storage format for user documents residing on a disk, and  a	compound  document
       format.

       The  purpose  of DDIF is to allow the creation of compound documents and also to serve as a standard intermediate format for the conversion
       of documents based on other formats.  For example, a simple ASCII text file can be converted to DDIF, and the DDIF file can  then  be  con-
       verted to PostScript.  A DDIF document can also be converted to ASCII.

       DDIF files are documents or portions of compound documents.  A DDIF document is considered a simple document if it consists of one file.  A
       DDIF document is considered a compound document if it consists of more than one file, the master of which must be a DDIF file.

       A DDIF file can contain storage addresses (for example, filename) of other files, which must be DDIF, ASCII text,  binary,  or  PostScript.
       References to DOTS files is not supported.

       Because	a  DDIF file can reference another DDIF file and the referenced DDIF file can reference other DDIF files, a DDIF document can con-
       sist of a tree of files.

       The following commands are used to manipulate DDIF files:

       cdoc		   Provides a set of converters to and from DDIF format.

       ctod		   Packs DDIF documents into DOTS syntax.  The user can choose to archive a DDIF document in  this  manner.   The  command
			   also copies DDIF files from one location to another.

       dtoc		   Copies DDIF files from one location to another.

       dxvdoc		   Enables  user to view DDIF documents. The command is used on workstations running ULTRIX UWS software.  The command can
			   also display imbedded graphics and image data that is encoded in the DDIF syntax.

       vdoc		   Enables user to view DDIF documents.  The command is for use on character-cell terminals.

       DDIF documents can be mailed to other users.

See Also
       cdoc(1), ctod(1), dtoc(1), vdoc(1), dxvdoc(1X), DOTS(5), DDIS(5)

																	   DDIF(5)

dtoc(1) 						      General Commands Manual							   dtoc(1)

Name
       dtoc - unpack objects from a DOTS file

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

Description
       The command unpacks the contents of a Data Object Transport Syntax (DOTS) file or standard input.

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

       A DOTS file may contain a data object which consists of more than one component.  Therefore, it is possible that more than one output  file
       may  be	generated.  As the object is unpacked, duplicate file or directory names may be encountered.  If a duplicate is encountered, a new
       output file is generated with a sequential number appended to its name.	For example, if discovers an existing file  during  unpacking,	is
       created.

       As  an  object  is unpacked, the external references within each object component are updated.  Because DOTS files may have originated from
       non-ULTRIX systems, names of components may be modified as components are unpacked.  References to those  renamed  components  are  updated
       accordingly.

Options
       -f   Suppresses output of unpacked file names.

       -p   Causes only the name of the primary input file to be written to standard output.

Implementation
   Standard Input
       If  a minus sign (-) is specified, or if no parameters are specified, standard input is read until a or EOF (end of file) is read.  It can-
       not be specified more than once.  The contents of standard input must conform to the syntax of a single DOTS file.

   Reconstitution Of Names
       Object file names and file names of referenced components may be modified as objects are extracted or unpacked.	If names are modified, the
       references in the unpacked objects are updated.	The handling of names depends in part on the name-type of the object, as follows:

	      ULTRIX file names

		     Names are unmodified.

	      VMS file names

		     The set of rules is as follows:

			    Convert uppercase letters to lower case.

			    Convert dollar signs ($) to underscores (_) because dollar signs have meaning on ULTRIX systems.

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

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

			    Leave all other characters alone.

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
       The  exit status is 0 if all objects were unpacked successfully, and 1 if any of the objects could not be unpacked.  Consult standard error
       to see what failed, and why.

       If a nonexistent target directory is specified, returns error status.

See Also
       ctod(1), DDIF(5), DTIF(5), DOTS(5)

																	   dtoc(1)