lkcd_config - configure system dumping parameters
SYNOPSIS
lkcd_config [ -d device_name | -D device_num ]
[ -c compression ] [ -f flags ] [ -l level ]
lkcd_config -q
DESCRIPTION
lkcd_config is a system dumping configuration utility that
allows the root user to define the dump parameters on the
system. Dump configuration is performed against the sys
tem device /dev/dump, which is the default dump device
driver for a system.
Once the system dump modules, including compression are
installed, dumps can be easily configured via the command
line. In addition, all options can be displayed via the
-q option, or read from the /proc/sys/dump directory.
OPTIONS
-d device_name
This specifies the device name to dump to. Typi
cally, this will be the primary swap partition on a
system, although any disk device can be specified.
NOTE: Be very careful when specifying this option.
Specifying the wrong disk device can lead to seri
ous damage to your system.
-D device_num
This specifies the disk device number (major and
minor) to dump to. For example, 0x304 specifies
/dev/hda4 after translating the major/minor pair.
This option should only be used by those adminis
trators that know which major/minor device numbers
to specify. NOTE: Be very careful when specifying
this option. Specifying the wrong disk device can
lead to serious damage to your system.
-c compression
This outlines the compression mechanism to use.
Depending on whether a dump compression module is
installed or not, or whether the kernel was built
with a compression functionality, compression can
be turned on or not. The three values to use are
currently:
Value Description of Value
0 DUMP_COMPRESS_NONE (No Compression)
1 DUMP_COMPRESS_RLE (RLE Compression)
2 DUMP_COMPRESS_GZIP (GZIP Compression)
These are the dump configuration to flags to use.
There are only a few values to pass in currently:
Value Description of Value
0 DUMP_FLAGS_NONE (No Flags)
1 DUMP_FLAGS_NONDISRUPT (Do Not Reboot After Dumping)
-l level
This specifies the dump level to use. Dump levels
define what amount of information will be dumped.
This value may change in the future as different
dump methods may be allowed. The current values
are:
Value Description of Value
0 DUMP_LEVEL_NONE (No Flags)
1 DUMP_LEVEL_HEADER (Only Create A Dump Header)
2 DUMP_LEVEL_KERN (Only Dump Kernel Pages)
4 DUMP_LEVEL_USED (Only Dump In-Use Pages)
8 DUMP_LEVEL_ALL (Dump All Pages)
-q This returns a print-out of the current dump con
figuration. The same information can be retrieved
by looking at the files in /proc/sys/dump, which
are the values currently set in the kernel dump
modules.
NOTES
lkcd_config will change as values in linux/dump.h change;
be sure to verify that your lkcd_config has the latest set
of dump configuration values.
lkcd_config was written pretty quickly, and really needs a
better interface to display potential values; there are
probably also bugs.
Please review any and all LKCD releases from our web site:
http://oss.sgi.com/projects/lkcd/.
Man(1) output converted with
man2html