[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Communications Technical Reference, Volume 2

strlog Utility

Purpose

Generates STREAMS error-logging and event-tracing messages.

Syntax

int
strlog(mid, sid, level, flags, fmt, arg1, . . . )
short mid, sid;
char level;
ushort flags;
char *fmt;
unsigned arg1;

Description

The strlog utility generates log messages within the kernel. Required definitions are contained in the sys/strlog.h file.

Parameters

mid Specifies the STREAMS module ID number for the module or driver submitting the log message.
sid Specifies an internal sub-ID number usually used to identify a particular minor device of a driver.
level Specifies a tracing level that allows for selective screening of low-priority messages from the tracer.
flags Specifies the destination of the message. This can be any combination of:
SL_ERROR The message is for the error logger.
SL_TRACE The message is for the tracer.
SL_CONSOLE Log the message to the console.
SL_FATAL Advisory notification of a fatal error.
SL_WARN Advisory notification of a nonfatal error.
SL_NOTE Advisory message.
SL_NOTIFY Request that a copy of the message be mailed to the system administrator.
fmt Specifies a print style-format string, except that %s, %f, %e, %E, %g, and %G conversion specifications are not handled.
arg1 Specifies numeric or character arguments. Up to NLOGARGS (currently 4) numeric or character arguments can be provided. (The NLOGARGS variable specifies the maximum number of arguments allowed. It is defined in the sys/strlog.h file.)

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

The streamio operations.

clone Device Driver in AIX Version 4.3 Communications Programming Concepts.

List of Streams Programming References, Understanding the log Device Driver, Understanding STREAMS Error and Trace Logging in AIX Version 4.3 Communications Programming Concepts.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]