opensolaris man page for addsev

addsev(3C)						   Standard C Library Functions 						addsev(3C)

NAME
       addsev - define additional severities

SYNOPSIS
       #include <pfmt.h>

       int addsev(int int_val, const char *string);

DESCRIPTION
       The  addsev()  function	defines  additional severities for use in subsequent calls to pfmt(3C) or lfmt(3C). It associates an integer value
       int_val in the range [5-255] with a character string, overwriting any previous string association between int_val and string.

       If int_val is OR-ed with the flags argument passed to subsequent calls to pfmt() or lfmt(), string will be used as severity. Passing a null
       string removes the severity.

RETURN VALUES
       Upon successful completion, addsev() returns 0.	Otherwise it returns-1.

USAGE
       Only  the  standard  severities	are automatically displayed for the locale in effect at runtime. An application must provide the means for
       displaying locale-specific versions of add-on severities. Add-on severities are only effective within the applications defining them.

EXAMPLES
       Example 1 Example of addsev() function.

       The following example

	 #define Panic 5
	 setlabel("APPL");
	 setcat("my_appl");
	 addsev(Panic, gettxt(":26", "PANIC"));
	 /* ... */
	 lfmt(stderr, MM_SOFT|MM_APPL|PANIC, ":12:Cannot locate database
");

       will display the message to stderr and forward to the logging service

	 APPL: PANIC: Cannot locate database

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       gettxt(3C), lfmt(3C), pfmt(3C), attributes(5)

SunOS 5.11							    29 Dec 1996 							addsev(3C)