Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
strlog(9F)		 Kernel	Functions for Drivers		    strlog(9F)

NAME
       strlog -	submit messages	to the log driver

SYNOPSIS
       #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, ...););

INTERFACE LEVEL
       Architecture independent	level 1	(DDI/DKI).

PARAMETERS
       mid   Identification number of the module or driver submitting the mes-
	     sage  (in	the  case  of  a  module, its mi_idnum value from mod-
	     ule_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.

DESCRIPTION
       strlog()	expands	the printf(3C) style format string passed to it,  that
       is,  the	conversion specifiers are replaced by the actual argument val-
       ues in the format string. The 32-bit representations of	the  arguments
       (up  to NLORGARGS) follow the string starting at	the next 32-bit	bound-
       ary following the string. Note that the 64-bit argument will  be	 trun-
       cated 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.

RETURN VALUES
       strlog()	returns	 0 if it fails to submit the message  to  the  log(7D)
       driver and 1 otherwise.

CONTEXT
       strlog()	can be called from user	or interrupt context.

FILES
       /var/adm/streams/error.mm-dd
	     Error  messages  dated  mm-dd appended by strerr(1M) from the log
	     driver

SEE ALSO
       strace(1M), strerr(1M), getmsg(2), log(7D), module_info(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.9			  11 Apr 1991			    strlog(9F)

NAME | SYNOPSIS | INTERFACE LEVEL | PARAMETERS | DESCRIPTION | RETURN VALUES | CONTEXT | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=strlog&sektion=9f&manpath=SunOS+5.9>

home | help