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

strerr(8)						      System Manager's Manual							 strerr(8)

NAME

       strerr - Receives error messages from the STREAMS log driver

SYNOPSIS

       /usr/sbin/strerr [-a sys_admin_mail_name] [-d logdir]

PARAMETERS

       Specifies the mail name of the user to receive the message via mail.  This is the system administrator by default.  Specifies the directory
       to contain the error log file.  This is /var/adm/streams by default.

DESCRIPTION

       The strerr daemon receives error messages from the STREAMS log driver (strlog) for addition to the STREAMS error log files (error.mm.dd) in
       the  STREAMS  error logger directory (/var/adm/streams by default).  When first called, the strerr daemon creates the log file error.mm.dd.
       This is a daily log file, where mm indicates the month and dd indicates the day of the logged messages.	The  strerr  daemon  then  appends
       each error message that it subsequently receives from the STREAMS log driver to the log file.

       STREAMS	error  log  messages  have  the  following format: seq_num  std_time  ticks_time  flags  mod_ID  sub_ID  msg_text where: The error
       sequence number.  The time the message was sent, in the format hh:mm:ss.  The time the message was sent, measured in  machine  ticks  since
       the  last  boot.  Can be any of the following indicators: Indicates that the message has also been saved in the process's trace log.  Indi-
       cates that the message signaled a fatal error.  Indicates that the message is to be sent to the system administrator or specified user  via
       mail.   The module identification number of the trace message source.  The subidentification number of the trace message source.  The trace
       message text.

       The strerr daemon will run continuously until terminated by the user.

FILES

       The error log file or files on which strerr operates.

NOTES

       Only one strerr process can open the STREAMS log driver at a time.  This restriction is intended to maximize performance.

       The STREAMS error logging mechanism works best when it is not overused.	The strerr daemon can degrade STREAMS performance by affecting the
       response,  throughput,  and  other  behaviors  of the drivers and modules that invoke it.  The daemon will also fail to capture messages if
       drivers and modules generate messages at a higher rate than its optimum read rate.  Missing sequence numbers among the messages	in  a  log
       file indicate that messages have been lost.

RELATED INFORMATION

       Interfaces: strlog(7).  delim off

																	 strerr(8)

Linux and UNIX Man Pages

strerr(1m) [opensolaris man page]

Check Out this Related Man Page