1109998Smarkm=pod 2109998Smarkm 3109998Smarkm=head1 NAME 4109998Smarkm 5109998SmarkmX509_NAME_ENTRY_get_object, X509_NAME_ENTRY_get_data, 6109998SmarkmX509_NAME_ENTRY_set_object, X509_NAME_ENTRY_set_data, 7109998SmarkmX509_NAME_ENTRY_create_by_txt, X509_NAME_ENTRY_create_by_NID, 8109998SmarkmX509_NAME_ENTRY_create_by_OBJ - X509_NAME_ENTRY utility functions 9109998Smarkm 10109998Smarkm=head1 SYNOPSIS 11109998Smarkm 12215697Ssimon #include <openssl/x509.h> 13109998Smarkm 14215697Ssimon ASN1_OBJECT * X509_NAME_ENTRY_get_object(X509_NAME_ENTRY *ne); 15215697Ssimon ASN1_STRING * X509_NAME_ENTRY_get_data(X509_NAME_ENTRY *ne); 16109998Smarkm 17215697Ssimon int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, ASN1_OBJECT *obj); 18215697Ssimon int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type, const unsigned char *bytes, int len); 19109998Smarkm 20215697Ssimon X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne, const char *field, int type, const unsigned char *bytes, int len); 21215697Ssimon X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid, int type,unsigned char *bytes, int len); 22215697Ssimon X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne, ASN1_OBJECT *obj, int type, const unsigned char *bytes, int len); 23215697Ssimon 24109998Smarkm=head1 DESCRIPTION 25109998Smarkm 26109998SmarkmX509_NAME_ENTRY_get_object() retrieves the field name of B<ne> in 27109998Smarkmand B<ASN1_OBJECT> structure. 28109998Smarkm 29109998SmarkmX509_NAME_ENTRY_get_data() retrieves the field value of B<ne> in 30109998Smarkmand B<ASN1_STRING> structure. 31109998Smarkm 32109998SmarkmX509_NAME_ENTRY_set_object() sets the field name of B<ne> to B<obj>. 33109998Smarkm 34109998SmarkmX509_NAME_ENTRY_set_data() sets the field value of B<ne> to string type 35109998SmarkmB<type> and value determined by B<bytes> and B<len>. 36109998Smarkm 37109998SmarkmX509_NAME_ENTRY_create_by_txt(), X509_NAME_ENTRY_create_by_NID() 38109998Smarkmand X509_NAME_ENTRY_create_by_OBJ() create and return an 39109998SmarkmB<X509_NAME_ENTRY> structure. 40109998Smarkm 41109998Smarkm=head1 NOTES 42109998Smarkm 43109998SmarkmX509_NAME_ENTRY_get_object() and X509_NAME_ENTRY_get_data() can be 44109998Smarkmused to examine an B<X509_NAME_ENTRY> function as returned by 45109998SmarkmX509_NAME_get_entry() for example. 46109998Smarkm 47109998SmarkmX509_NAME_ENTRY_create_by_txt(), X509_NAME_ENTRY_create_by_OBJ(), 48109998SmarkmX509_NAME_ENTRY_create_by_NID() and X509_NAME_ENTRY_set_data() 49109998Smarkmare seldom used in practice because B<X509_NAME_ENTRY> structures 50109998Smarkmare almost always part of B<X509_NAME> structures and the 51109998Smarkmcorresponding B<X509_NAME> functions are typically used to 52109998Smarkmcreate and add new entries in a single operation. 53109998Smarkm 54109998SmarkmThe arguments of these functions support similar options to the similarly 55109998Smarkmnamed ones of the corresponding B<X509_NAME> functions such as 56109998SmarkmX509_NAME_add_entry_by_txt(). So for example B<type> can be set to 57109998SmarkmB<MBSTRING_ASC> but in the case of X509_set_data() the field name must be 58109998Smarkmset first so the relevant field information can be looked up internally. 59109998Smarkm 60109998Smarkm=head1 RETURN VALUES 61109998Smarkm 62109998Smarkm=head1 SEE ALSO 63109998Smarkm 64109998SmarkmL<ERR_get_error(3)|ERR_get_error(3)>, L<d2i_X509_NAME(3)|d2i_X509_NAME(3)>, 65267256SjkimL<OBJ_nid2obj(3)|OBJ_nid2obj(3)> 66109998Smarkm 67109998Smarkm=head1 HISTORY 68109998Smarkm 69109998SmarkmTBA 70109998Smarkm 71109998Smarkm=cut 72