ProxyPolicy

Data Structures

• struct PROXYPOLICY_st

Get a method for ASN1 conversion

• ASN1_METHOD * PROXYPOLICY_asn1_meth ()

New

• PROXYPOLICY * PROXYPOLICY_new ()

Free

• void PROXYPOLICY_free (PROXYPOLICY *policy)

Duplicate

• PROXYPOLICY * PROXYPOLICY_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

• PROXYPOLICY * d2i_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 Internet Draft Document:

draft-ietf-pkix-proxy-01.txt

---

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 Definition at line 40 of file proxypolicy.c. References d2i_PROXYPOLICY(), i2d_PROXYPOLICY(), PROXYPOLICY_free(), and PROXYPOLICY_new(). { static ASN1_METHOD proxypolicy_asn1_meth = { (int (*)()) i2d_PROXYPOLICY, (char *(*)()) d2i_PROXYPOLICY, (char *(*)()) PROXYPOLICY_new, (void (*)()) PROXYPOLICY_free }; return (&proxypolicy_asn1_meth); }

PROXYPOLICY* PROXYPOLICY_new ( )

Allocates and initializes a new PROXYPOLICY structure. Returns: pointer to the new PROXYPOLICY Definition at line 65 of file proxypolicy.c. References ASN1_F_PROXYPOLICY_NEW, IMPERSONATION_PROXY_SN, PROXYPOLICY_st::policy, PROXYPOLICY_st::policy_language, and PROXYPOLICY. Referenced by d2i_PROXYPOLICY(), PROXYCERTINFO_new(), PROXYPOLICY_asn1_meth(), and PROXYPOLICY_x509v3_ext_meth(). { ASN1_CTX c; PROXYPOLICY * ret; ret = NULL; M_ASN1_New_Malloc(ret, PROXYPOLICY); ret->policy_language = OBJ_nid2obj(OBJ_sn2nid(IMPERSONATION_PROXY_SN)); ret->policy = NULL; return (ret); M_ASN1_New_Error(ASN1_F_PROXYPOLICY_NEW); }

void PROXYPOLICY_free (      PROXYPOLICY * policy )

