---
name: "globus_openssl_error_api"
section: "3"
platform: "linux"
package: "libglobus-gsi-openssl-error-doc"
version: "4.4-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_openssl_error_api"
---

# globus\_openssl\_error\_api(3)

Globus OpenSSL Error API - Globus OpenSSL Error API.

## NAME

globus\_openssl\_error\_api - Globus OpenSSL Error API

 \- Globus OpenSSL Error API.

## SYNOPSIS

### Modules

**Activation**\
 Activation.  **Globus OpenSSL Error Object**\
 Globus OpenSSL Error Object.  **Error Object Helper Functions**\
 Error Object Helper Functions.

## Detailed Description

Globus OpenSSL Error API.

The globus\_gsi\_openssl\_error functions provide a wrapper to error types defined by OpenSSL. The types and prototypes for the globus\_gsi\_openssl\_error library are defined in the **globus\_error\_openssl.h** header. Applications which use these functions must link with the libglobus\_openssl\_error library. The library is distributed with a pkg-config module called globus-gsi-openssl-error to automatically find header and library paths.

## Library Initialization

Activation.

Globus GSI OpenSSL Error uses standard Globus module activation and deactivation. Before any Globus GSI OpenSSL Error functions are called, the following function must be called:

```
globus_module_activate(GLOBUS_GSI_OPENSSL_ERROR_MODULE)
```

This function returns GLOBUS\_SUCCESS if Globus GSI OpenSSL Error was successfully initialized, and you are therefore allowed to subsequently call Globus GSI OpenSSL Error functions. Otherwise, an error code is returned, and Globus GSI OpenSSL Error functions should not be subsequently called. This function may be called multiple times.

To deactivate Globus GSI OpenSSL Error, the following function must be called:

```
globus_module_deactivate(GLOBUS_GSI_OPENSSL_ERROR_MODULE)
```

This function should be called once for each time Globus GSI OpenSSL Error was activated.

## Error Object Data Definition

Globus OpenSSL Error Object.

The globus\_openssl\_error\_handle\_t is an opaque structure pointer which contains information about the OpenSSL call which generated an error. The functions in the **Globus OpenSSL Error Object**  section of the API are used to create, manipulate, and destroy Globus OpenSSL Error object data.

## Error Object Manipulators

Error Object Helper Functions.

The functions in the **Error Object Helper Functions**  section deal with Globus error objects constructed with OpenSSL error data. These functions manipulate the generic globus\_object\_t representation of an OpenSSL error.

## Author

Generated automatically by Doxygen for globus\_gsi\_openssl\_error from the source code.