<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta name="robots" content="noindex">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<!-- THIS FILE IS AUTOMATICALLY GENERATED FROM THE GLOBUS SOURCE CODE
DO NOT MODIFY.
-->
<title>Globus Reference Manual</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head>
<body>
<!-- Generated by Doxygen 1.6.2-20100208 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="main.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>Utility Functions</h1>
<p>Utility functions for GSSAPI.
<a href="#_details">More...</a></p>
<h2>Defines</h2>
<ul>
<li>#define <a class="el" href="group__globus__gsi__gss__assist.html#gaec4343ae029aad696c125f311a54d380">GlobusGssAssistFreeDNArray</a>(dn_a)
</ul>
<h2>Functions</h2>
<ul>
<li>int <a class="el" href="group__globus__gsi__gss__assist.html#ga8cb7da6808b720b5185d67d858e78fec">globus_gss_assist_gridmap</a> (char *globusidp, char **useridp)
<li>int <a class="el" href="group__globus__gsi__gss__assist.html#ga6bfda92b7cb95813557688b7bdc8cea7">globus_gss_assist_userok</a> (char *globusid, char *userid)
<li>int <a class="el" href="group__globus__gsi__gss__assist.html#ga5e73fcdc1c36dde30c06721f80e9250e">globus_gss_assist_map_local_user</a> (char *local_user, char **globusidp)
<li>globus_result_t <a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3">globus_gss_assist_lookup_all_globusid</a> (char *username, char **dns[], int *dn_count)
<li>globus_result_t <a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61">globus_gss_assist_map_and_authorize</a> (gss_ctx_id_t context, char *service, char *desired_identity, char *identity_buffer, unsigned int identity_buffer_length)
<li>globus_result_t <a class="el" href="group__globus__gsi__gss__assist.html#ga50b5708435757bdf8d4fd45d56cc37b0">globus_gss_assist_authorization_host_name</a> (char *hostname, gss_name_t *authorization_hostname)
</ul>
<h2>Accept Security Context</h2>
<p><a class="anchor" id="amgrpfdf5c4398e8e85c884ea06ead3e3e2de"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga01e75ed381ee5a89e6e19c4c12117d73">globus_gss_assist_accept_sec_context</a> (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, int *token_status, gss_cred_id_t *delegated_cred_handle, int(*gss_assist_get_token)(void *, void **, size_t *), void *gss_assist_get_context, int(*gss_assist_send_token)(void *, void *, size_t), void *gss_assist_send_context)
</ul>
<h2>Accept Security Context Asyncronous</h2>
<p><a class="anchor" id="amgrpadee7017759a3f6c087b15162368055a"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga5e1eef554700030ed889b3b594eab4cc">globus_gss_assist_accept_sec_context_async</a> (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)
</ul>
<h2>Acquire Credential</h2>
<p><a class="anchor" id="amgrp9f96ce489916a1e69bd7528909280b0d"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga47713e99f1d1429ac3212dbc3e4854a8">globus_gss_assist_acquire_cred</a> (OM_uint32 *minor_status, gss_cred_usage_t cred_usage, gss_cred_id_t *output_cred_handle)
</ul>
<h2>Acquire Credential Extension</h2>
<p><a class="anchor" id="amgrp73c437b85352de992fe85d65c34b6964"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga9d527b8e3ab9459a0a9c95a0fc7ca057">globus_gss_assist_acquire_cred_ext</a> (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)
</ul>
<h2>Display Status</h2>
<p><a class="anchor" id="amgrp5bf4fd45c14e800d2bb90cb672699521"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga56720113a3aa7c40f4da81e71cb13190">globus_gss_assist_display_status</a> (FILE *fp, char *comment, OM_uint32 major_status, OM_uint32 minor_status, int token_status)
</ul>
<h2>Display Status String</h2>
<p><a class="anchor" id="amgrpa3c0350e18402fe974dd979a9f3e9fae"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga6a64e15ba5f89d8d8cd4b501bc07de7c">globus_gss_assist_display_status_str</a> (char **str, char *comment, OM_uint32 major_status, OM_uint32 minor_status, int token_status)
</ul>
<p><a class="anchor" id="amgrpd41d8cd98f00b204e9800998ecf8427e"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#ga7f81c21b7208321ba527b13e1a83e9c9">globus_gss_assist_import_sec_context</a> (OM_uint32 *minor_status, gss_ctx_id_t *context_handle, int *token_status, int fdp, FILE *fperr)
</ul>
<h2>Init Security Context</h2>
<p><a class="anchor" id="amgrp20596c144e800d2105b0546763718795"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#gab903ee3c21ece07d455a0cc56def425f">globus_gss_assist_init_sec_context</a> (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, int *token_status, int(*gss_assist_get_token)(void *, void **, size_t *), void *gss_assist_get_context, int(*gss_assist_send_token)(void *, void *, size_t), void *gss_assist_send_context)
</ul>
<h2>Init Security Context Async</h2>
<p><a class="anchor" id="amgrpb16b4b983aa75b89756e8c9a5c7cb3b3"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#gab9839402fbd6f43027e78bc220ebec62">globus_gss_assist_init_sec_context_async</a> (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)
</ul>
<h2>Will Handle Restrictions</h2>
<p><a class="anchor" id="amgrpb938054f1d2ee8878ef91154074f2c6c"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#gae685a612319e645b788ea25ea9087879">globus_gss_assist_will_handle_restrictions</a> (OM_uint32 *minor_status, gss_ctx_id_t *context_handle)
</ul>
<h2>Get Unwrap</h2>
<p><a class="anchor" id="amgrpbf538d41ada7d9a31ddeaf75b2defb83"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#gad7bf365bb646fed30b50f74773271c06">globus_gss_assist_get_unwrap</a> (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)
</ul>
<h2>Wrap</h2>
<p><a class="anchor" id="amgrpa212b19ef5f2fb30acf92e6cbccc1f2d"></a> </p>
<ul>
<li>OM_uint32 <a class="el" href="group__globus__gsi__gss__assist.html#gac60f4966ae13e3e9bc8188ce4aef40f9">globus_gss_assist_wrap_send</a> (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)
</ul>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Utility functions for GSSAPI. </p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="gaec4343ae029aad696c125f311a54d380"></a><!-- doxytag: member="globus_gss_assist.h::GlobusGssAssistFreeDNArray" ref="gaec4343ae029aad696c125f311a54d380" args="(dn_a)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define GlobusGssAssistFreeDNArray</td>
<td>(</td>
<td class="paramtype">dn_a </td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Free array of distinguished names. </p>
<p>Free the contents of a name array created during a successful call to <a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3" title="Look up all Grid IDs associated with a local user ID.">globus_gss_assist_lookup_all_globusid()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dn_a</em> </td><td>Array of names to free.</td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>void</em> </td><td></td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga01e75ed381ee5a89e6e19c4c12117d73"></a><!-- doxytag: member="accept.c::globus_gss_assist_accept_sec_context" ref="ga01e75ed381ee5a89e6e19c4c12117d73" args="(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, int *token_status, gss_cred_id_t *delegated_cred_handle, int(*gss_assist_get_token)(void *, void **, size_t *), void *gss_assist_get_context, int(*gss_assist_send_token)(void *, void *, size_t), void *gss_assist_send_context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_accept_sec_context </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_cred_id_t </td>
<td class="paramname"> <em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>src_name_char</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>ret_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>user_to_user_flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>token_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_id_t * </td>
<td class="paramname"> <em>delegated_cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void **, size_t *) </td>
<td class="paramname"> <em>gss_assist_get_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_get_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void *, size_t) </td>
<td class="paramname"> <em>gss_assist_send_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_send_context</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This routine accepts a GSSAPI security context and is called by the gram_gatekeeper. </p>
<p>It isolates the GSSAPI from the rest of the gram code.</p>
<p>Initialize a gssapi security connection. Used by the server. The context_handle is returned, and there is one for each connection. This routine will take cake of the looping and token processing, using the supplied get_token and send_token routines.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>gssapi return code </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>pointer to returned context. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cred_handle</em> </td><td>the cred handle obtained by acquire_cred. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src_name_char</em> </td><td>Pointer to char string repersentation of the client which contacted the server. Maybe NULL if not wanted. Should be freed when done. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ret_flags</em> </td><td>Pointer to which services are available after the connection is established. Maybe NULL if not wanted. We will also use this to pass in flags to the globus version of gssapi_ssleay </td></tr>
<tr><td valign="top"></td><td valign="top"><em>user_to_user_flag</em> </td><td>Pointer to flag to be set if the src_name is the same as our name. (Follwing are particular to this assist routine) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>assist routine get/send token status </td></tr>
<tr><td valign="top"></td><td valign="top"><em>delegated_cred_handle</em> </td><td>pointer to be set to the credential delegated by the client if delegation occurs during the security handshake </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_token</em> </td><td>a get token routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_context</em> </td><td>first arg for the get token routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_token</em> </td><td>a send token routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_context</em> </td><td>first arg for the send token routine </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on sucess Other gss errors on failure. </dd></dl>
</div>
</div>
<a class="anchor" id="ga5e1eef554700030ed889b3b594eab4cc"></a><!-- doxytag: member="accept.c::globus_gss_assist_accept_sec_context_async" ref="ga5e1eef554700030ed889b3b594eab4cc" args="(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)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_accept_sec_context_async </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_cred_id_t </td>
<td class="paramname"> <em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>src_name_char</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>ret_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>user_to_user_flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>input_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>input_buffer_len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void ** </td>
<td class="paramname"> <em>output_bufferp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t * </td>
<td class="paramname"> <em>output_buffer_lenp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_id_t * </td>
<td class="paramname"> <em>delegated_cred_handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This is a asynchronous version of the <a class="el" href="group__globus__gsi__gss__assist.html#ga01e75ed381ee5a89e6e19c4c12117d73" title="This routine accepts a GSSAPI security context and is called by the gram_gatekeeper...">globus_gss_assist_accept_sec_context()</a> function. </p>
<p>Instead of looping itself it passes in and out the read and written buffers and the calling application is responsible for doing the I/O directly.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>gssapi return code </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>pointer to returned context. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cred_handle</em> </td><td>the cred handle obtained by acquire_cred. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src_name_char</em> </td><td>Pointer to char string repersentation of the client which contacted the server. Maybe NULL if not wanted. Should be freed when done. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ret_flags</em> </td><td>Pointer to which services are available after the connection is established. Maybe NULL if not wanted. We will also use this to pass in flags to the globus version of gssapi_ssleay </td></tr>
<tr><td valign="top"></td><td valign="top"><em>user_to_user_flag</em> </td><td>Pointer to flag to be set if the src_name is the same as our name. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>input_buffer</em> </td><td>pointer to a buffer received from peer. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>input_buffer_len</em> </td><td>length of the buffer input_buffer. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>output_bufferp</em> </td><td>pointer to a pointer which will be filled in with a pointer to a allocated block of memory. If non-NULL the contents of this block should be written to the peer where they will be fed into the gss_assist_init_sec_context_async() function. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>output_buffer_lenp</em> </td><td>pointer to an integer which will be filled in with the length of the allocated output buffer pointed to by *output_bufferp. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>delegated_cred_handle</em> </td><td>pointer to be set to the credential delegated by the client if delegation occurs during the security handshake</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on successful completion when this function does not need to be called again.</dd></dl>
<p>GSS_S_CONTINUE_NEEDED when *output_bufferp should be sent to the peer and a new input_buffer read and this function called again.</p>
<p>Other gss errors on failure. </p>
</div>
</div>
<a class="anchor" id="ga47713e99f1d1429ac3212dbc3e4854a8"></a><!-- doxytag: member="acquire.c::globus_gss_assist_acquire_cred" ref="ga47713e99f1d1429ac3212dbc3e4854a8" args="(OM_uint32 *minor_status, gss_cred_usage_t cred_usage, gss_cred_id_t *output_cred_handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_acquire_cred </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_usage_t </td>
<td class="paramname"> <em>cred_usage</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_id_t * </td>
<td class="paramname"> <em>output_cred_handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called once at the start of the process, to obtain the credentials the process is running under. </p>
<p>The</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>pointer for return code </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cred_usage</em> </td><td>GSS_C_INITIATE, GSS_C_ACCEPT, or GSS_C_BOTH </td></tr>
<tr><td valign="top"></td><td valign="top"><em>output_cred_handle</em> </td><td>Pointer to the returned handle. This needs to be passed to many gss routines.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on sucess Other GSS return codes </dd></dl>
</div>
</div>
<a class="anchor" id="ga9d527b8e3ab9459a0a9c95a0fc7ca057"></a><!-- doxytag: member="acquire.c::globus_gss_assist_acquire_cred_ext" ref="ga9d527b8e3ab9459a0a9c95a0fc7ca057" args="(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)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_acquire_cred_ext </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>desired_name_char</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>time_req</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID_set </td>
<td class="paramname"> <em>desired_mechs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_usage_t </td>
<td class="paramname"> <em>cred_usage</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_id_t * </td>
<td class="paramname"> <em>output_cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_OID_set * </td>
<td class="paramname"> <em>actual_mechs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>time_rec</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called once at the start of the process, to obtain the credentials the process is running under. </p>
<p>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.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on sucess Other GSS return codes</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>globus_gsi_gss_acquire_cred </dd></dl>
</div>
</div>
<a class="anchor" id="ga56720113a3aa7c40f4da81e71cb13190"></a><!-- doxytag: member="display.c::globus_gss_assist_display_status" ref="ga56720113a3aa7c40f4da81e71cb13190" args="(FILE *fp, char *comment, OM_uint32 major_status, OM_uint32 minor_status, int token_status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_display_status </td>
<td>(</td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>fp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>comment</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>major_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>token_status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Display the messages for the major and minor status on the file pointed at by fp. </p>
<p>Takes care of the overloaded major_status if there was a problem with the get_token or send_token routines.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fp</em> </td><td>a file pointer </td></tr>
<tr><td valign="top"></td><td valign="top"><em>comment</em> </td><td>String to print out before other error messages. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>major_status</em> </td><td>The major status to display </td></tr>
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>The minor status to display </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>token status to display </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>0 </dd></dl>
</div>
</div>
<a class="anchor" id="ga6a64e15ba5f89d8d8cd4b501bc07de7c"></a><!-- doxytag: member="display.c::globus_gss_assist_display_status_str" ref="ga6a64e15ba5f89d8d8cd4b501bc07de7c" args="(char **str, char *comment, OM_uint32 major_status, OM_uint32 minor_status, int token_status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_display_status_str </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>comment</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>major_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>token_status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Display the messages for the major and minor status and return a string with the messages. </p>
<p>Takes care of the overloaded major_status if there was a problem with the get_token or send_token routines.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>pointer to char * for returned string. Must be freed </td></tr>
<tr><td valign="top"></td><td valign="top"><em>comment</em> </td><td>String to print out before other error messages. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>major_status</em> </td><td>The major status to display </td></tr>
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>The minor status to display </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>token status to display </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>0 </dd></dl>
</div>
</div>
<a class="anchor" id="ga8cb7da6808b720b5185d67d858e78fec"></a><!-- doxytag: member="gridmap.c::globus_gss_assist_gridmap" ref="ga8cb7da6808b720b5185d67d858e78fec" args="(char *globusidp, char **useridp)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int globus_gss_assist_gridmap </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>globusidp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>useridp</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Look up the default mapping for a Grid identity in a gridmap file. </p>
<p>The <a class="el" href="group__globus__gsi__gss__assist.html#ga8cb7da6808b720b5185d67d858e78fec" title="Look up the default mapping for a Grid identity in a gridmap file.">globus_gss_assist_gridmap()</a> function parses the default gridmap file and modifies its <em>useridp</em> parameter to point to a copy of the string containing the default local identity that the grid identity is mapped to. If successful, the caller is responsible for freeing the string pointed to by <em>useridp</em>.</p>
<p>By default, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga8cb7da6808b720b5185d67d858e78fec" title="Look up the default mapping for a Grid identity in a gridmap file.">globus_gss_assist_gridmap()</a></em> looks for the default gridmap file defined by the value of the GRIDMAP environment variable. If that is not set, it falls back to $HOME/.gridmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>globusidp</em> </td><td>The GSSAPI name string of the identity who requested authorization </td></tr>
<tr><td valign="top"></td><td valign="top"><em>useridp</em> </td><td>A pointer to a string to be set to the default user ID for the local system. No validation is done to check that such a user exists.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>On success, <a class="el" href="group__globus__gsi__gss__assist.html#ga8cb7da6808b720b5185d67d858e78fec" title="Look up the default mapping for a Grid identity in a gridmap file.">globus_gss_assist_gridmap()</a> returns 0 and modifies the the string pointed to by the <em>useridp</em> parameter. If an error occurs, a non-zero value is returned and the value pointed to by <em>useridp</em> is undefined.</dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_SUCCESS</em> </td><td>Success </td></tr>
<tr><td valign="top"></td><td valign="top"><em>1</em> </td><td>Error </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6bfda92b7cb95813557688b7bdc8cea7"></a><!-- doxytag: member="gridmap.c::globus_gss_assist_userok" ref="ga6bfda92b7cb95813557688b7bdc8cea7" args="(char *globusid, char *userid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int globus_gss_assist_userok </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>globusid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>userid</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gridmap entry existence check. </p>
<p>The <em><a class="el" href="group__globus__gsi__gss__assist.html#ga6bfda92b7cb95813557688b7bdc8cea7" title="Gridmap entry existence check.">globus_gss_assist_userok()</a></em> function parses the default gridmap file and checks whether any mapping exists for the grid identity passed as the <em>globusid</em> parameter and the local user identity passed as the @ userid parameter.</p>
<p>By default, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga6bfda92b7cb95813557688b7bdc8cea7" title="Gridmap entry existence check.">globus_gss_assist_userok()</a></em> looks for the default gridmap file defined by the value of the GRIDMAP environment variable. If that is not set, it falls back to $HOME/.gridmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>globusid</em> </td><td>The GSSAPI name string of the identity who requested authorization </td></tr>
<tr><td valign="top"></td><td valign="top"><em>userid</em> </td><td>The local account name that access is sought for.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>If <em><a class="el" href="group__globus__gsi__gss__assist.html#ga6bfda92b7cb95813557688b7bdc8cea7" title="Gridmap entry existence check.">globus_gss_assist_userok()</a></em> is able to find a mapping between <em>globusid</em> and <em>userid</em>, it returns 0; otherwise it returns 1.</dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_SUCCESS</em> </td><td>Success </td></tr>
<tr><td valign="top"></td><td valign="top"><em>1</em> </td><td>Error </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5e73fcdc1c36dde30c06721f80e9250e"></a><!-- doxytag: member="gridmap.c::globus_gss_assist_map_local_user" ref="ga5e73fcdc1c36dde30c06721f80e9250e" args="(char *local_user, char **globusidp)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int globus_gss_assist_map_local_user </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>local_user</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>globusidp</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Look up the default Grid identity associated with a local user name. </p>
<p>The <em><a class="el" href="group__globus__gsi__gss__assist.html#ga5e73fcdc1c36dde30c06721f80e9250e" title="Look up the default Grid identity associated with a local user name.">globus_gss_assist_map_local_user()</a></em> function parses the gridmap file to determine a if the user name passed as the <em>local_user</em> parameter is the default local user for a Grid ID in the gridmap file. If so, it modifies <em>globusidp</em> to point to a copy of that ID. Otherwise, it searches the gridmap file for a Grid ID that has a non-default mapping for <em>local_user</em> and modifies <em>globusidp</em> to point to a copy of that ID. If successful, the caller is responsible for freeing the string pointed to by the <em>globusidp</em> pointer.</p>
<p>By default, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga5e73fcdc1c36dde30c06721f80e9250e" title="Look up the default Grid identity associated with a local user name.">globus_gss_assist_map_local_user()</a></em> looks for the default gridmap file defined by the value of the GRIDMAP environment variable. If that is not set, it falls back to $HOME/.gridmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>local_user</em> </td><td>The local username to find a Grid ID for </td></tr>
<tr><td valign="top"></td><td valign="top"><em>globusidp</em> </td><td>A Grid ID that maps from the local_user.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>On success, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga5e73fcdc1c36dde30c06721f80e9250e" title="Look up the default Grid identity associated with a local user name.">globus_gss_assist_map_local_user()</a></em> returns 0 and modifies <em>globusidp</em> to point to a Grid ID that maps to <em>local_user</em>; otherwise, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga5e73fcdc1c36dde30c06721f80e9250e" title="Look up the default Grid identity associated with a local user name.">globus_gss_assist_map_local_user()</a></em> returns 1 and the value pointed to by <em>globusidp</em> is undefined.</dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_SUCCESS</em> </td><td>Success </td></tr>
<tr><td valign="top"></td><td valign="top"><em>1</em> </td><td>Error </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacbc4240d6e2722a82785ed74b718f4d3"></a><!-- doxytag: member="gridmap.c::globus_gss_assist_lookup_all_globusid" ref="gacbc4240d6e2722a82785ed74b718f4d3" args="(char *username, char **dns[], int *dn_count)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gss_assist_lookup_all_globusid </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>username</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>dns</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>dn_count</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Look up all Grid IDs associated with a local user ID. </p>
<p>The <em><a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3" title="Look up all Grid IDs associated with a local user ID.">globus_gss_assist_lookup_all_globusid()</a></em> function parses a gridmap file and finds all Grid IDs that map to a local user ID. The <em>dns</em> parameter is modified to point to an array of Grid ID strings from the gridmap file, and the <em>dn_count</em> parameter is modified to point to the number of Grid ID strings in the array. The caller is responsible for freeing the array using the macro <em><a class="el" href="group__globus__gsi__gss__assist.html#gaec4343ae029aad696c125f311a54d380" title="Free array of distinguished names.">GlobusGssAssistFreeDNArray()</a></em>.</p>
<p>By default, <em><a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3" title="Look up all Grid IDs associated with a local user ID.">globus_gss_assist_lookup_all_globusid()</a></em> looks for the default gridmap file defined by the value of the GRIDMAP environment variable. If that is not set, it falls back to $HOME/.gridmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>username</em> </td><td>The local username to look up in the gridmap file. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dns</em> </td><td>A pointer to an array of strings. This function modifies this to point to a newly allocated array of strings. The caller must use the macro <em><a class="el" href="group__globus__gsi__gss__assist.html#gaec4343ae029aad696c125f311a54d380" title="Free array of distinguished names.">GlobusGssAssistFreeDNArray()</a></em> to free this memory. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dn_count</em> </td><td>A pointer to an integer that is modified to contain the number of entries in the array returned via the <em>dns</em> parameter.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>On success, <em><a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3" title="Look up all Grid IDs associated with a local user ID.">globus_gss_assist_lookup_all_globusid()</a></em> returns GLOBUS_SUCCESS and modifies its <em>dns</em> and <em>dn_count</em> parameters as described above. If an error occurs, <em><a class="el" href="group__globus__gsi__gss__assist.html#gacbc4240d6e2722a82785ed74b718f4d3" title="Look up all Grid IDs associated with a local user ID.">globus_gss_assist_lookup_all_globusid()</a></em> returns a globus_result_t that can be resolved to an error object and the values pointed to by <em>dns</em> and <em>dn_count</em> are undefined.</dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_SUCCESS</em> </td><td>Success </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_ERROR_WITH_ARGUMENTS</em> </td><td>Error with arguments </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_ERROR_WITH_GRIDMAP</em> </td><td>Invalid path to gridmap </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_ERROR_ERRNO</em> </td><td>System error </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4bbf706fc204783494ae6f1a29abac61"></a><!-- doxytag: member="gridmap.c::globus_gss_assist_map_and_authorize" ref="ga4bbf706fc204783494ae6f1a29abac61" args="(gss_ctx_id_t context, char *service, char *desired_identity, char *identity_buffer, unsigned int identity_buffer_length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gss_assist_map_and_authorize </td>
<td>(</td>
<td class="paramtype">gss_ctx_id_t </td>
<td class="paramname"> <em>context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>service</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>desired_identity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>identity_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"> <em>identity_buffer_length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Authorize the peer of a security context to use a service. </p>
<p>The <a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61" title="Authorize the peer of a security context to use a service.">globus_gss_assist_map_and_authorize()</a> function attempts to authorize the peer of a security context to use a particular service. If the <em>desired_identity</em> parameter is non-NULL, the authorization will succeed only if the peer is authorized for that identity. Otherwise, any valid authorized local user name will be used. If authorized, the local user name will be copied to the string pointed to by the <em>identity_buffer</em> parameter, which must be at least as long as the value passed as the <em>identity_buffer_length</em> parameter.</p>
<p>If authorization callouts are defined in the callout configuration file, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61" title="Authorize the peer of a security context to use a service.">globus_gss_assist_map_and_authorize()</a></em> will invoke both the GLOBUS_GENERIC_MAPPING_TYPE callout and the GLOBUS_GENERIC_AUTHZ_TYPE callout; otherwise the default gridmap file will be used for mapping and no service-specific authorization will be done.</p>
<p>If <em><a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61" title="Authorize the peer of a security context to use a service.">globus_gss_assist_map_and_authorize()</a></em> uses a gridmap file, it first looks for a file defined by the value of the GRIDMAP environment variable. If that is not set, it falls back to $HOME/.gridmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>Security context to inspect for peer identity information. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>service</em> </td><td>A NULL-terminated string containing the name of the service that an authorization decision is being made for. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>desired_identity</em> </td><td>Optional. If non-NULL, perform an authorization to act as the local user named by this NULL-terminated string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>identity_buffer</em> </td><td>A pointer to a string buffer into which will be copied the local user name that the peer of the context is authorized to act as. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>identity_buffer_length</em> </td><td>Length of the <em>identity_buffer</em> array.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>On success, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61" title="Authorize the peer of a security context to use a service.">globus_gss_assist_map_and_authorize()</a></em> returns GLOBUS_SUCCESS and copies the authorized local identity to the <em>identity_buffer</em> parameter. If an error occurs, <em><a class="el" href="group__globus__gsi__gss__assist.html#ga4bbf706fc204783494ae6f1a29abac61" title="Authorize the peer of a security context to use a service.">globus_gss_assist_map_and_authorize()</a></em> returns a globus_result_t that can be resolved to an error object.</dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_SUCCESS</em> </td><td>Success </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_ERROR_WITH_CALLOUT_CONFIG</em> </td><td>Invalid authorization configuration file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_CALLOUT_ERROR_WITH_HASHTABLE</em> </td><td>Hash table operation failed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_CALLOUT_ERROR_CALLOUT_ERROR</em> </td><td>The callout itself returned a error. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_CALLOUT_ERROR_WITH_DL</em> </td><td>Dynamic library operation failed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_CALLOUT_ERROR_OUT_OF_MEMORY</em> </td><td>Out of memory </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_GSSAPI_ERROR</em> </td><td>A GSSAPI function returned an error </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_GRIDMAP_LOOKUP_FAILED</em> </td><td>Gridmap lookup failure </td></tr>
<tr><td valign="top"></td><td valign="top"><em>GLOBUS_GSI_GSS_ASSIST_BUFFER_TOO_SMALL</em> </td><td>Caller provided insufficient buffer space for local identity </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga50b5708435757bdf8d4fd45d56cc37b0"></a><!-- doxytag: member="hostname.c::globus_gss_assist_authorization_host_name" ref="ga50b5708435757bdf8d4fd45d56cc37b0" args="(char *hostname, gss_name_t *authorization_hostname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gss_assist_authorization_host_name </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>hostname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_name_t * </td>
<td class="paramname"> <em>authorization_hostname</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create a GSS Name structure from the given hostname. </p>
<p>This function tries to resolve the given host name string to the canonical DNS name for the host.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>hostname</em> </td><td>The host name or numerical address to be resolved and transform into a GSS Name </td></tr>
<tr><td valign="top"></td><td valign="top"><em>authorization_hostname</em> </td><td>The resulting GSS Name</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS on successful completion, a error object otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="ga7f81c21b7208321ba527b13e1a83e9c9"></a><!-- doxytag: member="import_sec_context.c::globus_gss_assist_import_sec_context" ref="ga7f81c21b7208321ba527b13e1a83e9c9" args="(OM_uint32 *minor_status, gss_ctx_id_t *context_handle, int *token_status, int fdp, FILE *fperr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_import_sec_context </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>token_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>fdp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>fperr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Import the security context from a file. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>GSSAPI return code. This is a Globus Error code (or GLOBUS_SUCCESS) cast to a OM_uint32 pointer. If an erro has occurred, the resulting error (from calling globus_error_get on this variable) needs to be freed by the caller </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>The imported context </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>Errors that occurred while reading from the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fdp</em> </td><td>the file descriptor pointing to a file containing the security context </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fperr</em> </td><td>FILE * to write error messages</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the major status </dd></dl>
</div>
</div>
<a class="anchor" id="gab903ee3c21ece07d455a0cc56def425f"></a><!-- doxytag: member="init.c::globus_gss_assist_init_sec_context" ref="gab903ee3c21ece07d455a0cc56def425f" args="(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, int *token_status, int(*gss_assist_get_token)(void *, void **, size_t *), void *gss_assist_get_context, int(*gss_assist_send_token)(void *, void *, size_t), void *gss_assist_send_context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_init_sec_context </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_cred_id_t </td>
<td class="paramname"> <em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>target_name_char</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>req_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>ret_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>token_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void **, size_t *) </td>
<td class="paramname"> <em>gss_assist_get_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_get_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void *, size_t) </td>
<td class="paramname"> <em>gss_assist_send_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_send_context</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialize a gssapi security connection. </p>
<p>Used by the client. The context_handle is returned, and there is one for each connection. This routine will take cake of the looping and token processing, using the supplied get_token and send_token routines.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>GSSAPI return code. The new minor_status is a globus_result_t cast to an OM_uint32. If the call was successful, the minor status is equivalant to GLOBUS_SUCCESS. Otherwise, it is a globus error object ID that can be passed to globus_error_get to get the error object. The error object needs to be freed with globus_object_free. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cred_handle</em> </td><td>the cred handle obtained by acquire_cred. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>pointer to returned context. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>target_name_char</em> </td><td>char string repersentation of the server to be contacted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>req_flags</em> </td><td>request flags, such as GSS_C_DELEG_FLAG for delegation and the GSS_C_MUTUAL_FLAG for mutual authentication. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ret_flags</em> </td><td>Pointer to which services are available after the connection is established. Maybe NULL if not wanted.</td></tr>
</table>
</dd>
</dl>
<p>The Follwing are particular to this assist routine:</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>the assist routine's get/send token status </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_token</em> </td><td>function pointer for getting the token </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_context</em> </td><td>first argument passed to the gss_assist_get_token function </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_token</em> </td><td>function pointer for setting the token </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_context</em> </td><td>first argument passed to the gss_assist_set_token function pointer</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The major status </dd></dl>
</div>
</div>
<a class="anchor" id="gab9839402fbd6f43027e78bc220ebec62"></a><!-- doxytag: member="init.c::globus_gss_assist_init_sec_context_async" ref="gab9839402fbd6f43027e78bc220ebec62" args="(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)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_init_sec_context_async </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_cred_id_t </td>
<td class="paramname"> <em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>target_name_char</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"> <em>req_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>ret_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>input_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>input_buffer_len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void ** </td>
<td class="paramname"> <em>output_bufferp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t * </td>
<td class="paramname"> <em>output_buffer_lenp</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This is a asynchronous version of the <a class="el" href="group__globus__gsi__gss__assist.html#gab903ee3c21ece07d455a0cc56def425f" title="Initialize a gssapi security connection.">globus_gss_assist_init_sec_context()</a> function. </p>
<p>Instead of looping itself it passes in and out the read and written buffers and the calling application is responsible for doing the I/O directly.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>GSSAPI return code. The new minor status is a globus_result_t cast to a OM_uint32. If an error occurred (GSS_ERROR(major_status)) the minor_status is a globus error object id. The error object can be obtained via globus_error_get and should be destroyed with globus_object_free when no longer needed. If no error occurred, the minor status is equal to GLOBUS_SUCCESS. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cred_handle</em> </td><td>the cred handle obtained by acquire_cred. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>pointer to returned context. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>target_name_char</em> </td><td>char string repersentation of the server to be contacted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>req_flags</em> </td><td>request flags, such as GSS_C_DELEG_FLAG for delegation and the GSS_C_MUTUAL_FLAG for mutual authentication. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ret_flags</em> </td><td>Pointer to which services are available after the connection is established. Maybe NULL if not wanted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>input_buffer</em> </td><td>pointer to a buffer received from peer. Should be NULL on first call. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>input_buffer_len</em> </td><td>length of the buffer input_buffer. Should be zero on first call. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>output_bufferp</em> </td><td>pointer to a pointer which will be filled in with a pointer to a allocated block of memory. If non-NULL the contents of this block should be written to the peer where they will be fed into the gss_assist_init_sec_context_async() function. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>output_buffer_lenp</em> </td><td>pointer to an integer which will be filled in with the length of the allocated output buffer pointed to by *output_bufferp. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on successful completion when this function does not need to be called again.</dd></dl>
<p>GSS_S_CONTINUE_NEEDED when *output_bufferp should be sent to the peer and a new input_buffer read and this function called again.</p>
<p>Other gss errors on failure. </p>
</div>
</div>
<a class="anchor" id="gae685a612319e645b788ea25ea9087879"></a><!-- doxytag: member="set_sec_context_opts.c::globus_gss_assist_will_handle_restrictions" ref="gae685a612319e645b788ea25ea9087879" args="(OM_uint32 *minor_status, gss_ctx_id_t *context_handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_will_handle_restrictions </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"> <em>context_handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the context to handle restrictions. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>the resulting minor status from setting the context handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>the context handle to set the minor status of</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the major status from setting the context </dd></dl>
</div>
</div>
<a class="anchor" id="gad7bf365bb646fed30b50f74773271c06"></a><!-- doxytag: member="unwrap.c::globus_gss_assist_get_unwrap" ref="gad7bf365bb646fed30b50f74773271c06" args="(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)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_get_unwrap </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_ctx_id_t </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"> <em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t * </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>token_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void **, size_t *) </td>
<td class="paramname"> <em>gss_assist_get_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_get_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>fperr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets a token using the specific tokenizing functions, and performs the GSS unwrap of that token. </p>
<dl class="see"><dt><b>See also:</b></dt><dd>gss_unwrap</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>GSSAPI return code, </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>gss_unwrap </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>the context </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>pointer to be set to the unwrapped application data. This must be freed by the caller. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>pointer to be set to the length of the <em>data</em> byte array. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>assist routine get/send token status </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_token</em> </td><td>a detokenizing routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_get_context</em> </td><td>first arg for above routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fperr</em> </td><td>error stream to print to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on sucess Other gss errors on failure. </dd></dl>
</div>
</div>
<a class="anchor" id="gac60f4966ae13e3e9bc8188ce4aef40f9"></a><!-- doxytag: member="wrap.c::globus_gss_assist_wrap_send" ref="gac60f4966ae13e3e9bc8188ce4aef40f9" args="(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)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">OM_uint32 globus_gss_assist_wrap_send </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"> <em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_ctx_id_t </td>
<td class="paramname"> <em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>token_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int(*)(void *, void *, size_t) </td>
<td class="paramname"> <em>gss_assist_send_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>gss_assist_send_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>fperr</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>minor_status</em> </td><td>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. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>context_handle</em> </td><td>the context. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>pointer to application data to wrap and send </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>length of the <em>data</em> array </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_status</em> </td><td>assist routine get/send token status </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_token</em> </td><td>a send_token routine </td></tr>
<tr><td valign="top"></td><td valign="top"><em>gss_assist_send_context</em> </td><td>first arg for the send_token </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fperr</em> </td><td>file handle to write error message to.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GSS_S_COMPLETE on sucess Other gss errors on failure.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>gss_wrap() </dd></dl>
</div>
</div>
</div>
<hr>
<p align="center">
<a href="http://www.globus.org/toolkit/about.html" target="_top">about globus</a> |
<a href="http://www.globus.org/toolkit/" target="_top">globus toolkit</a> |
<a href="https://dev.globus.org/wiki/Welcome/" target="_top">dev.globus</a>
<br>
<br>
Comments? <a href="mailto:webmaster@globus.org">webmaster@globus.org</a>
</body>
</html>
