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\n");


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


APPL: PANIC: Cannot locate database


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


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

SEE ALSO


gettxt(3C), lfmt(3C), pfmt(3C), attributes(7)

illumos June 20, 2021 ADDSEV(3C)