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 nom par défaut openssl_conf
       sera utilisé. Toutes les erreurs seront ignorées. Les appels suivants d’OPENSSL_config()
       n’auront aucun effet. Le format du fichier de configuration est documenté dans la page de
       manuel config(5).

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

NOTES

       Toutes les nouvelles applications devraient très préférablement appeler OPENSSL_config()
       ou les fonctions plus sophistiquées comme CONF_modules_load() lors de l’initialisation
       (c’est-à-dire avant de commencer un nouveau processus léger). En faisant cela, une
       application n’a pas besoin de garder trace de toutes les options de configuration et de
       nouvelles fonctionnalités peuvent être prises en charge automatiquement.

       OPENSSL_config() peut aussi être appelée automatiquement quand une application appelle
       OPENSSL_add_all_algorithms() en compilant une application avec le symbole de préprocesseur
       OPENSSL_LOAD_CONF défini. Ainsi, la configuration peut être ajoutée sans modification des
       sources.

       La variable d’environnement OPENSSL_CONF peut être définie pour indiquer l’emplacement du
       fichier de configuration.

       Les configurations d’OBJECT ASN1 et d’ENGINE peuvent actuellement être réalisées, les
       prochaines versions d’OpenSSL ajouteront de nouvelles options de configuration.

       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().

RESTRICTIONS

       La fonction OPENSSL_config() est conçue pour être une fonction très simple à « appeler et
       oublier ». Par conséquent, son comportement est assez limité. Elle ignore toutes les
       erreurs silencieusement et ne peut par exemple charger que depuis l’emplacement standard
       du fichier de configuration.

       C’est cependant bien mieux que rien. Les applications qui ont besoin d’un contrôle plus
       fin de leur fonctionnalité de configuration devraient utiliser les fonctions de
       configuration comme CONF_load_modules() directement.

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.