.IX \f4strlog\fP(D3DK)

NAME

strlog − submit messages to the log driver

SYNOPSIS

#include <sys/types.h>
#include <sys/stream.h>
#include <sys/strlog.h>
#include <sys/log.h>
int strlog(short mid, short sid, char level, ushort_t flags,
char ∗fmt, ... /∗ args ∗/);

ARGUMENTS

midIdentification number of the module or driver submitting the message. 

sidIdentification number for a particular minor device. 

levelTracing level for selective screening of low priority messages. 

flagsBitmask of flags indicating message purpose.  Valid flags are:

SL_ERROR Message is for error logger. 

SL_TRACE Message is for tracing. 

SL_CONSOLE
Message is for console logger.

SL_NOTIFY If SL_ERROR is also set, mail copy of message to system administrator. 

SL_FATAL Modifier indicating error is fatal. 

SL_WARN Modifier indicating error is a warning. 

SL_NOTE Modifier indicating error is a notice. 

fmtprintf(3S) style format string.  %s, %e, %g, and %G formats are not allowed. 

argsZero or more arguments to printf (maximum of NLOGARGS, currently three). 

DESCRIPTION

strlog submits formatted messages to the log(7) driver.  The messages can be retrieved with the getmsg(2) system call.  The flags argument specifies the type of the message and where it is to be sent.  strace(1M) receives messages from the log driver and sends them to the standard output.  strerr(1M) receives error messages from the log driver and appends them to a file called /var/adm/streams/error.mm-dd, where mm-dd identifies the date of the error message. 

RETURN VALUE

strlog returns 0 if the message is not seen by all the readers, 1 otherwise. 

LEVEL

Base or Interrupt. 

NOTES

Does not sleep. 

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function. 

SEE ALSO

log(7) in the Programmer’s Guide: STREAMS

strace(1M), strerr(1M) in the System Administrator’s Reference Manual

DDI/DKI  —  STREAMS