vpardump(1M) vpardump(1M)
NAME
vpardump - manage monitor dump files
SYNOPSIS
[vparmon[dumpfile]]
DESCRIPTION
The command is used to create (on PA-RISC systems only) and analyze a virtual partition monitor dump file. vparmon is the image of the
virtual partition monitor and dumpfile is the crash dump file corresponding to that image. is normally run from the rc script to analyze a
crash dump during HP-UX boot. If no options are specified, checks if the dumpfile has been cleared. If not, it analyzes dumpfile and
prints information about the crash to standard out. Then marks the dumpfile as clear. If dumpfile is not specified, the string is
appended to vparmon as in If vparmon is not specified, it defaults to
The dumpfile must exist prior to a vpar monitor crash. On PA-RISC systems, the and options create the dumpfile on PA-RISC. If is used, a
dumpfile is created that is large enough to contain the monitor image. If additional structures are required, such as I/O Page Directo-
ries, the option is used to reserve space for a full monitor crash dump. On Itanium(R)-based systems, the monitor dumpfile is created in
the EFI partition of the monitor's boot disk as needed. It is not necessary to pre-allocate a dump file in A monitor dump typically
requires less than 75 megabytes of free space in the EFI partition. In order to ensure that a complete crash dump can be saved, this much
free space must be maintained in the EFI partition.
Options
recognizes the following command-line options:
Analyze the
dumpfile. This option can be used to force an analysis even if dumpfile has been cleared.
Mark dumpfile as clear. No analysis is performed.
Analyze
dumpfile even if the versions do not match.
Initialize
dumpfile for a full dump. Supported only on PA-RISC systems.
Initialize
dumpfile for a normal dump. Supported only on PA-RISC systems.
Do not analyze the
dumpfile.
Enable verbose output.
The and options are allowed on Itanium-based systems for compatibility. No action is taken for the and options.
Operands
recognizes the following command-line operands:
vparmon The name of the image of the virtual partition monitor. If vparmon is not specified, it defaults to
dumpfile The name of the crash dump file corresponding to the image of the virtual partion monitor. If dumpfile is not specified,
the string is appended to vparmon as in
Security Restrictions
This command is restricted to processes owned by superuser or with the privilege. See privileges(5) for more information about privileged
access on systems that support fine-grained privileges.
RETURN VALUE
returns the following values:
Analyzed
dumpfile successfully.
Created a new
dumpfile.
A dumpfile does not exist.
The dumpfile is cleared, no action taken.
Error attempting to create a
dumpfile.
Error analyzing the
dumpfile.
Command syntax error.
EXAMPLES
Analyze the default dumpfile and create it if it does not exist:
Suppress the analysis of the default dumpfile, and reserve space for a full dump:
AUTHOR
was developed by the Hewlett-Packard Company.
SEE ALSO
vparextract(1M), privileges(5).
vpardump(1M)