BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kset_warnhandler - set the warning handler routine used by kwarn()
LIBRARY CALL
knotify kset_warnhandler(
knotify new_handler)
INPUT
- new_handler - the warning handler to be called. Specify
xvu_warn() 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 warning handler, or NULL
if the default warning handler was installed.
DESCRIPTION
Sets the warning handler routine to be used by the kwarn()
reporting facility. When set to NULL (the default) the
default Khoros warn handler is used, which simply prints
the warning to stderr.
If a different warning handler is set, the warning handler
must be declared as follows, and should return TRUE.
int warn_handler(
char *toolbox,
char *program,
char *library,
char *routine,
char *message)
toolbox - name of toolbox containing code issuing warning
program - name of program containing code issuing warning
library - name of library containing code issuing warning
routine - name of routine issuing warning
message - grammatically correct, clear warning
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.