NOM

       OPENSSL_config, OPENSSL_no_config - Fonctions simples de configuration d’OpenSSL

SYNOPSIS

        #include <openssl/conf.h>

        void OPENSSL_config(const char *config_name);
        void OPENSSL_no_config(void);

DESCRIPTION

       OPENSSL_config() configure OpenSSL avec le fichier de configuration standard openssl.cnf
       en utilisant config_name. Si config_name est NULL, alors le fichier indiqué dans la
       variable d’environnement OPENSSL_CONF sera utilisé, et si elle n’est pas définie, un
       emplacement par défaut du système sera utilisé. Les erreurs sont ignorées silencieusement.
       Plusieurs appels n’ont aucun effet.

       OPENSSL_no_config() désactive la configuration. Si elle est appelée avant
       OPENSSL_config(), aucune configuration n’aura lieu.

NOTES

       La fonction OPENSSL_config() est conçue comme une fonction très simple à « appeler et
       oublier ». C’est cependant bien mieux que rien. Les applications nécessitant un contrôle
       plus fin de leur fonctionnalité de configuration devraient utiliser les fonctions de
       configuration comme CONF_load_modules() directement. OPENSSL_config() est obsolète et son
       utilisation est à éviter. Les applications devraient plutôt utiliser CONF_load_modules()
       lors de l’initialisation (c’est-à-dire avant de commencer un nouveau processus léger).

       Plusieurs raisons justifient la recommandation d’utiliser les routines de configuration
       d’OpenSSL. Par exemple, la nouvelle fonctionnalité ENGINE a été ajoutée à OpenSSL 0.9.7.
       Dans OpenSSL 0.9.7, les fonctions de contrôle peuvent être prises en charge par les
       ENGINE, cela peut être utilisé (entre autres) pour charger des ENGINE dynamiques depuis
       des bibliothèques partagées (DSO). Cependant, très peu d’applications prennent
       actuellement en charge l’interface de contrôle et donc très peu peuvent charger et
       utiliser des ENGINE dynamiques. De même, à l’avenir, des ENGINE plus sophistiqués
       nécessiteront certaines opérations de contrôle pour les personnaliser. Si une application
       appelle OPENSSL_config(), elle n’a pas besoin de savoir ou s’inquiéter des opérations de
       contrôle d’ENGINE car elles peuvent être réalisées en modifiant un fichier de
       configuration.

       Les applications devraient libérer la configuration lors de la fermeture de l’application
       en appelant CONF_modules_free().

VALEURS DE RETOUR

       Ni OPENSSL_config() ni OPENSSL_no_config() ne renvoient de valeur.

VOIR AUSSI

       CONF_load_modules_file(3), CONF_modules_free(3), config(5)

HISTORIQUE

       OPENSSL_config() et OPENSSL_no_config() sont apparues pour la première fois dans
       OpenSSL 0.9.7

TRADUCTION

       La traduction de cette page de manuel est maintenue par les membres de la liste
       <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de
       traduction par un rapport de bogue sur le paquet manpages-fr-extra.