Standard C Library Functions                      addseverity(3C)



NAME
     addseverity - build a list of severity levels for an  appli-
     cation for use with fmtmsg

SYNOPSIS
     #include 

     int addseverity(int severity, const char *string);


DESCRIPTION
     The addseverity() function builds a list of severity  levels
     for  an  application  to be used with the message formatting
     facility fmtmsg(). The severity argument is an integer value
     indicating  the  seriousness  of  the  condition. The string
     argument is a pointer to a string describing  the  condition
     (string is not limited to a specific size).


     If addseverity() is called with an integer  value  that  has
     not  been  previously  defined,  the  function adds that new
     severity value and print string to the existing set of stan-
     dard severity levels.


     If addseverity() is called with an integer  value  that  has
     been  previously  defined, the function redefines that value
     with the new print string. Previously defined severity  lev-
     els  may  be  removed  by  supplying  the  null  string.  If
     addseverity() is called with a negative number or an integer
     value  of  0,  1, 2, 3, or 4, the function fails and returns
     -1. The values 0-4 are reserved for  the  standard  severity
     levels  and cannot be modified. Identifiers for the standard
     levels of severity are:

     MHALT       Indicates that the application has encountered
                   a  severe  fault  and is halting. Produces the
                   print string HALT.


     MEROR      Indicates that the application has detected  a
                   fault. Produces the print string EROR.


     MWARNING    Indicates a condition that is out of the ordi-
                   nary,  that  might be a problem, and should be
                   watched. Produces the print string WARNING.


     MINFO       Provides information about a condition that is
                   not in error. Produces the print string INFO.




SunOS 5.11          Last change: 29 Dec 1996                    1






Standard C Library Functions                      addseverity(3C)



     MNOSEV      Indicates that no severity level  is  supplied
                   for the message.



     Severity levels may also be defined at run  time  using  the
     SEVLEVEL environment variable (see fmtmsg(3C)).

RETURN VALUES
     Upon successful  completion,  addseverity()  returns  MOK.
     Otherwise it returns MNOTOK.

EXAMPLES
     Example 1 Example of addseverity() function.


     When the function call


       addseverity(7,"ALERT")



     is followed by the call


       fmtmsg(MPRINT, "UX:cat", 7, "invalid syntax", "refer to manual",
       "UX:cat:001")



     the resulting output is


       UX:cat: ALERT: invalid syntax
       TO FIX: refer to manual   UX:cat:001


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    






SunOS 5.11          Last change: 29 Dec 1996                    2






Standard C Library Functions                      addseverity(3C)



SEE ALSO
     fmtmsg(1), fmtmsg(3C), gettxt(3C), printf(3C), attributes(5)





















































SunOS 5.11          Last change: 29 Dec 1996                    3