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