share/man/man8/strerr.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH STRERR 8 "Oct 4, 1994"
   7 .SH NAME
   8 strerr \- STREAMS error logger daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBstrerr\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBstrerr\fR receives error log messages from the STREAMS-based log driver (see
  19 \fBlog\fR(7D)) and appends them to a log file. The resultant error log files
  20 reside in the directory \fB/var/log/streams\fR, and are named
  21 \fBerror.\fR\fImm\fR\fB-\fR\fBdd\fR, where \fImm\fR is the month and \fBdd\fR
  22 is the day of the messages contained in each log file.
  23 .sp
  24 .LP
  25 The format of an error log message is:
  26 .sp
  27 .LP
  28 <\fIseq\fR> <\fBtime\fR> <\fIticks\fR> <\fIflags\fR> <\fImid\fR> <\fIsid\fR>
  29 <\fItext\fR>
  30 .sp
  31 .ne 2
  32 .na
  33 \fB<\fIseq\fR>\fR
  34 .ad
  35 .RS 11n
  36 error sequence number
  37 .RE
  38
  39 .sp
  40 .ne 2
  41 .na
  42 \fB<\fBtime\fR>\fR
  43 .ad
  44 .RS 11n
  45 time of message in hh:mm:ss
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .na
  51 \fB<\fIticks\fR>\fR
  52 .ad
  53 .RS 11n
  54 time of message in machine ticks since boot priority level
  55 .RE
  56
  57 .sp
  58 .ne 2
  59 .na
  60 \fB<\fIflags\fR>\fR
  61 .ad
  62 .RS 11n
  63 \fBT\fR : the message was also sent to a tracing process \fBF\fR : indicates a
  64 fatal error \fBN\fR : send mail to the system administrator (hardcoded as root)
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB<\fImid\fR>\fR
  71 .ad
  72 .RS 11n
  73 module  \fBID\fR number of source
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fB<\fIsid\fR>\fR
  80 .ad
  81 .RS 11n
  82 sub-ID number of source
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fB<\fItext\fR>\fR
  89 .ad
  90 .RS 11n
  91 formatted text of the error message
  92 .RE
  93
  94 .sp
  95 .LP
  96 Messages that appear in the error log are intended to report exceptional
  97 conditions that require the attention of the system administrator.   Those
  98 messages which indicate the total failure of a STREAMS-based driver or module
  99 should have the \fBF\fR flag set. Those messages requiring the immediate
 100 attention of the administrator will have the \fBN\fR flag set, which causes the
 101 error logger to send the message to the system administrator using \fBmail\fR.
 102 The priority level usually has no meaning in the error log but will have
 103 meaning if the message is also sent to a tracer process.
 104 .sp
 105 .LP
 106 Once initiated, \fBstrerr\fR continues to execute until terminated by the user.
 107 It is commonly executed asynchronously.
 108 .SH FILES
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB/var/log/streams/error.\fR\fImm\fR\fB-\fR\fBdd\fR\fR
 113 .ad
 114 .sp .6
 115 .RS 4n
 116 error log file.
 117 .RE
 118
 119 .SH SEE ALSO
 120 .sp
 121 .LP
 122 \fBattributes\fR(5), \fBlog\fR(7D)
 123 .sp
 124 .LP
 125 \fI\fR
 126 .SH NOTES
 127 .sp
 128 .LP
 129 There is no restriction to the number of \fBstrerr\fR processes opening the
 130 \fBSTREAMS\fR-based log driver at a time.
 131 .sp
 132 .LP
 133 If a module or driver is generating a large number of error messages, running
 134 the error logger will cause a degradation in STREAMS performance. If a large
 135 burst of messages are generated in a short time, the log driver may not be able
 136 to deliver some of the messages. This situation is indicated by gaps in the
 137 sequence numbering of the messages in the log files.