OpenSS7
SS7 for the
Common Man
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.
Last modified: Mon, 28 Apr 2008 12:53:44 GMT
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manual Page
Quick Links

Download

SCTP

SIGTRAN

SS7

Hardware

STREAMS

Asterisk

Related

Package

Manual

FAQ

Man Pages

Applications

SS7 Stack

ISDN Stack

SIGTRAN Stack

VoIP Stack

MG Stack

SS7/ISDN Devices

IP Transport

Embedded Systems

OS

Documentation

FAQ

SIGTRAN

Design

Conformance

Performance

References

Man Pages

Manuals

Papers

Home

Overview

Status

Documentation

Resources

About

News

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci


STRERR

Section: The OpenSS7 Project Administration (8)
Updated: Sat, 21 Oct 2017 16:10:05 GMT
Index Return to Main Contents

NAME

strerr - receives error log messages from the STREAMS log(4) driver

SYNOPSIS

strerr [options] [-nqDv] [{-a|--admin[=]}mailuid] [{-d|--directory[=]}directory] [{-p|--pidfile[=]}[pidfile]] [{-l|--logdev[=]}[logdevice]] [{-D|--debug[=]}[level]] [{-v|--verbose[=]}[level]]
strerr {-h|--help}
strerr {-V|--version}
strerr {-C|--copying}

DESCRIPTION


The strerr daemon receives error log messages from the STREAMS log driver (log(4)) and writes these messages to standard output. When run as a daemon, strerr appends these messages to a log file. The error log files produced reside in the directory /var/adm/streams or /var/log/streams, or a user-specified directory, and are named error.mm-dd, where mm is the month and dd is the day of the messages contained in each log file.

By default, strlogd logs all STREAMS error messages from all drivers and modules.

Messages that appear in the error log are intended to report exceptional conditions that require the attention of the person who administers your system. Those messages indicating the total failure of a STREAMS driver or module should have the F flag set. Those messages requiring the immediate attention of the administrator should have the N flag set, which causes the console logger to send the message to that person by way of the mail(1) command. The priority level usually has no meaning in the error log, but does have meaning if the message is also sent to the tracer process.

Once initiated, the strerr daemon continues to execute until terminated by the user. Usually, the strerr daemon is executed asynchronously.

OPTIONS

-a, --admin mailuid
Specifies the mail user or alias to which to send all mail messages. Mail is sent to root by default.
-d, --directory directory
Specifies a directory to contain the messages. Default is to search for /var/adm/streams and then /var/log/streams .
-n, --nodaemon
Do not daemonize, run in the foreground, print output to stdout and error logs to stderr. This option is most usefull for debugging strerr.
-b, --basename basename
Specify the log file basename. Default is error .
-o, --outfile outfile
Specifiy the log file output name. When run as a daemon, the default is basename . mm-dd , where mm-dd is the current month and day of month. When run in the foreground, the default is ignored and all output is to stdout. When specified, standard output is redirected to the specified file regardless of whether strerr is being run in the foreground or as a daemon.
-e, --errfile errfile
Specify the error file output name. When run as a daemon, the default is /dev/null and all errors are logged to syslogd(8). When run in the foreground, the default is ignored and all errors are logged to stderr. When specified, standard error is redirected to the specified file regardless of whether strerr is being run in the foreground or as a daemon.
-p, --pidfile pidfile
Specify the pid file output name. Default is /var/run/strerr.pid . When run in the foreground, the default is ignored.
-l, --logdev logdevice
Specifies the log device. Default is to search /dev/streams/strlog , /dev/streams/log , /dev/strlog and /dev/log .
-q, --quiet
Suppresses normal output. This option is equivalent to --verbose=0.
-D, --debug [level]
Increase or specify the debug output level. When a debug level has been specified, strerr will log to stdout, prints debug messages to stderr, and will not place itself in the background. This option may be repeated.
-v, --verbose [level]
Increase or specify the verbosity level of the output. This option may be repeated.
-h, --help
When this option is encountered, strerr displays usage information on stdout and exits. No further processing of options or arguments is performed and no actions are taken.
-V, --version
When this option is encountered, strerr displays version information on stdout and exits. No further processing of options or arguments is performed and no actions are taken.
-C, --copying
When this option is encountered, strerr displays copying and copyright information on stdout and exits. No further processing of options or arguments is performed and no actions are taken.

ARGUMENTS

strerr takes no non-option arguments.

FORMAT

STREAMS error log messages have the following format:

<seq> <time> <ticks> <flags> <mid> <sid> <text>


Components are interpreted as follows:

<seq>
Error sequence number.
<time>
Time the message was sent expressed in hh:mm:ss.
<ticks>
Time the message was sent expressed in machine ticks since last boot.
<flags>
Any combination of the following three message indicators:
T
The message has also sent to a tracing process.
F
The message signalled a fatal error.
N
The message has also been mailed to the system administrator.
<mid>
Module identification number of the error message source.
<sid>
Sub-identification number of the error message source.
<text>
Formatted text of the error message.

DIAGNOSTICS

An exit status of zero (0) indicates that the command was successful; one (1) indicates that an error occured and a diagnostic message is printed to stderr; two (2) indicates that the option or argument syntax was in error and a diagnostic message is printed to stderr.

The --quiet option suppresses the printing of diagnostic messages to stderr.

SIGNALS

strerr catches the SIGHUP signal (see signal(7)).

SIGHUP
When the SIGHUP signal is caught, strerr will close the current log file and open a new (or reopen the existing) log file. This is for use with logrotate(8).
SIGTERM
When the SIGTERM signal is caught, strerr flushes and closes all of its log files and then exits.

NOTICES

