SETLABEL(3C) Standard C Library Functions SETLABEL(3C)

NAME


setlabel - define the label for pfmt() and lfmt()

SYNOPSIS


#include <pfmt.h>

int setlabel(const char *label);


DESCRIPTION


The setlabel() function defines the label for messages produced in
standard format by subsequent calls to lfmt(3C) and pfmt(3C).


The label argument is a character string no more than 25 characters in
length.


No label is defined before setlabel() is called. The label should be set
once at the beginning of a utility and remain constant. A null pointer or
an empty string passed as argument will reset the definition of the
label.

RETURN VALUE


Upon successful completion, setlabel() returns 0; otherwise, it returns a
non-zero value.

EXAMPLES


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


ATTRIBUTES


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


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+

SEE ALSO


getopt(3C), lfmt(3C), pfmt(3C), attributes(7)

illumos June 19, 2021 SETLABEL(3C)