.TH "globus_gsi_credential.h" 3 "Sun Nov 9 2014" "Version 7.7" "globus_gsi_credential" \" -*- nroff -*-
.ad l
.nh
.SH NAME
globus_gsi_credential.h \- 
.PP
Globus GSI Credential Library\&.  

.SH SYNOPSIS
.br
.PP
\fC#include 'globus_common\&.h'\fP
.br
\fC#include 'globus_error_openssl\&.h'\fP
.br
\fC#include 'globus_gsi_cred_constants\&.h'\fP
.br
\fC#include 'globus_gsi_callback\&.h'\fP
.br
\fC#include 'globus_gsi_cert_utils\&.h'\fP
.br
\fC#include 'openssl/x509\&.h'\fP
.br
\fC#include 'openssl/bio\&.h'\fP
.br
\fC#include 'openssl/ssl\&.h'\fP
.br
\fC#include 'globus_error_generic\&.h'\fP
.br

.SS "Macros"

.in +1c
.ti -1c
.RI "#define \fBGLOBUS_GSI_CREDENTIAL_MODULE\fP"
.br
.in -1c
.SS "Typedefs"

.in +1c
.ti -1c
.RI "typedef struct 
.br
globus_l_gsi_cred_handle_s * \fBglobus_gsi_cred_handle_t\fP"
.br
.ti -1c
.RI "typedef struct 
.br
globus_l_gsi_cred_handle_attrs_s * \fBglobus_gsi_cred_handle_attrs_t\fP"
.br
.in -1c
.SS "Functions"

