setlabel(3C)setlabel(3C)NAMEsetlabel - define the label for pfmt and lfmt.
SYNOPSIS
#include <pfmt.h>
int setlabel(const char *label);
DESCRIPTION
The routine setlabel defines the label for messages produced in standard
format by subsequent calls to lfmt, vlfmt, pfmt, and vpfmt.
label is a character string no more than 25 characters in length.
No label is defined before setlabel is called. A null pointer or an
empty string passed as argument will reset the definition of the label.
EXAMPLE
The following code (without previous call to setlabel):
pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");
setlabel("UX:test");
pfmt(stderr, MM_ERROR, "test:2:Cannot open file\n");
will produce the following output:
ERROR: Cannot open file
UX:test: ERROR: Cannot open file
SEE ALSOgetopt(3C), lfmt(3C), pfmt(3C)DIAGNOSTICSsetlabel returns 0 in case of success, non-zero otherwise.
NOTES
The label should be set once at the beginning of a utility and remain
constant.
getopt(3C) has been modified to report errors using the standard message
format. If setlabel is called before getopt, getopt will use that label.
Otherwise, getopt will use the name of the utility.
Page 1