Only one strerr daemon or process at a time is permitted to open the STREAMS log driver as an error logger. If a module or driver is generating a large number of error messages, running the error logger causes a degradation in STREAMS performance. If a large number of messages are generated in a short time, the log driver may not be able to deliver some of the messages. This situation is indicated by gaps in the sequence numbering of the messages in the log files.

When run in the foreground, strerr runs until terminated by the caller.

Running strerr can impair STREAMS performance, particularly for those modules and drivers that are sending the messages. Also be aware that strerr may not be able to handle a large number of messages. If drivers and modules return messages to strerr too quickly, some may be lost.

Due to performance considerations, only one strerr command is permitted to open the STREAMS log driver at a time. Running the strerr command has the most impact on the timing of modules and drivers generating the error messages that are sent to the strerr process. If error messages are generated faster than the strerr process can handle them, some of the messages will be lost. This last case can be determined by examining the sequence numbers on the error messages output.

DEVICES

/dev/streams/strlog, /dev/streams/log, /dev/strlog or /dev/log
the STREAMS logging device. See strlog(4).

FILES

/usr/sbin/strerr
contains the strerr command.
/var/log/streams or /var/adm/streams
directory containing the error log files.
/var/log/streams/error.mm-dd or /var/adm/streams/error.mm-dd
error log file.
/etc/init.d/strerr or /etc/strerr.sh
an SysV or Debian init script for starting the error logger.

SEE ALSO

log(4), strlog(4), strlog(9), strlog(1), strace(8), strclean(8), syslogd(8), syslog(3).

BUGS

strerr has no known bugs.

COMPATIBILITY

strerr is compatible with SVR 4.2[1], and systems based on SVR 4.2, such as AIX®, HP-UX®, OSF/1®, Solaris®, SUPER-UX®, UnixWare® and UXP/V®, with the following compatibility considerations:

---
Options -n, -D, -b, -o, -e, -p and -l, and all long options, are specific to this The OpenSS7 Project implementation of strerr and should not be used by portable applications.
---
No other implementation documents the -q, -D, -v, -h, -V or -C options. They should not be used by portable applications.
---
Options --help and --version are provided for compatibility with GNU coding standards; --copying, OpenSS7 coding standards.
---
AIX®, Solaris®, UnixWare® and UXP/V® do not document the -a or -d options; HP-UX® and OSF/1® do.
---
All other implementations document the log file directory as /var/adm/streams instead of /var/log/streams. /var/log/streams is used under Linux for compatibility with the Linux File Standard. For compatibility, strerr first checks if the directory /var/adm/streams exists, and then creates /var/log/streams if necessary, unless a directory is specified with the -d option.
---
Under SVR 4.2[1] and UnixWare®[2] the STREAMS log device is called /dev/log rather than /dev/strlog. Linux already has a non-STREAMS based log mechanism (BSD-style) logging device named /dev/log.
---
Under OSF/1®[3] the STREAMS log device is called /dev/streams/log instead of /dev/strlog.
---
For compatibility with these operating environments, strerr attempts to open /dev/streams/strlog, /dev/streams/log, /dev/strlog and then /dev/log if not specified with the -l option. The call to strerr will fail if there is no STREAMS-based log device in this search sequence, or specified with the -l option.

CONFORMANCE

SVR 4.2[1]; AIX®, HP-UX®, OSF/1®, Solaris®, SUPER-UX®, UnixWare® and UXP/V® documentation[2..8].

HISTORY

strerr first appear in SVR 4[9].

REFERENCES

[1]
SVR 4.2 CR, UNIX® System V Release 4.2 Command Reference Manual, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]
UnixWare® 7.1.3, UnixWare 7.1.3 (OpenUnix 8) Documentation, 2002, (Lindon, Utah), Caldera International, Inc., Caldera. <http://uw713doc.sco.com/>
[3]
Digital® UNIX (OSF/1.2), Digital UNIX Documentation Library, 2003, (Palo Alto, California), Digital Equipment Corporation, Hewlett-Packard Company. <http://www.true64unix.compaq.com/docs/>
[4]
AIX® 5L Version 5.1, AIX 5L Version 5.1 Documentation, 2001, (Boulder, Colorado), Internatonal Business Machines Corp., IBM. <http://publibn.boulder.ibm.com/>
[5]
HP-UX® 11i v2, HP-UX 11i v2 Documentation, 2001, (Palo Alto, California), Hewlett-Packard Company, HP. <http://docs.hp.com/>
[6]
Solaris® 8, Solaris 8 Docmentation, 2001, (Santa Clara, California), Sun Microsystems, Inc., Sun. <http://docs.sun.com/>
[7]
SUPER-UX® Release 9.2, SUPER-UX Release 9.2 Documentation, 1999, NEC Corporation, NEC.
[8]
UXP/V® V10L10, UXP/V V10L10 Documentation, 1997, Fujitsu Limited, Fujitsu.
[9]
SVR 4, UNIX® System V Release 4 Programmer's Manual, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

TRADEMARKS

OpenSS7tm
is a trademark of OpenSS7 Corporation.
Linux®
is a registered trademark of Linus Torvalds.
UNIX®
is a registered trademark of The Open Group.
Solaris®
is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Sat, 21 Oct 2017 16:10:05 GMT.

Copyright©1997-2008OpenSS7 Corp.
All Rights Reserved.
(See roff source for permission notice.)



Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ARGUMENTS
FORMAT
DIAGNOSTICS
SIGNALS
NOTICES
DEVICES
FILES
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 16:10:05 GMT, October 21, 2017
OpenSS7
SS7 for the
Common Man
Home TopIndex FirstPrev Next LastMore Download Info FAQ Mail  Home -> Documentation -> Man Pages -> Manual Page
Last modified: Mon, 28 Apr 2008 12:53:44 GMT
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.