NAME
livedump — initiates, configures, and stops Live Dump
SYNOPSIS
/sbin/livedump
[-aqbt]
[-m
minfree ]
[-s
chunksize]
[-i
class]
[-e
class]
[-p
path]
[-c
livedumpmsg]
[-d
action]
DESCRIPTION
The
livedump
utility is used to query and modify configurable parameters
(pageclass,
minfree,
chunksize,
etc.).
It is also used to enable/disable
Live Dump
feature and to start/stop
Live Dump.
See
livedump(5)
for details on the configurable parameters.
Live Dump
saves the operating system state to the existing directory that is
specified by
path.
Invoking the
livedump
command with no arguments displays the current
Live Dump
configuration and can be used by ordinary users.
However, using options
along with the command requires administrator privileges.
Options
- -a
Start the
Live Dump
daemon.
- -d action
Start or stop a
Live Dump.
The following are valid usages:
- -d START
Initiate a
Live Dump.
- -d STOP {-1|SID_ANY}
STOP -1
or
STOP SID_ANY
stops a currently running
Live Dump,
kernel or user initiated.
- -d STOP sid
Stop a
Live Dump
identified by the particular session id,
sid.
The
-d STOP
options should not be used along with any other options.
See
livedump(5)
for more details on
sid.
- -b
Initiate
Live Dump
in blocking mode.
To be used with
-d START
option. See
livedump(5)
for details on blocking invocation.
- -c livedumpmsg
Store
Live Dump
message in the INDEX file.
Should be used along with
-d START
option.
- -e class
Exclude the page class specified by
class
from the
Live Dump.
If both
-i
and
-e
options are specified on the command line,
-i
option will override the page classes set with
-e
option.
- -i class
Include the page class specified by
class
in the
Live Dump.
This option has precedence over
-e
option.
- -m minfree
Specify the amount of space left free upon completion of
Live Dump.
Default value is zero. The default unit is Bytes
(b or B).
It also supports Kilo (K or k), Mega (M or m), Giga (G or g),
and Tera (T or t) unit.
The specified
minfree
can be followed by a b or B or space.
The following all specify a
minfree
of 3 giga bytes:
livedump -m 3Gb
livedump -m 3GB
livedump -m 3G
If
Live Dump
detects that the free disk space has fallen below the
minfree
value, it stops saving the dump. The saved dump may not
be debuggable.
- -p path
Specify the directory to save the
Live Dump.
If this option is not specified, then
/var/adm/crash
is used as default directory to save the dump.
- -q
Stop the
Live Dump
daemon. This option should not be used in conjunction with other options.
- -s chunksize
Specify the size of a
Live Dump
image file. Value has to be
between 1G and 2G. The default unit is Bytes (b or B).
It also supports Kilo (K or k), Mega (M or m),
Giga (G or g), and Tera (T or t) unit.
The specified
chunksize
can be followed by a b or B or space. The following
all specify a
chunksize
of 1 giga bytes:
livedump -s 1Gb
livedump -s 1GB
livedump -s 1G
- -t
Use the
Live Dump
configuration specified on command line only for the particular
Live Dump
invocation.
If specified without this option, the
Live Dump
configuration is made default till
next boot. This option should be used along with the
-d START
option.
RETURN VALUE
Upon exit,
livedump
returns the following values:
- 0
Live Dump
was configured/saved successfully.
- 1
Live Dump
could not be saved; invalid options were specified in the command line.
AUTHOR
The
Live Dump
feature was developed by Hewlett-Packard.
FILES
- /etc/rc.config.d/livedump
Live Dump
startup configuration file
- /sbin/init.d/livedump
Live Dump
startup file
- path/lbounds
Live Dump
bounds file
- /stand/vmunix
kernel image saved by
Live Dump
- /var/adm/syslog/syslog.log
Messages saved by
Live Dump