scsi_log(9F)

NAME

scsi_log − display a SCSI-device-related message

SYNOPSIS

#include <sys/scsi/scsi.h>

#include <sys/cmm_err.h>

void scsi_log(dev_info_t ∗dip, char ∗drv_name, int level, const char ∗fmt, ...);

ARGUMENTS

dip Pointer to the dev_info structure.

drv_name String naming the device.

level Error level.

fmt Display format.

INTERFACE LEVEL

Solaris architecture specific (SunDDI).

DESCRIPTION

scsi_log() is a utility function that displays a message via the cmn_err(9F) routine. The error levels that can be passed in to this function are CE_PANIC, CE_WARN, CE_NOTE, CE_CONT, and SCSI_DEBUG. The last level is used to assist in displaying debug messages to the console only. drv_name is the short name by which this device is known; example disk driver names are sd and cmdk. If the dev_info_t pointer is NULL, then the drv_name will be used with no unit or long name.

EXAMPLE

scsi_log(dev, "Disk Unit ", CE_PANIC, "Bad Value %d\n", foo);
Generates:
     PANIC: /eisa/aha@330,0/cmdk@0,0 (Disk Unit 0): Bad Value 5
Followed by a PANIC.
scsi_log(dev, "sd", CE_WARN, "Label Bad\n");
Generates:
     WARNING: /sbus@1,f8000000/esp@0,8000000/sd@1,0 (sd1): Label Bad
scsi_log((dev_info_t ∗) NULL, "Disk Unit ", CE_NOTE, "Disk Ejected\n");
Generates:
     Disk Unit : Disk Ejected
scsi_log(cmdk_unit, "Disk Unit ", CE_CONT, "Disk Inserted\n");
Generates:
     Disk Inserted
scsi_log(sd_unit, "sd", SCSI_DEBUG, "We really got here\n");
Generates (only to the console):
     DEBUG: sd1: We really got here

CONTEXT

scsi_log() may be called from user or interrupt context.

Museum

Related Articles