Skip to content

Commit

Permalink
traduction 9.5 libpq.xml
Browse files Browse the repository at this point in the history
  • Loading branch information
@edelamusse @gleu
edelamusse authored and gleu committed Feb 15, 2016
1 parent 3d32e3f commit a108ef8
Showing 1 changed file with 79 additions and 65 deletions.
144 changes: 79 additions & 65 deletions postgresql/libpq.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1063,10 +1063,12 @@ typedef struct
l'exécution. Par exemple, en le configurant à <literal>-c
geqo=off</literal>, cela configure la valeur de la session
pour le paramètre <varname>geqo</varname> à
<literal>off</literal>. Spaces within this string are considered to
separate command-line arguments, unless escaped with a backslash
(<literal>\</literal>); write <literal>\\</literal> to represent a literal
backslash. Pour une discussion détaillée des options
<literal>off</literal>. Les espaces à l'intérieur de cette
chaîne sont considérés comme séparateurs d'arguments,
sauf si ils sont échappés avec le caractère d'échappement
<literal>\</literal>; écrivez <literal>\\</literal> pour obtenir
le caractère d'échappement lui même.
Pour une discussion détaillée des options
disponibles, voir <xref linkend="runtime-config"/>.
</para>
</listitem>
Expand Down Expand Up @@ -1825,15 +1827,15 @@ typedef struct
</para>

<para>
The following functions return information related to SSL. This information
usually doesn't change after a connection is established.

Les fonctions ci-dessous renvoi des informations relatives à
SSL. Cette information ne change généralement pas après qu'une
connexion soit établie.
<variablelist>
<varlistentry id="libpq-pqsslinuse">
<term><function>PQsslInUse</function><indexterm><primary>PQsslInUse</primary></indexterm></term>
<listitem>
<para>
Returns true (1) if the connection uses SSL, false (0) if not.
Renvoi true (1) si la connexion utilise SSL, false (0) si non.

<synopsis>
int PQsslInUse(const PGconn *conn);
Expand All @@ -1847,68 +1849,70 @@ int PQsslInUse(const PGconn *conn);
<term><function>PQsslAttribute</function><indexterm><primary>PQsslAttribute</primary></indexterm></term>
<listitem>
<para>
Returns SSL-related information about the connection.
Renvoi des informations relatives à SSL à propos de la connexion.

<synopsis>
const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);
</synopsis>
</para>

<para>
The list of available attributes varies depending on the SSL library
being used, and the type of connection. If an attribute is not
available, returns NULL.
La liste des attributs disponibles varie en fonction de la
librairie SSL utilisée, et du type de la connexion. Si un attribut
n'est pas disponible, renvoi NULL.
</para>

