unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



strerr(8)							    strerr(8)



NAME

  strerr - Receives error messages from	the STREAMS log	driver

SYNOPSIS

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

OPTIONS

  -a sys_admin_mail_name
      Specifies	the mail name of the user to receive the message via mail.
      This is the system administrator by default.

  -d logdir
      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

  seq_num
      The error	sequence number.

  std_time
      The time the message was sent, in	the format hh:mm:ss.

  ticks_time
      The time the message was sent, measured in machine ticks since the last
      boot.

  flags
      Can be any of the	following indicators:

      T	  Indicates that the message has also been saved in the	process's
	  trace	log.

      F	  Indicates that the message signaled a	fatal error.

      N	  Indicates that the message is	to be sent to the system administra-
	  tor or specified user	via mail.

  mod_ID
      The module identification	number of the trace message source.

  sub_ID
      The subidentification number of the trace	message	source.

  msg_text
      The trace	message	text.

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

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.

FILES

  /var/adm/streams/error.mm.dd
      The error	log file or files on which strerr operates

RELATED	INFORMATION

  Interfaces: strlog(7)