openssl - en to fr translation catalogue (182 entries)

note: type: =head1
en: NAME
fr: NOM

note: type: textblock
en: asn1parse - ASN.1 parsing tool
fr: asn1parse - Outil d'interprétation ASN.1

note: type: textblock
en: B<openssl> B<asn1parse> [B<-inform PEM|DER>] [B<-in filename>] [B<-out filename>] [B<-noout>] [B<-offset number>] [B<-length number>] [B<-i>] [B<-oid filename>] [B<-dump>] [B<-dlimit num>] [B<-strparse offset>] [B<-genstr string>] [B<-genconf file>]
fr: B<openssl> B<asn1parse> [B<-inform PEM>|B<DER>] [B<-in> I<fichier>] [B<-out> I<fichier>] [B<-noout>] [B<-offset> I<nombre>] [B<-length> I<nombre>] [B<-i>] [B<-oid> I<fichier>] [B<-dump>] [B<-dlimit> I<nombre>] [B<-strparse> I<position>] [B<-genstr> I<chaîne>] [B<-genconf> I<fichier>]

note: type: textblock
en: The B<asn1parse> command is a diagnostic utility that can parse ASN.1 structures. It can also be used to extract data from ASN.1 formatted data.
fr: La commande B<asn1parse> est un utilitaire de diagnostic permettant d'interpréter des structures ASN.1. Il peut aussi être utilisé pour extraire des informations de données au format ASN.1.

note: type: =item
en: B<-inform> B<DER|PEM>
fr: B<-inform> B<DER>|B<PEM>

note: type: textblock
en: the input format. B<DER> is binary format and B<PEM> (the default) is base64 encoded.
fr: Le format d'entrée. B<DER> est le format binaire et B<PEM> (par défaut) est encodé en base64.

note: type: =item
en: B<-in filename>
fr: B<-in> I<fichier>

note: type: textblock
en: the input file, default is standard input
fr: Le fichier d'entrée, par défaut l'entrée standard.

note: type: =item
en: B<-out filename>
fr: B<-out> I<fichier>

note: type: textblock
en: output file to place the DER encoded data into. If this option is not present then no data will be output. This is most useful when combined with the B<-strparse> option.
fr: Le fichier de sortie où les données encodées au format DER sont stockées. Sans cette option, aucune donnée ne sera créée. C'est en particulier utile en combinaison avec l'option B<-strparse>.

note: type: textblock
en: don't output the parsed version of the input file.
fr: Ne pas afficher la version interprétée du fichier d'entrée.

note: type: =item
en: B<-offset number>
fr: B<-offset> I<nombre>

note: type: textblock
en: starting offset to begin parsing, default is start of file.
fr: Position initiale avant le début de l'interprétation, par défaut c'est le début du fichier.

note: type: =item
en: B<-length number>
fr: B<-length> I<nombre>

note: type: textblock
en: number of bytes to parse, default is until end of file.
fr: Nombre d'octets à interpréter, par défaut jusqu'à la fin de fichier.

note: type: textblock
en: indents the output according to the "depth" of the structures.
fr: Indentation du fichier de sortie en fonction de la profondeur de la structure.

note: type: =item
en: B<-oid filename>
fr: B<-oid> I<fichier>

note: type: textblock
en: a file containing additional OBJECT IDENTIFIERs (OIDs). The format of this file is described in the NOTES section below.
fr: Fichier contenant des identifiants d'objets (« OBJECT IDENTIFIER », OID) supplémentaires. Le format utilisé pour ce fichier est décrit dans la section B<NOTES> ci-dessous.

note: type: textblock
en: dump unknown data in hex format.
fr: Vider les données inconnues au format hexadécimal.

note: type: =item
en: B<-dlimit num>
fr: B<-dlimit> I<nombre>

note: type: textblock
en: like B<-dump>, but only the first B<num> bytes are output.
fr: Comme B<-dump>, mais seuls les I<nombre> premiers octets sont affichés.

note: type: =item
en: B<-strparse offset>
fr: B<-strparse> I<position>

note: type: textblock
en: parse the contents octets of the ASN.1 object starting at B<offset>. This option can be used multiple times to "drill down" into a nested structure.
fr: Interpréter le contenu de l'objet ASN.1 à partir de l'octet indiqué par I<position>. Cette option peut être appelée plusieurs fois afin de descendre dans une structure imbriquée.

note: type: =item
en: B<-genstr string>, B<-genconf file>
fr: B<-genstr> I<chaîne>, B<-genconf> I<fichier>

note: type: textblock
en: generate encoded data based on B<string>, B<file> or both using L<ASN1_generate_nconf(3)|ASN1_generate_nconf(3)> format. If B<file> only is present then the string is obtained from the default section using the name B<asn1>. The encoded data is passed through the ASN1 parser and printed out as though it came from a file, the contents can thus be examined and written to a file using the B<out> option.
fr: Créer des données encodées à partir de I<chaîne>, de I<fichier> ou des deux, en utilisant le format de B<ASN1_generate_nconf>(3). Si seul I<fichier> est présent, alors la chaîne est obtenue dans la section par défaut en utilisant le nom B<asn1>. Les données encodées sont passées à un analyseur ASN1 et affichées même si elles proviennent d'un fichier. Le contenu peut ainsi être examiné et écrit dans un fichier en utilisant l'option B<-out>.

note: type: =head2
en: OUTPUT
fr: SORTIE

note: type: textblock
en: The output will typically contain lines like this:
fr: Le résultat se présente typiquement de la façon suivante :

