NAME
mkdumpdisk - configure a disk partition as a crash dump disk
SYNOPSIS
/sbin/mkdumpdisk raw_disk_device_name
DESCRIPTION
mkdumpdisk allows a superuser to configure a raw disk partition
exclusively for taking dumps and prepares this disk for taking
crash dumps subsequently. The change will be made effective on
the running kernel also.
raw_disk_device_name is the special file that needs to be configured as
the crash dump partition.
After a raw_disk_device_name is configured using mkdumpdisk, /dev/rswap
will not be used for taking crash dumps. Instead, /dev/rcrash with the
same minor number as raw_disk_device_name, will be used. (/dev/rcrash
is a character special device.)
By default, if no dump partition is configured using mkdumpdisk,
/dev/rswap will be the dump partition.
This command can be run only by the superuser.
After preliminary confirmation from the user about the device name,
mkdumpdisk does the following:
* Modifies /etc/conf/cf.d/sassign to change the minor number of all
lines describing the dump partition. These dump partitions will no
longer be mirrored.
* Modifies any entry for dumpdev in the /stand/boot file to reflect
the minor number of the dump slice.
* Creates a character special device node, /dev/rcrash, with the minor
number of raw_disk_device_name
* Modifies the value of dumpdev in the running kernel to the minor
number of raw_disk_device_name
* Rebuilds the kernel to make this change effective in subsequent
reboots
* Overrides the installation default value for the dump device.
EXAMPLES
mkdumpdisk /dev/rdsk/1s1 will configure /dev/rdsk/1s1 as the crash dump
partition and will create /dev/rcrash with a minor number the same as
that of /dev/rdsk/1s1.
DIAGNOSTICS
0 The task completed successfully.
1 mkdumpdisk failed. In case of a
failure, the sytem configuration is
left unaltered.
mkdumpdisk fails in the following cases:
* The user was not a superuser.
* No raw_disk_device_name was specified.
* The raw_disk_device_name specified is not a character.
* A special device was used.
* mkdumpdisk cannot create /dev/rcrash.