BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kset_errorhandler - set the error handling routine used by kerror()

LIBRARY CALL

knotify kset_errorhandler(
   knotify new_handler)

INPUT

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.