addsev(3C)							    addsev(3C)

NAME    [Toc]    [Back]

     addsev - define additional	severities

SYNOPSIS    [Toc]    [Back]

     int addsev(int int_val<b>, const char	*string);

DESCRIPTION    [Toc]    [Back]

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

     If	int_val	is ORed	with the flags passed to subsequent calls to pfmt or
     lfmt, string will be used as the severity.

     Passing a N.ULL string removes the	severity.

     Add-on severities are only	effective within the applications defining
     them.

EXAMPLE    [Toc]    [Back]

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

     will display the message to stderr	and forward to the logging service:
	  APPL:	PANIC: Cannot locate database

SEE ALSO    [Toc]    [Back]

     gettxt(1),	lfmt(3C), pfmt(3C)

DIAGNOSTICS    [Toc]    [Back]

     addsev returns 0 in case of success, -1 otherwise.

NOTES    [Toc]    [Back]

     Only the standard severities are automatically displayed per the locale
     in	effect at run time.  An	application must provide the means for
     displaying	locale-specific	versions of add-on severities.


									PPPPaaaaggggeeee 1111