<para>
The following attributes are commonly available:
Les attributs suivants sont communément disponibles:
<variablelist>
<varlistentry>
<term><literal>library</literal></term>
<listitem>
<para>
Name of the SSL implementation in use. (Currently, only
<literal>"OpenSSL"</literal> is implemented)
Nom de l'implémentation SSL utilisée. (À ce jour seul
<literal>"OpenSSL"</literal> est implémenté)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>protocol</literal></term>
<listitem>
<para>
SSL/TLS version in use. Common values
are <literal>"SSLv2"</literal>, <literal>"SSLv3"</literal>,
SSL/TLS version utilisée. Les valeurs courantes sont
<literal>"SSLv2"</literal>, <literal>"SSLv3"</literal>,
<literal>"TLSv1"</literal>, <literal>"TLSv1.1"</literal>
and <literal>"TLSv1.2"</literal>, but an implementation may
return other strings if some other protocol is used.
and <literal>"TLSv1.2"</literal>, mais une implémentation
peut renvoyer d'autres chaînes si d'autres protocoles
sont utilisés.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>key_bits</literal></term>
<listitem>
<para>
Number of key bits used by the encryption algorithm.
Nombre de bits clefs utilisés par l'algorithme de chiffrement.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>cipher</literal></term>
<listitem>
<para>
A short name of the ciphersuite used, e.g.
<literal>"DHE-RSA-DES-CBC3-SHA"</literal>. The names are specific
to each SSL implementation.
Le nom raccourci de la suite cryptographique utilisée,
exemple <literal>"DHE-RSA-DES-CBC3-SHA"</literal>. Les noms
sont spécifiques à chaque implémentation.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>compression</literal></term>
<listitem>
<para>
If SSL compression is in use, returns the name of the compression
algorithm, or "on" if compression is used but the algorithm is
not known. If compression is not in use, returns "off".
Si la compression SSL est utilisée, renvoi le nom de
l'algorithme de compression, ou "on" si la compression est
utilisée mais l'algorithme est inconnu. Si la compression
n'est pas utilisée, renvoi "off".
</para>
</listitem>
</varlistentry>
Expand All @@ -1921,7 +1925,8 @@ const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);
<term><function>PQsslAttributeNames</function><indexterm><primary>PQsslAttributeNames</primary></indexterm></term>
<listitem>
<para>
Return an array of SSL attribute names available. The array is terminated by a NULL pointer.
Renvoi un tableau des attributs SSL disponibles. Le tableau est
terminé par un pointeur NULL.
<synopsis>
const char * const * PQsslAttributeNames(const PGconn *conn);
</synopsis>
Expand All @@ -1933,17 +1938,18 @@ const char * const * PQsslAttributeNames(const PGconn *conn);
<term><function>PQsslStruct</function><indexterm><primary>PQsslStruct</primary></indexterm></term>
<listitem>
<para>
Return a pointer to an SSL-implementation-specific object describing
the connection.
Renvoi un pointeur sur un objet SSL qui est dépendant de
l'implémentation et qui décrit la connexion.
<synopsis>
void *PQsslStruct(const PGconn *conn, const char *struct_name);
</synopsis>
</para>
<para>
The struct(s) available depend on the SSL implementation in use.
For OpenSSL, there is one struct, available under the name "OpenSSL",
and it returns a pointer to the OpenSSL <literal>SSL</literal> struct.
To use this function, code along the following lines could be used:
La ou les structures disponibles dépendent de l'implémentation
SSL utilisée. Pour OpenSSL, il y a une structure, disponible
sous le nom "OpenSSL", qui renvoi un pointeur sur la structure
OpenSSL <literal>SSL<.literal>. Un exemple de code utilisant
cette fonction pourrait être:
<programlisting><![CDATA[
#include <libpq-fe.h>
#include <openssl/ssl.h>
Expand All @@ -1963,9 +1969,10 @@ void *PQsslStruct(const PGconn *conn, const char *struct_name);
]]></programlisting>
</para>
<para>
This structure can be used to verify encryption levels, check server
certificates, and more. Refer to the <productname>OpenSSL</productname>
documentation for information about this structure.
Cette structure peut être utilisée pour vérifier les niveaux
de cryptage, les certificats du serveur, .... Référez vous à
la documentation d'<productname>OpenSSL</productname> pour des
informations sur cette structure.
</para>
</listitem>
</varlistentry>
Expand All @@ -1974,22 +1981,24 @@ void *PQsslStruct(const PGconn *conn, const char *struct_name);
<term><function>PQgetssl</function><indexterm><primary>PQgetssl</primary></indexterm></term>
<listitem>
<para>
<indexterm><primary>SSL</primary><secondary sortas="libpq">in libpq</secondary></indexterm>
Returns the SSL structure used in the connection, or null
if SSL is not in use.
<indexterm><primary>SSL</primary><secondary sortas="libpq">dans libpq</secondary></indexterm>
Renvoi la structure SSL utilisée dans la connexion, ou null si
SSL n'est pas utilisé.

<synopsis>
void *PQgetssl(const PGconn *conn);
</synopsis>
</para>

