addseverity man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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 pre‐
       viously	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	previ‐
       ously  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.10			  29 Dec 1996		       addseverity(3C)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net