note: type: textblock
en: This example is part of a self signed certificate. Each line starts with the offset in decimal. B<d=XX> specifies the current depth. The depth is increased within the scope of any SET or SEQUENCE. B<hl=XX> gives the header length (tag and length octets) of the current type. B<l=XX> gives the length of the contents octets.
fr: Cet exemple est une partie d'un certificat autosigné. Chaque ligne débute avec la position en décimal. B<d=>I<XX> désigne le niveau de profondeur actuel. Cette profondeur est incrémentée pour chaque SET ou SEQUENCE. B<hl=>I<XX> donne la longueur de l'en-tête (octets de la balise et de l'en-tête) du type en cours. B<l=>I<XX> précise la longueur du contenu.

note: type: textblock
en: The B<-i> option can be used to make the output more readable.
fr: Avec l'option B<-i> l'affichage est plus lisible.

note: type: textblock
en: Some knowledge of the ASN.1 structure is needed to interpret the output.
fr: Quelques connaissances de la structure ASN.1 sont nécessaires pour interpréter la sortie.

note: type: textblock
en: In this example the BIT STRING at offset 229 is the certificate public key.  The contents octets of this will contain the public key information. This can be examined using the option B<-strparse 229> to yield:
fr: Dans cet exemple, la clef publique du certificat est le BIT STRING à la position 229. Les octets du contenu contiennent l'information de la clef publique. Cela peut être examiné en utilisant l'option B<-strparse 229> pour obtenir :

note: type: textblock
en: If an OID is not part of OpenSSL's internal table it will be represented in numerical form (for example 1.2.3.4). The file passed to the B<-oid> option allows additional OIDs to be included. Each line consists of three columns, the first column is the OID in numerical format and should be followed by white space. The second column is the "short name" which is a single word followed by white space. The final column is the rest of the line and is the "long name". B<asn1parse> displays the long name. Example:
fr: Si un identifiant d'objet (OID) ne figure pas dans la table interne d'OpenSSL, il sera représenté sous forme numérique (par exemple 1.2.3.4). Le fichier fourni avec l'option B<-oid> permet d'inclure des OID supplémentaires. Chaque ligne contient trois colonnes, la première étant l'OID sous forme numérique et doit être suivi d'espace. La deuxième colonne est le « short name » (libellé court), un seul mot suivi d'espace. La dernière colonne est le reste de la ligne contenant le libellé long (« long name »), affiché par B<asn1parse>. Exemple :

note: type: textblock
en: C<1.2.3.4	shortName	A long name>
fr: C<1.2.3.4	nomCourt	un nom long>

note: type: =head1
en: EXAMPLES
fr: EXEMPLES

note: type: textblock
en: Parse a file:
fr: Interpréter un fichier :

note: type: textblock
en: Parse a DER file:
fr: Interpréter un fichier DER :

note: type: textblock
en: Generate a simple UTF8String:
fr: Créer une UTF8String simple :

note: type: verbatim
en:  openssl asn1parse -genstr 'UTF8:Hello World'
fr:  openssl asn1parse -genstr 'UTF8:Salut le monde'

note: type: textblock
en: Generate and write out a UTF8String, don't print parsed output:
fr: Créer et écrire une UTF8String, sans afficher la sortie analysée :

note: type: verbatim
en:  openssl asn1parse -genstr 'UTF8:Hello World' -noout -out utf8.der
fr:  openssl asn1parse -genstr 'UTF8:Salut le monde' -noout -out utf8.der

note: type: textblock
en: Generate using a config file:
fr: Créer en utilisant un fichier de configuration :

note: type: textblock
en: Example config file:
fr: Exemple de fichier de configuration :

note: type: verbatim
en:  field1=BOOL:TRUE
     field2=EXP:0, UTF8:some random string
fr:  field1=BOOL:TRUE
     field2=EXP:0, UTF8:une chaîne aléatoire

note: type: =head1
en: BUGS
fr: BOGUES

note: type: textblock
en: There should be options to change the format of output lines. The output of some ASN.1 types is not well handled (if at all).
fr: Des options devraient permettre de modifier le format des lignes de l'entrée. La sortie de certains types ASN.1 n'est pas proprement gérée voire pas du tout.

note: type: =head1
en: SEE ALSO
fr: VOIR AUSSI

note: type: textblock
en: L<ASN1_generate_nconf(3)|ASN1_generate_nconf(3)>
fr: B<ASN1_generate_nconf>(3)

note: type: textblock
en: ASN1_OBJECT_new, ASN1_OBJECT_free, - object allocation functions
fr: ASN1_OBJECT_new, ASN1_OBJECT_free, - Fonctions d'allocation d'objets

note: type: verbatim
en:  #include <openssl/asn1.h>
fr: Z<>
     B<#include E<lt>openssl/asn1.hE<gt>>

note: type: verbatim
en:  ASN1_OBJECT *ASN1_OBJECT_new(void);
     void ASN1_OBJECT_free(ASN1_OBJECT *a);
fr: Z<>
     B<ASN1_OBJECT *ASN1_OBJECT_new(void);>
     B<void ASN1_OBJECT_free(ASN1_OBJECT *>I<a>B<);>

note: type: textblock
en: The ASN1_OBJECT allocation routines, allocate and free an ASN1_OBJECT structure, which represents an ASN1 OBJECT IDENTIFIER.
fr: Les routines d'allocation de ASN1_OBJECT allouent et libèrent une structure ASN1_OBJECT qui représente un identifiant d'objet ASN1.

note: type: textblock
en: ASN1_OBJECT_new() allocates and initializes a ASN1_OBJECT structure.
fr: B<ASN1_OBJECT_new>() alloue et initialise une structure ASN1_OBJECT.

note: type: textblock
en: ASN1_OBJECT_free() frees up the B<ASN1_OBJECT> structure B<a>.
fr: B<ASN1_OBJECT_free>() libère la structure B<ASN1_OBJECT> I<a>.

note: type: textblock
en: Although ASN1_OBJECT_new() allocates a new ASN1_OBJECT structure it is almost never used in applications. The ASN1 object utility functions such as OBJ_nid2obj() are used instead.
fr: Bien que B<ASN1_OBJECT_new>() alloue une nouvelle structure ASN1_OBJECT, elle n'est presque jamais utilisée dans les applications. Les fonctions utilitaires des objets ASN1 comme B<OBJ_nid2obj>() sont utilisées à la place.

note: type: =head1
en: RETURN VALUES
fr: VALEURS DE RETOUR

note: type: textblock
en: If the allocation fails, ASN1_OBJECT_new() returns B<NULL> and sets an error code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>.  Otherwise it returns a pointer to the newly allocated structure.
fr: Si l'allocation échoue, B<ASN1_OBJECT_new>() renvoie NULL et positionne une erreur qui peut être obtenue à l'aide de B<ERR_get_error>(3). Sinon, elle renvoie un pointeur vers la nouvelle structure allouée.

note: type: textblock
en: ASN1_OBJECT_free() returns no value.
fr: B<ASN1_OBJECT_free>() ne renvoie rien.

note: type: textblock
en: L<ERR_get_error(3)|ERR_get_error(3)>, L<d2i_ASN1_OBJECT(3)|d2i_ASN1_OBJECT(3)>
fr: B<ERR_get_error>(3), B<d2i_ASN1_OBJECT>(3)

note: type: =head1
en: HISTORY
fr: HISTORIQUE

note: type: textblock
en: ASN1_OBJECT_new() and ASN1_OBJECT_free() are available in all versions of SSLeay and OpenSSL.
fr: B<ASN1_OBJECT_new>() et B<ASN1_OBJECT_free>() sont disponibles dans toutes les versions de SSLeay et OpenSSL.

note: type: textblock
en: 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 - ASN1_STRING utility functions
fr: 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 ASN1_STRING

note: type: verbatim
en:  int ASN1_STRING_length(ASN1_STRING *x);
     unsigned char * ASN1_STRING_data(ASN1_STRING *x);
fr: Z<>
     B<int ASN1_STRING_length(ASN1_STRING *>I<x>B<);>
     B<unsigned char * ASN1_STRING_data(ASN1_STRING *>I<x>B<);>

note: type: verbatim
en:  ASN1_STRING * ASN1_STRING_dup(ASN1_STRING *a);
fr: Z<>
     B<ASN1_STRING * ASN1_STRING_dup(ASN1_STRING *>I<a>B<);>

note: type: verbatim
en:  int ASN1_STRING_cmp(ASN1_STRING *a, ASN1_STRING *b);
fr: Z<>
     B<int ASN1_STRING_cmp(ASN1_STRING *>I<a>B<, ASN1_STRING *>I<b>B<);>

note: type: verbatim
en:  int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len);
fr: Z<>
     B<int ASN1_STRING_set(ASN1_STRING *>I<str>B<, const void *>I<data>B<, int> I<len>B<);>

note: type: verbatim
en:  int ASN1_STRING_type(ASN1_STRING *x);
fr: Z<>
     B<int ASN1_STRING_type(ASN1_STRING *>I<x>B<);>

