GLOBUS_OPENSSL_ERROR_HANDLE_GET_REASON(3)

💖 globus_openssl_error_object — Globus OpenSSL Error Object 💖

okay so bestie, welcome to the <pink>globus_ope...rror_object(3)</pink> page from the Library Functions Manual 💅 this is a Globus OpenSSL Error Object and we're gonna get you fluent in it, no cap.

---

✨ NAME ✨

globus_openssl_error_object — Globus OpenSSL Error Object 🌸

• Globus OpenSSL Error Object.

---

🦋 SYNOPSIS 🦋

🎀 Macros 🎀

#define GLOBUS_ERROR_TYPE_OPENSSL

💅 Functions 💅

unsigned long globus_openssl_error_handle_get_error_code
    (globus_openssl_error_handle_t handle)
const char * globus_openssl_error_handle_get_data
    (globus_openssl_error_handle_t handle)
int globus_openssl_error_handle_get_data_flags
    (globus_openssl_error_handle_t handle)
const char * globus_openssl_error_handle_get_filename
    (globus_openssl_error_handle_t handle)
int globus_openssl_error_handle_get_linenumber
    (globus_openssl_error_handle_t handle)
const char * globus_openssl_error_handle_get_library
    (globus_openssl_error_handle_t handle)
const char * globus_openssl_error_handle_get_function
    (globus_openssl_error_handle_t handle)
const char * globus_openssl_error_handle_get_reason
    (globus_openssl_error_handle_t handle)
globus_object_t * globus_error_construct_openssl_error
    (globus_module_descriptor_t *base_source, globus_object_t
    *base_cause)
globus_object_t * globus_error_initialize_openssl_error (globus_object_t
    *error, globus_module_descriptor_t *base_source, globus_object_t
    *base_cause, globus_openssl_error_handle_t openssl_error_handle)

---

🌈 Detailed Description 🌈

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. it's giving very "I hold the receipts of what OpenSSL did" energy fr fr 🫶

---

👑 Macro Definition Documentation 👑

💜 #define GLOBUS_ERROR_TYPE_OPENSSL

Error type definition ⭐

---

🔥 Function Documentation 🔥

🍓 globus_object_t * globus_error_construct_openssl_error (globus_module_descriptor_t * base_source, globus_object_t * base_cause)

Allocate and initialize an error of type GLOBUS_ERROR_TYPE_OPENSSL. This function, combined with globus_error_initialize_openssl_error(), will recursively generate globus error objects (of type globus_object_t) from the errors on OpenSSL's static error stack. The errors will be chained in a causal fashion to provide a path to the root cause of the actual error. like a lil detective trail back to the origin story 🕵️♀️💖

NOTE: the static stack OpenSSL implements for its errors currently only supports at most 16 errors, so if more are added, the errors that were added first will be wiped out. If 16 errors are counted in the chain of OpenSSL errors, its possible that some errors (including the original error) are missing. 💀 so yeah, bestie, sometimes the receipts get deleted, that's just how the stack works.

Parameters

• base_source — Pointer to the originating globus module.
• base_cause — The error object causing the error. This parameter should be NULL in nearly all cases, as the root cause of an error will most likely be in the OpenSSL code itself. The actual cause of the error is determined from the static stack of OpenSSL errors.

Returns

The resulting error object. It is the user's responsibility to eventually free this object using globus_object_free(). A globus_result_t may be obtained by calling globus_error_put() on this object. 🎀 don't forget to free it, we do NOT leak in this house.

---

🧚 globus_object_t * globus_error_initialize_openssl_error (globus_object_t * error, globus_module_descriptor_t * base_source, globus_object_t * base_cause, globus_openssl_error_handle_t openssl_error_handle)

Initialize a previously allocated error of type GLOBUS_ERROR_TYPE_OPENSSL. ✨

Parameters

• error — The previously allocated error object.
• base_source — Pointer to the originating module.
• base_cause — The error object causing the error. If this is the original error this parameter may be NULL.
• openssl_error_handle — The OpenSSL error handle associated with this error, this parameter should already be initialized to contain the OpenSSL error code associated with the error.

Returns

The resulting error object. You may have to call globus_error_put() on this object before passing it on. 🫶

---

🦋 const char * globus_openssl_error_handle_get_data (globus_openssl_error_handle_t handle)

Get the OpenSSL error data which contains additional data about the error from the OpenSSL error handle. 🌸

Parameters

• handle — The OpenSSL error handle

Returns

The error data

---

💅 int globus_openssl_error_handle_get_data_flags (globus_openssl_error_handle_t handle)

Get the OpenSSL error data flags from the OpenSSL error handle. ⭐

Parameters

• handle — The OpenSSL error handle

Returns

The error data flags

---

🔥 unsigned long globus_openssl_error_handle_get_error_code (globus_openssl_error_handle_t handle)

Get the OpenSSL error code which represents the OpenSSL error from the OpenSSL error handle. 👑

Parameters

• handle — The OpenSSL error handle

Returns

The error code

---

🎀 const char * globus_openssl_error_handle_get_filename (globus_openssl_error_handle_t handle)

Get the filename where the OpenSSL error occurred from the OpenSSL error handle. 💖

Parameters

• handle — The OpenSSL error handle

Returns

The filename

---

🧚 const char * globus_openssl_error_handle_get_function (globus_openssl_error_handle_t handle)

Get the function name where the OpenSSL error occurred from the OpenSSL error handle. ✨

Parameters

• handle — The OpenSSL error handle

Returns

The function name

---

🌈 const char * globus_openssl_error_handle_get_library (globus_openssl_error_handle_t handle)

Get the library name where the OpenSSL error occurred in from the OpenSSL error handle. 💜

Parameters

• handle — The OpenSSL error handle

Returns

The library name

---

🍓 int globus_openssl_error_handle_get_linenumber (globus_openssl_error_handle_t handle)

Get the line number on which the OpenSSL error occurred from the OpenSSL error handle. 💅

Parameters

• handle — The OpenSSL error handle

Returns

The line number

---

🦋 const char * globus_openssl_error_handle_get_reason (globus_openssl_error_handle_t handle)

Get the reason string which caused the OpenSSL error from the OpenSSL error handle. 😭 the "why though" of it all.

Parameters

• handle — The OpenSSL error handle

Returns

The reason string

---

🌸 Author 🌸

Generated automatically by Doxygen for globus_gsi_openssl_error from the source code. 🤖✨

---

and that's the whole page, bestie — every flag, every handle, every return value, all of it, periodt 💅 this was globus_gsi_openssl_error, Version 4.4, and yeah it's globus_ope...rror_object(3) energy all the way down. mwah, go free your error objects 🫶💖