Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 408d955294ed7b2b439ee2b2a9e349da > files > 26

globus-gsi-proxy-core-doc-6.2-1.fc15.noarch.rpm

<!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&#160;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__proxy__handle__attrs.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">Handle Attributes</div>  </div>
</div>
<div class="contents">

<p>Handle attributes are used to control additional features of the GSI Proxy 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_proxy_handle_attrs_s * <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>
</ul>
<h2><a name="member-group"></a>
Initialize &amp; Destroy</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga77e3a01edd1d02cb5c00c9e979e2e8c4">globus_gsi_proxy_handle_attrs_init</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> *handle_attrs)
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gaaf45533f61ee932fe0338c43c1da6df8">globus_gsi_proxy_handle_attrs_destroy</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs)
</ul>
<h2><a name="member-group"></a>
Get/Set Key Bits</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga1e08370ff82b1a7cfd8555e1bc57029e">globus_gsi_proxy_handle_attrs_set_keybits</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int bits)
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga53d71ae813f1a7495d2ea2faf30d5a67">globus_gsi_proxy_handle_attrs_get_keybits</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int *bits)
</ul>
<h2><a name="member-group"></a>
Get/Set Initial Prime Number</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gaa542c7388f0283a2f0e4c8ccae0a87d1">globus_gsi_proxy_handle_attrs_set_init_prime</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int prime)
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga16724407f3492baa9f868c904ba10f61">globus_gsi_proxy_handle_attrs_get_init_prime</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int *prime)
</ul>
<h2><a name="member-group"></a>
Get/Set Signing Algorithm</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gac8dfd4999266c17b44ab4c866165af58">globus_gsi_proxy_handle_attrs_set_signing_algorithm</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, EVP_MD *algorithm)
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gafa430519bd76fcc702465622711680d0">globus_gsi_proxy_handle_attrs_get_signing_algorithm</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, EVP_MD **algorithm)
</ul>
<h2><a name="member-group"></a>
Get/Set Clock Skew Allowable</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga2a05a62d3b5b2b0b5b5e5f71ad3680c6">globus_gsi_proxy_handle_attrs_set_clock_skew_allowable</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int skew)
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga22a79f5f70986fb767ac9de2e19b93a6">globus_gsi_proxy_handle_attrs_get_clock_skew_allowable</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, int *skew)
</ul>
<h2><a name="member-group"></a>
Get/Set Key Gen Callback</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga0158bee8f62a54ce02eba1770eda76c3">globus_gsi_proxy_handle_attrs_get_key_gen_callback</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, void(**callback)(int, int, void *))
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gaee2ecf193e1b374a4d2f9da04440b577">globus_gsi_proxy_handle_attrs_set_key_gen_callback</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> handle_attrs, void(*callback)(int, int, void *))
</ul>
<h2><a name="member-group"></a>
Copy Attributes</h2>
<ul>
<li>globus_result_t <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga06d617220c58395a4699d35e6c56c1d0">globus_gsi_proxy_handle_attrs_copy</a> (<a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> a, <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> *b)
</ul>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>Handle attributes are used to control additional features of the GSI Proxy handle. </p>
<p>These features are operation independent.</p>
<p>Currently there are no attributes.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__globus__gsi__proxy__handle.html#ga8aa60a8f880c91bae12994052ceeafc4" title="GSI Proxy Handle.">globus_gsi_proxy_handle_t</a> </dd></dl>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga66b2fcd0c7df2737bef97c2011895cc3"></a><!-- doxytag: member="globus_gsi_proxy.h::globus_gsi_proxy_handle_attrs_t" ref="ga66b2fcd0c7df2737bef97c2011895cc3" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct globus_l_gsi_proxy_handle_attrs_s* <a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Handle Attributes. </p>
<p>A GSI Proxy handle attributes type is used to associate immutable parameter values with a <a class="el" href="group__globus__gsi__proxy__handle.html">Handle Management</a> handle. A handle attributes object should be created with immutable parameters and then passed to the proxy handle init function <a class="el" href="group__globus__gsi__proxy__handle.html#ga20f041b5edcdc912cea8b8778c9d9d65" title="Initialize a GSI Proxy handle.">globus_gsi_proxy_handle_init()</a>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__globus__gsi__proxy__handle.html">Handle Management</a> </dd></dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga77e3a01edd1d02cb5c00c9e979e2e8c4"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_init" ref="ga77e3a01edd1d02cb5c00c9e979e2e8c4" args="(globus_gsi_proxy_handle_attrs_t *handle_attrs)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_init </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> *&#160;</td>
          <td class="paramname"><em>handle_attrs</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Initialize GSI Proxy Handle Attributes. </p>
