strerr(1m) [opensolaris man page]

strerr(1M)						  System Administration Commands						strerr(1M)

NAME

       strerr - STREAMS error logger daemon

SYNOPSIS

       strerr

DESCRIPTION

       strerr  receives error log messages from the STREAMS-based log driver (see log(7D)) and appends them to a log file. The resultant error log
       files  reside in the directory /var/adm/streams, and are named error.mm-dd, where mm is the month and dd is the day of  the  messages  con-
       tained in each log file.

       The format of an error log message is:

       <seq> <time> <ticks> <flags> <mid> <sid> <text>

       <seq>	  error sequence number

       <time>	  time of message in hh:mm:ss

       <ticks>	  time of message in machine ticks since boot priority level

       <flags>	  T  : the message was also sent to a tracing process F : indicates a fatal error N : send mail to the system administrator (hard-
		  coded as root)

       <mid>	  module  ID number of source

       <sid>	  sub-ID number of source

       <text>	  formatted text of the error message

       Messages that appear in the error log are intended to report exceptional conditions that require the attention of the system administrator.
       Those  messages	which  indicate the total failure of a STREAMS-based driver or module should have the F flag set. Those messages requiring
       the immediate attention of the administrator will have the N flag set, which causes the error logger to send  the  message  to  the  system
       administrator using mail. The priority level usually has no meaning in the error log but will have meaning if the message is also sent to a
       tracer process.

       Once initiated, strerr continues to execute until terminated by the user. It is commonly executed asynchronously.

FILES

       /var/adm/streams/error.mm-dd

	   error log file.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5), log(7D)

NOTES

       There is no restriction to the number of strerr processes opening the  STREAMS-based log driver at a time.

       If a module or driver is generating a large number of error messages, running the error logger will cause a degradation in STREAMS  perfor-
       mance.  If  a  large  burst of messages are generated in a short time, the log driver may not be able to deliver some of the messages. This
       situation is indicated by gaps in the sequence numbering of the messages in the log files.

SunOS 5.11							    4 Oct 1994								strerr(1M)

Check Out this Related Man Page

strlog(9F)						   Kernel Functions for Drivers 						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  submitting the message (in the case of a module, its mi_idnum value from mod-
		ule_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 information.

       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 formats are not allowed but %s is supported.

DESCRIPTION

       The strlog() function 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  repre-
       sented 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

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

CONTEXT

       The strlog() function can be called from user, interrupt, or kernel 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

SunOS 5.11							    16 Jan 2006 							strlog(9F)

Linux and UNIX Man Pages

strerr(1m) [opensolaris man page]

Check Out this Related Man Page