<para>
This function is equivalent to <literal>PQsslStruct(conn, "OpenSSL")</literal>. It should
not be used in new applications, because the returned struct is
specific to OpenSSL and will not be available if another SSL
implementation is used. To check if a connection uses SSL, call
<function>PQsslInUse</function> instead, and for more details about the
connection, use <function>PQsslAttribute</function>.
Cette fonction est équivalente à <literal>PQsslStruct(conn,
"OpenSSL")</literal>. Elle ne devrait pas être utilisée dans les
nouvelles applications, car la structure renvoyée est spécifique
à OpenSSL et ne sera pas disponible si une autre implémentation
SSL est utilisée. Pour vérifier si une connexion utilise SSL,
appeler à la place la fonction <function>PQsslInUse</function>,
et pour plus de détails à propos de la connexion, utilisez
<function>PQsslAttribute</function>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -4746,17 +4755,20 @@ void *PQgetssl(const PGconn *conn);
</para>

<para>
The result is 1 if the termination message was sent; or in
nonblocking mode, this may only indicate that the termination
message was successfully queued. (In nonblocking mode, to be
certain that the data has been sent, you should next wait for
write-ready and call <function>PQflush</function>, repeating until it
returns zero.) Zero indicates that the function could not queue
the termination message because of full buffers; this will only
happen in nonblocking mode. (In this case, wait for
write-ready and try the <function>PQputCopyEnd</function> call
again.) If a hard error occurs, -1 is returned; you can use
<function>PQerrorMessage</function> to retrieve details.
Le résultat est 1 si la donnée de fin a été envoyée, ou dans le
mode non bloquant, cela peut uniquement indiquer que la donnée de
fin à été correctement mise dans la file d'attente. (En mode non
bloquant, pour être certain que les données ont été correctement
envoyées, vous devriez ensuite attendre que le mode écriture soit
disponible puis appeler <function>PQflush</function>, à répéter
jusqu'à ce que 0 soit renvoyé). Zéro indique que la fonction n'a
pas pu mettre en file d'attente la donnée de fin à cause d'une
file pleine; ceci ne peut survenir qu'en mode non bloquant. (Dans ce
cas, attendez que le mode écriture soit disponible puis rappeler
à nouveau la fonction <function>PQputCopyEnd</function>). Si
une erreur physique survient, -1 est renvoyé; vous pouvez alors
appeler <function>PQerrorMessage</function> pour avoir plus de
détails sur l'erreur.
</para>

<para>
Expand Down Expand Up @@ -6796,15 +6808,17 @@ description:sslmode=require
</para>

<para>
In <literal>verify-full</literal> mode, the host name is matched against the
certificate's Subject Alternative Name attribute(s), or against the Common
Name attribute if no Subject Alternative Name of type dNSName is present.
If the certificate's name attribute starts with an asterisk
(<literal>*</literal>), the asterisk will be treated as a wildcard, which will
match all characters <emphasis>except</emphasis> a dot. Cela signifie
que le certificat ne pourra pas être utilisé pour des sous-domaines complets.
Si la connexion se fait en utilisant une adresse IP au lieu d'un nom d'hôte,
l'adresse IP sera vérifiée (sans faire de recherche DNS).
En mode <literal>verify-full</literal>, le nom de l'hôte est mis
en correspondance avec le ou les attributs "Subject Alternative
Name" du certificat, ou avec l'attribut "Common Name" si aucun
"Subject Alternative Name" de type dNSName est présent. Si le nom du
certificat débute avec le caractère étoile (<literal>*</literal>),
le caractère étoile sera traité comme un métacaractère qui
correspondra à tous les caractères <emphasis>à l'exception
du</emphasis> point. Cela signifie que le certificat ne pourra pas
être utilisé pour des sous-domaines complets. Si la connexion se
fait en utilisant une adresse IP au lieu d'un nom d'hôte, l'adresse
IP sera vérifiée (sans faire de recherche DNS).
</para>

<para>
Expand Down

0 comments on commit a108ef8

Please sign in to comment.