note: type: verbatim
en:  int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in);
fr: Z<>
     B<int ASN1_STRING_to_UTF8(unsigned char **>I<out>B<, ASN1_STRING *>I<in>B<);>

note: type: textblock
en: These functions allow an B<ASN1_STRING> structure to be manipulated.
fr: Ces fonctions permettent à une structure B<ASN1_STRING> d’être manipulée.

note: type: textblock
en: ASN1_STRING_length() returns the length of the content of B<x>.
fr: B<ASN1_STRING_length>() renvoie la taille du contenu de I<x>.

note: type: textblock
en: ASN1_STRING_data() returns an internal pointer to the data of B<x>.  Since this is an internal pointer it should B<not> be freed or modified in any way.
fr: B<ASN1_STRING_data>() renvoie un pointeur interne vers les données de I<x>. Puisqu’il s’agit d’un pointeur interne, il ne devrait être libéré ou modifié en B<aucune> façon.

note: type: textblock
en: ASN1_STRING_dup() returns a copy of the structure B<a>.
fr: B<ASN1_STRING_dup>() renvoie une copie de la structure I<a>.

note: type: textblock
en: ASN1_STRING_cmp() compares B<a> and B<b> returning 0 if the two are identical. The string types and content are compared.
fr: B<ASN1_STRING_cmp>() compare I<a> et I<b> en renvoyant B<0> si les deux sont identiques. Les types et contenus des chaînes sont comparés.

note: type: textblock
en: ASN1_STRING_set() sets the data of string B<str> to the buffer B<data> or length B<len>. The supplied data is copied. If B<len> is -1 then the length is determined by strlen(data).
fr: B<ASN1_STRING_set>() définit les données de la chaîne I<str> au tampon I<data> ou à la taille I<len>. Les données fournies sont copiées. Si I<len> est B<-1> alors la taille est déterminée par B<strlen>(I<data>).

note: type: textblock
en: ASN1_STRING_type() returns the type of B<x>, using standard constants such as B<V_ASN1_OCTET_STRING>.
fr: B<ASN1_STRING_type>() renvoie le type de I<x>, en utilisant des constantes normalisées comme B<V_ASN1_OCTET_STRING>.

note: type: textblock
en: ASN1_STRING_to_UTF8() converts the string B<in> to UTF8 format, the converted data is allocated in a buffer in B<*out>. The length of B<out> is returned or a negative error code. The buffer B<*out> should be free using OPENSSL_free().
fr: B<ASN1_STRING_to_UTF8>() convertit la chaîne I<in> au format UTF-8, les données converties sont allouées dans un tampon de I<*out>. La taille de I<out> est renvoyée, ou un code d’erreur négatif. Le tampon I<*out> devrait être libéré en utilisant B<OPENSSL_free>().

note: type: textblock
en: Almost all ASN1 types in OpenSSL are represented as an B<ASN1_STRING> structure. Other types such as B<ASN1_OCTET_STRING> are simply typedefed to B<ASN1_STRING> and the functions call the B<ASN1_STRING> equivalents.  B<ASN1_STRING> is also used for some B<CHOICE> types which consist entirely of primitive string types such as B<DirectoryString> and B<Time>.
fr: Presque tous les types ASN1 dans OpenSSL sont représentés comme une structure B<ASN1_STRING>. Les autre types comme B<ASN1_OCTET_STRING> ont simplement leur type défini en B<ASN1_STRING> et les fonctions appellent les équivalents B<ASN1_STRING>. B<ASN1_STRING> est aussi utilisée pour certains types B<CHOICE> de types primitif de chaîne comme B<DirectoryString> et B<Time>.

note: type: textblock
en: These functions should B<not> be used to examine or modify B<ASN1_INTEGER> or B<ASN1_ENUMERATED> types: the relevant B<INTEGER> or B<ENUMERATED> utility functions should be used instead.
fr: Ces fonctions ne devraient B<pas> être utilisées pour examiner ou modifier des types B<ASN1_INTEGER> ou B<ASN1_ENUMERATED> : les fonctions utilitaires B<INTEGER> ou B<ENUMERATED> appropriées devraient être utilisées à la place.

note: type: textblock
en: In general it cannot be assumed that the data returned by ASN1_STRING_data()  is null terminated or does not contain embedded nulls. The actual format of the data will depend on the actual string type itself: for example for and IA5String the data will be ASCII, for a BMPString two bytes per character in big endian format, UTF8String will be in UTF8 format.
fr: En général, les données renvoyées par B<ASN1_STRING_data>() ne peuvent pas être supposées se terminer par NULL ou ne pas contenir de NULL 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 ASCII, pour un BMPString, deux octets par caractère au format grand-boutiste, UTF8String sera au format UTF-8.

note: type: textblock
en: Similar care should be take to ensure the data is in the correct format when calling ASN1_STRING_set().
fr: Une attention similaire devrait être prise pour s’assurer que les données sont au format correct en appelant B<ASN1_STRING_set>().

note: type: textblock
en: L<ERR_get_error(3)|ERR_get_error(3)>
fr: B<ERR_get_error>(3)

note: type: textblock
en: ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free - ASN1_STRING allocation functions
fr: ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free - Fonctions d'allocation d'objets ASN1_STRING

note: type: verbatim
en:  ASN1_STRING * ASN1_STRING_new(void);
     ASN1_STRING * ASN1_STRING_type_new(int type);
     void ASN1_STRING_free(ASN1_STRING *a);
fr: Z<>
     B<ASN1_STRING * ASN1_STRING_new(void);>
     B<ASN1_STRING * ASN1_STRING_type_new(int> I<type>B<);>
     B<void ASN1_STRING_free(ASN1_STRING *>I<a>B<);>

note: type: textblock
en: ASN1_STRING_new() returns an allocated B<ASN1_STRING> structure. Its type is undefined.
fr: B<ASN1_STRING_new>() renvoie une structure B<ASN1_STRING> allouée. Son type n'est pas défini.

note: type: textblock
en: ASN1_STRING_type_new() returns an allocated B<ASN1_STRING> structure of type B<type>.
fr: B<ASN1_STRING_type_new>() renvoie une structure B<ASN1_STRING> allouée, de type I<type>.

note: type: textblock
en: ASN1_STRING_free() frees up B<a>.
fr: B<ASN1_STRING_free>() libère I<a>.

note: type: textblock
en: Other string types call the B<ASN1_STRING> functions. For example ASN1_OCTET_STRING_new() calls ASN1_STRING_type(V_ASN1_OCTET_STRING).
fr: Les autres types de chaîne appellent les fonctions B<ASN1_STRING>. Par exemple, B<ASN1_OCTET_STRING_new>() appelle B<ASN1_STRING_type>(B<V_ASN1_OCTET_STRING>).

note: type: textblock
en: ASN1_STRING_new() and ASN1_STRING_type_new() return a valid ASN1_STRING structure or B<NULL> if an error occurred.
fr: B<ASN1_STRING_new>() et B<ASN1_STRING_type_new>() renvoient une structure B<ASN1_STRING> valable, ou NULL si une erreur est survenue.

note: type: textblock
en: ASN1_STRING_free() does not return a value.
fr: B<ASN1_STRING_free>() ne renvoie aucune valeur.

