addsev(3C) Standard C Library Functions addsev(3C)NAMEaddsev - 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 subse‐
quent 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 dis‐
playing locale-specific versions of add-on severities. Add-on severi‐
ties 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(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOgettxt(3C), lfmt(3C), pfmt(3C), attributes(5)SunOS 5.10 29 Dec 1996 addsev(3C)