.\" 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::X509_NAME_print_ex 3SSL" .TH fr::crypto::X509_NAME_print_ex 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" X509_NAME_print_ex, X509_NAME_print_ex_fp, X509_NAME_print, X509_NAME_oneline \- Routines d'affichage des structures X509_NAME .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& #include .Ve .PP \&\fB int X509_NAME_print_ex(\s-1BIO\s0 *\fR\fIout\fR\fB, X509_NAME *\fR\fInm\fR\fB, int\fR \fIindent\fR\fB, unsigned long\fR \fIflags\fR\fB);\fR \fBint X509_NAME_print_ex_fp(\s-1FILE\s0 *\fR\fIfp\fR\fB, X509_NAME *\fR\fInm\fR\fB, int\fR \fIindent\fR\fB, unsigned long\fR \fIflags\fR\fB);\fR \fBchar * X509_NAME_oneline(X509_NAME *\fR\fIa\fR\fB,char *\fR\fIbuf\fR\fB,int\fR \fItaille\fR\fB);\fR \fBint X509_NAME_print(\s-1BIO\s0 *\fR\fIbp\fR\fB, X509_NAME *\fR\fInom\fR\fB, int\fR \fIobase\fR\fB);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBX509_NAME_print_ex\fR() écrit une version lisible de \fInm\fR dans la \s-1BIO \&\s0\fIout\fR. Chaque ligne (pour les formats multilignes) est indentée de \&\fIindent\fR espaces. Le format de sortie peut être largement personnalisé par l'utilisation du paramètre \fIflags\fR. .PP \&\fBX509_NAME_print_ex_fp\fR() est identique à \fBX509_NAME_print_ex\fR() sauf que la sortie est écrite sur le pointeur de fichier \fIfp\fR . .PP \&\fBX509_NAME_oneline\fR() écrit une version \s-1ASCII\s0 de \fIa\fR dans \fIbuf\fR. Au moins \&\fItaille\fR octets seront écrits. Si \fIbuf\fR est \s-1NULL,\s0 alors un tampon est allouée dynamiquement et renvoyé, sinon \fIbuf\fR est renvoyé. .PP \&\fBX509_NAME_print\fR() écrit \fInom\fR dans \fIbp\fR en indentant chaque ligne de \&\fIobase\fR caractères. Plusieurs lignes sont utilisées si la sortie (y compris l’indentation) dépasse 80 caractères. .SH "NOTES" .IX Header "NOTES" Les fonctions \fBX509_NAME_oneline\fR() et \fBX509_NAME_print\fR() sont des fonctions anciennes qui produisent une forme de sortie non standard, elles ne traitent pas les champs de multicaractères et ont diverses bizarreries et incohérences. Leur utilisation est fortement déconseillée dans de nouvelles applications. .PP Bien qu'il existe un grand nombre de drapeaux pour des besoins les plus divers, \fB\s-1XN_FLAG_ONELINE\s0\fR , \fB\s-1XN_FLAG_MULTILINE\s0\fR ou \fB\s-1XN_FLAG_RFC2253\s0\fR suffiront. Comme indiqué sur la page de manuel \&\fBASN1_STRING_print_ex\fR(3) pour terminaux \s-1UTF8, \&\s0\fB\s-1ASN1_STRFLGS_ESC_MSB \s0\fR devrait être désactivé : par exemple \&\fB\s-1XN_FLAG_ONELINE &\s0 ~ \s-1ASN1_STRFLGS_ESC_MSB\s0\fR serait utilisé. .PP L'ensemble des indicateurs pris en charge par \fBX509_NAME_print_ex\fR() est listé ci-dessous. .PP Le choix entre plusieurs options peut être proposé. .PP Les options \fB\s-1XN_FLAG_SEP_COMMA_PLUS\s0\fR, \fB\s-1XN_FLAG_SEP_CPLUS_SPC\s0\fR, \&\fB\s-1XN_FLAG_SEP_SPLUS_SPC\s0\fR et \fB\s-1XN_FLAG_SEP_MULTILINE\s0\fR déterminent les séparateurs de champ à utiliser. Deux séparateurs distincts sont utilisés entre les composants différents de RelativeDistinguishedName et séparent les valeurs dans le même \s-1RDN\s0 pour un \s-1RDN\s0 multi-valeur. Les \s-1RDN\s0 multi-valeurs sont actuellement très rares et le second séparateur peut ne presque jamais être utilisé. .PP \&\fB\s-1XN_FLAG_SEP_COMMA_PLUS\s0\fR utilise une virgule et le signe « + » comme séparateurs. \fB\s-1XN_FLAG_SEP_CPLUS_SPC\s0\fR utilise une virgule et le signe « + » avec des espaces : cela est plus lisible que la simple virgule avec le « + ». \fB\s-1XN_FLAG_SEP_SPLUS_SPC\s0\fR utilise un point-virgule et un « + » espacés. \fB\s-1XN_FLAG_SEP_MULTILINE\s0\fR utilise un saut de ligne et un « + » espacés. .PP Si \fB\s-1XN_FLAG_DN_REV\s0\fR est activé alors l'ensemble des \s-1DN\s0 est affiché dans l'ordre inverse. .PP Les champs \fB\s-1XN_FLAG_FN_SN\s0\fR, \fB\s-1XN_FLAG_FN_LN\s0\fR, \fB\s-1XN_FLAG_FN_OID\s0\fR, \&\fB\s-1XN_FLAG_FN_NONE\s0\fR déterminent comment un nom de champ est affiché. Ils utiliseront respectivement, le nom court (par exemple \s-1CN\s0), le nom long (par exemple commonName) qui utilise toujours la forme numérique de l'\s-1OID \&\s0(normalement les \s-1OID\s0 ne sont utilisés que si le nom de champ n'est pas reconnu) et pas de nom de champ. .PP Si \fB\s-1XN_FLAG_SPC_EQ\s0\fR est activé, alors des espaces seront placées autour des caractères « = » séparant les champs noms et valeurs. .PP Si \fB\s-1XN_FLAG_DUMP_UNKNOWN_FIELDS\s0\fR est activé, l’encodage champs inconnus est affiché à la place des valeurs. .PP Si \fB\s-1XN_FLAG_FN_ALIGN\s0\fR est activé, alors les champs noms sont étendus à 20 caractères : cela est seulement utilisé pour le format multiligne. .PP De plus, toutes les options prises en charge par \fBASN1_STRING_print_ex\fR() peuvent être utilisées pour contrôler la façon dont chaque valeur de champ est affiché. .PP En plus, une option numéro peut être définie pour les formats couramment utilisés. .PP \&\fB\s-1XN_FLAG_RFC2253\s0\fR définit les options qui produisent une sortie compatible avec la \s-1RFC2253 \s0; cela est équivalent à : \&\fB\s-1ASN1_STRFLGS_RFC2253\s0\fR | \fB\s-1XN_FLAG_SEP_COMMA_PLUS\s0\fR | \fB\s-1XN_FLAG_DN_REV\s0\fR | \fB\s-1XN_FLAG_FN_SN\s0\fR | \fB\s-1XN_FLAG_DUMP_UNKNOWN_FIELDS\s0\fR .PP \&\fB\s-1XN_FLAG_ONELINE\s0\fR est un format d’une seule ligne, plus lisible, qui est identique à : \fB\s-1ASN1_STRFLGS_RFC2253\s0\fR | \fB\s-1ASN1_STRFLGS_ESC_QUOTE\s0\fR | \fB\s-1XN_FLAG_SEP_CPLUS_SPC\s0\fR | \fB\s-1XN_FLAG_SPC_EQ\s0\fR | \fB\s-1XN_FLAG_FN_SN\s0\fR .PP \&\fB\s-1XN_FLAG_MULTILINE\s0\fR est un format multiligne qui est le même que : \fB\s-1ASN1_STRFLGS_ESC_CTRL\s0\fR | \fB\s-1ASN1_STRFLGS_ESC_MSB\s0\fR | \fB\s-1XN_FLAG_SEP_MULTILINE\s0\fR | \fB\s-1XN_FLAG_SPC_EQ\s0\fR | \fB\s-1XN_FLAG_FN_LN\s0\fR | \fB\s-1XN_FLAG_FN_ALIGN\s0\fR .PP \&\fB\s-1XN_FLAG_COMPAT\s0\fR utilise un format identique à \fBX509_NAME_print\fR() : en fait, il appelle \fBX509_NAME_print\fR() en interne. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBASN1_STRING_print_ex\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" À préciser .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.