Copyright (c) 2006, Sun Microsystems, Inc.
All Rights Reserved.
Copyright 2006 AT&T
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.
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.
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]
#include <sys/stream.h> #include <sys/strlog.h> #include <sys/log.h> int strlog(short mid, short sid, char level, unsigned short flags, char *fmt, ...);
Architecture independent level 1 (DDI/DKI).
mid
Identification number of the module or driver submitting the message (in the case of a module, its mi_idnum value from module_info(9S)).
sid
Identification number for a particular minor device.
level
Tracing level for selective screening of low priority messages. Larger values imply less important information.
flags
Valid flag values are:
SL_ERROR
Message is for error logger.
SL_TRACE
Message is for trace.
SL_NOTIFY
Mail copy of message to system administrator.
SL_CONSOLE
Log message to console.
SL_FATAL
Error is fatal.
SL_WARN
Error is a warning.
SL_NOTE
Error is a notice.
fmt
printf(3C) style format string. %e, %g, and %G formats are not allowed but %s is supported.
The strlog() function expands the printf(3C) style format string passed to it, that is, the conversion specifiers are replaced by the actual argument values in the format string. The 32-bit representations of the arguments (up to NLORGARGS) follow the string starting at the next 32-bit boundary following the string. Note that the 64-bit argument will be truncated to 32-bits here but will be fully represented in the string.
The messages can be retrieved with the getmsg(2) system call. The flags argument specifies the type of the message and where it is to be sent. strace(1M) receives messages from the log driver and sends them to the standard output. strerr(1M) receives error messages from the log driver and appends them to a file called /var/adm/streams/error.mm-dd, where mm-dd identifies the date of the error message.
The strlog() function returns 0 if it fails to submit the message to the log(7D) driver and 1 otherwise.
The strlog() function can be called from user, interrupt, or kernel context.
Error messages dated mm-dd appended by strerr(1M) from the log driver
strace(1M), strerr(1M), getmsg(2), log(7D), module_info(9S)
Writing Device Drivers
STREAMS Programming Guide