Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > S

strerr(1M)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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 messages 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

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.