note: type: textblock
en: TBA
fr: À préciser

note: type: textblock
en: ASN1_STRING_print_ex, ASN1_STRING_print_ex_fp, ASN1_STRING_print - ASN1_STRING output routines.
fr: ASN1_STRING_print_ex, ASN1_STRING_print_ex_fp, ASN1_STRING_print - Routines de sortie ASN1_STRING

note: type: verbatim
en:  int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags);
     int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags);
     int ASN1_STRING_print(BIO *out, ASN1_STRING *str);
fr: Z<>
     B<int ASN1_STRING_print_ex(BIO *>I<out>B<, ASN1_STRING *>I<str>B<, unsigned long> I<flags>B<);>
     B<int ASN1_STRING_print_ex_fp(FILE *>I<fp>B<, ASN1_STRING *>I<str>B<, unsigned long> I<flags>B<);>
     B<int ASN1_STRING_print(BIO *>I<out>B<, ASN1_STRING *>I<str>B<);>

note: type: textblock
en: These functions output an B<ASN1_STRING> structure. B<ASN1_STRING> is used to represent all the ASN1 string types.
fr: Ces fonctions renvoient une structure B<ASN1_STRING>. B<ASN1_STRING> est utilisée pour représenter tous les types de chaîne ASN1.

note: type: textblock
en: ASN1_STRING_print_ex() outputs B<str> to B<out>, the format is determined by the options B<flags>. ASN1_STRING_print_ex_fp() is identical except it outputs to B<fp> instead.
fr: B<ASN1_STRING_print_ex>() renvoie I<str> vers I<out>, le format est déterminé par les options I<flags>. B<ASN1_STRING_print_ex_fp>() est identique à part qu’elle renvoie à la place vers I<fp>.

note: type: textblock
en: ASN1_STRING_print() prints B<str> to B<out> but using a different format to ASN1_STRING_print_ex(). It replaces unprintable characters (other than CR, LF)  with '.'.
fr: B<ASN1_STRING_print>() affiche I<str> vers I<out> mais en utilisant un format différent de B<ASN1_STRING_print_ex>(). Elle remplace les caractères non imprimables (autres que RC et PAL — CR et LF en anglais) par « . ».

note: type: textblock
en: ASN1_STRING_print() is a legacy function which should be avoided in new applications.
fr: B<ASN1_STRING_print>() est une fonction obsolète qui devrait être évitée dans les nouvelles applications.

note: type: textblock
en: Although there are a large number of options frequently B<ASN1_STRFLGS_RFC2253> is suitable, or on UTF8 terminals B<ASN1_STRFLGS_RFC2253 & ~ASN1_STRFLGS_ESC_MSB>.
fr: Malgré un grand nombre d’options, B<ASN1_STRFLGS_RFC2253> convient souvent, ou B<ASN1_STRFLGS_RFC2253 & ~ASN1_STRFLGS_ESC_MSB> sur les terminaux UTF-8.

note: type: textblock
en: The complete set of supported options for B<flags> is listed below.
fr: La totalité des options acceptées pour I<flags> est décrite ci-dessous.

note: type: textblock
en: Various characters can be escaped. If B<ASN1_STRFLGS_ESC_2253> is set the characters determined by RFC2253 are escaped. If B<ASN1_STRFLGS_ESC_CTRL> is set control characters are escaped. If B<ASN1_STRFLGS_ESC_MSB> is set characters with the MSB set are escaped: this option should B<not> be used if the terminal correctly interprets UTF8 sequences.
fr: Plusieurs caractères peuvent être protégés. Si B<ASN1_STRFLGS_ESC_2253> est définie, les caractères déterminés par la RFC 2253 sont protégés. Si B<ASN1_STRFLGS_ESC_CTRL> est définie, les caractères de contrôle sont protégés. Si B<ASN1_STRFLGS_ESC_MSB> est définie, les caractères avec le bit de poids fort défini sont protégés : cette option ne devrait B<pas> être utilisée si le terminal interprète correctement les suites UTF-8.

note: type: textblock
en: Escaping takes several forms.
fr: Les protections prennent différentes formes.

note: type: textblock
en: If the character being escaped is a 16 bit character then the form "\UXXXX" is used using exactly four characters for the hex representation. If it is 32 bits then "\WXXXXXXXX" is used using eight characters of its hex representation. These forms will only be used if UTF8 conversion is not set (see below).
fr: Si le caractère à protéger est un caractère de 16 bits, alors la forme « \UXXXX » est utilisée avec exactement quatre caractères pour la représentation hexadécimale. Si c’est en 32 bits, alors « \WXXXXXXXX » est utilisée avec huit caractères pour sa représentation hexadécimale. Ces formes ne sont utilisées que si la conversion en UTF-8 n’est pas définie (voir ci-dessous).

note: type: textblock
en: Printable characters are normally escaped using the backslash '\' character. If B<ASN1_STRFLGS_ESC_QUOTE> is set then the whole string is instead surrounded by double quote characters: this is arguably more readable than the backslash notation. Other characters use the "\XX" using exactly two characters of the hex representation.
fr: Les caractères imprimables sont normalement protégés à l’aide d’une barre oblique inversée « \ ». Si B<ASN1_STRFLGS_ESC_QUOTE> 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 « \XX » avec exactement deux caractères de la représentation hexadécimale.

note: type: textblock
en: If B<ASN1_STRFLGS_UTF8_CONVERT> is set then characters are converted to UTF8 format first. If the terminal supports the display of UTF8 sequences then this option will correctly display multi byte characters.
fr: Si B<ASN1_STRFLGS_UTF8_CONVERT> est définie, alors les caractères sont d’abord convertis au format UTF-8. Si le terminal permet d’afficher les suites UTF-8, alors cette option permettra d’afficher correctement les caractères multioctets.

note: type: textblock
en: If B<ASN1_STRFLGS_IGNORE_TYPE> is set then the string type is not interpreted at all: everything is assumed to be one byte per character. This is primarily for debugging purposes and can result in confusing output in multi character strings.
fr: Si B<ASN1_STRFLGS_IGNORE_TYPE> 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.

note: type: textblock
en: If B<ASN1_STRFLGS_SHOW_TYPE> is set then the string type itself is printed out before its value (for example "BMPSTRING"), this actually uses ASN1_tag2str().
fr: Si B<ASN1_STRFLGS_SHOW_TYPE> est définie, alors le type de chaîne lui-même est affiché avant sa valeur (par exemple « BMPSTRING »), cela utilise en fait B<ASN1_tag2str>().

note: type: textblock
en: The content of a string instead of being interpreted can be "dumped": this just outputs the value of the string using the form #XXXX using hex format for each octet.
fr: 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.

note: type: textblock
en: If B<ASN1_STRFLGS_DUMP_ALL> is set then any type is dumped.
fr: Si B<ASN1_STRFLGS_DUMP_ALL> est définie, alors tous les types sont déversés.

note: type: textblock
en: Normally non character string types (such as OCTET STRING) are assumed to be one byte per character, if B<ASN1_STRFLGS_DUMP_UNKNOWN> is set then they will be dumped instead.
fr: Normalement, les types de chaîne de non caractères (comme OCTET STRING) sont supposés être d’un octet par caractère, si B<ASN1_STRFLGS_DUMP_UNKNOWN> est définie, alors elles seront déversées à la place.

