NAME

dump - dump memory to device during system failure

SYNOPSIS

#include <sys/types.h>

#include <sys/ddi.h>
#include <sys/sunddi.h>

int prefixdump(dev_t dev, caddr_t addr, daddr_t blkno, int nblk);

INTERFACE LEVEL

Solaris specific (Solaris DDI). This entry point is required. For drivers that do not implement dump routines, nodev should be used.

ARGUMENTS

dev

Device number.

addr

Address for the beginning of the area to be dumped.

blkno

Block offset to dump memory to.

nblk

Number of blocks to dump.

DESCRIPTION

dump( ) is used to dump a portion of virtual address space directly to a device in the case of system failure. The memory area to be dumped is specified by addr (base address) and nblk (length). It is dumped to the device specified by dev starting at offset blkno. Upon completion dump( ) returns the status of the transfer.

dump( ) is called at interrupt priority.

RETURN VALUES

dump( ) should return 0 on success, or the appropriate error number.

SEE ALSO

Writing Device Drivers