NAME

VistaIOSetProgramName - register a program name for error messages

SYNOPSIS

void VistaIOSetProgramName (name)

VistaIOStringConst name

ARGUMENTS

name

Specifies the program's name as a null-terminated string, or is NULL to indicate that no program name should be registered.

DESCRIPTION

VistaIOSetProgramName determines what, if any, program name will be included in subsequent error messages composed by VistaIOError (3), VistaIOSystemError(3), VistaIOWarning(3), and VistaIOSystemWarning(3).

Initially, no program name is registered. If VistaIOSetProgramName is called with a string, that string is registered as the program name. If VistaIOSetProgramName is called with an argument of NULL, any previously-registered name is forgotten.

EXAMPLES

int main (argc, argv)
int argc;
char *argv[];
{
	...
	VistaIOSetProgramName (argv[0]);
	...
}

SEE ALSO

VistaIOError(3), VistaIOWarning(3), VistaIOSetErrorHandler(3), VistaIOSetWarningHandler(3),

NOTES

VistaIOSetProgramName does not make its own copy of the string it is passed. Consequently, storage used for the string must be maintained by the caller.

AUTHOR

Art Pope <pope@cs.ubc.ca>

Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>