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



NAME
       addseverity - introduce new severity classes

SYNOPSIS
       #include <fmtmsg.h>

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

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       addseverity(): _SVID_SOURCE

DESCRIPTION
       This  function  allows  the  introduction  of new severity classes which can be addressed by the severity argument 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.

VERSIONS
       addseverity() is provided in glibc since version 2.1.

CONFORMING TO
       This function is not specified in the X/Open Portability Guide although the fmtmsg(3) function is.  It  is  available  on
       System V systems.

NOTES
       New severity classes can also be added by setting the environment variable SEV_LEVEL.

SEE ALSO
       fmtmsg(3)

COLOPHON
       This  page  is  part of release 3.25 of the Linux man-pages project.  A description of the project, and information about
       reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.



GNU                                                        2008-06-14                                             ADDSEVERITY(3)