.TH "Handle Management" 3 "Mon Apr 30 2012" "Version 6.2" "globus gsi proxy core" \" -*- nroff -*- .ad l .nh .SH NAME Handle Management \- .SS "Typedefs" .in +1c .ti -1c .RI "typedef struct .br globus_l_gsi_proxy_handle_s * \fBglobus_gsi_proxy_handle_t\fP" .br .in -1c .SS "Initialize and Destroy" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_init\fP (\fBglobus_gsi_proxy_handle_t\fP *handle, \fBglobus_gsi_proxy_handle_attrs_t\fP handle_attrs)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_destroy\fP (\fBglobus_gsi_proxy_handle_t\fP handle)" .br .in -1c .SS "Get/Set Request" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_req\fP (\fBglobus_gsi_proxy_handle_t\fP handle, X509_REQ **req)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_req\fP (\fBglobus_gsi_proxy_handle_t\fP handle, X509_REQ *req)" .br .in -1c .SS "Get/Set Private Key" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_private_key\fP (\fBglobus_gsi_proxy_handle_t\fP handle, EVP_PKEY **proxy_key)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_private_key\fP (\fBglobus_gsi_proxy_handle_t\fP handle, EVP_PKEY *proxy_key)" .br .in -1c .SS "Get/Set Proxy Type" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_type\fP (\fBglobus_gsi_proxy_handle_t\fP handle, globus_gsi_cert_utils_cert_type_t *type)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_type\fP (\fBglobus_gsi_proxy_handle_t\fP handle, globus_gsi_cert_utils_cert_type_t type)" .br .in -1c .SS "Get/Set Policy" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_policy\fP (\fBglobus_gsi_proxy_handle_t\fP handle, unsigned char *policy_data, int policy_length, int policy_language_NID)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_policy\fP (\fBglobus_gsi_proxy_handle_t\fP handle, unsigned char **policy_data, int *policy_length, int *policy_NID)" .br .in -1c .SS "Get/Set Path Length" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_pathlen\fP (\fBglobus_gsi_proxy_handle_t\fP handle, long pathlen)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_pathlen\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int *pathlen)" .br .in -1c .SS "Get/Set Time Valid" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_time_valid\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int *time_valid)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_time_valid\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int time_valid)" .br .in -1c .SS "Clear Cert Info" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_clear_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fP handle)" .br .in -1c .SS "Get/Set Cert Info" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_proxy_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fP handle, PROXYCERTINFO **pci)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_proxy_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fP handle, PROXYCERTINFO *pci)" .br .in -1c .SS "Get Signing Algorithm" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_signing_algorithm\fP (\fBglobus_gsi_proxy_handle_t\fP handle, EVP_MD **signing_algorithm)" .br .in -1c .SS "Get Key Bits" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_keybits\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int *key_bits)" .br .in -1c .SS "Get Init Prime" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_init_prime\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int *init_prime)" .br .in -1c .SS "Get Clock Skew" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_clock_skew_allowable\fP (\fBglobus_gsi_proxy_handle_t\fP handle, int *skew)" .br .in -1c .SS "Get Callback for Creating Keys" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_key_gen_callback\fP (\fBglobus_gsi_proxy_handle_t\fP handle, void(**callback)(int, int, void *))" .br .in -1c .SS "Get/Set Proxy Common Name" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_get_common_name\fP (\fBglobus_gsi_proxy_handle_t\fP handle, char **common_name)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_common_name\fP (\fBglobus_gsi_proxy_handle_t\fP handle, char *common_name)" .br .in -1c .SS "Set/Check Proxy Is Limited" .in +1c .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_handle_set_is_limited\fP (\fBglobus_gsi_proxy_handle_t\fP handle, globus_bool_t is_limited)" .br .ti -1c .RI "globus_result_t \fBglobus_gsi_proxy_is_limited\fP (\fBglobus_gsi_proxy_handle_t\fP handle, globus_bool_t *is_limited)" .br .in -1c .SH "Detailed Description" .PP Create/Destroy/Modify a GSI Proxy Handle\&. Within the Globus GSI Proxy Library, all proxy operations require a handle parameter\&. Currently, only one proxy operation may be in progress at once per proxy handle\&. .PP This section defines operations to create, modify and destroy GSI Proxy handles\&. .SH "Typedef Documentation" .PP .SS "typedef struct globus_l_gsi_proxy_handle_s* \fBglobus_gsi_proxy_handle_t\fP" .PP GSI Proxy Handle\&. An GSI Proxy handle is used to associate state with a group of operations\&. Handles can have immutable \fBattributes\fP associated with them\&. All proxy \fBoperations \fP take a handle pointer as a parameter\&. .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_init()\fP, \fBglobus_gsi_proxy_handle_destroy()\fP, \fBHandle Attributes\fP .RE .PP .SH "Function Documentation" .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_init\fP (\fBglobus_gsi_proxy_handle_t\fP *handle, \fBglobus_gsi_proxy_handle_attrs_t\fPhandle_attrs)" .PP Initialize a GSI Proxy handle\&. Initialize a proxy handle which can be used in subsequent operations\&. The handle may only be used in one sequence of operations at a time\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP A pointer to the handle to be initialized\&. If the handle is originally NULL, space is allocated for it\&. Otherwise, the current values of the handle are overwritten\&. .br \fIhandle_attrs\fP Initial attributes to be used to create this handle\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_destroy()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_req\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, X509_REQ **req)" .PP Get the certificate request from a GSI Proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle from which to get the certificate request .br \fIreq\fP Parameter used to return the request\&. It is the users responsibility to free the returned request\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_req()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_private_key\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, EVP_PKEY **proxy_key)" .PP Get the private key from a GSI Proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle from which to get the private key .br \fIproxy_key\fP Parameter used to return the key\&. It is the users responsibility to free the returned key\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_private_key()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_type\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, globus_gsi_cert_utils_cert_type_t *type)" .PP Determine the type of proxy that will be generated when using this handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle from which to get the type .br \fItype\fP Parameter used to return the type\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_type()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_policy\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, unsigned char *policy_data, intpolicy_length, intpolicy_language_NID)" .PP Set the policy to be used in the GSI Proxy handle\&. This function sets the policy to be used in the proxy cert info extension\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle to be modified\&. .br \fIpolicy_data\fP The policy data\&. .br \fIpolicy_length\fP The length of the policy data .br \fIpolicy_language_NID\fP The NID of the policy language\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS if the handle and its associated fields are valid otherwise an error is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_get_policy()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_pathlen\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, longpathlen)" .PP Set the path length to be used in the GSI Proxy handle\&. This function sets the path length to be used in the proxy cert info extension\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle to be modified\&. .br \fIpathlen\fP The maximum allowable path length .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS if the handle is valid, otherwise an error is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_get_pathlen()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_time_valid\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, int *time_valid)" .PP Get the validity time of the proxy\&. \fBParameters:\fP .RS 4 \fIhandle\fP The proxy handle to get the expiration date of .br \fItime_valid\fP expiration date of the proxy handle .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_clear_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fPhandle)" .PP Clear the proxy cert info extension stored in the GSI Proxy handle\&. This function clears proxy cert info extension related setting in the GSI Proxy handle\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to clear the proxy cert info extension\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS if the handle is valid, otherwise an error is returned .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_proxy_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, PROXYCERTINFO **pci)" .PP Get the proxy cert info extension stored in the GSI Proxy handle\&. This function retrieves the proxy cert info extension from the GSI Proxy handle\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle from which to get the proxy cert info extension\&. .br \fIpci\fP Contains the proxy cert info extension upon successful return\&. If the handle does not contain a pci extension, this parameter will be NULL upon return\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS upon success GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE if handle is invalid GLOBUS_GSI_PROXY_ERROR_WITH_PROXYCERTINFO if the pci pointer is invalid or if the get failed\&. .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_signing_algorithm\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, EVP_MD **signing_algorithm)" .PP Get the signing algorithm used to sign the proxy cert request\&. \fBParameters:\fP .RS 4 \fIhandle\fP The proxy handle containing the type of signing algorithm used .br \fIsigning_algorithm\fP signing algorithm of the proxy handle .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned GLOBUS_SUCCESS .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_keybits\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, int *key_bits)" .PP Get the key bits used for the pub/private key pair of the proxy\&. \fBParameters:\fP .RS 4 \fIhandle\fP The proxy handle to get the key bits of .br \fIkey_bits\fP key bits of the proxy handle .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned GLOBUS_SUCCESS .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_init_prime\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, int *init_prime)" .PP Get the init prime of the proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle to get the init prime used in generating the key pair .br \fIinit_prime\fP The resulting init prime .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case an error object identifier (in the form of a globus_result_t) is returned .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_clock_skew_allowable\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, int *skew)" .PP Get the clock skew of the proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle to get the clock skew of .br \fIskew\fP The resulting clock skew .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case an error object identifier (in the form of a globus_result_t) is returned .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_key_gen_callback\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, void(**)(int, int, void *)callback)" .PP Get the callback for creating the public/private key pair\&. \fBParameters:\fP .RS 4 \fIhandle\fP The proxy handle to get the callback from .br \fIcallback\fP Parameter used for returning the callback .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS or an error object identifier .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_common_name\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, char **common_name)" .PP Get the proxy common name stored in the GSI Proxy handle\&. This function retrieves the proxy common name from the GSI Proxy handle\&. The common name only impacts draft compliant proxies\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle from which to get the proxy common name\&. .br \fIcommon_name\fP Contains the proxy common name upon successful return\&. If the handle does not contain a common name, this parameter will be NULL upon return\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS upon success GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE if handle is invalid .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_is_limited\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, globus_bool_tis_limited)" .PP Set the limited proxy flag on the proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP the proxy handle .br \fIis_limited\fP boolean value to set on the proxy handle .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_destroy\fP (\fBglobus_gsi_proxy_handle_t\fPhandle)" .PP Destroy a GSI Proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle to be destroyed\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_init()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_req\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, X509_REQ *req)" .PP Set the certificate request in a GSI Proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to set the certificate request .br \fIreq\fP Request to be copied to handle\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_get_req()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_private_key\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, EVP_PKEY *proxy_key)" .PP Set the private key in a GSI Proxy handle\&. \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to set the private key .br \fIproxy_key\fP Parameter used to pass the key .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_get_private_key()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_type\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, globus_gsi_cert_utils_cert_type_ttype)" .PP Set the type of proxy that will be generated when using this handle\&. Note that this will have no effect when generating a proxy from a proxy\&. In that case the generated proxy will inherit the type of the parent\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to set the type .br \fItype\fP Parameter used to pass the type\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_type()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_policy\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, unsigned char **policy_data, int *policy_length, int *policy_NID)" .PP Get the policy from the GSI Proxy handle\&. This function gets the policy that is being used in the proxy cert info extension\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle to be interrogated\&. .br \fIpolicy_data\fP The policy data\&. .br \fIpolicy_length\fP The length of the returned policy .br \fIpolicy_NID\fP The NID of the policy language\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS if the handle is valid, otherwise an error is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_policy()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_get_pathlen\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, int *pathlen)" .PP Get the path length from the GSI Proxy handle\&. This function gets the path length that is being used in the proxy cert info extension\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle to be interrogated\&. .br \fIpathlen\fP The maximum allowable path length .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS if the handle is valid, otherwise an error is returned .RE .PP \fBSee also:\fP .RS 4 \fBglobus_gsi_proxy_handle_set_pathlen()\fP .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_time_valid\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, inttime_valid)" .PP Set the validity time of the proxy\&. \fBParameters:\fP .RS 4 \fIhandle\fP The proxy handle to set the expiration date for .br \fItime_valid\fP desired expiration date of the proxy .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned GLOBUS_SUCCESS .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_proxy_cert_info\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, PROXYCERTINFO *pci)" .PP Set the proxy cert info extension stored in the GSI Proxy handle\&. This function sets the proxy cert info extension in the GSI Proxy handle\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to set the proxy cert info extension\&. .br \fIpci\fP The proxy cert info extension to set\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS upon success GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE if handle is invalid GLOBUS_GSI_PROXY_ERROR_WITH_PROXYCERTINFO if the pci pointer is invalid or if the set failed\&. .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_handle_set_common_name\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, char *common_name)" .PP Set the proxy common name stored in the GSI Proxy handle\&. This function sets the proxy common name in the GSI Proxy handle\&. Note that the common name is only used for draft compliant proxies\&. .PP \fBParameters:\fP .RS 4 \fIhandle\fP The handle for which to set the proxy common name\&. .br \fIcommon_name\fP The proxy common name to set\&. .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS upon success GLOBUS_GSI_PROXY_ERROR_WITH_HANDLE if handle is invalid .RE .PP .SS "globus_result_t \fBglobus_gsi_proxy_is_limited\fP (\fBglobus_gsi_proxy_handle_t\fPhandle, globus_bool_t *is_limited)" .PP Check to see if the proxy is a limited proxy\&. \fBParameters:\fP .RS 4 \fIhandle\fP the proxy handle to check .br \fIis_limited\fP boolean value to set depending on the type of proxy .RE .PP \fBReturns:\fP .RS 4 GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned .RE .PP .SH "Author" .PP Generated automatically by Doxygen for globus gsi proxy core from the source code\&.