strlog.7 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

strlog(7) strlog(7)

NAME

strlog - STREAMS log driver

DESCRIPTION

The STREAMS log driver allows user-level processes and STREAMS drivers and modules to perform

error logging and event tracing. These tasks are done via a user interface and a kernel interface.

Further, the STREAMS log driver delivers error logging and event tracing messages to the Network Trac-

ing and Logging Facility (NetTL) (see nettl (1M), netfmt (1M), and nettlconf (1M)).

The interface that this driver presents to user-level processes is a subset of the

ioctl() system calls

and STREAMS message formats. These processes can be error loggers, trace loggers, or other user

processes, that generate error or event messages. The user interface collects log messages from the log

driver, and also generates log messages from user processes.

The driver also accepts log messages from STREAMS drivers and modules in the kernel via its function

call interface. The kernel interface enters requests or calls from STREAMS drivers and modules into log

messages.

The log messages accepted by the log driver are also delivered to NetTL. NetTL can be used to control

which types of messages to log, and to format and ﬁlter the logged messages.

Kernel Interface

STREAMS drivers and modules generate log messages by calls to the

strlog function.

#include <sys/strlog.h>

int strlog (mid, sid, level, flags, fmt [, value ]...);

short mid;

short sid;

char level;

ushort flags;

char *fmt;

int value;

mid speciﬁes the STREAMS module ID number for the driver or module submitting the log mes-

sage.

sid speciﬁes the sub-ID number of a minor device associated with the STREAMS module or driver

identiﬁed by mid.

level speciﬁes a level for screening lower-level event messages from a tracer.

flags contains several ﬂags that can be set in various combinations. The ﬂags are as follows:

SL_ERROR The message is for the error logger.

SL_TRACE The message is for the tracer.

SL_CONSOLE The message will be printed to the console.

SL_FATAL Provides a notiﬁcation of a fatal error.

SL_NOTIFY Makes a request to mail a copy of a message to the system administrator.

The following are additional ﬂags. These ﬂags are not used by

strerr or strace.

However, they are used to map STREAMS messages to NetTL messages as described

below in STREAMS-NetTL Link section.

SL_WARN The message is a warning.

SL_NOTE The message is a note.

fmt is a

printf style format string. This accepts the %x, %l, %o, %u, %d, %c, and %s conversion

speciﬁcations.

values are numeric or character arguments for the format string. There is no maximum number of

arguments that can be speciﬁed.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
strlog(7) strlog(7) NAME strlog - STREAMS log driver DESCRIPTION The STREAMS log driver allows user-level processes and STREAMS drivers and modules to perform error logging and event tracing. These tasks are done via a user interface and a kernel interface. Further, the STREAMS log driver delivers error logging and event tracing messages to the Network Tracing and Logging Facility (NetTL) (see nettl (1M), netfmt (1M), and nettlconf (1M)).
PAGE 2
strlog(7) strlog(7) User Interface User processes access the log driver with an open() call to /dev/strlog. Each open to the device will obtain a separate stream. After a process opens /dev/strlog, it indicates whether it is an error logger or trace logger.
PAGE 3
strlog(7) strlog(7) if (flags & SL_WARN) if (flags & SL_NOTE) otherwise ====> ====> ====> WARNING INFORMATIVE ERROR all messages ====> INFORMATIVE else As a default, only DISASTER and ERROR messages are logged. This setting can be altered by the nettl command or the nettlconf command (see nettl (1M) and nettlconf (1M)). The STREAMS subsystem ID used by NetTL is STREAMS. The messages logged by NetTL facility can be formatted to a readable form by the netfmt command (see netfmt (1M)).
PAGE 4
strlog(7) strlog(7) control.len = control.maxlen = sizeof(log); control.buf = (char *)&lc; data.len = data.maxlen = strlen(warning); data.buf = warning; lc.level = 2; lc.flags = SL_FATAL|SL_CONSOLE; putmsg(logfd, &control, &data, 0); The following examples illustrate how to use the NetTL facility for the STREAMS. See nettl (1M), netfmt (1M), nettlconf (1M) for the general NetTL usage. The STREAMS subsystem ID used by NetTL is STREAMS. The netfmt accepts a filter configuration file as a command argument.