setlabel(3C)							  setlabel(3C)

NAME    [Toc]    [Back]

     setlabel -	define the label for pfmt and lfmt.

SYNOPSIS    [Toc]    [Back]

     #include <pfmt.h>

     int setlabel(const	char *label<b>);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     setlabel returns 0	in case	of success, non-zero otherwise.

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111