Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Standard C Library Functionsaddsev(3C)


NAME

 addsev - define additional severities

SYNOPSIS

 
#include <pfmt.h>
int addsev(int int_val, const char *string);

DESCRIPTION

 

The addsev() function defines additional severities for use in subsequent calls to pfmt(3C) or lfmt(3C). It associates an integer value int_val in the range [5-255] with a character string, overwriting any previous string association between int_val and string.

If int_val is OR-ed with the flags argument passed to subsequent calls to pfmt() or lfmt(), string will be used as severity. Passing a null string removes the severity.


RETURN VALUES

 

Upon successful completion, addsev() returns 0. Otherwise it returns-1.


USAGE

 

Only the standard severities are automatically displayed for the locale in effect at runtime. An application must provide the means for displaying locale-specific versions of add-on severities. Add-on severities are only effective within the applications defining them.


EXAMPLES

 Example 1. Example of addsev() function.
 

The following example

 
#define Panic 5
setlabel("APPL");
setcat("my_appl");
addsev(Panic, gettxt(":26", "PANIC"));
/* ... */
lfmt(stderr, MM_SOFT|MM_APPL|PANIC, ":12:Cannot locate database\n");

will display the message to stderr and forward to the logging service

 
APPL: PANIC: Cannot locate database


ATTRIBUTES

 

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

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-safe

SEE ALSO

 

gettxt(3C), lfmt(3C), pfmt(3C), attributes(5)



SunOS 5.9Go To TopLast Changed 29 Dec 1996


Updated: 2004-01-16, 17:09