HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

addsev(3C) addsev(3C)

NAME

addsev() - deﬁne additional severities for formatting routines

SYNOPSIS

#include <pfmt.h>

int addsev(int sev, const char *sev_string);

DESCRIPTION

The addsev() routine allows the user to deﬁne additional severities to be used by formatting routines

(see pfmt(3C)) in the standard message format. sev is the severity level. It must be between 5 and 255

inclusively. sev_string is a character string to be associated for this severity level. If the severity com-

ponent of the ﬂags parameter of the formatting routines matches sev, sev_string is printed as the severity

string.

The

addsev() routine may be called multiple times to set up a list of associations. If sev is already set,

sev_string overwrites the previous string. If sev_string is NULL, the association is removed from the list.

addsev() assumes that sev_string has already been translated into a locale-speciﬁc string using the

current locale.

RETURN VALUE

If successful, addsev() returns zero. Otherwise, it returns −1.

EXAMPLE

#define MM_USER 10

addsev(MM_USER, "MY_NOTE");

pfmt(stdout, MM_USER|MM_GET,"my_appl_cat:1:The file is writable");

This example writes the following message to standard output:

MY_NOTE: The file is writable