globus_gss...credential(3)

🌸 globus_gss...credential 💅

okay bestie, welcome to the Library Functions Manual page for globus_gss...credential — it's part of the globus_gss_assist fam, and it's all about getting your credentials sorted. let's go ✨

---

💖 NAME 💖

globus_gss_assist_credential — Credential Management

• Acquire Credential.

periodt. that's the whole job. it acquires credentials. iconic behavior honestly 👑

---

✨ SYNOPSIS ✨

🎀 Functions

OM_uint32 globus_gss_assist_acquire_cred (OM_uint32 *minor_status,
    gss_cred_usage_t cred_usage, gss_cred_id_t *output_cred_handle)
OM_uint32 globus_gss_assist_acquire_cred_ext (OM_uint32 *minor_status,
    char *desired_name_char, OM_uint32 time_req, const gss_OID_set
    desired_mechs, gss_cred_usage_t cred_usage, gss_cred_id_t
    *output_cred_handle, gss_OID_set *actual_mechs, OM_uint32 *time_rec)
OM_uint32 globus_gss_assist_read_vhost_cred_dir (OM_uint32
    *minor_status, const char *dir, gss_cred_id_t
    **output_credentials_array, size_t *output_credentials_array_size)

Acquire all GSSAPI credentials in a directory. 🗂️

---

🦋 Detailed Description 🦋

Acquire Credential.

The functions in this section are used to acquire security credentials. that's it, that's the vibe. you want creds? these are the little guys that go get them for you 🫶

---

🌈 Function Documentation 🌈

⭐ OM_uint32 globus_gss_assist_acquire_cred (OM_uint32 * minor_status, gss_cred_usage_t cred_usage, gss_cred_id_t * output_cred_handle)

Called once at the start of the process, to obtain the credentials the process is running under. The

ngl bestie the original sentence just... ends on "The" 💀 not me finishing a thought for it, we do not make the rules, we just report them faithfully.

💜 Parameters

• minor_status — pointer for return code
• cred_usage — GSS_C_INITIATE, GSS_C_ACCEPT, or GSS_C_BOTH
• output_cred_handle — Pointer to the returned handle. This needs to be passed to many gss routines.

💖 Returns

• GSS_S_COMPLETE on success
• Other GSSAPI return codes

---

⭐ OM_uint32 globus_gss_assist_acquire_cred_ext (OM_uint32 * minor_status, char * desired_name_char, OM_uint32 time_req, const gss_OID_set desired_mechs, gss_cred_usage_t cred_usage, gss_cred_id_t * output_cred_handle, gss_OID_set * actual_mechs, OM_uint32 * time_rec)

Called once at the start of the process, to obtain the credentials the process is running under. All the parameters of the gss_acquire_cred(), except the desired_name is a string of the form: [type:]name. This will be imported with the type. ✨

💖 Returns

• GSS_S_COMPLETE on success
• Other GSSPI return codes

🔍 See also

• globus_gss_acquire_cred

---

⭐ OM_uint32 globus_gss_assist_read_vhost_cred_dir (OM_uint32 * minor_status, const char * dir, gss_cred_id_t ** output_credentials_array, size_t * output_credentials_array_size)

Acquire all GSSAPI credentials in a directory. This function loads all of the credentials available in the vhost credential directory and returns them in its output parameters. 💅

The credentials directory is expected to contain a directory for each credential, with the directory containing cert.pem and privkey.pem files. 🗝️

If the dir parameter is NULL, then this function uses the X509_VHOST_CRED_DIR environment variable, or the default /etc/grid-security/vhosts/ if it is not set.

heads up bestie — that default path is /etc/grid-security/vhosts/ exactly as written, hyphen wrap in the original and all, no cap. 🙈

💜 Parameters

• minor_status — Mechanism-specific error code
• dir — Optional directory name to override X509_VHOST_CRED_DIR
• output_credentials_array — Pointer to a dynamic array allocated to hold credentials
• output_credentials_array_size — Pointer to be set to the resulting size (in bytes) of the output_credentials_array

---

👑 Author 👑

Generated automatically by Doxygen for globus_gss_assist from the source code. (so nobody hand-wrote this and honestly? respect the automation 😭)

---

and that's the whole page, bestie!! this came to you courtesy of globus_gss_assist, Version 12.7 💖 go forth and acquire those credentials, you main character 🦋✨🎀