setlabel(3C)                                                      setlabel(3C)


NAME
     setlabel - 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 ALSO
     getopt(3C), lfmt(3C), pfmt(3C)

DIAGNOSTICS
     setlabel 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