ProxyPolicy

Data Structures

• struct PROXYPOLICY_st

---

Detailed Description

Author:

Sam Meder

Sam Lang

The proxypolicy set of data structures and functions provides an interface to generating a PROXYPOLICY structure which is maintained as a field in the PROXYCERTINFO structure, and ultimately gets written to a DER encoded string.

See also:

Further Information about proxy policies is available in the X.509 Proxy Certificate Profile document.

---

Function Documentation

ASN1_METHOD* PROXYPOLICY_asn1_meth

(

)

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

Returns:

the ASN1_METHOD object

PROXYPOLICY* PROXYPOLICY_new

(

)

Allocates and initializes a new PROXYPOLICY structure.

Returns:

pointer to the new PROXYPOLICY

void PROXYPOLICY_free

(

PROXYPOLICY *

policy

)

Frees a PROXYPOLICY.

Parameters:

policy

the proxy policy to free

PROXYPOLICY* PROXYPOLICY_dup

(

PROXYPOLICY *

policy

)

Makes a copy of the proxypolicy - this function allocates space for a new PROXYPOLICY, so the returned PROXYPOLICY must be freed when its no longer needed.

Parameters:

policy

the proxy policy to copy

Returns:

the new PROXYPOLICY

int PROXYPOLICY_cmp	(	const PROXYPOLICY *	a,
		const PROXYPOLICY *	b
	)

Compares two PROXYPOLICY structs for equality This function first compares the policy language numeric id's, if they're equal, it then compares the two policies.

Returns:

0 if equal, nonzero if not

int PROXYPOLICY_print	(	BIO *	bp,
		PROXYPOLICY *	policy
	)

Prints the PROXYPOLICY struct using the BIO stream.

Parameters:

	bp	the BIO stream to print to
	policy	the PROXYPOLICY to print

Returns:

1 on success, 0 on error

int PROXYPOLICY_print_fp	(	FILE *	fp,
		PROXYPOLICY *	policy
	)

Prints the PROXYPOLICY to the file stream FILE*.

Parameters:

	fp	the FILE* stream to print to
	policy	the PROXYPOLICY to print

Returns:

number of bytes printed, -2 or -1 on error

int PROXYPOLICY_set_policy_language	(	PROXYPOLICY *	policy,
		ASN1_OBJECT *	policy_language
	)

Sets the policy language of the PROXYPOLICY.

Parameters:

	policy	the PROXYPOLICY to set the policy language of
	policy_language	the policy language to set it to

Returns:

1 on success, 0 on error

ASN1_OBJECT* PROXYPOLICY_get_policy_language

(

PROXYPOLICY *

policy

)

Gets the policy language of the PROXYPOLICY.

Parameters:

policy

the proxy policy to get the policy language of

Returns:

the policy language as an ASN1_OBJECT

int PROXYPOLICY_set_policy	(	PROXYPOLICY *	proxypolicy,
		unsigned char *	policy,
		int	length
	)

Sets the policy of the PROXYPOLICY.

Parameters:

	proxypolicy	the proxy policy to set the policy of
	policy	the policy to set it to
	length	the length of the policy

Returns:

1 on success, 0 on error

unsigned char* PROXYPOLICY_get_policy	(	PROXYPOLICY *	policy,
		int *	length
	)

Gets the policy of a PROXYPOLICY.

Parameters:

	policy	the PROXYPOLICY to get the policy of
	length	the length of the returned policy - this value gets set by this function

Returns:

the policy

int i2d_PROXYPOLICY	(	PROXYPOLICY *	a,
		unsigned char **	pp
	)

Converts a PROXYPOLICY from its internal structure to a DER encoded form.

Parameters:

	a	the PROXYPOLICY to convert
	pp	the buffer to put the DER encoding in

Returns:

the length of the DER encoding in bytes

PROXYPOLICY* d2i_PROXYPOLICY	(	PROXYPOLICY **	a,
		unsigned char **	pp,
		long	length
	)

Converts the PROXYPOLICY from its DER encoded form to an internal PROXYPOLICY structure.

Parameters:

	a	the PROXYPOLICY struct to set
	pp	the DER encoding to get the PROXYPOLICY from
	length	the length of the DER encoding

Returns:

the resulting PROXYPOLICY in its internal structure form - this variable has been allocated using _new routines, so it needs to be freed once its no longer used