.in +1c
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_init\fP (\fBglobus_gsi_cred_handle_t\fP *handle, \fBglobus_gsi_cred_handle_attrs_t\fP handle_attrs)"
.br
.RI "\fIInitialize a Handle\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_destroy\fP (\fBglobus_gsi_cred_handle_t\fP handle)"
.br
.RI "\fIDestroy the credential handle\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_copy\fP (\fBglobus_gsi_cred_handle_t\fP source, \fBglobus_gsi_cred_handle_t\fP *dest)"
.br
.RI "\fICopy a handle\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_init\fP (\fBglobus_gsi_cred_handle_attrs_t\fP *handle_attrs)"
.br
.RI "\fIInitialize credential handle attributes\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_destroy\fP (\fBglobus_gsi_cred_handle_attrs_t\fP handle_attrs)"
.br
.RI "\fIDestroy credential handle attributes\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_copy\fP (\fBglobus_gsi_cred_handle_attrs_t\fP source, \fBglobus_gsi_cred_handle_attrs_t\fP *dest)"
.br
.RI "\fICopy credential handle attributes\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509_NAME *desired_subject)"
.br
.RI "\fIRead a credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_proxy\fP (\fBglobus_gsi_cred_handle_t\fP handle, const char *proxy_filename)"
.br
.RI "\fIRead proxy credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_proxy_bio\fP (\fBglobus_gsi_cred_handle_t\fP handle, BIO *bio)"
.br
.RI "\fIRead proxy credential from a BIO\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_key\fP (\fBglobus_gsi_cred_handle_t\fP handle, char *key_filename, int(*pw_cb)())"
.br
.RI "\fIRead a private key\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_cert\fP (\fBglobus_gsi_cred_handle_t\fP handle, char *cert_filename)"
.br
.RI "\fIRead a certificate chain from a file\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_cert_bio\fP (\fBglobus_gsi_cred_handle_t\fP handle, BIO *bio)"
.br
.RI "\fIRead a certificate chain from a BIO\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_cert_buffer\fP (char *pem_buf, \fBglobus_gsi_cred_handle_t\fP *out_handle, X509 **out_cert, STACK_OF(X509)**out_cert_chain, char **out_subject)"
.br
.RI "\fIRead certificate chain from a buffer\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_read_pkcs12\fP (\fBglobus_gsi_cred_handle_t\fP handle, char *pkcs12_filename)"
.br
.RI "\fIRead certificate and key from a PKCS12 file\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_write\fP (\fBglobus_gsi_cred_handle_t\fP handle, BIO *bio)"
.br
.RI "\fIWrite Credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_write_proxy\fP (\fBglobus_gsi_cred_handle_t\fP handle, char *proxy_filename)"
.br
.RI "\fIWrite a proxy credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_verify_cert_chain\fP (\fBglobus_gsi_cred_handle_t\fP cred_handle, globus_gsi_callback_data_t callback_data)"
.br
.RI "\fIVerify credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_verify_cert_chain_when\fP (\fBglobus_gsi_cred_handle_t\fP cred_handle, globus_gsi_callback_data_t callback_data, time_t check_time)"
.br
.RI "\fIVerify credential at a specific time\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_verify\fP (\fBglobus_gsi_cred_handle_t\fP handle)"
.br
.RI "\fIVerify a credential\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_X509_subject_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509_NAME **subject_name)"
.br
.RI "\fIGet credential subject name\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_subject_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, char **subject_name)"
.br
.RI "\fIGet credential subject name\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_policies\fP (\fBglobus_gsi_cred_handle_t\fP handle, STACK **policies)"
.br
.RI "\fIGet certificate chain policies\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_policy_languages\fP (\fBglobus_gsi_cred_handle_t\fP handle, STACK_OF(ASN1_OBJECT)**languages)"
.br
.RI "\fIGet certificate chain policy languages\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_X509_issuer_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509_NAME **issuer_name)"
.br
.RI "\fIGet credential issuer name object\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_issuer_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, char **issuer_name)"
.br
.RI "\fIGet issuer name\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_X509_identity_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509_NAME **identity_name)"
.br
.RI "\fIGet X\&.509 identity\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_identity_name\fP (\fBglobus_gsi_cred_handle_t\fP handle, char **identity_name)"
.br
.RI "\fIGet identity name\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_set_cert\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509 *cert)"
.br
.RI "\fISet the credential's certificate\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_set_key\fP (\fBglobus_gsi_cred_handle_t\fP handle, EVP_PKEY *key)"
.br
.RI "\fISet the credential's private key\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_set_cert_chain\fP (\fBglobus_gsi_cred_handle_t\fP handle, STACK_OF(X509)*cert_chain)"
.br
.RI "\fISet the certificate chain\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_cert\fP (\fBglobus_gsi_cred_handle_t\fP handle, X509 **cert)"
.br
.RI "\fIGet the credential's certificate\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_key\fP (\fBglobus_gsi_cred_handle_t\fP handle, EVP_PKEY **key)"
.br
.RI "\fIGet the credential's private key\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_cert_chain\fP (\fBglobus_gsi_cred_handle_t\fP handle, STACK_OF(X509)**cert_chain)"
.br
.RI "\fIGet the certificate chain\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_handle_attrs\fP (\fBglobus_gsi_cred_handle_t\fP handle, \fBglobus_gsi_cred_handle_attrs_t\fP *handle_attrs)"
.br
.RI "\fIGet the handle attributes\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_lifetime\fP (\fBglobus_gsi_cred_handle_t\fP handle, time_t *lifetime)"
.br
.RI "\fIGet credential lifetime\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_goodtill\fP (\fBglobus_gsi_cred_handle_t\fP handle, time_t *goodtill)"
.br
.RI "\fIGet credential expiration\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_cert_type\fP (\fBglobus_gsi_cred_handle_t\fP handle, globus_gsi_cert_utils_cert_type_t *type)"
.br
.RI "\fIGet the X\&.509 certificate type\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_get_key_bits\fP (\fBglobus_gsi_cred_handle_t\fP handle, int *key_bits)"
.br
.RI "\fIGet credential strength\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_set_ca_cert_dir\fP (\fBglobus_gsi_cred_handle_attrs_t\fP handle_attrs, char *ca_cert_dir)"
.br
.RI "\fISet the CA certificate directory\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_get_ca_cert_dir\fP (\fBglobus_gsi_cred_handle_attrs_t\fP handle_attrs, char **ca_cert_dir)"
.br
.RI "\fIGet the CA certificate directory\&. \fP"
.ti -1c
.RI "globus_result_t \fBglobus_gsi_cred_handle_attrs_set_search_order\fP (\fBglobus_gsi_cred_handle_attrs_t\fP handle_attrs, \fBglobus_gsi_cred_type_t\fP search_order[])"
.br
.RI "\fISet the search order\&. \fP"
.in -1c
.SH "Detailed Description"
.PP 
Globus GSI Credential Library\&. 


.PP
\fBAuthor:\fP
.RS 4
Sam Lang, Sam Meder 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for globus_gsi_credential from the source code\&.