Error Handling Helpers
[Globus Generic Error API]

Helper functions for dealing with Globus Generic Error objects. More...

Collaboration diagram for Error Handling Helpers:

Detailed Description

Helper functions for dealing with Globus Generic Error objects.

This section defines utility functions for dealing with Globus Generic Error objects.


Function Documentation

globus_bool_t globus_error_match ( globus_object_t *  error,
globus_module_descriptor_t *  module,
int  type 
)

Check whether the error originated from a specific module and is of a specific type.

This function checks whether the error or any of it's causative errors originated from a specific module and is of a specific type. If the module descriptor is left unspecified this function will check for any error of the specified type and vice versa.

Parameters:
error The error object for which to perform the check
module The module descriptor to check for
type The type to check for
Returns:
GLOBUS_TRUE - the error matched the module and type GLOBUS_FALSE - the error failed to match the module and type

References globus_error_get_cause(), globus_error_get_source(), globus_error_get_type(), and GLOBUS_ERROR_TYPE_GLOBUS.

char* globus_error_print_chain ( globus_object_t *  error  ) 

Return a string containing all printable errors found in a error object and it's causative error chain.

If the GLOBUS_ERROR_VERBOSE env is set, file, line and function info will also be printed (where available). Otherwise, only the module name will be printed.

Parameters:
error The error to print
Returns:
A string containing all printable errors. This string needs to be freed by the user of this function.

References globus_error_get_cause().

char* globus_error_print_friendly ( globus_object_t *  error  ) 

Return a string containing error messages from the top 1 and bottom 3 objects, and, if found, show a friendly error message.

The error chain will be searched from top to bottom until a friendly handler is found and a friendly message is created.

If the GLOBUS_ERROR_VERBOSE env is set, then the result from globus_error_print_chain() will be used.

Parameters:
error The error to print
Returns:
A string containing a friendly error message. This string needs to be freed by the user of this function.

References globus_error_get_cause(), globus_error_get_source(), and globus_error_print_chain().


about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org