.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "fr::crypto::CONF_modules_load_file 3SSL" .TH fr::crypto::CONF_modules_load_file 3SSL "2015-12-31" "1.0.2a 1.0.2c" "OpenSSL" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" .Vb 1 \& CONF_modules_load_file, CONF_modules_load \- Fonctions de configuration d\*(AqOpenSSL .Ve .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& #include \& \& int CONF_modules_load_file(const char *filename, const char *appname, \& unsigned long flags); \& int CONF_modules_load(const CONF *cnf, const char *appname, \& unsigned long flags); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" La fonction \fICONF_modules_load_file()\fR configure OpenSSL en utilisant le fichier \fBfilename\fR et l'application \fBappname\fR. Si \fBfilename\fR vaut \s-1NULL,\s0 le fichier standard de configuration d'OpenSSL est utilisé. Si \fBappname\fR vaut \s-1NULL,\s0 le nom d'application standard d’OpenSSL, \fBopenssl_conf\fR, est utilisé. Le comportement peut être personnalisé en utilisant \fBflags\fR. .PP \&\fICONF_modules_load()\fR est identique à \fICONF_modules_load_file()\fR sauf qu'il lit l'information de configuration depuis \fBcnf\fR. .SH "NOTES" .IX Header "NOTES" Les \fBflags\fR suivants sont reconnus : .PP Si \fB\s-1CONF_MFLAGS_IGNORE_ERRORS\s0\fR est activé, les erreurs renvoyées individuellement par les modules de configuration sont ignorées. Sinon la première erreur provenant d’un module sera considérée comme fatale et aucun autre module ne sera chargé. .PP Normalement, toutes les erreurs provenant des modules ajouteront des informations à la file d’erreur. Si \fB\s-1CONF_MFLAGS_SILENT\s0\fR est activé, il n'y aura pas d'information d'erreur ajoutée. .PP Si \fB\s-1CONF_MFLAGS_NO_DSO\s0\fR est activé, le module de configuration chargeant à partir des \s-1DSO\s0 est désactivé. .PP Si \fB\s-1CONF_MFLAGS_IGNORE_MISSING_FILE\s0\fR est activé, \fICONF_load_modules_file()\fR ignorera l'absence de fichiers de configuration. Normalement l'absence d'un fichier de configuration renvoie une erreur. .PP Si \fB\s-1CONF_MFLAGS_DEFAULT_SECTION\s0\fR est activé, et \fBappname\fR n'est pas \s-1NULL,\s0 il utilisera la section par défaut pointée par \fBopenssl_conf\fR si \fBappname\fR n'existe pas. .PP Les applications devraient appeler ces fonctions après le chargement des modules intégrés en utilisant \fBOPENSSL_load_builtin_modules\fR(), par exemple, tous les \s-1ENGINES\s0 en utilisant \fBENGINE_load_builtin_engines\fR(), tous les algorithmes en utilisant \fBOPENSSL_add_all_algorithms\fR() et (si l'application utilise libssl) \fBSSL_library_init\fR(). .PP En utilisant \fBCONF_modules_load_file\fR() avec les réglages appropriés, une application peut personnaliser sa configuration pour mieux répondre à ses besoins. Dans certains cas, l'utilisation d'un fichier de configuration est facultatif et son absence n'est pas une erreur : dans ce cas \&\fB\s-1CONF_MFLAGS_IGNORE_MISSING_FILE\s0\fR devrait être activé. .PP Les erreurs lors de la configuration peuvent aussi être traitées autrement par différentes applications. Par exemple, dans certains cas, une erreur peut seulement afficher un message d'avertissement et l'application continue. Dans d'autres cas, l'application peut considérer comme fatale une erreur de ficher de configuration et se terminer immédiatement. .PP Des applications peuvent utiliser la fonction \fBCONF_modules_load\fR() si elles souhaitent charger elles\-mêmes un fichier de configuration et avoir un contrôle plus fin sur la manière dont les erreurs sont traitées. .SH "EXEMPLES" .IX Header "EXEMPLES" Charger un fichier de configuration, afficher toutes les erreurs et terminer l'application (absence de fichier considérée comme fatale) : .PP .Vb 5 \& if (CONF_modules_load_file(NULL, NULL, 0) <= 0) { \& fprintf(stderr, "FATAL: error loading configuration file\en"); \& ERR_print_errors_fp(stderr); \& exit(1); \& } .Ve .PP Charger le ficher de configuration par défaut en utilisant la section indiquée par « myapp », tolérer les fichiers manquants, mais terminer l'application si d'autres erreurs surviennent : .PP .Vb 6 \& if (CONF_modules_load_file(NULL, "myapp", \& CONF_MFLAGS_IGNORE_MISSING_FILE) <= 0) { \& fprintf(stderr, "FATAL: error loading configuration file\en"); \& ERR_print_errors_fp(stderr); \& exit(1); \& } .Ve .PP Charger la section et le fichier de configuration personnalisés, afficher seulement des avertissements en cas d'erreur, l'absence de fichier de configuration est ignorée : .PP .Vb 5 \& if (CONF_modules_load_file("/something/app.cnf", "myapp", \& CONF_MFLAGS_IGNORE_MISSING_FILE) <= 0) { \& fprintf(stderr, "WARNING: error loading configuration file\en"); \& ERR_print_errors_fp(stderr); \& } .Ve .PP Charger et analyser soi\-même le fichier de configuration, traitement d'erreur personnalisé : .PP .Vb 10 \& FILE *fp; \& CONF *cnf = NULL; \& long eline; \& fp = fopen("/somepath/app.cnf", "r"); \& if (fp == NULL) { \& fprintf(stderr, "Error opening configuration file\en"); \& /* Other missing configuration file behaviour */ \& } else { \& cnf = NCONF_new(NULL); \& if (NCONF_load_fp(cnf, fp, &eline) == 0) { \& fprintf(stderr, "Error on line %ld of configuration file\en", eline); \& ERR_print_errors_fp(stderr); \& /* Other malformed configuration file behaviour */ \& } else if (CONF_modules_load(cnf, "appname", 0) <= 0) { \& fprintf(stderr, "Error configuring application\en"); \& ERR_print_errors_fp(stderr); \& /* Other configuration error behaviour */ \& } \& fclose(fp); \& NCONF_free(cnf); \& } .Ve .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" Ces fonctions renvoient 1 pour un succès et 0 ou une valeur négative pour un échec. Si les erreurs des modules ne sont pas ignorées, le code de retour représentera la valeur de retour du module défaillant (cette valeur sera toujours inférieure ou égale à 0). .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBerr\fR(3),\fIerr\fR\|(3), \fBOPENSSL_config\fR(3), \&\fBCONF_free\fR(3), \fBconf\fR(5) .SH "HISTORIQUE" .IX Header "HISTORIQUE" CONF_modules_load_file et CONF_modules_load sont apparues dans la version 0.9.7 d'OpenSSL. .SH "TRADUCTION" .IX Header "TRADUCTION" La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.