X509_NAME_ENTRY_get_object 3 2008-05-09 0.9.9-dev OpenSSL

NAME

X509_NAME_ENTRY_get_object, X509_NAME_ENTRY_get_data, X509_NAME_ENTRY_set_object, X509_NAME_ENTRY_set_data, X509_NAME_ENTRY_create_by_txt, X509_NAME_ENTRY_create_by_NID, X509_NAME_ENTRY_create_by_OBJ - X509_NAME_ENTRY utility functions

LIBRARY

libcrypto, -lcrypto

SYNOPSIS


 #include 


 ASN1_OBJECT * X509_NAME_ENTRY_get_object(X509_NAME_ENTRY *ne);
 ASN1_STRING * X509_NAME_ENTRY_get_data(X509_NAME_ENTRY *ne);


 int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, ASN1_OBJECT *obj);
 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type, const unsigned char *bytes, int len);




 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne, const char *field, int type, const unsigned char *bytes, int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid, int type,unsigned char *bytes, int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne, ASN1_OBJECT *obj, int type, const unsigned char *bytes, int len);

DESCRIPTION

_X_5_0_9___N_A_M_E___E_N_T_R_Y___g_e_t___o_b_j_e_c_t_(_) retrieves the field name of nnee in and AASSNN11__OOBBJJEECCTT structure.

_X_5_0_9___N_A_M_E___E_N_T_R_Y___g_e_t___d_a_t_a_(_) retrieves the field value of nnee in and AASSNN11__SSTTRRIINNGG structure.

_X_5_0_9___N_A_M_E___E_N_T_R_Y___s_e_t___o_b_j_e_c_t_(_) sets the field name of nnee to oobbjj.

_X_5_0_9___N_A_M_E___E_N_T_R_Y___s_e_t___d_a_t_a_(_) sets the field value of nnee to string type ttyyppee and value determined by bbyytteess and lleenn.

_X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___t_x_t_(_), _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___N_I_D_(_) and _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___O_B_J_(_) create and return an XX550099__NNAAMMEE__EENNTTRRYY structure.

NOTES

_X_5_0_9___N_A_M_E___E_N_T_R_Y___g_e_t___o_b_j_e_c_t_(_) and _X_5_0_9___N_A_M_E___E_N_T_R_Y___g_e_t___d_a_t_a_(_) can be used to examine an XX550099__NNAAMMEE__EENNTTRRYY function as returned by _X_5_0_9___N_A_M_E___g_e_t___e_n_t_r_y_(_) for example.

_X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___t_x_t_(_), _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___N_I_D_(_), and _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___O_B_J_(_) create and return an

_X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___t_x_t_(_), _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___O_B_J_(_), _X_5_0_9___N_A_M_E___E_N_T_R_Y___c_r_e_a_t_e___b_y___N_I_D_(_) and _X_5_0_9___N_A_M_E___E_N_T_R_Y___s_e_t___d_a_t_a_(_) are seldom used in practice because XX550099__NNAAMMEE__EENNTTRRYY structures are almost always part of XX550099__NNAAMMEE structures and the corresponding XX550099__NNAAMMEE functions are typically used to create and add new entries in a single operation.

The arguments of these functions support similar options to the similarly named ones of the corresponding XX550099__NNAAMMEE functions such as _X_5_0_9___N_A_M_E___a_d_d___e_n_t_r_y___b_y___t_x_t_(_). So for example ttyyppee can be set to MMBBSSTTRRIINNGG__AASSCC but in the case of _X_5_0_9___s_e_t___d_a_t_a_(_) the field name must be set first so the relevant field information can be looked up internally.

RETURN VALUES

SEE ALSO

_E_R_R___g_e_t___e_r_r_o_r(3), _d_2_i___X_5_0_9___N_A_M_E(3), _O_B_J___n_i_d_2_o_b_j(3),_O_B_J___n_i_d_2_o_b_j(3)

HISTORY

TBA