NAME

       VistaIOWarning, VistaIOSystemWarning - report a nonfatal error

SYNOPSIS

       void VistaIOWarning (format [, arg...])
              VistaIOStringConst format;

       void VistaIOSystemWarning (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

       VistaIOWarning  is  called  to  report  a nonfatal error. It composes an error message and
       passes it to the nonfatal error handler, which typically prints the  message  and  returns
       (see VistaIOSetWarningHandler(3)).

       The message composed by VistaIOWarning is of the form:

              Program: Warning: 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.

       VistaIOSystemWarning  is  identical  to VistaIOWarning 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 VistaIOSystemWarning
       is of the form:

              Program: Warning: Description: Diagnostic.

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

EXAMPLES

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

              char *attr_name;
              float act_value, exp_value;

              if (act_value != exp_value)
                   VistaIOWarning ("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 VistaIOSystemWarning.

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

SEE ALSO

       VistaIOError(3), VistaIOSetWarningHandler(3), VistaIOSetProgramName(3), perror(3),

AUTHOR

       Art Pope <pope@cs.ubc.ca>

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