uncompress(1) — Reliant UNIX 5.44c4

uncompress(1)                                                 uncompress(1)

NAME
     uncompress - expand compressed files

SYNOPSIS
     uncompress[ option]...[ file]...

DESCRIPTION
     uncompress expands files compressed by compress. The files are
     restored to their original form. The access permissions and access and
     modification dates for the specified files remain unchanged. On sys-
     tems which evaluate the RSTCHOWN variable, the user who invokes
     uncompress is made the owner of the expanded file (unless the invoking
     user is the system administrator). On other systems the owner stays
     the same.

     Whenever possible, each file specified is replaced by a file with the
     same name but without the .Z extension.

     Expansion is not performed if

     -  the file to be created already exists and uncompress is running in
        the background

     -  the specified file was compressed with a higher value for maxbits
        (see compress -b) than your current system can process.

     -  there are links to the compressed file.

OPTIONS
     No option specified:
          The specified files are expanded.

     -c   uncompress writes the expanded files to standard output. No files
          are modified or created. uncompress -c has exactly the same
          effect as zcat.

     -f   (force) file.Z is expanded even if a file named file already
          exists. file is overwritten.

          -f not specified:

          uncompress asks whether the existing file should be overwritten
          or not. You are not asked for confirmation, however, when
          uncompress is running in the background. The specified file is
          not expanded.










Page 1                       Reliant UNIX 5.44                Printed 11/98

uncompress(1)                                                 uncompress(1)

     -v   (verbose) uncompress issues a message confirming successful
          expansion.

          file.Z: -- replaced with file

     --   If file begins with a dash (-), the end of the command-line
          options must be marked with --.

     file Name of a file compressed with compress. You can specify more
          than one file. If you specify a dash - for one of the files,
          uncompress reads from the standard input. Each file name must
          include a .Z suffix which you do not have to specify when invok-
          ing uncompress. The expanded file is assigned the name file.
          file.Z is deleted after being successfully expanded (except in
          the case of -c). Access permissions, access and modification
          dates, and the owner of the file remain unchanged.

          On systems which evaluate the RSTCHOWN variable, the user who
          invokes uncompress is made the owner of the expanded file (unless
          the invoking user is the system administrator). On other systems
          the owner stays the same.

EXIT STATUS
     0   successful

     >0  not successful

ERROR MESSAGES

     file.Z: not in compressed format

          The specified file is not available in compressed format or is a
          directory.

     file.Z: compressed with xx bits, can only handle yy bits

          The specified file was compressed with too high a value for max-
          bits (see compress -b). The system on which you called uncompress
          cannot process this value. Compress the file again using the
          value specified as yy in the error message or with a lower value.

     file.Z: -- has xx links: unchanged

          There are xx links to the specified file. The file is not
          expanded.

     uncompress: corrupt input

          The SIGSEGV signal (segmentation violation; an addressing error
          caused by unauthorized segment access) was received, which nor-
          mally indicates that the input file is corrupted.



Page 2                       Reliant UNIX 5.44                Printed 11/98

uncompress(1)                                                 uncompress(1)

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed. If LCMESSAGES is undefined or is defined
     as the null string, it defaults to the value of LANG. If LANG is like-
     wise undefined or null, the system acts as if it were not internation-
     alized.

     Answers to yes/no queries must be given in the language appropriate to
     the current locale.

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

EXAMPLES
     You want to expand the file topsecret.Z. The same directory already
     contains a file called topsecret, but this can be overwritten.

     $ ls -l
     total 62
     -rw-------  1  felix    group1    4862 Mar 12 10:16 topsecret
     -rw-------  1  felix    group1   26326 Feb 08 10:27 topsecret.Z

     $ uncompress -v topsecret.Z
     topsecret already exists; do you wish to overwrite topsecret (y or n)? y
     topsecret.Z: -- replaced with topsecret

     $ ls -l
     total 138
     -rw-------  1  felix    group1   69845 Feb 08 10:27 topsecret

SEE ALSO
     compress(1), pack(1), pcat(1), unpack(1), zcat(1).





















Page 3                       Reliant UNIX 5.44                Printed 11/98

Museum

Related Articles