strlog(D3)                                                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       fprintf(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:




                           Copyright 1994 Novell, Inc.               Page 1

      strlog(D3)                                                strlog(D3)


                  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.  The
            format string should contain no more than 1012 characters.

         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)

      NOTICES
         Portability
            All processors

         Applicability
            ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp








                          Copyright 1994 Novell, Inc.               Page 2