ProxyCertInfo

Data Structures

ASN1_METHOD

New

Free.

Duplicate

Compare

Print to a BIO stream

Print To Stream

Set the Policy Field

Get the Policy Field

Set the Path Length Field

Get Path Length Field

Convert PROXYCERTINFO to DER encoded form

Convert a PROXYCERTINFO to internal form

Convert old PROXYCERTINFO to DER encoded form

Convert a old PROXYCERTINFO to internal form


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_info pointer 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_info the PROXYCERTINFO structure to copy
Returns:
the copied PROXYCERTINFO structure
int PROXYCERTINFO_cmp ( const PROXYCERTINFO a,
const PROXYCERTINFO b 
)

Compares two PROXYCERTINFO structures.

Parameters:
a pointer to the first PROXYCERTINFO structure
b pointer 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:
bp the BIO to print to
cert_info the 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:
fp the file stream (FILE *) to print to
cert_info the 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_info the PROXYCERTINFO object to set the policy of
policy the 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_info the 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_info the PROXYCERTINFO to set the path length of
path_length 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
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_info the 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_info the PROXYCERTINFO structure to convert
pp the 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_info the resulting PROXYCERTINFO in internal form
pp the DER encoded ASN.1 string containing the PROXYCERTINFO
length the 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_info the old PROXYCERTINFO structure to convert
pp the 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_info the resulting old PROXYCERTINFO in internal form
pp the DER encoded ASN.1 string containing the old PROXYCERTINFO
length the length of the buffer
Returns:
the resulting old PROXYCERTINFO in internal form

about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org