<!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.8.1.1 -->
<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><!-- top -->
<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">
$(document).ready(function(){initNavTree('group__globus__gsi__sysconfig__win32.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">Functions for Win32 platforms</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Set Key Permissions</h2></td></tr>
<tr class="memitem:gab406d12caca14f03e8f4091f1ea8aded"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gab406d12caca14f03e8f4091f1ea8aded">globus_gsi_sysconfig_set_key_permissions_win32</a> (char *filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - File Exists</h2></td></tr>
<tr class="memitem:ga0de1a8a77f5e354fd33b51045ca77b76"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga0de1a8a77f5e354fd33b51045ca77b76">globus_gsi_sysconfig_file_exists_win32</a> (const char *filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Directory Exists</h2></td></tr>
<tr class="memitem:gadee596e751b393f4a933082d178b64c4"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gadee596e751b393f4a933082d178b64c4">globus_gsi_sysconfig_dir_exists_win32</a> (const char *filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Current Working Directory</h2></td></tr>
<tr class="memitem:ga9d463d1ef4c5c9bb9d0d3308f25730c5"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga9d463d1ef4c5c9bb9d0d3308f25730c5">globus_gsi_sysconfig_get_current_working_dir_win32</a> (char **working_dir)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Make Absolute Path</h2></td></tr>
<tr class="memitem:ga6e5899291e6da583025b079f37b0244d"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga6e5899291e6da583025b079f37b0244d">globus_gsi_sysconfig_make_absolute_path_for_filename_win32</a> (char *filename, char **absolute_path)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Split Directory and Filename</h2></td></tr>
<tr class="memitem:gac04852db1744d25b3304c99a304f1513"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gac04852db1744d25b3304c99a304f1513">globus_gsi_sysconfig_split_dir_and_filename_win32</a> (char *full_filename, char **dir_string, char **filename_string)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Trusted CA Cert Dir</h2></td></tr>
<tr class="memitem:ga659592fe01da9aa1e97974b856e76eba"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga659592fe01da9aa1e97974b856e76eba">globus_gsi_sysconfig_get_cert_dir_win32</a> (char **cert_dir)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get User Certificate Filename</h2></td></tr>
<tr class="memitem:gaaada88adba88bcb8012e5f55c458a55e"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gaaada88adba88bcb8012e5f55c458a55e">globus_gsi_sysconfig_get_user_cert_filename_win32</a> (char **user_cert, char **user_key)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Host Certificate and Key Filenames</h2></td></tr>
<tr class="memitem:gacbe95ade22d67b1eda727f66ffa566dd"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gacbe95ade22d67b1eda727f66ffa566dd">globus_gsi_sysconfig_get_host_cert_filename_win32</a> (char **host_cert, char **host_key)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Service Certificate and Key Filenames</h2></td></tr>
<tr class="memitem:gae0c8a43f59f8c0134a758a3a4e94ea9d"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gae0c8a43f59f8c0134a758a3a4e94ea9d">globus_gsi_sysconfig_get_service_cert_filename_win32</a> (char *service_name, char **service_cert, char **service_key)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Proxy Filename</h2></td></tr>
<tr class="memitem:ga6989d9c71362e212bdd39f51eac9412e"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga6989d9c71362e212bdd39f51eac9412e">globus_gsi_sysconfig_get_proxy_filename_win32</a> (char **user_proxy, <a class="el" href="group__globus__gsi__sysconfig__datatypes.html#ga94d70620ea9adb2fb5b11b4e38244f30">globus_gsi_proxy_file_type_t</a> proxy_file_type)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get CA Cert Filenames</h2></td></tr>
<tr class="memitem:ga7d17dc1d58d691774ae5c4f6785fb4ed"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga7d17dc1d58d691774ae5c4f6785fb4ed">globus_gsi_sysconfig_get_ca_cert_files_win32</a> (char *ca_cert_dir, globus_fifo_t *ca_cert_list)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Remove all proxies owned by current uid</h2></td></tr>
<tr class="memitem:ga4e211e363d8386a3682e07a9e72c1657"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga4e211e363d8386a3682e07a9e72c1657">globus_gsi_sysconfig_remove_all_owned_files_win32</a> (char *default_filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get the path and file name of the grid map file</h2></td></tr>
<tr class="memitem:ga07fcd88933991485d524f650cc7c3236"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga07fcd88933991485d524f650cc7c3236">globus_gsi_sysconfig_get_gridmap_filename_win32</a> (char **filename)</td></tr>
<tr class="memitem:ga89bb2738de9eb4da9c21326314ab6b4d"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga89bb2738de9eb4da9c21326314ab6b4d">globus_gsi_sysconfig_get_authz_conf_filename_win32</a> (char **filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get the path and file name of the gaa config file</h2></td></tr>
<tr class="memitem:gab724a1f83f59c28b4493bf102fccb170"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gab724a1f83f59c28b4493bf102fccb170">globus_gsi_sysconfig_get_gaa_conf_filename_win32</a> (char **filename)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Check if the current user is root</h2></td></tr>
<tr class="memitem:gad095b5503e3f756dc393c3bdc39a8003"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#gad095b5503e3f756dc393c3bdc39a8003">globus_gsi_sysconfig_is_superuser_win32</a> (int *is_superuser)</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="member-group"></a>
Win32 - Get Signing Policy Filename</h2></td></tr>
<tr class="memitem:ga4c4210ed1d4ca7045fb44d0cc81b2389"><td class="memItemLeft" align="right" valign="top">globus_result_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__globus__gsi__sysconfig__win32.html#ga4c4210ed1d4ca7045fb44d0cc81b2389">globus_gsi_sysconfig_get_signing_policy_filename_win32</a> (X509_NAME *ca_name, char *cert_dir, char **signing_policy_filename)</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>These functions implement the Win32 version of the Globus GSI System Configuration API. </p>
<p><b>They should never be called directly, please use the provided platform independent defines.</b> </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gab406d12caca14f03e8f4091f1ea8aded"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_set_key_permissions_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the file permissions of a file to read only by the user which are the permissions that should be set for all private keys. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS or an error object id </dd></dl>
</div>
</div>
<a class="anchor" id="ga0de1a8a77f5e354fd33b51045ca77b76"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_file_exists_win32 </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check that the file exists. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the file to check</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS (even if the file doesn't exist) - in some abortive cases an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gadee596e751b393f4a933082d178b64c4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_dir_exists_win32 </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check that the directory exists. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the file to check</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if the directory exists, otherwise an error object identifier. </dd></dl>
</div>
</div>
<a class="anchor" id="ga9d463d1ef4c5c9bb9d0d3308f25730c5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_current_working_dir_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>working_dir</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the current working directory on a windows system. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">working_dir</td><td>The working directory to get </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga6e5899291e6da583025b079f37b0244d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_make_absolute_path_for_filename_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>absolute_path</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make the filename into an absolute path string based on the current working directory. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>the filename to get the absolute path of. </td></tr>
<tr><td class="paramname">absolute_path</td><td>The resulting absolute path </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gac04852db1744d25b3304c99a304f1513"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_split_dir_and_filename_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>full_filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>dir_string</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>filename_string</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Split the directory and filename portions of a filename string into two separate strings. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">full_filename</td><td></td></tr>
<tr><td class="paramname">dir_string</td><td></td></tr>
<tr><td class="paramname">filename_string</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga659592fe01da9aa1e97974b856e76eba"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_cert_dir_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>cert_dir</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the Trusted Certificate Directory containing the trusted Certificate Authority certificates. </p>
<p>This directory is determined in the order shown below. Failure in one method results in attempting the next.</p>
<ol>
<li>
<b>X509_CERT_DIR environment variable</b> - if this is set, the trusted certificates will be searched for in that directory. This variable allows the end user to specify the location of trusted certificates. </li>
<li>
<b>x509_cert_dir registry key</b> - If this registry key is set on windows, the directory it points to should contain the trusted certificates. The path to the registry key is software\Globus\GSI </li>
<li>
<b>\<user home directory>globus\certificates</b> - If this directory exists, and the previous methods of determining the trusted certs directory failed, this directory will be used. </li>
<li>
<b>Host Trusted Cert Dir</b> - This location is intended to be independent of the globus installation ($GLOBUS_LOCATION), and is generally only writeable by the host system administrator. </li>
<li>
<b>Globus Install Trusted Cert Dir</b> - this is $GLOBUS_LOCATION\share\certificates. </li>
</ol>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">cert_dir</td><td>The trusted certificates directory </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, and a sufficient trusted certificates directory was found. Otherwise, an error object identifier returned. </dd></dl>
</div>
</div>
<a class="anchor" id="gaaada88adba88bcb8012e5f55c458a55e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_user_cert_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>user_cert</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>user_key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the User Certificate Filename based on the current user's environment. </p>
<p>The following locations are searched for cert and key files in order:</p>
<ol>
<li>
environment variables X509_USER_CERT and X509_USER_KEY </li>
<li>
registry keys x509_user_cert and x509_user_key in software\Globus\GSI </li>
<li>
<users home directory>globus\usercert.pem and <users home directory>globus\userkey.pem </li>
<li>
<users home directory>globus\usercred.p12 - this is a PKCS12 credential </li>
</ol>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">user_cert</td><td>pointer the filename of the user certificate </td></tr>
<tr><td class="paramname">user_key</td><td>pointer to the filename of the user key </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if the cert and key files were found in one of the possible locations, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gacbe95ade22d67b1eda727f66ffa566dd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_host_cert_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>host_cert</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>host_key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the Host Certificate and Key Filenames based on the current user's environment. </p>
<p>The host cert and key are searched for in the following locations (in order):</p>
<ol>
<li>
X509_USER_CERT and X509_USER_KEY environment variables </li>
<li>
registry keys x509_user_cert and x509_user_key in software\Globus\GSI </li>
<li>
<GLOBUS_LOCATION>\etc\host[cert|key].pem </li>
<li>
<users home directory>globus\host[cert|key].pem </li>
</ol>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">host_cert</td><td>pointer to the host certificate filename </td></tr>
<tr><td class="paramname">host_key</td><td>pointer to the host key filename</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if the host cert and key were found, otherwise an error object identifier is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gae0c8a43f59f8c0134a758a3a4e94ea9d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_service_cert_filename_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>service_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>service_cert</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>service_key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the Service Certificate Filename based on the current user's environment. </p>
<p>The host cert and key are searched for in the following locations (in order):</p>
<ol>
<li>
X509_USER_CERT and X509_USER_KEY environment variables </li>
<li>
registry keys x509_user_cert and x509_user_key in software\Globus\GSI </li>
<li>
GLOBUS_LOCATION\etc\{service_name}\{service_name}[cert|key].pem So for example, if my service was named: myservice, the location of the certificate would be: GLOBUS_LOCATION\etc\myservice\myservicecert.pem </li>
<li>
<users home>globus\{service_name}\{service_name}[cert|key].pem </li>
</ol>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">service_name</td><td>The name of the service which allows us to determine the locations of cert and key files to look for </td></tr>
<tr><td class="paramname">service_cert</td><td>pointer to the host certificate filename </td></tr>
<tr><td class="paramname">service_key</td><td>pointer to the host key filename</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if the service cert and key were found, otherwise an error object identifier </dd></dl>
</div>
</div>
<a class="anchor" id="ga6989d9c71362e212bdd39f51eac9412e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_proxy_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>user_proxy</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__globus__gsi__sysconfig__datatypes.html#ga94d70620ea9adb2fb5b11b4e38244f30">globus_gsi_proxy_file_type_t</a> </td>
<td class="paramname"><em>proxy_file_type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the proxy cert filename based on the following search order: </p>
<ol>
<li>
<p class="startli">X509_USER_PROXY environment variable - This environment variable is set by the at run time for the specific application. If the proxy_file_type variable is set to GLOBUS_PROXY_OUTPUT (a proxy filename for writing is requested), and the X509_USER_PROXY is set, this will be the resulting value of the user_proxy filename string passed in. If the proxy_file_type is set to GLOBUS_PROXY_INPUT and X509_USER_PROXY is set, but the file it points to does not exist, or has some other readability issues, the function will continue checking using the other methods available.</p>
<p class="endli"></p>
</li>
<li>
<p class="startli">check the registry key: x509_user_proxy. Just as with the environment variable, if the registry key is set, and proxy_file_type is GLOBUS_PROXY_OUTPUT, the string set to be the proxy filename will be this registry key's value. If proxy_file_type is GLOBUS_PROXY_INPUT, and the file doesn't exist, the function will check the next method for the proxy's filename.</p>
<p class="endli"></p>
</li>
<li>
Check the default location for the proxy file. The default location should be set to reside in the temp directory on that host, with the filename taking the format: x509_u<user id> where <user id> is some unique string for that user on the host </li>
</ol>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">user_proxy</td><td>the proxy filename of the user </td></tr>
<tr><td class="paramname">proxy_file_type</td><td>Switch for determining whether to return a existing proxy filename or if a filename suitable for creating a proxy should be returned</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS or an error object identifier </dd></dl>
</div>
</div>
<a class="anchor" id="ga7d17dc1d58d691774ae5c4f6785fb4ed"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_ca_cert_files_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>ca_cert_dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">globus_fifo_t * </td>
<td class="paramname"><em>ca_cert_list</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets a list of trusted CA certificate filenames in a trusted CA certificate directory. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">ca_cert_dir</td><td>The trusted CA certificate directory to get the filenames from </td></tr>
<tr><td class="paramname">ca_cert_list</td><td>The resulting list of CA certificate filenames. This is a a globus list structure. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also:</dt><dd>globus_fifo_t </dd></dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga4e211e363d8386a3682e07a9e72c1657"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_remove_all_owned_files_win32 </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>default_filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Removes all proxies (ie. </p>
<p>all delegated and grid-proxy-init generated proxies) found in the secure tmp directory that are owned by the current user.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">default_filename</td><td>The filename of the default proxy </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga07fcd88933991485d524f650cc7c3236"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_gridmap_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the path and file name of the grid map file. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>Contains the location of the grid map file upon successful return </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga89bb2738de9eb4da9c21326314ab6b4d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_authz_conf_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the path and file name of the authorization callback configuration file. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>Contains the location of the authorization callback configuration file upon successful return </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gab724a1f83f59c28b4493bf102fccb170"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_gaa_conf_filename_win32 </td>
<td>(</td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the path and file name of the gaa config configuration file . </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>Contains the location of the authorization callback configuration file upon successful return </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="gad095b5503e3f756dc393c3bdc39a8003"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_is_superuser_win32 </td>
<td>(</td>
<td class="paramtype">int * </td>
<td class="paramname"><em>is_superuser</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks whether the current user is root. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">is_superuser</td><td>1 if the user is the superuser 0 if not </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID is returned </dd></dl>
</div>
</div>
<a class="anchor" id="ga4c4210ed1d4ca7045fb44d0cc81b2389"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">globus_result_t globus_gsi_sysconfig_get_signing_policy_filename_win32 </td>
<td>(</td>
<td class="paramtype">X509_NAME * </td>
<td class="paramname"><em>ca_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>cert_dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char ** </td>
<td class="paramname"><em>signing_policy_filename</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the Signing Policy Filename on the current system, based on the CA's subject name, and the trusted certificates directory. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">ca_name</td><td>The X509 subject name of the CA to get the signing policy of. The hash of the CA is generated from this</td></tr>
<tr><td class="paramname">cert_dir</td><td>The trusted CA certificates directory, containing the singing_policy files of the trusted CA's.</td></tr>
<tr><td class="paramname">signing_policy_filename</td><td>The resulting singing_policy filename </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>GLOBUS_SUCCESS if no error occurred, otherwise an error object ID </dd></dl>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<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>
distrib
>
Fedora
>
17
>
i386
>
media
>
updates
>
by-pkgid
>
d20dea4b6e145c914db1f168dac29ec7
>
files
>
40
