Helper functions for dealing with Globus Generic Error objects.
This section defines utility functions for dealing with Globus Generic Error objects.
◆ globus_error_match()
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
◆ globus_error_print_chain()
| 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
-
- Returns
- A string containing all printable errors. This string needs to be freed by the user of this function.
◆ globus_error_print_friendly()
| 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
-
- Returns
- A string containing a friendly error message. This string needs to be freed by the user of this function.
