OPENSSL_config(3) Fonctions simples de configuration

Other Alias

OPENSSL_no_config

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.

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.