note: type: textblock
en: When a type is dumped normally just the content octets are printed, if B<ASN1_STRFLGS_DUMP_DER> is set then the complete encoding is dumped instead (including tag and length octets).
fr: Quand un type est déversé normalement, seul les octets du contenu sont affichés, si B<ASN1_STRFLGS_DUMP_DER> est définie, alors l’encodage complet est déversé à la place (y compris les octets d’étiquette et de taille).

note: type: verbatim
en: B<ASN1_STRFLGS_RFC2253> includes all the flags required by RFC2253. It is
    equivalent to:
     ASN1_STRFLGS_ESC_2253 | ASN1_STRFLGS_ESC_CTRL | ASN1_STRFLGS_ESC_MSB |
     ASN1_STRFLGS_UTF8_CONVERT | ASN1_STRFLGS_DUMP_UNKNOWN ASN1_STRFLGS_DUMP_DER
fr: B<ASN1_STRFLGS_RFC2253> contient tous les attributs requis par la RFC 2253.
    C’est équivalent à :
     ASN1_STRFLGS_ESC_2253 | ASN1_STRFLGS_ESC_CTRL | ASN1_STRFLGS_ESC_MSB |
     ASN1_STRFLGS_UTF8_CONVERT | ASN1_STRFLGS_DUMP_UNKNOWN ASN1_STRFLGS_DUMP_DER

note: type: textblock
en: L<X509_NAME_print_ex(3)|X509_NAME_print_ex(3)>, L<ASN1_tag2str(3)|ASN1_tag2str(3)>
fr: L<B<ASN1_tag2str>(3)|ASN1_tag2str(3)>, L<B<X509_NAME_print_ex>(3)|X509_NAME_print_ex(3)>

note: type: textblock
en: ASN1_TIME_set, ASN1_TIME_adj, ASN1_TIME_check, ASN1_TIME_set_string, ASN1_TIME_print, ASN1_TIME_diff - ASN.1 Time functions.
fr: ASN1_TIME_set, ASN1_TIME_adj, ASN1_TIME_check, ASN1_TIME_set_string, ASN1_TIME_print, ASN1_TIME_diff - Fonctions d’heure ASN.1

note: type: verbatim
en:  ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s, time_t t);
     ASN1_TIME *ASN1_TIME_adj(ASN1_TIME *s, time_t t,
                              int offset_day, long offset_sec);
     int ASN1_TIME_set_string(ASN1_TIME *s, const char *str);
     int ASN1_TIME_check(const ASN1_TIME *t);
     int ASN1_TIME_print(BIO *b, const ASN1_TIME *s);
fr: B< ASN1_TIME *ASN1_TIME_set(ASN1_TIME *>I<s>B<, time_t> I<t>B<);>
     B<ASN1_TIME *ASN1_TIME_adj(ASN1_TIME *>I<s>B<, time_t> I<t>B<,>
                              B<int> I<offset_day>B<, long> I<offset_sec>B<);>
     B<int ASN1_TIME_set_string(ASN1_TIME *>I<s>B<, const char *>I<str>B<);>
     B<int ASN1_TIME_check(const ASN1_TIME *>I<t>B<);>
     B<int ASN1_TIME_print(BIO *>I<b>B<, const ASN1_TIME *>I<s>B<);>

note: type: verbatim
en:  int ASN1_TIME_diff(int *pday, int *psec,
                        const ASN1_TIME *from, const ASN1_TIME *to);
fr: B< int ASN1_TIME_diff(int *>I<pday>B<, int *>I<psec>B<,>
                        B<const ASN1_TIME *>I<from>B<, const ASN1_TIME *>I<to>B<);>

note: type: textblock
en: The function ASN1_TIME_set() sets the ASN1_TIME structure B<s> to the time represented by the time_t value B<t>. If B<s> is NULL a new ASN1_TIME structure is allocated and returned.
fr: La fonction B<ASN1_TIME_set>() définit la structure B<ASN1_TIME> I<s> à l’heure représentée par la valeur B<time_t> I<t>. Si I<s> est NULL, une nouvelle structure B<ASN1_TIME> est allouée et renvoyée.

note: type: textblock
en: ASN1_TIME_adj() sets the ASN1_TIME structure B<s> to the time represented by the time B<offset_day> and B<offset_sec> after the time_t value B<t>.  The values of B<offset_day> or B<offset_sec> can be negative to set a time before B<t>. The B<offset_sec> value can also exceed the number of seconds in a day. If B<s> is NULL a new ASN1_TIME structure is allocated and returned.
fr: B<ASN1_TIME_adj>() définit la structure B<ASN1_TIME> I<s> à l’heure représentée par la valeur B<time_t> I<t>. Les valeurs de I<offset_day> ou I<offset_sec> peuvent être négatives pour définir une heure avant I<t>. La valeur I<offset_sec> peut aussi dépasser le nombre de secondes dans un jour. Si I<s> est NULL, une nouvelle structure B<ASN1_TIME> est allouée et renvoyée.

note: type: textblock
en: ASN1_TIME_set_string() sets ASN1_TIME structure B<s> to the time represented by string B<str> which must be in appropriate ASN.1 time format (for example YYMMDDHHMMSSZ or YYYYMMDDHHMMSSZ).
fr: B<ASN1_TIME_set_string>() définit la structure B<ASN1_TIME> I<s> à l’heure représentée par la chaîne I<str> qui doit être dans un format d’heure ASN.1 approprié (par exemple AAMMJJHHMMSSZ ou AAAAMMJJHHMMSSZ).

note: type: textblock
en: ASN1_TIME_check() checks the syntax of ASN1_TIME structure B<s>.
fr: B<ASN1_TIME_check>() vérifie la syntaxe de la structure B<ASN1_TIME> I<s>.

note: type: textblock
en: ASN1_TIME_print() prints out the time B<s> to BIO B<b> in human readable format. It will be of the format MMM DD HH:MM:SS YYYY [GMT], for example "Feb 3 00:55:52 2015 GMT" it does not include a newline. If the time structure has invalid format it prints out "Bad time value" and returns an error.
fr: B<ASN1_TIME_print>() affiche l’heure I<s> dans le BIO I<b> en format lisible. Le format est Mmm JJ HH:MM:SS AAAA [GMT], par exemple « Feb 3 00:55:52 2015 GMT », sans changement de ligne. Si la structure de temps a un format incorrect, elle affiche « Bad time value » et renvoie une erreur.

note: type: textblock
en: ASN1_TIME_diff() sets B<*pday> and B<*psec> to the time difference between B<from> and B<to>. If B<to> represents a time later than B<from> then one or both (depending on the time difference) of B<*pday> and B<*psec> will be positive. If B<to> represents a time earlier than B<from> then one or both of B<*pday> and B<*psec> will be negative. If B<to> and B<from> represent the same time then B<*pday> and B<*psec> will both be zero.  If both B<*pday> and B<*psec> are non-zero they will always have the same sign. The value of B<*psec> will always be less than the number of seconds in a day. If B<from> or B<to> is NULL the current time is used.
fr: B<ASN1_TIME_diff>() définit B<*>I<pday> et B<*>I<psec> à la différence d’heure entre I<from> et I<to>. Si I<to> représente une heure suivant I<from>, B<*>I<pday> ou B<*>I<psec> ou les deux (en fonction de la différence d’heure) seront positives. Si I<to> représente une heure précédent I<from>, B<*>I<pday> ou B<*>I<psec> ou les deux seront négatives. Si I<to> et I<from> représentent la même heure, B<*>I<pday> et B<*>I<psec> seront toutes deux nulles. Si B<*>I<pday> et B<*>I<psec> ne sont pas nulles, elles seront toujours de même signe. La valeur de B<*>I<psec> sera toujours inférieure au nombre de secondes dans une journée. Si I<from> ou I<to> sont NULL, l’heure actuelle est utilisée.

