globus_gss_assist.h(3)

✨ globus_gss_assist.h(3) — Library Functions Manual ✨

okay bestie, gather round 💖 this is the GSS Assist Header from globus_gss_assist, and it lives in section 3 of the manual. It's a whole pile of helper functions for doing GSSAPI stuff without losing your entire mind. Buckle up, we're going through every single one. 🦋

---

🌸 NAME 🌸

globus_gss_assist.h — GSS Assist Header. that's it, that's the name, she's self-explanatory 💅

---

✨ SYNOPSIS ✨

#include 'gssapi.h'
#include <stdio.h>
#include <stdlib.h>
#include 'globus_gss_assist_constants.h'

🎀 Macros

• #define GLOBUS_GSI_GSS_ASSIST_MODULE — the module marker macro, no description needed, she just exists 🫶
• #define GlobusGssAssistFreeDNArray(dn_a) — Free array of distinguished names. yes queen, clean up after yourself 🧹

💜 Functions

• int globus_gss_assist_token_get_fd (void *arg, void **bufp, size_t *sizep) — Get token from a FILE *.
• int globus_gss_assist_token_send_fd (void *arg, void *buf, size_t size) — Send token via a FILE *.
• int globus_gss_assist_token_send_fd_ex (void *exp, void *buf, size_t size) — Send a token to a FILE *.
• int globus_gss_assist_token_send_fd_without_length (void *arg, void *buf, size_t size) — Send token to a FILE *.
• OM_uint32 globus_gss_assist_acquire_cred (OM_uint32 *, gss_cred_usage_t, gss_cred_id_t *)
• 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.
• OM_uint32 globus_gss_assist_acquire_cred_ext (OM_uint32 *, char *, OM_uint32, const gss_OID_set, gss_cred_usage_t, gss_cred_id_t *, gss_OID_set *, OM_uint32 *)
• OM_uint32 globus_gss_assist_accept_sec_context (OM_uint32 *, gss_ctx_id_t *, const gss_cred_id_t, char **, OM_uint32 *, int *, int *, gss_cred_id_t *, int(*get_token)(void *, void **, size_t *), void *get_context, int(*send_token)(void *, void *, size_t), void *send_context) — Accept a Security Context.
• OM_uint32 globus_gss_assist_accept_sec_context_async (OM_uint32 *minor_status, gss_ctx_id_t *context_handle, const gss_cred_id_t cred_handle, char **src_name_char, OM_uint32 *ret_flags, int *user_to_user_flag, void *input_buffer, size_t input_buffer_len, void **output_bufferp, size_t *output_buffer_lenp, gss_cred_id_t *delegated_cred_handle) — Accept a Security Context Without Blocking.
• OM_uint32 globus_gss_assist_init_sec_context (OM_uint32 *, const gss_cred_id_t, gss_ctx_id_t *, char *, OM_uint32, OM_uint32 *, int *, int(*get_token)(void *, void **, size_t *), void *get_arg, int(*send_token)(void *, void *, size_t), void *send_arg)
• OM_uint32 globus_gss_assist_init_sec_context_async (OM_uint32 *minor_status, const gss_cred_id_t cred_handle, gss_ctx_id_t *context_handle, char *target_name_char, OM_uint32 req_flags, OM_uint32 *ret_flags, void *input_buffer, size_t input_buffer_len, void **output_bufferp, size_t *output_buffer_lenp)
• OM_uint32 globus_gss_assist_display_status (FILE *, char *, OM_uint32, OM_uint32, int)
• OM_uint32 globus_gss_assist_display_status_str (char **, char *, OM_uint32, OM_uint32, int)
• OM_uint32 globus_gss_assist_wrap_send (OM_uint32 *minor_status, const gss_ctx_id_t context_handle, char *data, size_t length, int *token_status, int(*gss_assist_send_token)(void *, void *, size_t), void *gss_assist_send_context, FILE *fperr) — Wrap.
• OM_uint32 globus_gss_assist_get_unwrap (OM_uint32 *minor_status, const gss_ctx_id_t context_handle, char **data, size_t *length, int *token_status, int(*gss_assist_get_token)(void *, void **, size_t *), void *gss_assist_get_context, FILE *fperr) — Get Unwrap.
• OM_uint32 globus_gss_assist_will_handle_restrictions (OM_uint32 *minor_status, gss_ctx_id_t *context_handle)
• OM_uint32 globus_gss_assist_export_sec_context (OM_uint32 *minor_status, gss_ctx_id_t *context_handle, int *token_status, int fdp, FILE *fperr)
• OM_uint32 globus_gss_assist_import_sec_context (OM_uint32 *minor_status, gss_ctx_id_t *context_handle, int *token_status, int fdp, FILE *fperr)
• globus_result_t globus_gss_assist_authorization_host_name (char *hostname, gss_name_t *authorization_hostname)
• int globus_gss_assist_gridmap (char *globusidp, char **useridp) — Look up the default mapping for a Grid identity in a gridmap file.
• int globus_gss_assist_userok (char *globusid, char *userid) — Gridmap entry existence check.
• int globus_gss_assist_map_local_user (char *local_user, char **globusidp) — Look up the default Grid identity associated with a local user name.
• globus_result_t globus_gss_assist_lookup_all_globusid (char *username, char **dns[], int *dn_count) — Look up all Grid IDs associated with a local user ID.
• globus_result_t globus_gss_assist_map_and_authorize (gss_ctx_id_t context, char *service, char *desired_identity, char *identity_buffer, unsigned int identity_buffer_length) — Authorize the peer of a security context to use a service.
• globus_result_t globus_gss_assist_map_and_authorize_sharing (char *shared_user_certificate, gss_ctx_id_t context, char *desired_identity, char *identity_buffer, unsigned int identity_buffer_length) — Authorize a particular credential for shared access.

