HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

v
vpardump(1M) vpardump(1M)
NAME
vpardump - manage monitor dump files
SYNOPSIS
vpardump [-f | -i][-a
| -c | -q | -F][-v][vparmon[ dumpfile]]
DESCRIPTION
The
vpardump command is used to create 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.
vpardump is normally run from the vparinit rc script to analyze a crash dump during HP-UX boot. If
no options are specified, vpardump checks if dumpfile has been cleared. If not, it analyzes dumpfile and
prints information about the crash to
stdout. Then
vpardump marks the dumpfile as clear. If dumpfile
is not specified, the string ".dmp" is appended to vparmon as in
/stand/vparmon.dmp. If vparmon is
not specified, it defaults to
/stand/vpmon
.
The dumpfile must exist prior to a vpar monitor crash. The
-i and -f options create the dumpfile.If-i
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 Directories, the
-f option is used to reserve space for a full monitor crash
dump. These structures are rarely useful for diagnostics and are normally omitted.
Only a superuser can execute the
vpardump command.
Options
vpardump recognizes the following command-line options:
-a Analyze the dumpfile. This option can be used to force an analysis even if dumpfile has been cleared.
-c Mark dumpfile as clear. No analysis is performed.
-f Initialize dumpfile for a full dump.
-i Initialize dumpfile for a normal dump.
-q Do not analyze the dumpfile.
-F Analyze dumpfile even if the versions do not match.
-v Enable verbose output.
Operands
vpardump 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 /stand/vpmon .
dumpfile The name of the crash dump file corresponding to the image of the virtual partion moni-
tor. If dumpfile is not specified, the string ".dmp" is appended to vparmon as in
/stand/vparmon.dmp.
EXAMPLES
Analyze the default dumpfile (/stand/vpmon.dmp
), and create it if it does not exist:
#
vpardump -i
Suppress the analysis of the default dumpfile, and reserve space for a full dump:
# vpardump -fq
RETURN VALUE
0 Analyzed dumpfile successfully.
1 Created a new dumpfile.
2 A dumpfile does not exist.
3 The dumpfile is cleared, no action taken.
4 Error attempting to create a dumpfile.
5 Error analyzing the dumpfile.
6 Command syntax error.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−1103