Index Index for
Section 8
Index Alphabetical
listing for S
Bottom of page Bottom of
page

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 administrator 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)

Index Index for
Section 8
Index Alphabetical
listing for S
Top of page Top of
page