uncompvm(1M)                                                      uncompvm(1M)


NAME
     uncompvm - expand a compressed IRIX vmcore dump of the operating system

SYNOPSIS
     /etc/uncompvm [ -hHvfd ] [ -s max_mbytes ]
     [ -b  block_number | list | check ] corename [ outfile ]

DESCRIPTION
     uncompvm expands IRIX vmcore.n.comp files into standard vmcore.n files.

     Under some circumstances, an IRIX operating system core dump may be made
     in a special compressed format.  Running file(1) on a vmcore.n.comp file
     yields something like the following:

          vmcore.0.comp:  IRIX vmcore dump of  'IRIX abu stever-j 03080214 IP19'

     uncompvm without any command-line options uncompresses these into files
     of up to the size of the physical memory on the system that created the
     dump.  For this reason, it may not be advisable to expand such dumps.  If
     outfile is not specified, uncompvm expands the dump into vmcore.n without
     the .comp extension.

     The options are:

     -h              Header mode.  In header mode, uncompvm does not
                     uncompress the entire dump file, but rather decodes the
                     dump header which contains information about the system
                     and the reason it created a vmcore file.

     -H              Long header mode.  Like header mode, but it prints a more
                     complete accounting of the information in the dump
                     header.

     -d              Debug mode. Useful only for debugging uncompvm.

     -v              Verbose mode. Prints additional information for each
                     block of the corename.

     -s max_mbytes   Specifies the maximum size of the expanded vmcore.n file
                     in megabytes.

     -b block_number Print detailed information about a particular
                     block_number. The block_number of interest can be
                     possibly obtained by first running the 'uncompvm -b list
                     corename'. (Output goes to stdout).

     -b list         Print specific header information for each block of the
                     corename. (Output goes to stdout, generates lots of
                     output!).


     -b check        uncompvm will read all corename and verify the
                     completeness and correctness of the corename dump. No
                     output will be generated unless errors were detected.

     When -b is specified, uncompvm will not generate the uncompressed outfile
     even if the outfile has been specified on the uncompvm call. The -b
     option is useful to see more in details the internals of the corename and
     it is thus most used by developers.

EXAMPLE
                    uncompvm -s 16 vmcore.0.comp


     This uncompresses vmcore.0.comp into vmcore.0, truncating the size of
     vmcore.0 to 16 megabytes if necessary.

                    uncompvm -b check vmcore.0.comp


     This will read through the coredump and verify its correctness and
     completeness. No output will be generated unless errors were detected.

DIAGNOSTICS
     uncompvm: filename is not an IRIX compressed dump file! is printed if
     uncompvm doesn't recognize the file as a compressed dump file.

SEE ALSO
     savecore(1M), trcore(1M).


                                                                        Page 2