.\"
.\" $XConsortium: p041,v 5.2 94/04/17 20:54:43 rws Exp $
.\"
.\" 
$XMCOPY
.\" Copyright (c) 1990, 1991 by Sun Microsystems, Inc. and the X Consortium.
.\" 
.\"                         All Rights Reserved
.\" 
.\" Permission to use, copy, modify, and distribute this software and its 
.\" documentation for any purpose and without fee is hereby granted, 
.\" provided that the above copyright notice appear in all copies and that
.\" both that copyright notice and this permission notice appear in 
.\" supporting documentation, and that the names of Sun Microsystems,
.\" and the X Consortium not be used in advertising or publicity 
.\" pertaining to distribution of the software without specific, written 
.\" prior permission.  
.\" 
.\" SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\" EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\" USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.TH "ERROR HANDLING" 3P "29 February 1991"
.SH NAME
ERROR HANDLING \- default \s-2PHIGS\s+2 error handling routine
.IX "Errors" "ERROR HANDLING"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
perr_hand ( errnum, funcnum, fname )
Pint	errnum;	\fIerror number\fP
Pint	funcnum;	\fINumber of function that detected the error\fP
char	*fname;	\fIname of error file\fP
.fi
.ft R
.SS Required PHIGS Operating States
(*, *, *, *)
.SH DESCRIPTION
.SS Purpose
When the error handling mode is \s-2ON\s+2, \s-2ERROR HANDLING\s+2 is
called by \s-2PHIGS\s+2 functions when they detect an error.
.LP
An application may replace the default \s-2ERROR HANDLING\s+2
function in order to modify the default response to errors, which is
simply to call \s-2ERROR LOGGING\s+2.
Any such replacement must have the name above and accept the same parameters.
.SS C Input Parameters
.IP \fIerrnum\fP
The number of the error detected. The error numbers and corresponding error
messages are listed with each function description in
this reference.
.IP \fIfuncnum\fP
The identification of the function that detected the error.
.IP \fIfname\fP
A pointer to a character string containing the name of the error file.
The error file is specified in the call to \s-2OPEN PHIGS\s+2.
.SS Execution
\s-2ERROR HANDLING\s+2 is called by a \s-2PHIGS\s+2 function that
has deteced an error.
The default \s-2ERROR HANDLING\s+2 function performs no
other processing than to call \s-2ERROR LOGGING\s+2.
.LP
See \s-2OPEN PHIGS\s+2 for a description of the \s-2PHIGS\s+2
interaction with the error file.
.SH ERRORS
.IP 
No Errors
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "ERROR LOGGING (3P)"
.SM "SET ERROR HANDLING MODE (3P)"
.fi
