Data Structures

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

ASN1_METHOD

ASN1_METHOD * PROXYCERTINFO_asn1_meth ()

New

PROXYCERTINFO * PROXYCERTINFO_new ()

Free.

void PROXYCERTINFO_free (PROXYCERTINFO *cert_info)

Duplicate

PROXYCERTINFO * PROXYCERTINFO_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

PROXYPOLICY * PROXYCERTINFO_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

PROXYCERTINFO * d2i_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

PROXYCERTINFO * d2i_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_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