addseverity(3) [centos man page]

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.53 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)

addseverity(3C) 					   Standard C Library Functions 					   addseverity(3C)

NAME

       addseverity - build a list of severity levels for an application for use with fmtmsg

SYNOPSIS

       #include <fmtmsg.h>

       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 standard 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 levels 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:

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

       MM_ERROR      Indicates that the application has detected a fault. Produces the print string ERROR.

       MM_WARNING    Indicates	a condition that is out of the ordinary, that might be a problem, and should be watched. Produces the print string
		     WARNING.

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

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

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

RETURN VALUES

       Upon successful completion, addseverity() returns MM_OK. Otherwise it returns MM_NOTOK.

EXAMPLES

       Example 1 Example of addseverity() function.

       When the function call

	 addseverity(7,"ALERT")

       is followed by the call

	 fmtmsg(MM_PRINT, "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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.11							    29 Dec 1996 						   addseverity(3C)