LKCD_CONFIG(1)

NAME
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 system 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. Typically, 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 serious 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 administrators 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)

-f flags
    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 configuration. 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/.