.\" 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::ASN1_STRING_print_ex 3SSL" .TH fr::crypto::ASN1_STRING_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" ASN1_STRING_print_ex, ASN1_STRING_print_ex_fp, ASN1_STRING_print \- Routines de sortie \s-1ASN1_STRING\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \fB#include \fR .PP \fBint ASN1_STRING_print_ex(\s-1BIO\s0 *\fR\fIout\fR\fB, \s-1ASN1_STRING\s0 *\fR\fIstr\fR\fB, unsigned long\fR \fIflags\fR\fB);\fR \fBint ASN1_STRING_print_ex_fp(\s-1FILE\s0 *\fR\fIfp\fR\fB, \s-1ASN1_STRING\s0 *\fR\fIstr\fR\fB, unsigned long\fR \fIflags\fR\fB);\fR \fBint ASN1_STRING_print(\s-1BIO\s0 *\fR\fIout\fR\fB, \s-1ASN1_STRING\s0 *\fR\fIstr\fR\fB);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" Ces fonctions renvoient une structure \fB\s-1ASN1_STRING\s0\fR. \fB\s-1ASN1_STRING\s0\fR est utilisée pour représenter tous les types de chaîne \s-1ASN1.\s0 .PP \&\fBASN1_STRING_print_ex\fR() renvoie \fIstr\fR vers \fIout\fR, le format est déterminé par les options \fIflags\fR. \fBASN1_STRING_print_ex_fp\fR() est identique à part qu’elle renvoie à la place vers \fIfp\fR. .PP \&\fBASN1_STRING_print\fR() affiche \fIstr\fR vers \fIout\fR mais en utilisant un format différent de \fBASN1_STRING_print_ex\fR(). Elle remplace les caractères non imprimables (autres que \s-1RC\s0 et \s-1PAL\s0 — \s-1CR\s0 et \s-1LF\s0 en anglais) par « . ». .SH "NOTES" .IX Header "NOTES" \&\fBASN1_STRING_print\fR() est une fonction obsolète qui devrait être évitée dans les nouvelles applications. .PP Malgré un grand nombre d’options, \fB\s-1ASN1_STRFLGS_RFC2253\s0\fR convient souvent, ou \fB\s-1ASN1_STRFLGS_RFC2253 &\s0 ~ASN1_STRFLGS_ESC_MSB\fR sur les terminaux \s-1UTF\-8.\s0 .PP La totalité des options acceptées pour \fIflags\fR est décrite ci-dessous. .PP Plusieurs caractères peuvent être protégés. Si \fB\s-1ASN1_STRFLGS_ESC_2253\s0\fR est définie, les caractères déterminés par la \s-1RFC 2253\s0 sont protégés. Si \&\fB\s-1ASN1_STRFLGS_ESC_CTRL\s0\fR est définie, les caractères de contrôle sont protégés. Si \fB\s-1ASN1_STRFLGS_ESC_MSB\s0\fR est définie, les caractères avec le bit de poids fort défini sont protégés : cette option ne devrait \fBpas\fR être utilisée si le terminal interprète correctement les suites \s-1UTF\-8.\s0 .PP Les protections prennent différentes formes. .PP Si le caractère à protéger est un caractère de 16 bits, alors la forme « \eUXXXX » est utilisée avec exactement quatre caractères pour la représentation hexadécimale. Si c’est en 32 bits, alors « \eWXXXXXXXX » est utilisée avec huit caractères pour sa représentation hexadécimale. Ces formes ne sont utilisées que si la conversion en \s-1UTF\-8\s0 n’est pas définie (voir ci-dessous). .PP Les caractères imprimables sont normalement protégés à l’aide d’une barre oblique inversée « \e ». Si \fB\s-1ASN1_STRFLGS_ESC_QUOTE\s0\fR est définie, alors toute la chaîne est à la place entourée de guillemets : ce peut être considéré plus lisible que la notation en barre oblique inversée. D’autres caractères utilisent « \eXX » avec exactement deux caractères de la représentation hexadécimale. .PP Si \fB\s-1ASN1_STRFLGS_UTF8_CONVERT\s0\fR est définie, alors les caractères sont d’abord convertis au format \s-1UTF\-8.\s0 Si le terminal permet d’afficher les suites \s-1UTF\-8,\s0 alors cette option permettra d’afficher correctement les caractères multioctets. .PP Si \fB\s-1ASN1_STRFLGS_IGNORE_TYPE\s0\fR est définie, alors le type de chaîne n’est pas interprété du tout : tout est supposé être un octet par caractère. C’est surtout pour le débogage et peut résulter en affichage déroutant pour les chaînes multicaractères. .PP Si \fB\s-1ASN1_STRFLGS_SHOW_TYPE\s0\fR est définie, alors le type de chaîne lui\-même est affiché avant sa valeur (par exemple « \s-1BMPSTRING\s0 »), cela utilise en fait \fBASN1_tag2str\fR(). .PP Le contenu d’une chaîne, au lieu d’être interprété, peut être « déversé » : cela n’affiche que la valeur de la chaîne utilisant la forme #XXXX avec un format hexadécimal pour chaque octet. .PP Si \fB\s-1ASN1_STRFLGS_DUMP_ALL\s0\fR est définie, alors tous les types sont déversés. .PP Normalement, les types de chaîne de non caractères (comme \s-1OCTET STRING\s0) sont supposés être d’un octet par caractère, si \fB\s-1ASN1_STRFLGS_DUMP_UNKNOWN\s0\fR est définie, alors elles seront déversées à la place. .PP Quand un type est déversé normalement, seul les octets du contenu sont affichés, si \fB\s-1ASN1_STRFLGS_DUMP_DER\s0\fR est définie, alors l’encodage complet est déversé à la place (y compris les octets d’étiquette et de taille). .PP \&\fB\s-1ASN1_STRFLGS_RFC2253\s0\fR contient tous les attributs requis par la \s-1RFC 2253.\s0 C’est équivalent à : \s-1ASN1_STRFLGS_ESC_2253\s0 | \s-1ASN1_STRFLGS_ESC_CTRL\s0 | \s-1ASN1_STRFLGS_ESC_MSB\s0 | \s-1ASN1_STRFLGS_UTF8_CONVERT\s0 | \s-1ASN1_STRFLGS_DUMP_UNKNOWN ASN1_STRFLGS_DUMP_DER\s0 .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBASN1_tag2str\fR(3), \&\fBX509_NAME_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.