addsev(S)

addsev -- define additional severities

Synopsis

   #include <pfmt.h>
   
   int addsev(int int_val, const char string);

Description

The function addsev defines additional severities for use in subsequent calls to pfmt. 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, string will be used as the severity.

Passing a NULL string removes the severity.

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

Return values

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

Usage

#define Panic 5
setlabel("APPL");
setcat("my_appl");
addsev(Panic, gettxt(":26", "PANIC"));
/

...

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

References

gettxt(C), pfmt(S)

Notices

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.