dumpsave(1M) dumpsave(1M)
NAME
dumpsave - save a system dump
SYNOPSIS
dumpsave [-c] [-q] [-d dumpdir] [-s swapfile] [-o]
DESCRIPTION
The dumpsave command should be called during the system boot process.
Its function is to save a system dump from the swap device to a regu-
lar file.
dumpsave checks the swap device to see if a system dump exists. If one
is found, it saves the system dump to the system dump directory, and
also copies /unix there. If the system dump is saved successfully, the
dump header is cleared from the swap device so that successive runs of
dumpsave will not resave the same system dump. Both the dump and a
copy of /unix are given an identical numeric suffix. The suffix used
is the lowest number that doesn't already appear.
dumpsave initializes several parameters from /etc/default/dumpsave:
DUMPDIR=/var/crash
MINFREE=4096
UNIXFILE=/unix
SWAPFILE=/dev/swap
TMPDEV=temporary-name-for-devices
ULIMIT=ulimit-value
The first two, DUMPDIR and MINFREE are present by default, but can be
modified or removed. The next four, UNIXFILE, SWAPFILE, TMPDEV, and
ULIMIT, can be added.
DUMPDIR specifies the system dump directory. MINFREE specifies the
minimum number of 512 byte blocks that should be left free on the
filesystem containing DUMPDIR. If the dump, or /unix, or both will not
fit in DUMPDIR without leaving MINFREE blocks free, it will not be
saved.
Typically UNIXFILE is /unix and SWAPFILE is /dev/swap. TMPDEV is the
pathname of a device that will be created and removed by dumpsave when
the dump spans more than one swap device. The value of ULIMIT is nor-
mally unlimited, but can be set lower.
OPTIONS
-c Checks if the dump exists, but will not save or clear it. Returns
0 if the dump exists, otherwise 1.
-q Quiet. A less verbose mode.
-d dumpdir
Directory to which the dump file and /unix will be copied.
Page 1 Reliant UNIX 5.44 Printed 11/98
dumpsave(1M) dumpsave(1M)
-s swapfile
The source of the dump will be swapfile instead of /dev/swap.
-o The memory dump is not written to the directory specified with
dumpdir rather to standard output for further processing. This
option is intended for writing the memory dump to tape.
DIAGNOSTICS
The dumpsave command exits with a status of 0 if the dump exists and
was successfully saved, otherwise non-zero.
FILES
/dev/swap
/dev/tmpdumpdev
/etc/default/dumpsave
/unix
/var/crash
SEE ALSO
dumpsave(4).
Page 2 Reliant UNIX 5.44 Printed 11/98