.\" 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_length 3SSL" .TH fr::crypto::ASN1_STRING_length 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_dup, ASN1_STRING_cmp, ASN1_STRING_set, ASN1_STRING_length, ASN1_STRING_length_set, ASN1_STRING_type, ASN1_STRING_data, ASN1_STRING_to_UTF8 \- Fonctions utilitaires \s-1ASN1_STRING\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \fB#include \fR .PP \fBint ASN1_STRING_length(\s-1ASN1_STRING\s0 *\fR\fIx\fR\fB);\fR \fBunsigned char * ASN1_STRING_data(\s-1ASN1_STRING\s0 *\fR\fIx\fR\fB);\fR .PP \fB\s-1ASN1_STRING\s0 * ASN1_STRING_dup(\s-1ASN1_STRING\s0 *\fR\fIa\fR\fB);\fR .PP \fBint ASN1_STRING_cmp(\s-1ASN1_STRING\s0 *\fR\fIa\fR\fB, \s-1ASN1_STRING\s0 *\fR\fIb\fR\fB);\fR .PP \fBint ASN1_STRING_set(\s-1ASN1_STRING\s0 *\fR\fIstr\fR\fB, const void *\fR\fIdata\fR\fB, int\fR \fIlen\fR\fB);\fR .PP \fBint ASN1_STRING_type(\s-1ASN1_STRING\s0 *\fR\fIx\fR\fB);\fR .PP \fBint ASN1_STRING_to_UTF8(unsigned char **\fR\fIout\fR\fB, \s-1ASN1_STRING\s0 *\fR\fIin\fR\fB);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" Ces fonctions permettent à une structure \fB\s-1ASN1_STRING\s0\fR d’être manipulée. .PP \&\fBASN1_STRING_length\fR() renvoie la taille du contenu de \fIx\fR. .PP \&\fBASN1_STRING_data\fR() renvoie un pointeur interne vers les données de \&\fIx\fR. Puisqu’il s’agit d’un pointeur interne, il ne devrait être libéré ou modifié en \fBaucune\fR façon. .PP \&\fBASN1_STRING_dup\fR() renvoie une copie de la structure \fIa\fR. .PP \&\fBASN1_STRING_cmp\fR() compare \fIa\fR et \fIb\fR en renvoyant \fB0\fR si les deux sont identiques. Les types et contenus des chaînes sont comparés. .PP \&\fBASN1_STRING_set\fR() définit les données de la chaîne \fIstr\fR au tampon \&\fIdata\fR ou à la taille \fIlen\fR. Les données fournies sont copiées. Si \fIlen\fR est \fB\-1\fR alors la taille est déterminée par \fBstrlen\fR(\fIdata\fR). .PP \&\fBASN1_STRING_type\fR() renvoie le type de \fIx\fR, en utilisant des constantes normalisées comme \fBV_ASN1_OCTET_STRING\fR. .PP \&\fBASN1_STRING_to_UTF8\fR() convertit la chaîne \fIin\fR au format \s-1UTF\-8,\s0 les données converties sont allouées dans un tampon de \fI*out\fR. La taille de \&\fIout\fR est renvoyée, ou un code d’erreur négatif. Le tampon \fI*out\fR devrait être libéré en utilisant \fBOPENSSL_free\fR(). .SH "NOTES" .IX Header "NOTES" Presque tous les types \s-1ASN1\s0 dans OpenSSL sont représentés comme une structure \fB\s-1ASN1_STRING\s0\fR. Les autre types comme \fB\s-1ASN1_OCTET_STRING\s0\fR ont simplement leur type défini en \fB\s-1ASN1_STRING\s0\fR et les fonctions appellent les équivalents \fB\s-1ASN1_STRING\s0\fR. \fB\s-1ASN1_STRING\s0\fR est aussi utilisée pour certains types \fB\s-1CHOICE\s0\fR de types primitif de chaîne comme \fBDirectoryString\fR et \&\fBTime\fR. .PP Ces fonctions ne devraient \fBpas\fR être utilisées pour examiner ou modifier des types \fB\s-1ASN1_INTEGER\s0\fR ou \fB\s-1ASN1_ENUMERATED\s0\fR : les fonctions utilitaires \&\fB\s-1INTEGER\s0\fR ou \fB\s-1ENUMERATED\s0\fR appropriées devraient être utilisées à la place. .PP En général, les données renvoyées par \fBASN1_STRING_data\fR() ne peuvent pas être supposées se terminer par \s-1NULL\s0 ou ne pas contenir de \s-1NULL\s0 incorporé. Le véritable format des données dépendra du type de chaîne présent : par exemple, pour un IA5String, les données seront \s-1ASCII,\s0 pour un BMPString, deux octets par caractère au format grand-boutiste, UTF8String sera au format \s-1UTF\-8.\s0 .PP Une attention similaire devrait être prise pour s’assurer que les données sont au format correct en appelant \fBASN1_STRING_set\fR(). .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBERR_get_error\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" .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.