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 vari- able 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 systems.

SEE ALSO fmtmsg(3)

gnu 2002-08-07 ADDSEVERITY(3)