addseverity man page on SmartOS

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

ADDSEVERITY(3C)						       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. Pro‐
		     duces 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 mes‐
		     sage.

       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)

				 Dec 29, 1996		       ADDSEVERITY(3C)
[top]

List of man pages available for SmartOS

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