Provided by: libvistaio-dev_1.2.19-2_amd64 bug


       VistaIOSetWarningHandler - register a procedure to be called on any nonfatal error


       void VistaIOSetWarningHandler (VistaIOWarningHandler *handler)

       typedef void VistaIOWarningHandler (VistaIOStringConst message);

       void VistaIODefaultWarning (VistaIOStringConst message);


       handler   Specifies the new nonfatal error handler.

       message   Specifies a null-terminated error message string to be reported.


       VistaIOSetWarningHandler  registers  a  procedure, handler, as the nonfatal error handler.
       That procedure is called by VistaIOWarning(3) or by VistaIOSystemWarning(3) to report  any
       nonfatal  error.  When  called  it  is  passed  a  string,  message,  containing a textual
       description of the error.

       Only one procedure serves as the nonfatal error handler at any one time.

       Prior to the first call to VistaIOSetWarningHandler, the  procedure  VistaIODefaultWarning
       is the nonfatal error handler. This procedure will write the error message to the standard
       error stream, then return.  VistaIODefaultWarning can be re-established as the fatal error
       handler at any time by calling VistaIOSetWarningHandler with a NULL argument.


       To adopt a warning handler that writes messages both to the standard error stream and to a
       log file, one might do the following:

              FILE *log_file;

              void MyWarningHandler (message)
                   VistaIOStringConst message;
                   fputs (message, stderr);
                   fputs (message, log_file);

              int main (...)
                   log_file = fopen ("log", "w");
                   VistaIOSetWarningHandler (MyWarningHandler);


       VistaIOWarning(3), VistaIOSetErrorHandler(3),


       Art Pope <>

       Adaption to vistaio: Gert Wollny <>