SYNOPSIS

#include <openssl/x509.h>

int X509_NAME_add_entry_by_txt(X509_NAME *nom, const char *champ, int type, const unsigned char *bytes, int len, int loc, int set);

int X509_NAME_add_entry_by_OBJ(X509_NAME *nom, ASN1_OBJECT *obj, int type, unsigned char *bytes, int len, int loc, int set);

int X509_NAME_add_entry_by_NID(X509_NAME *nom, int nid, int type, unsigned char *bytes, int len, int loc, int set);

int X509_NAME_add_entry(X509_NAME *nom,X509_NAME_ENTRY *ne, int loc, int set);

X509_NAME_ENTRY *X509_NAME_delete_entry(X509_NAME *nom, int loc);

DESCRIPTION

Le type de champ est déterminé par type qui peut être soit une définition du type de bytes (tel que MBSTRING_ASC) ou un type ASN1 standard (tel que V_ASN1_IA5STRING). La nouvelle entrée est ajoutée à une position déterminée par loc et set.

X509_NAME_add_entry() ajoute une copie de la structure X509_NAME_ENTRY ne à nom. La nouvelle entrée est ajoutée à une position déterminée par loc et set. Puisqu'une copie de ne est ajoutée, ne doit être libéré après l'appel.

X509_NAME_delete_entry() supprime une entrée de nom à la position loc. L'entrée supprimée est renvoyée et doit être libérée.

NOTES

Si un type ASN1 est utilisé à la place, alors aucun contrôle n'est effectué et les données dans bytes sont utilisées directement.

Dans X509_NAME_add_entry_by_txt() la chaîne field représente le nom du champ à l'aide de OBJ_txt2obj(champ, 0).

Les paramètres loc et set déterminent où une nouvelle entrée devrait être ajoutée. Pour la quasi-totalité des applications loc peut être réglé à -1 et set à 0. Cela ajoute une nouvelle entrée à la fin de nom comme une valeur unique de « RelativeDistinguishedName » (RDN).

loc détermine en fait l'index où la nouvelle entrée est insérée : s’il vaut -1, elle est ajoutée à la fin.

set détermine comment le nouveau type est ajouté. S’il vaut zéro, un nouveau RDN est créé.

Si set est -1 ou 1, il est ajouté respectivement à la structure RDN précédente ou suivante. Ce sera alors un RDN multi-valeur : comme les RDN multi-valeur sont très rarement utilisés, set est presque toujours mis à zéro.

EXEMPLES

``C=FR, O=Organisation désorganisée, CN=Joe Bloggs''

 X509_NAME *nm;
 nm = X509_NAME_new();
 if (nm == NULL)
        /* Une erreur*/
 if S<( X509_NAME_add_entry_by_txt(nm,> "C", MBSTRING_ASC,
                        "FR", -1, -1, 0))
        /* Erreur */
 if S<( !X509_NAME_add_entry_by_txt(nm,> "O", MBSTRING_ASC,
                        "Organisation désorganisée", -1, -1, 0))
        /* Erreur */
 if S<( !X509_NAME_add_entry_by_txt(nm,> "CN", MBSTRING_ASC,
                        "Joe Bloggs", -1, -1, 0))
        /* Erreur */

VALEURS DE RETOUR

X509_NAME_delete_entry() renvoie soit la structure X509_NAME_ENTRY supprimée ou NULL si une erreur s'est produite.

HISTORIQUE

TRADUCTION