DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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.