BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kset_errorhandler - set the error handling routine used by kerror()
LIBRARY CALL
knotify kset_errorhandler(
knotify new_handler)
INPUT
- new_handler - the error handler to be called. Specify
xvu_error() for the Khoros pop-up error
message (xvroutines & hybrid routines only),
NULL for the Khoros default error handler which
prints to the tty, or your own error handler.
OUTPUT
none
RETURN VALUE
the previously installed error handler, or NULL
if the default error handler was installed.
DESCRIPTION
Sets the error handler routine to be used by the kerror()
reporting facility. When set to NULL (the default) the
default Khoros error handler is used, which simply prints the
error to stderr.
If a different error handler is set, the error handler
must be declared as follows, and should return TRUE.
int error_handler(
char *toolbox,
char *program,
char *library,
char *routine,
char *category,
char *message)
toolbox - name of toolbox in which error occured
program - name of program in which error occured
library - name of library in which error occured
routine - name of routine in which error occured
category - error message category
(see $BOOTSTRAP/include/kutils/knotify.h)
message - grammatically correct, clear error message
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/notify.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.