globus_gss_assist.h File Reference

GSS Assist Header. More...

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

Go to the source code of this file.

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

Functions
int	globus_gss_assist_token_get_fd (void *arg, void **bufp, size_t *sizep)
	Get token from a FILE *. More...
int	globus_gss_assist_token_send_fd (void *arg, void *buf, size_t size)
	Send token via a FILE *. More...
int	globus_gss_assist_token_send_fd_ex (void *arg, void *buf, size_t size)
	Send a token to a FILE *. More...
int	globus_gss_assist_token_send_fd_without_length (void *arg, void *buf, size_t size)
	Send token to a FILE *. More...
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. More...
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. More...
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. More...
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. More...
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. More...
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. More...
int	globus_gss_assist_userok (char *globusid, char *userid)
	Gridmap entry existence check. More...
int	globus_gss_assist_map_local_user (char *local_user, char **globusidp)
	Look up the default Grid identity associated with a local user name. More...
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. More...
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. More...
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. More...

Detailed Description

GSS Assist Header.

Function Documentation

globus_gss_assist_authorization_host_name()

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

globus_gss_assist_wrap_send()

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()