note: type: textblock
en: The ASN1_TIME structure corresponds to the ASN.1 structure B<Time> defined in RFC5280 et al. The time setting functions obey the rules outlined in RFC5280: if the date can be represented by UTCTime it is used, else GeneralizedTime is used.
fr: La structure B<ASN1_TIME> correspond à la structure B<ASN.1> B<Time> définie dans la RFC 5280 et suivantes. Les fonctions de définition d’heure obéissent aux règles soulignées dans la RFC 5280 : si la date peut être représentée par UTCTime, c’est ce qui est utilisé, sinon GeneralizedTime est utilisé.

note: type: textblock
en: The ASN1_TIME structure is represented as an ASN1_STRING internally and can be freed up using ASN1_STRING_free().
fr: La structure B<ASN1_TIME> est représentée par une B<ASN1_STRING> en interne et peut être libérée en utilisant B<ASN1_STRING_free>().

note: type: textblock
en: The ASN1_TIME structure can represent years from 0000 to 9999 but no attempt is made to correct ancient calendar changes (for example from Julian to Gregorian calendars).
fr: La structure B<ASN1_TIME> peut représenter des années entre 0000 et 9999 mais aucune correction des modifications de calendrier ancien n’est tentée (par exemple, de calendrier julien en grégorien).

note: type: textblock
en: Some applications add offset times directly to a time_t value and pass the results to ASN1_TIME_set() (or equivalent). This can cause problems as the time_t value can overflow on some systems resulting in unexpected results.  New applications should use ASN1_TIME_adj() instead and pass the offset value in the B<offset_sec> and B<offset_day> parameters instead of directly manipulating a time_t value.
fr: Certaines applications ajoutent des heures de décalage directement dans une valeur I<time_t> et passent le résultat à B<ASN1_TIME_set>() (ou équivalent). Cela peut poser des problèmes car la valeur I<time_t> peut déborder sur certains systèmes avec pour conséquence des résultats inattendus. Les nouvelles applications devraient utiliser B<ASN1_TIME_adj>() à la place et passer la valeur de décalage dans les paramètres I<offset_sec> et I<offset_day> au lieu de manipuler directement une valeur I<time_t>.

note: type: textblock
en: ASN1_TIME_print() currently does not print out the time zone: it either prints out "GMT" or nothing. But all certificates complying with RFC5280 et al use GMT anyway.
fr: B<ASN1_TIME_print>() n’affiche actuellement pas le fuseau horaire : elle affiche soit « GMT », soit rien. Tous les certificats sont compatibles avec la RFC 5280 et utilisent tous GMT de toute façon.

note: type: textblock
en: Set a time structure to one hour after the current time and print it out:
fr: Définir une structure de temps à une heure après l’heure actuelle et l’afficher :

note: type: verbatim
en:  #include <time.h>
     #include <openssl/asn1.h>
     ASN1_TIME *tm;
     time_t t;
     BIO *b;
     t = time(NULL);
     tm = ASN1_TIME_adj(NULL, t, 0, 60 * 60);
     b = BIO_new_fp(stdout, BIO_NOCLOSE);
     ASN1_TIME_print(b, tm);
     ASN1_STRING_free(tm);
     BIO_free(b);
fr:     #include <time.h>
        #include <openssl/asn1.h>
        ASN1_TIME *tm;
        time_t t;
        BIO *b;
        t = time(NULL);
        tm = ASN1_TIME_adj(NULL, t, 0, 60 * 60);
        b = BIO_new_fp(stdout, BIO_NOCLOSE);
        ASN1_TIME_print(b, tm);
        ASN1_STRING_free(tm);
        BIO_free(b);

note: type: textblock
en: Determine if one time is later or sooner than the current time:
fr: Déterminer si une heure est après ou avant l’heure actuelle :

note: type: verbatim
en:  if (!ASN1_TIME_diff(&day, &sec, NULL, to))
    	/* Invalid time format */
fr:     if (!ASN1_TIME_diff(&day, &sec, NULL, to))
    	/* Format d’heure incorrect */

note: type: verbatim
en:  if (day > 0 || sec > 0)
       printf("Later\n");
     else if (day < 0 || sec < 0)
       printf("Sooner\n");
     else
       printf("Same\n");
fr:     if (day > 0 || sec > 0)
            printf("Après\n");
        else if (day < 0 || sec < 0)
            printf("Avant\n");
        else
            printf("Identique\n");

note: type: textblock
en: ASN1_TIME_set() and ASN1_TIME_adj() return a pointer to an ASN1_TIME structure or NULL if an error occurred.
fr: B<ASN1_TIME_set>() et B<ASN1_TIME_adj>() renvoient un pointeur vers une structure B<ASN1_TIME>, ou NULL si une erreur est survenue.

note: type: textblock
en: ASN1_TIME_set_string() returns 1 if the time value is successfully set and 0 otherwise.
fr: B<ASN1_TIME_set_string>() renvoie B<1> si la valeur de temps est définie correctement et B<0> sinon.

note: type: textblock
en: ASN1_TIME_check() returns 1 if the structure is syntactically correct and 0 otherwise.
fr: B<ASN1_TIME_check>() renvoie B<1> si la structure est correcte d’un point de vue syntaxique et B<0> sinon.

note: type: textblock
en: ASN1_TIME_print() returns 1 if the time is successfully printed out and 0 if an error occurred (I/O error or invalid time format).
fr: B<ASN1_TIME_print>() renvoie B<1> si le temps est affiché correctement et B<0> si une erreur est survenue (erreur d’entrée et sortie ou format d’heure incorrect).

note: type: textblock
en: ASN1_TIME_diff() returns 1 for sucess and 0 for failure. It can fail if the pass ASN1_TIME structure has invalid syntax for example.
fr: B<ASN1_TIME_diff>() renvoie B<1> en cas de réussite et B<0> en cas d’échec. Elle peut échouer si la structure B<ASN1_TIME> passée a par exemple une syntaxe incorrecte.

note: type: textblock
en: ASN1_generate_nconf, ASN1_generate_v3 - ASN1 generation functions
fr: ASN1_generate_nconf, ASN1_generate_v3 - Fonction de génération ASN1

note: type: verbatim
en:  ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf);
     ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf);
fr: Z<>
     B<ASN1_TYPE *ASN1_generate_nconf(char *>I<str>B<, CONF *>I<nconf>B<);>
     B<ASN1_TYPE *ASN1_generate_v3(char *>I<str>B<, X509V3_CTX *>I<cnf>B<);>

note: type: textblock
en: These functions generate the ASN1 encoding of a string in an B<ASN1_TYPE> structure.
fr: Ces fonctions génèrent l'encodage ASN1 d'une chaîne dans une structure B<ASN1_TYPE>.

