addseverity

ADDSEVERITY(3)		  Linux Programmer’s Manual	       ADDSEVERITY(3)



NAME
       addseverity - introduce new severity classes

SYNOPSIS
       #define _SVID_SOURCE
       #include <fmtmsg.h>

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


DESCRIPTION
       This  function  allows  the introduction of new severity classes which
       can be addressed by the severity parameter of the fmtmsg(3)  function.
       By  default  that latter function only knows how to print messages for
       severity 0-4 (with strings (none), HALT, ERROR, WARNING,	 INFO).	 This
       call attaches the given string s to the given value severity.  If s is
       NULL, the severity class with the numeric value severity	 is  removed.
       It  is not possible to overwrite or remove one of the default severity
       classes. The severity value must be nonnegative.

RETURN VALUE
       Upon success, the value MM_OK is	 returned.  Upon  error,  the  return
       value is MM_NOTOK.  Possible errors include: out of memory, attempt to
       remove a nonexistent or default severity class.

NOTE
       New severity classes can also be	 added	by  setting  the  environment
       varible SEV_LEVEL.

CONFORMING TO
       This  function  is  not	specified  in  the  X/Open  Portability Guide
       although the ‘fmtsmg’ function is.  It is available on System  V	 sys-
       tems.

SEE ALSO
       fmtmsg(3)



gnu				  2002-08-07		       ADDSEVERITY(3)