The following routines are provided as a convinience for Dervish programmers. They provide a consistent interface to memory management and error handling.
This routine prints a debugging message on the output device. Only those messages below a certain threshold will be printed. Specify message to be printed using printf(2V) type strings.
This routine sets the maximum threshold value for printing error messages. All error messages less then or equal to this threshold value will be printed. All error messages greater then this value will be silently ignored. If the passed parameter value is less then zero, then the threshold value remains unchanged.
This is the routine to call when the science module receives a non-fatal error and needs to tell the framework. The message is printed on the ouput device, and the string is pushed onto the error stack. A new line in the error string will be removed before passing it on to the error stack routines.
This routine handles fatal errors by displaying an error message on the output device and terminating the program. It also produces a core image of the executable for further debugging purposes.