note: type: textblock
en: B<str> contains the string to encode B<nconf> or B<cnf> contains the optional configuration information where additional strings will be read from. B<nconf> will typically come from a config file wherease B<cnf> is obtained from an B<X509V3_CTX> structure which will typically be used by X509 v3 certificate extension functions. B<cnf> or B<nconf> can be set to B<NULL> if no additional configuration will be used.
fr: I<str> contient la chaîne à encoder. I<nconf> ou I<cnf> contiennent les renseignements facultatifs de configuration dans lesquelles d'autres chaînes seront lues. I<nconf> proviendra typiquement d'un fichier de configuration tandis que I<cnf> est obtenu dans une structure B<X509V3_CTX> qui sera typiquement utilisée par les fonctions d'extension de certificats X509 v3. I<cnf> ou I<nconf> peuvent valoir NULL si aucune configuration supplémentaire n'est utilisée.

note: type: =head1
en: GENERATION STRING FORMAT
fr: FORMAT DES CHAÎNES DE GÉNÉRATION

note: type: textblock
en: The actual data encoded is determined by the string B<str> and the configuration information. The general format of the string is:
fr: Les données effectivement encodées sont déterminées par la chaîne I<str> et les informations de configuration. Le format général de la chaîne est :

note: type: =item
en: B<[modifier,]type[:value]>
fr: [I<modificateur>B<,>]I<type>[B<:>I<valeur>]

note: type: textblock
en: That is zero or more comma separated modifiers followed by a type followed by an optional colon and a value. The formats of B<type>, B<value> and B<modifier> are explained below.
fr: C'est-à-dire zéro modificateur ou plus, séparés par des virgules, suivis d'un type, lui-même suivi de façon facultative par un deux-points et une valeur. Les formats de I<type>, I<valeur> et I<modificateur> sont décrits ci-dessous.

note: type: =head2
en: SUPPORTED TYPES
fr: TYPES PRIS EN CHARGE

note: type: textblock
en: The supported types are listed below. Unless otherwise specified only the B<ASCII> format is permissible.
fr: Les types pris en charge sont décrits ci-dessous. À moins que ce ne soit indiqué explicitement, seul le format B<ASCII> est autorisé.

note: type: textblock
en: This encodes a boolean type. The B<value> string is mandatory and should be B<TRUE> or B<FALSE>. Additionally B<TRUE>, B<true>, B<Y>, B<y>, B<YES>, B<yes>, B<FALSE>, B<false>, B<N>, B<n>, B<NO> and B<no> are acceptable.
fr: Encoder un type booléen. La chaîne I<valeur> est obligatoire et devrait valoir soit B<TRUE>, soit B<FALSE>. Les valeurs B<TRUE>, B<true>, B<Y>, B<y>, B<YES>, B<yes>, B<FALSE>, B<false>, B<N>, B<n>, B<NO> et B<no> sont acceptées.

note: type: textblock
en: Encode the B<NULL> type, the B<value> string must not be present.
fr: Encoder le type NULL, la chaîne I<valeur> ne doit pas être présente.

note: type: textblock
en: Encodes an ASN1 B<INTEGER> type. The B<value> string represents the value of the integer, it can be prefaced by a minus sign and is normally interpreted as a decimal value unless the prefix B<0x> is included.
fr: Encoder un type ASN1 B<INTEGER>. La chaîne I<valeur> représente la valeur de l'entier. Elle peut être précédée d'un signe moins et est normalement interprétée comme une valeur décimale à moins que le préfixe B<0x> soit inclus.

note: type: textblock
en: Encodes the ASN1 B<ENUMERATED> type, it is otherwise identical to B<INTEGER>.
fr: Encoder un type ASN1 B<ENUMERATED>, par ailleurs identique à B<INTEGER>.

note: type: textblock
en: Encodes an ASN1 B<OBJECT IDENTIFIER>, the B<value> string can be a short name, a long name or numerical format.
fr: Encoder un type ASN1 B<OBJECT IDENTIFIER>, la chaîne I<valeur> peut être un nom court, un nom long ou un format numérique.

note: type: textblock
en: Encodes an ASN1 B<UTCTime> structure, the value should be in the format B<YYMMDDHHMMSSZ>.
fr: Encoder une structure ASN1 B<UTCTime>. La I<valeur> doit être au format I<AAMMDDHHMMSSZ>.

note: type: textblock
en: Encodes an ASN1 B<GeneralizedTime> structure, the value should be in the format B<YYYYMMDDHHMMSSZ>.
fr: Encoder une structure ASN1 B<GeneralizedTime>. La I<valeur> doit être au format I<AAAAMMDDHHMMSSZ>.

note: type: textblock
en: Encodes an ASN1 B<OCTET STRING>. B<value> represents the contents of this structure, the format strings B<ASCII> and B<HEX> can be used to specify the format of B<value>.
fr: Encoder un type ASN1 B<OCTET STRING>. La I<valeur> représente le contenu de cette structure. Les chaînes de format B<ASCII> et B<HEX> peuvent être utilisées pour indiquer le format de I<valeur>.

note: type: textblock
en: Encodes an ASN1 B<BIT STRING>. B<value> represents the contents of this structure, the format strings B<ASCII>, B<HEX> and B<BITLIST> can be used to specify the format of B<value>.
fr: Encoder un type ASN1 B<BIT STRING>. La I<valeur> représente le contenu de cette structure. Les chaînes de format B<ASCII>, B<HEX> et B<BITLIST> peuvent être utilisées pour indiquer le format de I<valeur>.

note: type: textblock
en: If the format is anything other than B<BITLIST> the number of unused bits is set to zero.
fr: Si le format diffère de B<BITLIST>, le nombre de bits non utilisés est mis à zéro.

note: type: textblock
en: These encode the corresponding string types. B<value> represents the contents of this structure. The format can be B<ASCII> or B<UTF8>.
fr: Encoder les types de chaîne correspondant. La I<valeur> représente le contenu de cette structure. Le format peut être B<ASCII> ou B<UTF8>.

note: type: textblock
en: Formats the result as an ASN1 B<SEQUENCE> or B<SET> type. B<value> should be a section name which will contain the contents. The field names in the section are ignored and the values are in the generated string format. If B<value> is absent then an empty SEQUENCE will be encoded.
fr: Formater le résultat en tant que type ASN1 B<SEQUENCE> ou B<SET>. La I<valeur> devrait être un nom de section qui contiendra le contenu. Les noms des champs de la section sont ignorés et les valeurs sont au format de la chaîne créée. Si I<valeur> est absent, alors une SEQUENCE vide sera encodée.

note: type: =head2
en: MODIFIERS
fr: MODIFICATEURS

note: type: textblock
en: Modifiers affect the following structure, they can be used to add EXPLICIT or IMPLICIT tagging, add wrappers or to change the string format of the final type and value. The supported formats are documented below.
fr: Les modificateurs affectent les structures suivantes. Ils peuvent être utilisés pour ajouter des étiquettes EXPLICIT ou IMPLICIT, ajouter des enveloppes ou changer le format de chaîne du type et de la valeur finale. Les formats pris en charge sont documentés ci-dessous.

