.TH "ProxyCertInfo" 3 "Wed Jan 25 2012" "Version 4.1" "globus gsi proxy ssl" \" -*- nroff -*-
.ad l
.nh
.SH NAME
ProxyCertInfo \- 
.SS "Data Structures"

.in +1c
.ti -1c
.RI "struct \fBPROXYCERTINFO_st\fP"
.br
.RI "\fIThis typedef maintains information about a proxy certificate\&. \fP"
.in -1c
.SS "ASN1_METHOD"

.in +1c
.ti -1c
.RI "ASN1_METHOD * \fBPROXYCERTINFO_asn1_meth\fP ()"
.br
.in -1c
.SS "New"

.in +1c
.ti -1c
.RI "\fBPROXYCERTINFO\fP * \fBPROXYCERTINFO_new\fP ()"
.br
.in -1c
.SS "Free\&."

.in +1c
.ti -1c
.RI "void \fBPROXYCERTINFO_free\fP (\fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Duplicate"

.in +1c
.ti -1c
.RI "\fBPROXYCERTINFO\fP * \fBPROXYCERTINFO_dup\fP (\fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Compare"

.in +1c
.ti -1c
.RI "int \fBPROXYCERTINFO_cmp\fP (const \fBPROXYCERTINFO\fP *a, const \fBPROXYCERTINFO\fP *b)"
.br
.in -1c
.SS "Print to a BIO stream"

.in +1c
.ti -1c
.RI "int \fBPROXYCERTINFO_print\fP (BIO *bp, \fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Print To Stream"

.in +1c
.ti -1c
.RI "int \fBPROXYCERTINFO_print_fp\fP (FILE *fp, \fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Set the Policy Field"

.in +1c
.ti -1c
.RI "int \fBPROXYCERTINFO_set_policy\fP (\fBPROXYCERTINFO\fP *cert_info, \fBPROXYPOLICY\fP *policy)"
.br
.in -1c
.SS "Get the Policy Field"

.in +1c
.ti -1c
.RI "\fBPROXYPOLICY\fP * \fBPROXYCERTINFO_get_policy\fP (\fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Set the Path Length Field"

.in +1c
.ti -1c
.RI "int \fBPROXYCERTINFO_set_path_length\fP (\fBPROXYCERTINFO\fP *cert_info, long path_length)"
.br
.in -1c
.SS "Get Path Length Field"

.in +1c
.ti -1c
.RI "long \fBPROXYCERTINFO_get_path_length\fP (\fBPROXYCERTINFO\fP *cert_info)"
.br
.in -1c
.SS "Convert PROXYCERTINFO to DER encoded form"

.in +1c
.ti -1c
.RI "int \fBi2d_PROXYCERTINFO\fP (\fBPROXYCERTINFO\fP *cert_info, unsigned char **pp)"
.br
.in -1c
.SS "Convert a PROXYCERTINFO to internal form"

.in +1c
.ti -1c
.RI "\fBPROXYCERTINFO\fP * \fBd2i_PROXYCERTINFO\fP (\fBPROXYCERTINFO\fP **cert_info, unsigned char **pp, long length)"
.br
.in -1c
.SS "Convert old PROXYCERTINFO to DER encoded form"

.in +1c
.ti -1c
.RI "int \fBi2d_PROXYCERTINFO_OLD\fP (\fBPROXYCERTINFO\fP *cert_info, unsigned char **pp)"
.br
.in -1c
.SS "Convert a old PROXYCERTINFO to internal form"

