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 charac-
     ter  string,  overwriting  any  previous  string association
     between int_val and string.

     If int_val is OR-ed with the flags argument passed to subse-
     quent  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  log-
     ging service

     APPL: PANIC: Cannot locate database

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-safe                     |
    |_____________________________|_____________________________|

SEE ALSO

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