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
");
	 setlabel("UX:test");
	 pfmt(stderr, MM_ERROR, "test:2:Cannot open file
");

       will produce the following output:

	 ERROR: Cannot open file
	 UX:test: ERROR: Cannot open file

ATTRIBUTES

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

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

SEE ALSO

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

SunOS 5.11							    29 Dec 1996 						      setlabel(3C)