strerr(8) [osf1 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)

strace(1M)																strace(1M)

NAME

       strace - write STREAMS event trace messages to standard output

SYNOPSIS

       mod sub pri

DESCRIPTION

       gets STREAMS event trace messages from STREAMS drivers and modules via the STREAMS log driver and writes these messages to standard output.
       By default, without arguments writes all STREAMS trace messages from all drivers and modules.  with command-line arguments limits the trace
       messages received.

       The arguments, which must be specified in groups of three, are:

	      mod    Specifies the STREAMS module identification number from the streamtab entry.

	      sub    Specifies a subidentification number (often corresponding to a minor device).

	      pri    Specifies	a  tracing priority level.  gets messages of a level equal to or less than the value specified by pri.	Only posi-
		     tive integer values are allowed.

       The value can be used for any argument in the command line to indicate that there are no restrictions for that argument.

       Multiple sets of the three arguments can be specified to obtain the messages from more than one driver or module.

       Only one process can open the STREAMS log driver at a time.

       When is invoked, the log driver compares the sets of command line arguments with actual trace messages, returning only messages	that  sat-
       isfy the specified criteria.

       STREAMS event trace messages have the following format:

	      seq time tick pri ind mod sub text

       Components are interpreted as follows:

	      seq    Trace event sequence number.

	      time   Time the message was sent expressed in hh:mm:ss.

	      tick   Time the message was sent expressed in machine ticks since the last boot.

	      pri    Tracing priority level as defined by the STREAMS driver or module that originates the messages.

	      ind    Can be any combination of the following three message indicators:

			The message has also been saved in the error log.

			The message signaled a fatal error.

			The message has also been mailed to the system administrator.

	      mod    Module identification number of the trace message source.

	      sub    Subidentification number of the trace message source.

	      text   Trace message text.

       runs until terminated by the user.

EXAMPLES

       Display all trace messages received from the driver or module identified by mod

       Display	trace  messages  of any tracing priority level from the driver or module identified by mod and its minor devices identified by the
       sub or

       Display the trace messages from the same driver or module and subs but limit the priority levels to 0 for subs 2 and 3; 1 for sub 4, driver
       or module

WARNINGS

       Running with several sets of arguments can impair STREAMS performance, particularly for those modules and drivers that are sending the mes-
       sages.

       Also be aware that may not be able to handle a large number of messages.  If drivers and modules return messages to too quickly,  some  may
       be lost.

FILES

       NLS catalog for

SEE ALSO

       strclean(1M), strerr(1M), strlog(7).

																	strace(1M)