<!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.7.4 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('group__globus__gsi__cred__handle.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#typedef-members">Typedefs</a> </div>
<div class="headertitle">
<div class="title">Credential Handle Management</div> </div>
</div>
<div class="contents">
<p>Create/Destroy/Modify a GSI Credential Handle.
<a href="#details">More...</a></p>
<h2><a name="typedef-members"></a>
Typedefs</h2>
<ul>
<li>typedef struct <br class="typebreak"/>
globus_l_gsi_cred_handle_s * <a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a>
</ul>
<h2><a name="member-group"></a>
Initializing and Destroying a Handle</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gab1f6da81b0a8ea3dcac07f6a3ecf03ff">globus_gsi_cred_handle_init</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> *handle, <a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233">globus_gsi_cred_handle_attrs_t</a> handle_attrs)
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga54f4779760d1a250b6b7c3a096745ef3">globus_gsi_cred_handle_destroy</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle)
</ul>
<h2><a name="member-group"></a>
Copying a Handle</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gaadefe7ae63a4362c4d70c8fbeae14b15">globus_gsi_cred_handle_copy</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> source, <a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> *dest)
</ul>
<h2><a name="member-group"></a>
Getting the Handle Attributes</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga5be66c03dc5070ccd78f1690fa4f7771">globus_gsi_cred_get_handle_attrs</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, <a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233">globus_gsi_cred_handle_attrs_t</a> *attrs)
</ul>
<h2><a name="member-group"></a>
Getting the Credential Expiration</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga8e4d8219b660f0abcb438a250bdad57e">globus_gsi_cred_get_goodtill</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> cred_handle, time_t *goodtill)
</ul>
<h2><a name="member-group"></a>
Getting the Credential Lifetime</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga0c59fed47bd07a565e90273d7eb4c455">globus_gsi_cred_get_lifetime</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> cred_handle, time_t *lifetime)
</ul>
<h2><a name="member-group"></a>
Getting the Credential Strength</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gac9b66c1ff4e769eeb3e6ce3466146687">globus_gsi_cred_get_key_bits</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> cred_handle, int *key_bits)
</ul>
<h2><a name="member-group"></a>
Setting and Getting the Certificate</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga68766ec921383359f195ddc9684f3d81">globus_gsi_cred_set_cert</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, X509 *cert)
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga7ad9d62b3317179cb319b6b3a5e5c4a6">globus_gsi_cred_get_cert</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, X509 **cert)
</ul>
<h2><a name="member-group"></a>
Setting and Getting the Credential Key</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gaa29a5d75193246a1af3ac77666565878">globus_gsi_cred_set_key</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, EVP_PKEY *key)
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gaa2cf6dc76558878dadfe370520dcd294">globus_gsi_cred_get_key</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, EVP_PKEY **key)
</ul>
<h2><a name="member-group"></a>
Setting and Getting the Certificate Chain</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga35288d5737157a281ad7e46844611368">globus_gsi_cred_set_cert_chain</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, STACK_OF(X509)*cert_chain)
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga5a49e847aec9e0668c6a2e7938cd134d">globus_gsi_cred_get_cert_chain</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, STACK_OF(X509)**cert_chain)
</ul>
<h2><a name="member-group"></a>
Get Cred Cert X509 Subject Name object</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga99d38deafecdd40dbff8fd0c78835a5d">globus_gsi_cred_get_X509_subject_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, X509_NAME **subject_name)
</ul>
<h2><a name="member-group"></a>
Get X509 Identity Name</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga0f2ce7c41dfcb1cc06534a438a19f667">globus_gsi_cred_get_X509_identity_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, X509_NAME **identity_name)
</ul>
<h2><a name="member-group"></a>
Get Cred Cert Subject Name</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gaeea1b66d1e89b53462038de21da67880">globus_gsi_cred_get_subject_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, char **subject_name)
</ul>
<h2><a name="member-group"></a>
Get Policies from Cert Chain</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga091ca57bff7bb8b36880f8bbaf849b96">globus_gsi_cred_get_policies</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, STACK **policies)
</ul>
<h2><a name="member-group"></a>
Get Policy Languages from Cert Chain</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga3a4d2c456e483727664b5351fc92c8cb">globus_gsi_cred_get_policy_languages</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, STACK_OF(ASN1_OBJECT)**policy_languages)
</ul>
<h2><a name="member-group"></a>
Get Cred Cert X509 Issuer Name object</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gac1a0cc543f8dbbee257ea429f952fa01">globus_gsi_cred_get_X509_issuer_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, X509_NAME **issuer_name)
</ul>
<h2><a name="member-group"></a>
Get Issuer Name</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga05faf84aa7c2b28397ebbfe85814c743">globus_gsi_cred_get_issuer_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, char **issuer_name)
</ul>
<h2><a name="member-group"></a>
Get Identity Name</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga3963689cdc49338786b0283f28b2b98a">globus_gsi_cred_get_identity_name</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle, char **identity_name)
</ul>
<h2><a name="member-group"></a>
Credential validation functions</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#ga2ec21ddce5a26607d90851573111e3ba">globus_gsi_cred_verify_cert_chain</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> cred_handle, globus_gsi_callback_data_t callback_data)
<li>globus_result_t <a class="el" href="group__globus__gsi__cred__handle.html#gad032b8b184ee2e7c3fd9ff4c810a639c">globus_gsi_cred_verify</a> (<a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> handle)
</ul>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>Create/Destroy/Modify a GSI Credential Handle. </p>
<p>Within the Globus GSI Credential Library, all credential operations require a handle parameter. Currenlty only one operation may be in progress at once per credential handle.</p>
<p>This section defines operations to create, modify and destroy GSI Credential handles. </p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gab2702f6c6cea4d59ecea6835f184477b"></a><!-- doxytag: member="globus_gsi_credential.h::globus_gsi_cred_handle_t" ref="gab2702f6c6cea4d59ecea6835f184477b" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct globus_l_gsi_cred_handle_s* <a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>GSI Credential Handle. </p>
<p>A GSI Credential handle keeps track of state relating to a credential. Handles can have immutable <a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233">attributes</a> associated with them. All credential <a class="el" href="group__globus__gsi__cred__operations.html">operations </a> take a credential handle pointer as a parameter.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__globus__gsi__cred__handle.html#gab1f6da81b0a8ea3dcac07f6a3ecf03ff" title="Initializes a credential handle to be used credential handling functions.">globus_gsi_cred_handle_init()</a>, <a class="el" href="group__globus__gsi__cred__handle.html#ga54f4779760d1a250b6b7c3a096745ef3" title="Destroys the credential handle.">globus_gsi_cred_handle_destroy()</a>, <a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233" title="Credential Handle Attributes.">globus_gsi_cred_handle_attrs_t</a> </dd></dl>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gab1f6da81b0a8ea3dcac07f6a3ecf03ff"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_handle_init" ref="gab1f6da81b0a8ea3dcac07f6a3ecf03ff" args="(globus_gsi_cred_handle_t *handle, globus_gsi_cred_handle_attrs_t handle_attrs)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_handle_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> * </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233">globus_gsi_cred_handle_attrs_t</a> </td>
<td class="paramname"><em>handle_attrs</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initializes a credential handle to be used credential handling functions. </p>
<p>Takes a set of handle attributes that are immutable to the handle. The handle attributes are only pointed to by the handle, so the lifetime of the attributes needs to be as long as that of the handle.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The handle to be initialized </td></tr>
<tr><td class="paramname">handle_attrs</td><td>The immutable attributes of the handle</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="ga54f4779760d1a250b6b7c3a096745ef3"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_handle_destroy" ref="ga54f4779760d1a250b6b7c3a096745ef3" args="(globus_gsi_cred_handle_t handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_handle_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destroys the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle to be destroyed </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>
</div>
</div>
<a class="anchor" id="gaadefe7ae63a4362c4d70c8fbeae14b15"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_handle_copy" ref="gaadefe7ae63a4362c4d70c8fbeae14b15" args="(globus_gsi_cred_handle_t source, globus_gsi_cred_handle_t *dest)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_handle_copy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>source</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> * </td>
<td class="paramname"><em>dest</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copies a credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">source</td><td>The handle to be copied </td></tr>
<tr><td class="paramname">dest</td><td>The destination of the copy</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="ga5be66c03dc5070ccd78f1690fa4f7771"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_handle_attrs" ref="ga5be66c03dc5070ccd78f1690fa4f7771" args="(globus_gsi_cred_handle_t handle, globus_gsi_cred_handle_attrs_t *attrs)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_handle_attrs </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle__attrs.html#gac3a90cdd8e00d9890f4696a4ade91233">globus_gsi_cred_handle_attrs_t</a> * </td>
<td class="paramname"><em>attrs</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function retreives a copy of the credential handle attributes. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle to retrieve the attributes from </td></tr>
<tr><td class="paramname">attrs</td><td>Contains the credential attributes on return</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="ga8e4d8219b660f0abcb438a250bdad57e"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_goodtill" ref="ga8e4d8219b660f0abcb438a250bdad57e" args="(globus_gsi_cred_handle_t cred_handle, time_t *goodtill)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_goodtill </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">time_t * </td>
<td class="paramname"><em>goodtill</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function retreives the expiration time of the credential contained in the handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">cred_handle</td><td>The credential handle to retrieve the expiration time from </td></tr>
<tr><td class="paramname">goodtill</td><td>Contains the expiration time on return</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="ga0c59fed47bd07a565e90273d7eb4c455"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_lifetime" ref="ga0c59fed47bd07a565e90273d7eb4c455" args="(globus_gsi_cred_handle_t cred_handle, time_t *lifetime)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_lifetime </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">time_t * </td>
<td class="paramname"><em>lifetime</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function retreives the lifetime of the credential contained in a handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">cred_handle</td><td>The credential handle to retrieve the lifetime from </td></tr>
<tr><td class="paramname">lifetime</td><td>Contains the lifetime on return</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="gac9b66c1ff4e769eeb3e6ce3466146687"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_key_bits" ref="gac9b66c1ff4e769eeb3e6ce3466146687" args="(globus_gsi_cred_handle_t cred_handle, int *key_bits)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_key_bits </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>key_bits</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function retreives the key strength of the credential contained in a handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">cred_handle</td><td>The credential handle to retrieve the strength from </td></tr>
<tr><td class="paramname">key_bits</td><td>Contains the number of bits in the key on return</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error captured in a globus_result_t </dd></dl>
</div>
</div>
<a class="anchor" id="ga68766ec921383359f195ddc9684f3d81"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_set_cert" ref="ga68766ec921383359f195ddc9684f3d81" args="(globus_gsi_cred_handle_t handle, X509 *cert)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_set_cert </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">X509 * </td>
<td class="paramname"><em>cert</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the Credential's Certificate. </p>
<p>The X509 cert that is passed in should be a valid X509 certificate object</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle to set the certificate on </td></tr>
<tr><td class="paramname">cert</td><td>The X509 cert to set in the cred handle. The cert passed in can be NULL which will set the cert in the handle to NULL, freeing the current cert in the handle. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error object id if an error </dd></dl>
</div>
</div>
<a class="anchor" id="ga7ad9d62b3317179cb319b6b3a5e5c4a6"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_cert" ref="ga7ad9d62b3317179cb319b6b3a5e5c4a6" args="(globus_gsi_cred_handle_t handle, X509 **cert)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_cert </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">X509 ** </td>
<td class="paramname"><em>cert</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the certificate of a credential. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle to get the certificate from </td></tr>
<tr><td class="paramname">cert</td><td>The resulting X509 certificate, a duplicate of the certificate in the credential handle. This variable should be freed when the user is finished with it using the function X509_free. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object id is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gaa29a5d75193246a1af3ac77666565878"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_set_key" ref="gaa29a5d75193246a1af3ac77666565878" args="(globus_gsi_cred_handle_t handle, EVP_PKEY *key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_set_key </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">EVP_PKEY * </td>
<td class="paramname"><em>key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the private key of the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The handle on which to set the key. </td></tr>
<tr><td class="paramname">key</td><td>The private key to set the handle's key to. This value can be NULL, in which case the current handle's key is freed. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaa2cf6dc76558878dadfe370520dcd294"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_key" ref="gaa2cf6dc76558878dadfe370520dcd294" args="(globus_gsi_cred_handle_t handle, EVP_PKEY **key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_key </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">EVP_PKEY ** </td>
<td class="paramname"><em>key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the credential handle's private key. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the private key to get </td></tr>
<tr><td class="paramname">key</td><td>The private key which after this function returns is set to a duplicate of the private key of the credential handle. This variable needs to be freed by the user when it is no longer used via the function EVP_PKEY_free.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error object identifier </dd></dl>
</div>
</div>
<a class="anchor" id="ga35288d5737157a281ad7e46844611368"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_set_cert_chain" ref="ga35288d5737157a281ad7e46844611368" args="(globus_gsi_cred_handle_t handle, STACK_OF(X509)*cert_chain)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_set_cert_chain </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">STACK_OF(X509)* </td>
<td class="paramname"><em>cert_chain</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the certificate chain of the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The handle containing the certificate chain field to set </td></tr>
<tr><td class="paramname">cert_chain</td><td>The certificate chain to set the handle's certificate chain to </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object id is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga5a49e847aec9e0668c6a2e7938cd134d"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_cert_chain" ref="ga5a49e847aec9e0668c6a2e7938cd134d" args="(globus_gsi_cred_handle_t handle, STACK_OF(X509)**cert_chain)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_cert_chain </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">STACK_OF(X509)** </td>
<td class="paramname"><em>cert_chain</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the certificate chain of the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate chain to get </td></tr>
<tr><td class="paramname">cert_chain</td><td>The certificate chain to set as a duplicate of the cert chain in the credential handle. This variable (or the variable it points to) needs to be freed when the user is finished with it using sk_X509_free. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object id is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga99d38deafecdd40dbff8fd0c78835a5d"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_X509_subject_name" ref="ga99d38deafecdd40dbff8fd0c78835a5d" args="(globus_gsi_cred_handle_t handle, X509_NAME **subject_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_X509_subject_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">X509_NAME ** </td>
<td class="paramname"><em>subject_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the credential handle's certificate subject name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the subject name of </td></tr>
<tr><td class="paramname">subject_name</td><td>The subject name as an X509_NAME object. This should be freed using X509_NAME_free when the user is finished with it </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, a error object id otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="ga0f2ce7c41dfcb1cc06534a438a19f667"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_X509_identity_name" ref="ga0f2ce7c41dfcb1cc06534a438a19f667" args="(globus_gsi_cred_handle_t handle, X509_NAME **identity_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_X509_identity_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">X509_NAME ** </td>
<td class="paramname"><em>identity_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the identity's X509 subject name from the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the identity from </td></tr>
<tr><td class="paramname">identity_name</td><td>The identity certificate's X509 subject name</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gaeea1b66d1e89b53462038de21da67880"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_subject_name" ref="gaeea1b66d1e89b53462038de21da67880" args="(globus_gsi_cred_handle_t handle, char **subject_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_subject_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>subject_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the credential handle's certificate subject name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the subject name of </td></tr>
<tr><td class="paramname">subject_name</td><td>The subject name as a string. This should be freed using free() when the user is finished with it </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, a error object id otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="ga091ca57bff7bb8b36880f8bbaf849b96"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_policies" ref="ga091ca57bff7bb8b36880f8bbaf849b96" args="(globus_gsi_cred_handle_t handle, STACK **policies)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_policies </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">STACK ** </td>
<td class="paramname"><em>policies</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the Policies from the Cert Chain in the handle. </p>
<p>The policies will be null-terminated as they are added to the handle. If a policy for a cert in the chain doesn't exist, the string in the stack will be set to the static string GLOBUS_NULL_POLICIES</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>the handle to get the cert chain containing the policies </td></tr>
<tr><td class="paramname">policies</td><td>the stack of policies retrieved from the handle's cert chain </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error object if an error occurred </dd></dl>
</div>
</div>
<a class="anchor" id="ga3a4d2c456e483727664b5351fc92c8cb"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_policy_languages" ref="ga3a4d2c456e483727664b5351fc92c8cb" args="(globus_gsi_cred_handle_t handle, STACK_OF(ASN1_OBJECT)**policy_languages)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_policy_languages </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">STACK_OF(ASN1_OBJECT)** </td>
<td class="paramname"><em>policy_languages</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the policy languages from the cert chain in the handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>the handle to get the cert chain containing the policies </td></tr>
<tr><td class="paramname">policy_languages</td><td>the stack of policies retrieved from the handle's cert chain </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS or an error object if an error occurred </dd></dl>
</div>
</div>
<a class="anchor" id="gac1a0cc543f8dbbee257ea429f952fa01"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_X509_issuer_name" ref="gac1a0cc543f8dbbee257ea429f952fa01" args="(globus_gsi_cred_handle_t handle, X509_NAME **issuer_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_X509_issuer_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">X509_NAME ** </td>
<td class="paramname"><em>issuer_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the credential handle's certificate issuer name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the issuer name of </td></tr>
<tr><td class="paramname">issuer_name</td><td>The issuer name as an X509_NAME object. This should be freed using X509_NAME_free when the user is finished with it </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, a error object id otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="ga05faf84aa7c2b28397ebbfe85814c743"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_issuer_name" ref="ga05faf84aa7c2b28397ebbfe85814c743" args="(globus_gsi_cred_handle_t handle, char **issuer_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_issuer_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>issuer_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the issuer's subject name from the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the issuer of </td></tr>
<tr><td class="paramname">issuer_name</td><td>The issuer certificate's subject name</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga3963689cdc49338786b0283f28b2b98a"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_get_identity_name" ref="ga3963689cdc49338786b0283f28b2b98a" args="(globus_gsi_cred_handle_t handle, char **identity_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_get_identity_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>identity_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the identity's subject name from the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate to get the identity of </td></tr>
<tr><td class="paramname">identity_name</td><td>The identity certificate's subject name</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga2ec21ddce5a26607d90851573111e3ba"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_verify_cert_chain" ref="ga2ec21ddce5a26607d90851573111e3ba" args="(globus_gsi_cred_handle_t cred_handle, globus_gsi_callback_data_t callback_data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_verify_cert_chain </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_gsi_callback_data_t </td>
<td class="paramname"><em>callback_data</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function performs path valiadtion on the certificate chain contained in the credential handle. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">cred_handle</td><td>The credential handle containing the certificate chain to be validated </td></tr>
<tr><td class="paramname">callback_data</td><td>A initialized callback data structure</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gad032b8b184ee2e7c3fd9ff4c810a639c"></a><!-- doxytag: member="globus_gsi_cred_handle.c::globus_gsi_cred_verify" ref="gad032b8b184ee2e7c3fd9ff4c810a639c" args="(globus_gsi_cred_handle_t handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_cred_verify </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__globus__gsi__cred__handle.html#gab2702f6c6cea4d59ecea6835f184477b">globus_gsi_cred_handle_t</a> </td>
<td class="paramname"><em>handle</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function checks that the certificate is signed by the public key of the issuer cert (the first cert in the chain). </p>
<p>Note that this function DOES NOT check the private key or the public of the certificate, as stated in a previous version of the documentation.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">handle</td><td>The credential handle containing the certificate and key to be validated</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if no error, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
</div>
</div>
<div id="nav-path" class="navpath">
<ul>
<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>
