mot_msg(D3DKX) —

NAME

mot_msg − begin a multi-line error message .IX \f4mot_msg\fP(D3DKX)

SYNOPSIS

#include <sys/cmn_err.h>
void mot_msg(int type, int mclass, void ∗msg);

ARGUMENTS

typeType of device this error message is for. The types supported are listed in /usr/include/sys/cmn_err.h.

CMN_DISK	Device type appropriate for a non-SCSI disk.
CMN_SCSI_DISK	Device type appropriate for a SCSI disk.
CMN_TAPE	Device type appropriate for a non-SCSI tape.
CMN_SCSI_TAPE	Device type appropriate for a SCSI tape.
CMN_FLOPPY	Device type appropriate for a non-SCSI floppy.
CMN_SCSI_FLOPPY	Device type appropriate for a SCSI floppy.
CMN_CDROM	Device type appropriate for a CDROM.
CMN_DEVICE	Device type appropriate for any device.
CMN_SCSI_DEVICE	Device type appropriate for any SCSI device."
CMN_CONTROLLER	Device type appropraite for a controller.

mclassIndication of the severity of the message. The ME_- classes are listed in /usr/include/sys/cmn_err.h.

ME_CONT	Continuation of a message.
ME_NOTE	Simple notification message.
ME_WARN	Warning message.
ME_STERNWARN	Stronger warning message.
ME_ERROR	Error notification.
ME_PANIC	System PANIC message.

msgPointer to a structure that is specific to the type of device. The specific structure types can be found in /usr/include/sys/cmn_err.h

DESCRIPTION

mot_msg aquires a lock preventing collision with other system messages that may be generated through cmn_err(), mot_msg(), mot_msg_x() or mot_exit(). The lock must be freed by calling mot_exit().

Each device type message contains information about the device name, controller, sub controller, device address, device sub address, the command that failed, and an information string. SCSI related messages also contain the sense key, additional sense key, and additional sense key qualifier information. Disk type device messages include the block number. mot_msg_x may be used to display additional text associated with the initial information displayed by mot_msg.

mot_exit must be called to end the message and release the message lock.

LEVEL

Base or Interrupt.

NOTES

May block while other calls to mot_msg and cmn_err are being processed.

Museum