strerr.1m (2010 09)

s
strerr(1M) strerr(1M)
NAME
strerr - receive error messages from the STREAMS log driver
SYNOPSIS
strerr [-a sys_admin_mail_name ][
-d
logdir ]
DESCRIPTION
strerr receives error messages from the STREAMS log driver (strlog (7)) 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,
strerr 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.
strerr then appends error
messages to the log file as they are received from the STREAMS log driver.
STREAMS error log messages have the following format:
seq time tick pri ind mod sub text
Components are interpreted as follows:
seq Error 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 Error 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:
T The message has also been saved in the trace log.
F The message signaled a fatal error.
N The message has also been mailed to the system administrator.
mod Module identification number of the error message source.
sub Subidentification number of the error message source.
text Error message text.
strerr runs continuously until terminated by the user.
Options
strerr recognizes the following options and command-line arguments:
-a sys_admin_mail_name Specify the user’s mail name for sending mail messages. Mail is sent to
the system administrator by default.
-d logdir Specify the directory to contain the error log file. Default is
/var/adm/streams
.
WARNINGS
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.
strerr can degrade
STREAMS performance by affecting the response, throughput, and other behaviors of the drivers and
modules that invoke it. strerr also fails to capture messages if drivers and modules generate mes-
sages at a higher rate than its optimum read rate. If there are missing sequence numbers among the
messages in a log file, messages have been lost.
FILES
/usr/lib/nls/msg/C/strerr.cat NLS catalog for strerr.
/var/adm/streams/error.mm-dd error log file or files on which strerr operates
SEE ALSO
strace(1M), strlog(7).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1