.in +1c
.ti -1c
.RI "\fBPROXYCERTINFO\fP * \fBd2i_PROXYCERTINFO_OLD\fP (\fBPROXYCERTINFO\fP **cert_info, unsigned char **pp, long length)"
.br
.in -1c
.SH "Detailed Description"
.PP 
\fBAuthor:\fP
.RS 4
Sam Meder 
.PP
Sam Lang
.RE
.PP
The proxycertinfo\&.h file defines a method of maintaining information about proxy certificates\&. 
.SH "Function Documentation"
.PP 
.SS "ASN1_METHOD* \fBPROXYCERTINFO_asn1_meth\fP ()"
.PP
Define the functions required for manipulating a PROXYCERTINFO and its ASN1 form\&. Creates an ASN1_METHOD structure, which contains pointers to routines that convert any PROXYCERTINFO structure to its associated ASN1 DER encoded form and vice-versa\&.
.PP
\fBReturns:\fP
.RS 4
the ASN1_METHOD object 
.RE
.PP

.SS "\fBPROXYCERTINFO\fP* \fBPROXYCERTINFO_new\fP ()"
.PP
Create a new PROXYCERTINFO\&. Allocates and initializes a new PROXYCERTINFO structure\&.
.PP
\fBReturns:\fP
.RS 4
pointer to the new PROXYCERTINFO 
.RE
.PP

.SS "void \fBPROXYCERTINFO_free\fP (\fBPROXYCERTINFO\fP *cert_info)"
.PP
Free a PROXYCERTINFO\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP pointer to the PROXYCERTINFO structure to be freed\&. 
.RE
.PP

.SS "\fBPROXYCERTINFO\fP* \fBPROXYCERTINFO_dup\fP (\fBPROXYCERTINFO\fP *cert_info)"
.PP
Makes a copy of a PROXYCERTINFO\&. Makes a copy of a PROXYCERTINFO structure
.PP
\fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO structure to copy
.RE
.PP
\fBReturns:\fP
.RS 4
the copied PROXYCERTINFO structure 
.RE
.PP

.SS "int \fBPROXYCERTINFO_cmp\fP (const \fBPROXYCERTINFO\fP *a, const \fBPROXYCERTINFO\fP *b)"
.PP
Compares two PROXYCERTINFO structures\&. \fBParameters:\fP
.RS 4
\fIa\fP pointer to the first PROXYCERTINFO structure 
.br
\fIb\fP pointer to the second PROXYCERTINFO structure
.RE
.PP
\fBReturns:\fP
.RS 4
an integer - the result of the comparison\&. The comparison compares each of the fields, so if any of those fields are not equal then a nonzero value is returned\&. Equality is indicated by returning a 0\&. 
.RE
.PP

.SS "int \fBPROXYCERTINFO_print\fP (BIO *bp, \fBPROXYCERTINFO\fP *cert_info)"
.PP
print the PROXYCERTINFO structure to stdout \fBParameters:\fP
.RS 4
\fIbp\fP the BIO to print to 
.br
\fIcert_info\fP the PROXYCERTINFO to print
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success, 0 on error 
.RE
.PP

.SS "int \fBPROXYCERTINFO_print_fp\fP (FILE *fp, \fBPROXYCERTINFO\fP *cert_info)"
.PP
print the PROXYCERTINFO structure to the specified file stream \fBParameters:\fP
.RS 4
\fIfp\fP the file stream (FILE *) to print to 
.br
\fIcert_info\fP the PROXYCERTINFO structure to print
.RE
.PP
\fBReturns:\fP
.RS 4
the number of characters printed 
.RE
.PP

.SS "int \fBPROXYCERTINFO_set_policy\fP (\fBPROXYCERTINFO\fP *cert_info, \fBPROXYPOLICY\fP *policy)"
.PP
Sets the policy on the PROXYCERTINFO Since this is an optional field in the ASN1 encoding, this variable can be set to NULL through this function - which means that when the PROXYCERTINFO is encoded the policy won't be included\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO object to set the policy of 
.br
\fIpolicy\fP the PROXYPOLICY to set it to
.RE
.PP
\fBReturns:\fP
.RS 4
1 if success, 0 if error 
.RE
.PP