---

🦋 Detailed Description 🦋

GSS Assist Header. that's the whole vibe. 💖

---

👑 Function Documentation 👑

🌈 globus_result_t globus_gss_assist_authorization_host_name (char * hostname, gss_name_t * authorization_hostname)

Create a GSS Name structure from the given hostname. This function tries to resolve the given host name string to the canonical DNS name for the host. 🧚

Parameters

• hostname — The host name or numerical address to be resolved and transform into a GSS Name
• authorization_hostname — The resulting GSS Name

Returns

GLOBUS_SUCCESS on successful completion, a error object otherwise

---

🌸 OM_uint32 globus_gss_assist_wrap_send (OM_uint32 * minor_status, const gss_ctx_id_t context_handle, char * data, size_t length, int * token_status, int(* gss_assist_send_token )(void *, void *, size_t), void * gss_assist_send_context, FILE * fperr) [extern]

Wrap. that's it, that's the summary, she's concise 💅

Parameters

• minor_status — GSSAPI return code. If the call was successful, the minor status is equal to GLOBUS_SUCCESS. Otherwise, it is an error object ID for which globus_error_get() and globus_object_free() can be used to get and destroy it.
• context_handle — the context.
• data — pointer to application data to wrap and send
• length — length of the data array
• token_status — assist routine get/send token status
• gss_assist_send_token — a send_token routine
• gss_assist_send_context — first arg for the send_token
• fperr — file handle to write error message to.

Returns

GSS_S_COMPLETE on success Other GSSAPI errors on failure.

See also

gss_wrap()

---

💖 Author 💖

Generated automatically by Doxygen for globus_gss_assist from the source code. (so if anything's weird in here, blame the robots, not me 🙈)

---

ngl bestie, that's the whole page. every macro, every function, every param, every return, untouched and unbothered, just wearing a cuter outfit now. no cap. 🎀

globus_gss_assist — Version 12.7 — globus_gss_assist.h(3). mwah, slay, go write some secure code, ily 🫶✨💜