Frees a PROXYPOLICY Parameters: policy  the proxy policy to free Definition at line 93 of file proxypolicy.c. References PROXYPOLICY_st::policy, PROXYPOLICY_st::policy_language, and PROXYPOLICY. Referenced by d2i_PROXYPOLICY(), PROXYPOLICY_asn1_meth(), and PROXYPOLICY_x509v3_ext_meth(). { if(policy == NULL) return; ASN1_OBJECT_free(policy->policy_language); M_ASN1_OCTET_STRING_free(policy->policy); OPENSSL_free(policy); }

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 Definition at line 121 of file proxypolicy.c. References d2i_PROXYPOLICY(), i2d_PROXYPOLICY(), and PROXYPOLICY. Referenced by PROXYCERTINFO_set_policy(). { return ((PROXYPOLICY *) ASN1_dup((int (*)())i2d_PROXYPOLICY, (char *(*)())d2i_PROXYPOLICY, (char *)policy)); }

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 Definition at line 145 of file proxypolicy.c. References PROXYPOLICY_st::policy, PROXYPOLICY_st::policy_language, and PROXYPOLICY. Referenced by PROXYCERTINFO_cmp(). { if((a->policy_language->nid != b->policy_language->nid) || ASN1_STRING_cmp((ASN1_STRING *)a->policy, (ASN1_STRING *)b->policy)) { return 1; } return 0; }

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 Definition at line 174 of file proxypolicy.c. References PROXYPOLICY, PROXYPOLICY_x509v3_ext_meth(), and STACK_OF(). Referenced by PROXYPOLICY_print_fp(). { STACK_OF(CONF_VALUE) * values = NULL; values = i2v_PROXYPOLICY(PROXYPOLICY_x509v3_ext_meth(), policy, values); X509V3_EXT_val_prn(bp, values, 0, 1); sk_CONF_VALUE_pop_free(values, X509V3_conf_free); return 1; }

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 Definition at line 206 of file proxypolicy.c. References PROXYPOLICY, and PROXYPOLICY_print(). { int ret; BIO * bp = BIO_new(BIO_s_file()); BIO_set_fp(bp, fp, BIO_NOCLOSE); ret = PROXYPOLICY_print(bp, policy); BIO_free(bp); return (ret); }

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 Definition at line 236 of file proxypolicy.c. References PROXYPOLICY_st::policy_language, and PROXYPOLICY. { if(policy_language != NULL) { ASN1_OBJECT_free(policy->policy_language); policy->policy_language = OBJ_dup(policy_language); return 1; } return 0; }

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 Definition at line 264 of file proxypolicy.c. References PROXYPOLICY_st::policy_language, and PROXYPOLICY. Referenced by STACK_OF(). { return policy->policy_language; }

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 lenght of the policy Returns: 1 on success, 0 on error Definition at line 286 of file proxypolicy.c. References PROXYPOLICY_st::policy, and PROXYPOLICY. { if(policy != NULL) { unsigned char * copy = malloc(length); memcpy(copy, policy, length); if(!proxypolicy->policy) { proxypolicy->policy = ASN1_OCTET_STRING_new(); } ASN1_OCTET_STRING_set(proxypolicy->policy, copy, length); } else { if(proxypolicy->policy) { ASN1_OCTET_STRING_free(proxypolicy->policy); } } return 1; }

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 Definition at line 332 of file proxypolicy.c. References PROXYPOLICY_st::policy, and PROXYPOLICY. Referenced by STACK_OF(). { if(policy->policy) { (*length) = policy->policy->length; if(*length > 0 && policy->policy->data) { unsigned char * copy = malloc(*length); memcpy(copy, policy->policy->data, *length); return copy; } } return NULL; }

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 Definition at line 367 of file proxypolicy.c. References PROXYPOLICY_st::policy, PROXYPOLICY_st::policy_language, and PROXYPOLICY. Referenced by i2d_PROXYCERTINFO(), i2d_PROXYCERTINFO_OLD(), PROXYPOLICY_asn1_meth(), PROXYPOLICY_dup(), and PROXYPOLICY_x509v3_ext_meth(). { M_ASN1_I2D_vars(a); M_ASN1_I2D_len(a->policy_language, i2d_ASN1_OBJECT); if(a->policy) { M_ASN1_I2D_len(a->policy, i2d_ASN1_OCTET_STRING); } M_ASN1_I2D_seq_total(); M_ASN1_I2D_put(a->policy_language, i2d_ASN1_OBJECT); if(a->policy) { M_ASN1_I2D_put(a->policy, i2d_ASN1_OCTET_STRING); } M_ASN1_I2D_finish(); }

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 Definition at line 409 of file proxypolicy.c. References ASN1_F_D2I_PROXYPOLICY, PROXYPOLICY, PROXYPOLICY_free(), and PROXYPOLICY_new(). Referenced by d2i_PROXYCERTINFO(), d2i_PROXYCERTINFO_OLD(), PROXYPOLICY_asn1_meth(), PROXYPOLICY_dup(), and PROXYPOLICY_x509v3_ext_meth(). { M_ASN1_D2I_vars(a, PROXYPOLICY *, PROXYPOLICY_new); M_ASN1_D2I_Init(); M_ASN1_D2I_start_sequence(); M_ASN1_D2I_get(ret->policy_language, d2i_ASN1_OBJECT); /* need to try getting the policy using * a) a call expecting no tags * b) a call expecting tags * one of which should succeed */ M_ASN1_D2I_get_opt(ret->policy, d2i_ASN1_OCTET_STRING, V_ASN1_OCTET_STRING); M_ASN1_D2I_get_IMP_opt(ret->policy, d2i_ASN1_OCTET_STRING, 0, V_ASN1_OCTET_STRING); M_ASN1_D2I_Finish(a, PROXYPOLICY_free, ASN1_F_D2I_PROXYPOLICY); }

---

about globus | grid research | globus toolkit | software development

Comments? webmaster@globus.org

 

---

For questions or feedback about this website: webmaster@globus.org [privacy statements]
For technical support or questions about Globus software, visit our technical support page.

Globus, Globus Alliance, and Globus Toolkit are trademarks held by the University of Chicago.