---
name: "VistaIOSetProgramName"
section: "3"
platform: "linux"
package: "libvistaio-dev"
version: "1.2.19-3+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/VistaIOSetProgramName"
---

# VistaIOSetProgramName(3)

register a program name for error messages

## 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)](/VistaIOWarning/3.md), 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)](/VistaIOError/3.md), [**VistaIOWarning**(3)](/VistaIOWarning/3.md), [**VistaIOSetErrorHandler**(3)](/VistaIOSetErrorHandler/3.md), [**VistaIOSetWarningHandler**(3)](/VistaIOSetWarningHandler/3.md),

## 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\>**