Data Structures
struct	PROXYCERTINFO_st

Functions
ASN1_METHOD *	PROXYCERTINFO_asn1_meth ()
PROXYCERTINFO *	PROXYCERTINFO_new ()
void	PROXYCERTINFO_free (PROXYCERTINFO *cert_info)
PROXYCERTINFO *	PROXYCERTINFO_dup (PROXYCERTINFO *cert_info)
int	PROXYCERTINFO_cmp (const PROXYCERTINFO a, const PROXYCERTINFO b)
int	PROXYCERTINFO_print (BIO bp, PROXYCERTINFO cert_info)
int	PROXYCERTINFO_print_fp (FILE fp, PROXYCERTINFO cert_info)
int	PROXYCERTINFO_set_policy (PROXYCERTINFO cert_info, PROXYPOLICY policy)
PROXYPOLICY *	PROXYCERTINFO_get_policy (PROXYCERTINFO *cert_info)
int	PROXYCERTINFO_set_path_length (PROXYCERTINFO *cert_info, long path_length)
long	PROXYCERTINFO_get_path_length (PROXYCERTINFO *cert_info)
int	i2d_PROXYCERTINFO (PROXYCERTINFO cert_info, unsigned char *pp)
PROXYCERTINFO *	d2i_PROXYCERTINFO (PROXYCERTINFO cert_info, unsigned char pp, long length)
int	i2d_PROXYCERTINFO_OLD (PROXYCERTINFO cert_info, unsigned char *pp)
PROXYCERTINFO *	d2i_PROXYCERTINFO_OLD (PROXYCERTINFO cert_info, unsigned char pp, long length)

Detailed Description

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

Function Documentation

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

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

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

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

ASN1_METHOD* PROXYCERTINFO_asn1_meth ( )

Define the functions required for manipulating a PROXYCERTINFO and its ASN.1 form.

Creates an ASN1_METHOD structure, which contains pointers to routines that convert any PROXYCERTINFO structure to its associated ASN.1 DER encoded form and vice-versa.

Returns: the ASN1_METHOD object

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.

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

void PROXYCERTINFO_free ( PROXYCERTINFO * cert_info )

Free a PROXYCERTINFO.

Parameters

cert_info pointer to the PROXYCERTINFO structure to be freed.

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

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

PROXYCERTINFO* PROXYCERTINFO_new ( )

Create a new PROXYCERTINFO.

Allocates and initializes a new PROXYCERTINFO structure.

Returns: pointer to the new PROXYCERTINFO

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_path_length	(	PROXYCERTINFO *	cert_info,
		long	path_length
	)

Sets the path length of the PROXYCERTINFO. The path length specifies 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 ASN.1 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

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

Data Structures

Functions

Detailed Description

Function Documentation