strlog(9F)

NAME

     strlog - submit messages to the log driver

SYNOPSIS

     #include <sys/stream.h>
      #include <sys/strlog.h>
     #include <sys/log.h>

     int strlog(short mid, short sid, char level, unsigned  short
     flags, char *fmt, ...););

INTERFACE LEVEL

     Architecture independent level 1 (DDI/DKI).

PARAMETERS

     mid   Identification number of the module or driver  submit-
           ting  the  message  (in  the  case  of  a  module, its
           mi_idnum value from module_info(9S)).

     sid   Identification number for a particular minor device.

     level Tracing level for selective screening of low  priority
           messages.  Larger values imply less important informa-
           tion.

     flags Valid flag values are:

           SL_ERROR
                 Message is for error logger.

           SL_TRACE
                 Message is for trace.

           SL_NOTIFY
                 Mail copy of message to system administrator.

           SL_CONSOLE
                 Log message to console.

           SL_FATAL
                 Error is fatal.

           SL_WARN
                 Error is a warning.

           SL_NOTE
                 Error is a notice.

     fmt   printf(3C) style format string.   %e, %g, and %G  for-
           mats are not allowed but %s is supported.

DESCRIPTION

     strlog() expands the printf(3C) style format  string  passed
     to  it,  that  is, the conversion specifiers are replaced by
     the actual argument values in the format string. The  32-bit
     representations  of  the  arguments (up to NLORGARGS) follow
     the string starting at the next  32-bit  boundary  following
     the  string. Note that the 64-bit argument will be truncated
     to 32-bits here but will be fully represented in the string.

     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 VALUES

     strlog() returns  0 if it fails to submit the message to the
     log(7D) driver and 1 otherwise.

CONTEXT

     strlog() can be called from user or interrupt context.

FILES

     /var/adm/streams/error.mm-dd
           Error messages dated mm-dd appended by strerr(1M) from
           the log driver

SEE ALSO

     strace(1M), strerr(1M), getmsg(2), log(7D), module_info(9S)

     Writing Device Drivers

     STREAMS Programming Guide