<p>Initialize proxy handle attributes, which can (and should) be associated with a proxy handle. For most purposes, these attributes should primarily be used by the proxy handle.</p>
<p>Currently, no attibute values are initialized.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The handle attributes structure to be initialized </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#gaaf45533f61ee932fe0338c43c1da6df8" title="Destroy the GSI Proxy handle attributes.">globus_gsi_proxy_handle_attrs_destroy()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga1e08370ff82b1a7cfd8555e1bc57029e"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_set_keybits" ref="ga1e08370ff82b1a7cfd8555e1bc57029e" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int bits)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_set_keybits </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>bits</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set the length of the public key pair used by the proxy certificate. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>the attributes to set </td></tr>
    <tr><td class="paramname">bits</td><td>the length to set it to (usually 1024)</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>

</div>
</div>
<a class="anchor" id="gaa542c7388f0283a2f0e4c8ccae0a87d1"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_set_init_prime" ref="gaa542c7388f0283a2f0e4c8ccae0a87d1" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int prime)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_set_init_prime </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>prime</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set the initial prime number used for generating public key pairs in the RSA algorithm. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The attributes to set </td></tr>
    <tr><td class="paramname">prime</td><td>The prime number to set it to This value needs to be a prime number </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>

</div>
</div>
<a class="anchor" id="gac8dfd4999266c17b44ab4c866165af58"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_set_signing_algorithm" ref="gac8dfd4999266c17b44ab4c866165af58" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, EVP_MD *algorithm)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_set_signing_algorithm </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">EVP_MD *&#160;</td>
          <td class="paramname"><em>algorithm</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Sets the Signing Algorithm to be used to sign the certificate request. </p>
<p>In most cases, the signing party will ignore this value, and sign with an algorithm of its choice.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The proxy handle to set the signing algorithm of </td></tr>
    <tr><td class="paramname">algorithm</td><td>The signing algorithm to set </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Returns GLOBUS_SUCCESS if the handle is valid, otherwise an error object is returned. </dd></dl>

</div>
</div>
<a class="anchor" id="ga2a05a62d3b5b2b0b5b5e5f71ad3680c6"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_set_clock_skew_allowable" ref="ga2a05a62d3b5b2b0b5b5e5f71ad3680c6" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int skew)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_set_clock_skew_allowable </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>skew</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Sets the clock skew in minutes of the proxy cert request so that time differences between hosts won't cause problems. </p>
<p>This value defaults to 5 minutes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>the handle_attrs containing the clock skew to be set </td></tr>
    <tr><td class="paramname">skew</td><td>the amount to skew by (in seconds) </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if the handle_attrs is valid - otherwise an error is returned. </dd></dl>

</div>
</div>
<a class="anchor" id="ga0158bee8f62a54ce02eba1770eda76c3"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_get_key_gen_callback" ref="ga0158bee8f62a54ce02eba1770eda76c3" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, void(**callback)(int, int, void *))" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_get_key_gen_callback </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void(**)(int, int, void *)&#160;</td>
          <td class="paramname"><em>callback</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the public/private key generation callback that provides status during the generation of the keys. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The handle_attrs to get the callback from </td></tr>
    <tr><td class="paramname">callback</td><td>The callback from the handle attributes</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error is returned </dd></dl>

</div>
</div>
<a class="anchor" id="ga06d617220c58395a4699d35e6c56c1d0"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_copy" ref="ga06d617220c58395a4699d35e6c56c1d0" args="(globus_gsi_proxy_handle_attrs_t a, globus_gsi_proxy_handle_attrs_t *b)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_copy </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>a</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a> *&#160;</td>
          <td class="paramname"><em>b</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Make a copy of GSI Proxy handle attributes. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">a</td><td>The handle attributes to copy </td></tr>
    <tr><td class="paramname">b</td><td>The copy </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>