note: type: textblock
en: Add an explicit tag to the following structure. This string should be followed by a colon and the tag value to use as a decimal value.
fr: Ajouter une étiquette explicite à la structure suivante. Cette chaîne devrait être suivie par un deux-points et la valeur de l'étiquette à utiliser sous forme numérique décimale.

note: type: textblock
en: By following the number with B<U>, B<A>, B<P> or B<C> UNIVERSAL, APPLICATION, PRIVATE or CONTEXT SPECIFIC tagging can be used, the default is CONTEXT SPECIFIC.
fr: En faisant suivre le nombre d'un B<U>, B<A>, B<P> ou B<C>, une étiquette de type UNIVERSAL, APPLICATION, PRIVATE ou CONTEXT SPECIFIC peut être utilisée (CONTEXT SPECIFIC par défaut).

note: type: textblock
en: This is the same as B<EXPLICIT> except IMPLICIT tagging is used instead.
fr: Identique à B<EXPLICIT> sauf qu'un étiquetage IMPLICIT est utilisé à la place.

note: type: textblock
en: The following structure is surrounded by an OCTET STRING, a SEQUENCE, a SET or a BIT STRING respectively. For a BIT STRING the number of unused bits is set to zero.
fr: La structure suivante est entourée par une OCTET STRING, une SEQUENCE, un SET ou une BIT STRING respectivement. Pour une BIT STRING, le nombre de bits non utilisés est mis à zéro.

note: type: textblock
en: This specifies the format of the ultimate value. It should be followed by a colon and one of the strings B<ASCII>, B<UTF8>, B<HEX> or B<BITLIST>.
fr: Indique le format de la valeur finale. Il devrait être suivi par un deux-points et une des chaînes B<ASCII>, B<UTF8>, B<HEX> ou B<BITLIST>.

note: type: textblock
en: If no format specifier is included then B<ASCII> is used. If B<UTF8> is specified then the value string must be a valid B<UTF8> string. For B<HEX> the output must be a set of hex digits. B<BITLIST> (which is only valid for a BIT STRING) is a comma separated list of the indices of the set bits, all other bits are zero.
fr: Si aucune chaîne de format n'est incluse, B<ASCII> est utilisée. Si B<UTF8> est indiquée, alors la chaîne I<valeur> doit être une chaîne B<UTF8> correcte. Pour le format B<HEX>, la sortie doit être un ensemble de chiffres hexadécimaux. B<BITLIST> (qui n'est correct que pour une BIT STRING) est la liste des index des bits positionnés séparés par des virgules, tous les autres bits valent zéro.

note: type: textblock
en: A simple IA5String:
fr: Une IA5String simple :

note: type: verbatim
en:  IA5STRING:Hello World
fr:  IA5STRING:Salut le monde

note: type: textblock
en: An IA5String explicitly tagged:
fr: Une IA5String étiquetée explicitement :

note: type: verbatim
en:  EXPLICIT:0,IA5STRING:Hello World
fr:  EXPLICIT:0,IA5STRING:Salut le monde

note: type: textblock
en: An IA5String explicitly tagged using APPLICATION tagging:
fr: Une IA5String étiquetée explicitement et utilisant une étiquette APPLICATION :

note: type: verbatim
en:  EXPLICIT:0A,IA5STRING:Hello World
fr:  EXPLICIT:0A,IA5STRING:Salut le monde

note: type: textblock
en: A BITSTRING with bits 1 and 5 set and all others zero:
fr: Une BITSTRING avec les bits 1 et 5 activés et tous les autres à zéro :

note: type: textblock
en: A more complex example using a config file to produce a SEQUENCE consiting of a BOOL an OID and a UTF8String:
fr: Un exemple plus complexe utilisant un fichier de configuration pour produire une SEQUENCE constituée d'un BOOL, d'un OID et d'une UTF8String :

note: type: verbatim
en:  field1 = BOOLEAN:TRUE
     field2 = OID:commonName
     field3 = UTF8:Third field
fr:  field1 = BOOLEAN:TRUE
     field2 = OID:commonName
     field3 = UTF8:Troisième champ

note: type: textblock
en: This example produces an RSAPrivateKey structure, this is the key contained in the file client.pem in all OpenSSL distributions (note: the field names such as 'coeff' are ignored and are present just for clarity):
fr: Cet exemple produit une structure RSAPrivateKey. Il s'agit de la clef contenue dans le fichier client.pem de toute distribution OpenSSL (remarque : les noms des champs comme « coeff » sont ignorés et ne sont présents que par souci de clarté.

note: type: textblock
en: This example is the corresponding public key in a SubjectPublicKeyInfo structure:
fr: Cet exemple est la clef publique correspondante dans une structure SubjectPublicKeyInfo :

note: type: verbatim
en:  # Start with a SEQUENCE
     asn1=SEQUENCE:pubkeyinfo
fr:  # Commencer par une SEQUENCE
     asn1=SEQUENCE:pubkeyinfo

note: type: verbatim
en:  # pubkeyinfo contains an algorithm identifier and the public key wrapped
     # in a BIT STRING
     [pubkeyinfo]
     algorithm=SEQUENCE:rsa_alg
     pubkey=BITWRAP,SEQUENCE:rsapubkey
fr:  # pubkeyinfo contient un identificateur d'algorithme et la clef publique
     # enveloppés dans une BIT STRING
     [pubkeyinfo]
     algorithm=SEQUENCE:rsa_alg
     pubkey=BITWRAP,SEQUENCE:rsapubkey

note: type: verbatim
en:  # algorithm ID for RSA is just an OID and a NULL
     [rsa_alg]
     algorithm=OID:rsaEncryption
     parameter=NULL
fr:  # l'identifiant d'algorithme pour RSA est un simple OID et un NULL
     [rsa_alg]
     algorithm=OID:rsaEncryption
     parameter=NULL

note: type: verbatim
en:  # Actual public key: modulus and exponent
     [rsapubkey]
     n=INTEGER:0xBB6FE79432CC6EA2D8F970675A5A87BFBE1AFF0BE63E879F2AFFB93644\
     D4D2C6D000430DEC66ABF47829E74B8C5108623A1C0EE8BE217B3AD8D36D5EB4FCA1D9
fr:  # Véritable clef publique : module et exposant
     [rsapubkey]
     n=INTEGER:0xBB6FE79432CC6EA2D8F970675A5A87BFBE1AFF0BE63E879F2AFFB93644\
     D4D2C6D000430DEC66ABF47829E74B8C5108623A1C0EE8BE217B3AD8D36D5EB4FCA1D9

note: type: textblock
en: ASN1_generate_nconf() and ASN1_generate_v3() return the encoded data as an B<ASN1_TYPE> structure or B<NULL> if an error occurred.
fr: B<ASN1_generate_nconf>() et B<ASN1_generate_v3>() renvoient les données encodées sous la forme d'une structure B<ASN1_TYPE> ou NULL si une erreur est survenue.

note: type: textblock
en: The error codes that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>.
fr: Les codes d'erreur peuvent être obtenus avec B<ERR_get_error>(3).

note: type: textblock
en: ASN1_generate_nconf() and ASN1_generate_v3() were added to OpenSSL 0.9.8
fr: B<ASN1_generate_nconf>() et B<ASN1_generate_v3>() ont été ajoutées dans la version 0.9.8 d'OpenSSL.
