ProxyPolicy

Data Structures

struct  PROXYPOLICY_st

Get a method for ASN1 conversion

ASN1_METHOD * PROXYPOLICY_asn1_meth ()

New

PROXYPOLICYPROXYPOLICY_new ()

Free

void PROXYPOLICY_free (PROXYPOLICY *policy)

Duplicate

PROXYPOLICYPROXYPOLICY_dup (PROXYPOLICY *policy)

Compare

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

Print to a BIO stream

int PROXYPOLICY_print (BIO *bp, PROXYPOLICY *policy)

Print to a File Stream

int PROXYPOLICY_print_fp (FILE *fp, PROXYPOLICY *policy)

Set the Policy Language Field

int PROXYPOLICY_set_policy_language (PROXYPOLICY *policy, ASN1_OBJECT *policy_language)

Get the Policy Language Field

ASN1_OBJECT * PROXYPOLICY_get_policy_language (PROXYPOLICY *policy)

Set the Policy Field

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

Get the Policy Field

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

Convert from Internal to DER encoded form

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

Convert from DER encoded form to Internal

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

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:
policythe 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:
policythe 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:
bpthe BIO stream to print to
policythe 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:
fpthe FILE* stream to print to
policythe 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:
policythe PROXYPOLICY to set the policy language of
policy_languagethe 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:
policythe 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:
proxypolicythe proxy policy to set the policy of
policythe policy to set it to
lengththe 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:
policythe PROXYPOLICY to get the policy of
lengththe 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:
athe PROXYPOLICY to convert
ppthe 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:
athe PROXYPOLICY struct to set
ppthe DER encoding to get the PROXYPOLICY from
lengththe 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

about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org