.SS "\fBPROXYPOLICY\fP* \fBPROXYCERTINFO_get_policy\fP (\fBPROXYCERTINFO\fP *cert_info)"
.PP
Gets the policy on the PROXYCERTINFO\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO to get the policy of
.RE
.PP
\fBReturns:\fP
.RS 4
the PROXYPOLICY of the PROXYCERTINFO 
.RE
.PP

.SS "int \fBPROXYCERTINFO_set_path_length\fP (\fBPROXYCERTINFO\fP *cert_info, longpath_length)"
.PP
Sets the path length of the PROXYCERTINFO\&. The path length specifices the maximum depth of the path of the Proxy Certificates that can be signed by an End Entity Certificate (EEC) or Proxy Certificate\&.
.PP
Since this is an optional field in its ASN1 coded representation, it can be set to NULL through this function - which means that it won't be included in the encoding\&.
.PP
\fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO to set the path length of 
.br
\fIpath_length\fP the path length to set it to if -1 is passed in, the path length gets unset, which configures the PROXYCERTINFO to not include the path length in the DER encoding
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success, 0 on error 
.RE
.PP

.SS "long \fBPROXYCERTINFO_get_path_length\fP (\fBPROXYCERTINFO\fP *cert_info)"
.PP
Gets the path length of the PROXYCERTINFO\&. \fBSee also:\fP
.RS 4
\fBPROXYCERTINFO_set_path_length\fP
.RE
.PP
\fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO to get the path length from
.RE
.PP
\fBReturns:\fP
.RS 4
the path length of the PROXYCERTINFO, or -1 if not set 
.RE
.PP

.SS "int \fBi2d_PROXYCERTINFO\fP (\fBPROXYCERTINFO\fP *cert_info, unsigned char **pp)"
.PP
Converts the PROXYCERTINFO structure from internal format to a DER encoded ASN\&.1 string\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the PROXYCERTINFO structure to convert 
.br
\fIpp\fP the resulting DER encoded string
.RE
.PP
\fBReturns:\fP
.RS 4
the length of the DER encoded string 
.RE
.PP

.SS "\fBPROXYCERTINFO\fP* \fBd2i_PROXYCERTINFO\fP (\fBPROXYCERTINFO\fP **cert_info, unsigned char **pp, longlength)"
.PP
Convert from a DER encoded ASN\&.1 string of a PROXYCERTINFO to its internal structure\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the resulting PROXYCERTINFO in internal form 
.br
\fIpp\fP the DER encoded ASN\&.1 string containing the PROXYCERTINFO 
.br
\fIlength\fP the length of the buffer
.RE
.PP
\fBReturns:\fP
.RS 4
the resulting PROXYCERTINFO in internal form 
.RE
.PP

.SS "int \fBi2d_PROXYCERTINFO_OLD\fP (\fBPROXYCERTINFO\fP *cert_info, unsigned char **pp)"
.PP
Converts the old PROXYCERTINFO structure from internal format to a DER encoded ASN\&.1 string\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the old PROXYCERTINFO structure to convert 
.br
\fIpp\fP the resulting DER encoded string
.RE
.PP
\fBReturns:\fP
.RS 4
the length of the DER encoded string 
.RE
.PP

.SS "\fBPROXYCERTINFO\fP* \fBd2i_PROXYCERTINFO_OLD\fP (\fBPROXYCERTINFO\fP **cert_info, unsigned char **pp, longlength)"
.PP
Convert from a DER encoded ASN\&.1 string of a old PROXYCERTINFO to its internal structure\&. \fBParameters:\fP
.RS 4
\fIcert_info\fP the resulting old PROXYCERTINFO in internal form 
.br
\fIpp\fP the DER encoded ASN\&.1 string containing the old PROXYCERTINFO 
.br
\fIlength\fP the length of the buffer
.RE
.PP
\fBReturns:\fP
.RS 4
the resulting old PROXYCERTINFO in internal form 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for globus gsi proxy ssl from the source code\&.