setlabel(3C)
NAME
setlabel() − define label for formatting routines
SYNOPSIS
#include <pfmt.h>
int setlabel(const char *label);
DESCRIPTION
The setlabel() system call defines a label to be printed by formatting routines (see pfmt(3C) and vpfmt(3C)) in the standard message format. label is a character string limited to 25 characters in length.
If label is NULL or an empty string, the label is reset to no label. No label is defined before setlabel().
setlabel() assumes that label has already been translated into a locale-specific string using the current locale.
RETURN VALUE
setlabel() returns zero upon successful completion or nonzero if the routine failed.
EXAMPLES
This example, with no label defined:
pfmt(stderr, MM_INFO,"my_appl_cat:1:file is writable");
generates:
INFO: file is writable
Using setlabel():
setlabel("my_appl");
pfmt(stderr, MM_INFO,"my_appl_cat:1:file is writable");
generates:
my_appl: INFO: file is writable
SEE ALSO
STANDARDS COMPLIANCE
setlabel(): SVID3
Hewlett-Packard Company — HP-UX Release 10.20: July 1996