NAME

       globus_gss_assist.h - GSS Assist Header.

SYNOPSIS

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

   Macros
       #define GLOBUS_GSI_GSS_ASSIST_MODULE
       #define GlobusGssAssistFreeDNArray(dn_a)
           Free array of distinguished names.

   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 *arg, 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_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.

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(*)(void *, void *,
       size_t) gss_assist_send_token, void * gss_assist_send_context, FILE * fperr)
       Wrap.

       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.