Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dtoc(1) [ultrix man page]

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)

Check Out this Related Man Page

pack(1) 						      General Commands Manual							   pack(1)

Name
       pack, pcat, unpack - compress and expand files

Syntax
       pack [ - ] [ -f ] name...

       pcat name...

       unpack name...

Description
       The  command stores the specified files in a compressed form.  Wherever possible (and useful), each input file name is replaced by a packed
       file name.z with the same access modes, access and modified dates, and owner as those of name.  The  -f	option	forces	packing  of  name.
       Using  this option you can cause an entire directory to be packed even if some of the files cannot benefit from it.  If is successful, name
       is removed.  Packed files can be restored to their original form using or

       The command uses Huffman (minimum redundancy) codes on a byte-by-byte basis.  If a hyphen (-) is used as an argument, an internal  flag	is
       set that causes the number of times each byte is used, its relative frequency, and the code for the byte to be printed on the standard out-
       put.  Additional occurrences of a hyphen (-) in place of name causes the internal flag to be set and reset.

       The amount of compression obtained depends on the size of the input file and the character frequency distribution.  Because a decoding tree
       forms  the first part of each .z file, it is usually not worthwhile to pack files smaller than three blocks, unless the character frequency
       distribution is skewed, which may occur with printer plots or pictures.

       Typically, text files are reduced to 60-75% of their original size.  Load modules, which use a larger character set and have a more uniform
       distribution of characters, show little compression.  The packed versions are about 90% of the original size.

       The command returns a value that is the number of files that it failed to compress.

       No packing occurs if one of the following is true:

       o    The file appears packed.

       o    The file name exceeds 12 characters.

       o    The file has links.

       o    The file is a directory.

       o    The file cannot be opened.

       o    No disk storage blocks can be saved by packing.

       o    A file called already exists.

       o    The .z file cannot be created.

       o    An I/O error occurred during processing.

       The  last  segment of the file name must not exceed 12 characters to allow space for the appended .z extension.	Directories cannot be com-
       pressed.

       The command does for packed files what does for ordinary files, except that can not be used as a filter.  The specified files are  unpacked
       and written to the standard output.  Thus, to view a packed file named name.z use:
       pcat name.z
       or just:
       pcat name
       To make an unpacked copy, say nnn, of a packed file named (without destroying name.z) use the command:
       pcat name >nnn
       The command returns the number of files it was unable to unpack.  Failure may occur if:

	      the file name (exclusive of the .z) has more than 12 characters;
	      the file cannot be opened;
	      the file does not appear to be the output of pack.

       The  command expands files created by For each file name specified in the command, a search is made for a file called name.z (or just name,
       if name ends in .z).  If this file appears to be a packed file, it is replaced by its expanded version.	The new file  has  the	.z  suffix
       stripped from its name, and has the same access modes, access and modification dates, and owner as those of the packed file.

       The  command returns a value that is the number of files it was unable to unpack.  Failure occurs for the same reasons that it occurs in as
       well as for the following:

	      a file with the unpacked name already exists;
	      if the unpacked file cannot be created.

       This command is present only for compatibility.	In general, the command runs faster and gives better compression.

See Also
       cat(1), compress(1)

																	   pack(1)
Man Page