home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | VERSIONS | CONFORMING TO | NOTES | SEE ALSO | COLOPHONThe Linux Programming Interface


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

NAME         top

       addseverity - introduce new severity classes

SYNOPSIS         top

       #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         top

       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         top

       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         top

       addseverity() is provided in glibc since version 2.1.

CONFORMING TO         top

       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         top

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

SEE ALSO         top

       fmtmsg(3)

COLOPHON         top

       This page is part of release 3.32 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)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter