SETLABEL man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

SETLABEL(3C)							  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  defini‐
       tion 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(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)

				 Dec 29, 1996			  SETLABEL(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net