strlog(D3)

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>
     #include <sys/ddi.h>
     int strlog(short mid, short sid, char level, ushort_t flags,
          char *fmt, ... /* args */);

   Arguments
     mid       Identification number of the module or driver submitting the
               message.

     sid       Identification number for a particular minor device.

     level     Tracing level for selective screening of low priority messages.

     flags     Bitmask of flags indicating message purpose.

     fmt       printf(3S) style format string.

     args      Zero or more arguments to printf.

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 Values
     strlog returns 0 if the message is not seen by all the readers, 1
     otherwise.

USAGE
   flags Argument
     Valid values for 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.

   fmt Argument
     The %s, %e, %g, and %G formats are not allowed.

   printf args
     args can specify a maximum of NLOGARGS, currently three.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

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

REFERENCES
     log(7), strace(1M), strerr(1M)