SYNOPSIS

void VistaIOError (format [, arg...])

VistaIOStringConst

format;
void VistaIOSystemError (format [, arg...])

VistaIOStringConst

format;

ARGUMENTS

format

Specifies the format of the message that is to be reported.

arg

Specifies values that are to be included in the formatted message.

DESCRIPTION

VistaIOError is called to report a fatal error. It composes an error message and passes it to the fatal error handler, which typically prints the message and terminates the program (see VistaIOSetErrorHandler(3)).

The message composed by VistaIOError is of the form:

Program: Fatal: Description.

Program, the program's name, is included if it has been previously established with a call to VistaIOSetProgramName. Description is a string that has been formatted by sprintf using format, plus all of the optional arguments, arg.

VistaIOSystemError is identical to VistaIOError except that it also includes in the message a phrase based on the current value of the external variable errno, which is used by system calls to return diagnostic codes. The message composed by VistaIOSystemError is of the form:

Program: Fatal: Description: Diagnostic.

Diagnostic is a short phrase corresponding to the value of errno. This phrase is drawn from the table used by perror(3).

RETURN VALUES

Neither VistaIOError nor VistaIOSystemError ever return.

EXAMPLES

In this first example, the values of attr_name, act_value, and exp_value are incorporated into the error message produced by VistaIOError.

char *attr_name;
float act_value, exp_value;
if (act_value != exp_value)
        VistaIOError ("MyRoutine: Attribute %s is %f rather than %f",
                attr_name, act_value, exp_value);

In this second example, the diagnostic phrase corresponding to the value of errno is incorporated into the error message produced by VistaIOSystemError.

if (ioctl (fd, request, arg) == -1)
        VistaIOSystemError ("MyRoutine: ioctl failed");

AUTHOR

Art Pope <[email protected]>

Adaption to vistaio: Gert Wollny <[email protected]>