[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, 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 5L Version 5.1 Communications Programming Concepts.

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


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]