ProxyCertInfo

Data Structures

struct  PROXYCERTINFO_st
 This typedef maintains information about a proxy certificate. More...

ASN1_METHOD

ASN1_METHOD * PROXYCERTINFO_asn1_meth ()

New

PROXYCERTINFOPROXYCERTINFO_new ()

Free.

void PROXYCERTINFO_free (PROXYCERTINFO *cert_info)

Duplicate

PROXYCERTINFOPROXYCERTINFO_dup (PROXYCERTINFO *cert_info)

Compare

int PROXYCERTINFO_cmp (const PROXYCERTINFO *a, const PROXYCERTINFO *b)

Print to a BIO stream

int PROXYCERTINFO_print (BIO *bp, PROXYCERTINFO *cert_info)

Print To Stream

int PROXYCERTINFO_print_fp (FILE *fp, PROXYCERTINFO *cert_info)

Set the Policy Field

int PROXYCERTINFO_set_policy (PROXYCERTINFO *cert_info, PROXYPOLICY *policy)

Get the Policy Field

PROXYPOLICYPROXYCERTINFO_get_policy (PROXYCERTINFO *cert_info)

Set the Path Length Field

int PROXYCERTINFO_set_path_length (PROXYCERTINFO *cert_info, long path_length)

Get Path Length Field

long PROXYCERTINFO_get_path_length (PROXYCERTINFO *cert_info)

Convert PROXYCERTINFO to DER encoded form

int i2d_PROXYCERTINFO (PROXYCERTINFO *cert_info, unsigned char **pp)

Convert a PROXYCERTINFO to internal form

PROXYCERTINFOd2i_PROXYCERTINFO (PROXYCERTINFO **cert_info, unsigned char **pp, long length)

Convert old PROXYCERTINFO to DER encoded form

int i2d_PROXYCERTINFO_OLD (PROXYCERTINFO *cert_info, unsigned char **pp)

Convert a old PROXYCERTINFO to internal form

PROXYCERTINFOd2i_PROXYCERTINFO_OLD (PROXYCERTINFO **cert_info, unsigned char **pp, long length)

Detailed Description

Author
Sam Meder
Sam Lang

The proxycertinfo.h file defines a method of maintaining information about proxy certificates.

Function Documentation

ASN1_METHOD* PROXYCERTINFO_asn1_meth ( )

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.

Returns
the ASN1_METHOD object
PROXYCERTINFO* PROXYCERTINFO_new ( )

Create a new PROXYCERTINFO.

Allocates and initializes a new PROXYCERTINFO structure.

Returns
pointer to the new PROXYCERTINFO
void PROXYCERTINFO_free ( PROXYCERTINFO cert_info)

Free a PROXYCERTINFO.

Parameters
cert_infopointer to the PROXYCERTINFO structure to be freed.
PROXYCERTINFO* PROXYCERTINFO_dup ( PROXYCERTINFO cert_info)

Makes a copy of a PROXYCERTINFO.

Makes a copy of a PROXYCERTINFO structure

Parameters
cert_infothe PROXYCERTINFO structure to copy
Returns
the copied PROXYCERTINFO structure
int PROXYCERTINFO_cmp ( const PROXYCERTINFO a,
const PROXYCERTINFO b 
)

Compares two PROXYCERTINFO structures.

Parameters
apointer to the first PROXYCERTINFO structure
bpointer to the second PROXYCERTINFO structure
Returns
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.
int PROXYCERTINFO_print ( BIO *  bp,
PROXYCERTINFO cert_info 
)

print the PROXYCERTINFO structure to stdout

Parameters
bpthe BIO to print to
cert_infothe PROXYCERTINFO to print
Returns
1 on success, 0 on error
int PROXYCERTINFO_print_fp ( FILE *  fp,
PROXYCERTINFO cert_info 
)

print the PROXYCERTINFO structure to the specified file stream

Parameters
fpthe file stream (FILE *) to print to
cert_infothe PROXYCERTINFO structure to print
Returns
the number of characters printed
int PROXYCERTINFO_set_policy ( PROXYCERTINFO cert_info,
PROXYPOLICY policy 
)

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.

Parameters
cert_infothe PROXYCERTINFO object to set the policy of
policythe PROXYPOLICY to set it to
Returns
1 if success, 0 if error
PROXYPOLICY* PROXYCERTINFO_get_policy ( PROXYCERTINFO cert_info)

Gets the policy on the PROXYCERTINFO.

Parameters
cert_infothe PROXYCERTINFO to get the policy of
Returns
the PROXYPOLICY of the PROXYCERTINFO
int PROXYCERTINFO_set_path_length ( PROXYCERTINFO cert_info,
long  path_length 
)

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.

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.

Parameters
cert_infothe PROXYCERTINFO to set the path length of
path_lengththe 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
Returns
1 on success, 0 on error
long PROXYCERTINFO_get_path_length ( PROXYCERTINFO cert_info)

Gets the path length of the PROXYCERTINFO.

See Also
PROXYCERTINFO_set_path_length
Parameters
cert_infothe PROXYCERTINFO to get the path length from
Returns
the path length of the PROXYCERTINFO, or -1 if not set
int i2d_PROXYCERTINFO ( PROXYCERTINFO cert_info,
unsigned char **  pp 
)

Converts the PROXYCERTINFO structure from internal format to a DER encoded ASN.1 string.

Parameters
cert_infothe PROXYCERTINFO structure to convert
ppthe resulting DER encoded string
Returns
the length of the DER encoded string
PROXYCERTINFO* d2i_PROXYCERTINFO ( PROXYCERTINFO **  cert_info,
unsigned char **  pp,
long  length 
)

Convert from a DER encoded ASN.1 string of a PROXYCERTINFO to its internal structure.

Parameters
cert_infothe resulting PROXYCERTINFO in internal form
ppthe DER encoded ASN.1 string containing the PROXYCERTINFO
lengththe length of the buffer
Returns
the resulting PROXYCERTINFO in internal form
int i2d_PROXYCERTINFO_OLD ( PROXYCERTINFO cert_info,
unsigned char **  pp 
)

Converts the old PROXYCERTINFO structure from internal format to a DER encoded ASN.1 string.

Parameters
cert_infothe old PROXYCERTINFO structure to convert
ppthe resulting DER encoded string
Returns
the length of the DER encoded string
PROXYCERTINFO* d2i_PROXYCERTINFO_OLD ( PROXYCERTINFO **  cert_info,
unsigned char **  pp,
long  length 
)

Convert from a DER encoded ASN.1 string of a old PROXYCERTINFO to its internal structure.

Parameters
cert_infothe resulting old PROXYCERTINFO in internal form
ppthe DER encoded ASN.1 string containing the old PROXYCERTINFO
lengththe length of the buffer
Returns
the resulting old PROXYCERTINFO in internal form

about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org