osSetErrorHandler.3p
876 Bytes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
.TH osSetErrorHandler 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
osSetErrorHandler \- set debug library error handling routine
.SH SYNOPSIS
.nf
\f3
.Op c
#include <ultra64.h>
.sp .8v
typedef void (\(**OSErrorHandler)(s16 code, s16 numArgs, ...);
.sp .8v
OSErrorHandler osSetErrorHandler(OSErrorHandler func);
.Op
\f1
.fi
.SH DESCRIPTION
The
.I osSetErrorHandler
routine sets the debug library error handling routine to
.I func
and returns the previous value.
If
.I func
is NULL,
then no routine is called when a routine debug library encounters an error.
.PP
The default error handling routine installed at boot time will marshal
the arguments and send them to
.IR gload (3P)
where they are interpreted and printed.
.PP
This routine is only present in the debug library
.I libultra_d.a,
and not in the non-debug library
.IR libultra.a .
.SH "SEE ALSO"
.IR gload (3P)