</div>
</div>
<a class="anchor" id="gaaf45533f61ee932fe0338c43c1da6df8"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_destroy" ref="gaaf45533f61ee932fe0338c43c1da6df8" args="(globus_gsi_proxy_handle_attrs_t handle_attrs)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_destroy </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Destroy the GSI Proxy handle attributes. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The handle attributes to be destroyed. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga77e3a01edd1d02cb5c00c9e979e2e8c4" title="Initialize GSI Proxy Handle Attributes.">globus_gsi_proxy_handle_attrs_init()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga53d71ae813f1a7495d2ea2faf30d5a67"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_get_keybits" ref="ga53d71ae813f1a7495d2ea2faf30d5a67" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int *bits)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_get_keybits </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&#160;</td>
          <td class="paramname"><em>bits</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Gets the length of the public key pair used by the proxy certificate. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>the attributes to get the key length from </td></tr>
    <tr><td class="paramname">bits</td><td>the length of the key pair in bits </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>

</div>
</div>
<a class="anchor" id="ga16724407f3492baa9f868c904ba10f61"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_get_init_prime" ref="ga16724407f3492baa9f868c904ba10f61" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int *prime)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_get_init_prime </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&#160;</td>
          <td class="paramname"><em>prime</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the initial prime number used for generating the public key pair in the RSA algorithm. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The attributes to get the initial prime number from </td></tr>
    <tr><td class="paramname">prime</td><td>The initial prime number taken from the attributes </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS </dd></dl>

</div>
</div>
<a class="anchor" id="gafa430519bd76fcc702465622711680d0"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_get_signing_algorithm" ref="gafa430519bd76fcc702465622711680d0" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, EVP_MD **algorithm)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_get_signing_algorithm </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">EVP_MD **&#160;</td>
          <td class="paramname"><em>algorithm</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Gets the Signing Algorithm to used to sign the certificate request. </p>
<p>In most cases, the signing party will ignore this value, and sign with an algorithm of its choice.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The proxy handle_attrs to get the signing algorithm of </td></tr>
    <tr><td class="paramname">algorithm</td><td>Parameter used to return the signing algorithm used </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Returns GLOBUS_SUCCESS if the handle is valid, otherwise an error object is returned. </dd></dl>

</div>
</div>
<a class="anchor" id="ga22a79f5f70986fb767ac9de2e19b93a6"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_get_clock_skew_allowable" ref="ga22a79f5f70986fb767ac9de2e19b93a6" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, int *skew)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_get_clock_skew_allowable </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&#160;</td>
          <td class="paramname"><em>skew</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the allowable clock skew for the proxy certificate. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The handle_attrs to get the clock skew from </td></tr>
    <tr><td class="paramname">skew</td><td>The allowable clock skew (in seconds) to get from the proxy certificate request. This value gets set by the function, so it needs to be a pointer. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error is returned </dd></dl>

</div>
</div>
<a class="anchor" id="gaee2ecf193e1b374a4d2f9da04440b577"></a><!-- doxytag: member="globus_gsi_proxy_handle_attrs.c::globus_gsi_proxy_handle_attrs_set_key_gen_callback" ref="gaee2ecf193e1b374a4d2f9da04440b577" args="(globus_gsi_proxy_handle_attrs_t handle_attrs, void(*callback)(int, int, void *))" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">globus_result_t globus_gsi_proxy_handle_attrs_set_key_gen_callback </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__globus__gsi__proxy__handle__attrs.html#ga66b2fcd0c7df2737bef97c2011895cc3">globus_gsi_proxy_handle_attrs_t</a>&#160;</td>
          <td class="paramname"><em>handle_attrs</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void(*)(int, int, void *)&#160;</td>
          <td class="paramname"><em>callback</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set the public/private key generation callback that provides status during the generation of the keys. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">handle_attrs</td><td>The handle_attrs to get the callback from </td></tr>
    <tr><td class="paramname">callback</td><td>The callback from the handle attributes</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>GLOBUS_SUCCESS if the handle_attrs is valid, otherwise an error 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>