Translate libpq.xml

postgresql/libpq.xml

@@ -436,7 +436,8 @@ PGconn *PQconnectdbParams(const char * const *keywords,
          <term><symbol>CONNECTION_CHECK_WRITABLE</symbol></term>
          <listitem>
           <para>
-           Checking if connection is able to handle write transactions.
+           Vérification que la connexion est capable de gérer des transactions
+           en écriture.
           </para>
          </listitem>
         </varlistentry>
@@ -810,10 +811,10 @@ typedef struct
     analysent une chaîne donnée par l'utilisateur pour obtenir les paramètres
     de connexion. Deux formats sont acceptés pour ces chaînes&nbsp;:
     le format régulier <literal>keyword = value</literal> et le format des
-    URI. URIs generally follow
+    URI. Les URIs respectent généralement la
     <ulink url="http://www.ietf.org/rfc/rfc3986.txt">RFC
-    3986</ulink>, except that multi-host connection strings are allowed
-    as further described below.
+    3986</ulink>, sauf que les chaînes de connexions multi hôtes sont
+    autorisées, comme décrit ci-dessous.
    </para>
 
    <sect3>
@@ -919,12 +920,13 @@ typedef struct
     </para>
 
    <para>
-    It is possible to specify multiple host components, each with an optional
-    port component, in a single URI.  A URI of the form
-    <literal>postgresql://host1:port1,host2:port2,host3:port3/</literal>
-    is equivalent to a connection string of the form
-    <literal>host=host1,host2,host3 port=port1,port2,port3</literal>.  Each
-    host will be tried in turn until a connection is successfully established.
+    Il est possible de spécifier plusieurs composants hôte, chacun avec un port
+    optionnel, dans une seule URI. Une URI de la forme
+    <literal>postgresql://host1:port1,host2:port2,host3:port3/</literal> est
+    équivalent à une chaîne de connexion de la forme
+    <literal>host=host1,host2,host3 port=port1,port2,port3</literal>.  Chaque
+    hôte sera testé à son tour jusqu'à ce qu'une connexion soit établie avec
+    succès.
    </para>
    </sect3>
   </sect2>
@@ -940,18 +942,20 @@ typedef struct
       <term><literal>host</literal></term>
       <listitem>
        <para>
-        Comma-separated list of host names.<indexterm><primary>host name</primary></indexterm>
-        Si a host name commence avec un slash, il spécifie une communication par domaine
-        Unix plutôt qu'une communication TCP/IP&nbsp;; la valeur est le nom du
-        répertoire où le fichier socket est stocké. If
-        multiple host names are specified, each will be tried in turn in
-        the order given.  Par défaut, quand
-        <literal>host</literal> n'est pas spécifié, il s'agit d'une communication par
-        socket de domaine Unix<indexterm><primary>socket de domaine Unix</primary></indexterm>
-        dans <filename>/tmp</filename> (ou tout autre répertoire de socket spécifié
-        lors de la construction de <productname>PostgreSQL</productname>). Sur les machines
-        sans sockets de domaine Unix, la valeur par défaut est de se connecter
-        à <literal>localhost</literal>.
+        Liste de noms d'hôte séparés par des virgule.<indexterm><primary>host
+                name</primary></indexterm>
+        Si un host name commence avec un slash, il spécifie une communication
+        par domaine Unix plutôt qu'une communication TCP/IP&nbsp;; la valeur
+        est le nom du répertoire où le fichier socket est stocké. If multiple
+        host names are specified, each will be tried in turn in the order
+        given.  Par défaut, quand <literal>host</literal> n'est pas spécifié,
+        il s'agit d'une communication par socket de domaine
+        Unix<indexterm><primary>socket de domaine Unix</primary></indexterm>
+        dans <filename>/tmp</filename> (ou tout autre répertoire de socket
+        spécifié lors de la construction de
+        <productname>PostgreSQL</productname>). Sur les machines sans sockets
+        de domaine Unix, la valeur par défaut est de se connecter à
+        <literal>localhost</literal>.
        </para>
       </listitem>
      </varlistentry>
@@ -1024,10 +1028,12 @@ typedef struct
       <listitem>
        <para>
         Numéro de port pour la connexion au serveur ou extension du nom de
-        fichier pour des connexions de domaine Unix.<indexterm><primary>port</primary></indexterm>
-        If the <literal>host</literal> parameter included multiple, comma-separated
-        hosts, this parameter may specify a list of ports of equal length,
-        or it may specify a single port number to be used for all hosts.
+        fichier pour des connexions de domaine
+        Unix.<indexterm><primary>port</primary></indexterm> Si le paramètre
+        <literal>host</literal> inclue plusieurs hôtes, séparés par des
+        virgules, ce paramètre peut spécifier une liste de ports de même même
+        taille, ou il peut spécifier un seul numéro de port à être utilisé avec
+        tous les hôtes.
        </para>
       </listitem>
      </varlistentry>
@@ -1069,11 +1075,11 @@ typedef struct
       <term><literal>passfile</literal></term>
       <listitem>
       <para>
-       Specifies the name of the file used to store passwords
-       (see <xref linkend="libpq-pgpass"/>).
-       Defaults to <filename>~/.pgpass</filename>, or
-       <filename>%APPDATA%\postgresql\pgpass.conf</filename> on Microsoft Windows.
-       (No error is reported if this file does not exist.)
+       Spécifié le nom du fichier utilisé pour stocker les mots de passe
+       (voir <xref linkend="libpq-pgpass"/>).
+       La valeur par défaut est <filename>~/.pgpass</filename>, ou
+       <filename>%APPDATA%\postgresql\pgpass.conf</filename> sur Microsoft
+       Windows. (Aucune erreur n'est levée si le fichier n'existe pas.)
       </para>
       </listitem>
      </varlistentry>
@@ -1086,10 +1092,11 @@ typedef struct
         chaîne d'entier décimaux). Zéro ou non spécifié signifie une attente
         indéfinie. Utiliser un décompte de moins de deux secondes n'est pas
         recommandé.
-        This timeout applies separately to each connection attempt.
-        For example, if you specify two hosts and both of them are unreachable,
-        and <literal>connect_timeout</literal> is 5, the total time spent waiting for a
-        connection might be up to 10 seconds.
+        Ce temps d'attente s'applique séparément pour chaque tentative de
+        connexion.  Par exemple, si vous spécifiez deux hôtes et qu'aucun des
+        deux n'est joignable, et que <literal>connect_timeout</literal> vaut 5,
+        le temps total passé à attendre une connexion pourra être jusqu'à 10
+        secondes.
        </para>
       </listitem>
      </varlistentry>
@@ -1488,15 +1495,16 @@ typedef struct
       <term><literal>target_session_attrs</literal></term>
       <listitem>
        <para>
-        If this parameter is set to <literal>read-write</literal>, only a
-        connection in which read-write transactions are accepted by default
-        is considered acceptable.  The query
-        <literal>show transaction_read_only</literal> will be sent upon any
-        successful connection; if it returns <literal>on</literal>, the connection
-        will be closed.  If multiple hosts were specified in the connection
-        string, any remaining servers will be tried just as if the connection
-        attempt had failed.  The default value of this parameter,
-        <literal>any</literal>, regards all connections as acceptable.
+        Si ce paramètre est positionné à <literal>read-write</literal>, seule
+        une connexion dans laquelle les transaction en lecture/écriture sont
+        acceptées par défaut est considéré comme acceptable.  La requête
+        <literal>show transaction_read_only</literal> sera envoyée à chaque
+        connexion réussie; si elle retourne <literal>on</literal>, la connexion
+        sera fermée.  Si plusieurs hôtes étaient spécifiés dans la chaîne de
+        connexion, chaque serveur restant sera testé tout comme si la tentative
+        de connexion avait échouée.  La valeur par défaut pour ce paramètre,
+        <literal>any</literal>, considère toutes les connexions comme
+        acceptables.
        </para>
       </listitem>
      </varlistentry>
@@ -1531,12 +1539,13 @@ typedef struct
 
   <para>
    Les fonctions suivantes renvoient les valeurs des paramètres utilisés
-   pour la connexion. Ces valeurs sont fixes pour la durée de vie de la connexion.
-   If a multi-host connection string is used, the values of
-   <function>PQhost</function>, <function>PQport</function>, and
-   <function>PQpass</function> can change if a new connection is established
-   using the same <structname>PGconn</structname> object.  Other values are
-   fixed for the lifetime of the <structname>PGconn</structname> object.
+   pour la connexion. Ces valeurs sont fixes pour la durée de vie de la
+   connexion.  Si une chaîne de connexion multi h$ote est utilisée, les valeurs
+   de <function>PQhost</function>, <function>PQport</function>, et
+   <function>PQpass</function> peuvent changer si une nouvelle connexion est
+   établie en utilisant le même objet <structname>PGconn</structname>.  Les
+   autres valeurs sont figées pour la durée de vie de l'objet
+   <structname>PGconn</structname>.
 
    <structname>PGconn</structname>.
 
@@ -5447,32 +5456,37 @@ PGContextVisibility PQsetErrorContextVisibility(PGconn *conn, PGContextVisibilit
      </para>
 
      <para>
-      The <parameter>passwd</parameter> and <parameter>user</parameter> arguments
-      are the cleartext password, and the SQL name of the user it is for.
-      <parameter>algorithm</parameter> specifies the encryption algorithm
-      to use to encrypt the password. Currently supported algorithms are
-      <literal>md5</literal> and <literal>scram-sha-256</literal> (<literal>on</literal> and
-      <literal>off</literal> are also accepted as aliases for <literal>md5</literal>, for
-      compatibility with older server versions). Note that support for
-      <literal>scram-sha-256</literal> was introduced in <productname>PostgreSQL</productname>
-      version 10, and will not work correctly with older server versions. If
-      <parameter>algorithm</parameter> is <symbol>NULL</symbol>, this function will query
-      the server for the current value of the
-      <xref linkend="guc-password-encryption"/> setting. That can block, and
-      will fail if the current transaction is aborted, or if the connection
-      is busy executing another query. If you wish to use the default
-      algorithm for the server but want to avoid blocking, query
-      <varname>password_encryption</varname> yourself before calling
-      <function>PQencryptPasswordConn</function>, and pass that value as the
-      <parameter>algorithm</parameter>.
-     </para>
-
-     <para>
-      The return value is a string allocated by <function>malloc</function>.
-      The caller can assume the string doesn't contain any special characters
-      that would require escaping.  Use <function>PQfreemem</function> to free the
-      result when done with it. On error, returns <symbol>NULL</symbol>, and
-      a suitable message is stored in the connection object.
+      Les arguments <parameter>passwd</parameter> et
+      <parameter>user</parameter> sont des mots de passe en clair, et le nom
+      SQL de l'utilisateur à qui ils correspondent.
+      <parameter>algorithm</parameter> spécifie l'algorithme de chiffrement à
+      utiliser pour chiffrer le mot de passe.  Pour le moment, les algorithmes
+      supportés sont <literal>md5</literal> et <literal>scram-sha-256</literal>
+      (<literal>on</literal> et <literal>off</literal> sont également acceptés
+      comme des alias pour aliases for <literal>md5</literal>, pour
+      compatibilité avec les anciennes versions de serveur).  Veuillez noter
+      que le support de <literal>scram-sha-256</literal> a été introduit dans
+      la version 10 de <productname>PostgreSQL</productname>, et ne
+      fonctionnera pas corrrectement avec des versions de serveur plus
+      ancienne.  Si <parameter>algorithm</parameter> est <symbol>NULL</symbol>,
+      cette fonction demandera au serveur pour la valeur actuelle du réglage
+      <xref linkend="guc-password-encryption"/>.  Cela peut être bloquant, et
+      échouera si la transaction courante est annulée, ou si la connexion est
+      occupée à effectuer une autre requête.  Si vous souhaitez utiliser
+      l'algorithme par défaut du serveur mais que vous voulez éviter un
+      blocage, vérifiez vous-même <varname>password_encryption</varname> avant
+      d'appeler <function>PQencryptPasswordConn</function>, et fournissez cette
+      valeur pour <parameter>algorithm</parameter>.
+     </para>
+
+     <para>
+      La valeur retournée esst une chaîne allouée par
+      <function>malloc</function>.  L'appelant peut partir du principe que la
+      chaîne ne contient pas de caractères spéciaux qui nécessiteraient un
+      échappement.  Utilisez <function>PQfreemem</function> pour libérer le
+      résultat quand vous avez fini de l'utiliser.  En cas d'erreur,
+      <symbol>NULL</symbol> est retourné, et un message d'erreur adéquat est
+      stocké dans l'objet de connexion.
      </para>
 
     </listitem>
@@ -5488,15 +5502,16 @@ PGContextVisibility PQsetErrorContextVisibility(PGconn *conn, PGContextVisibilit
 
     <listitem>
      <para>
-      Prepares the md5-encrypted form of a <productname>PostgreSQL</productname> password.
+      Prépare la version chiffrée en md5 du mot de passe
+      <productname>PostgreSQL</productname>.
  <synopsis>
 char *PQencryptPassword(const char *passwd, const char *user);
  </synopsis>
-      <function>PQencryptPassword</function> is an older, deprecated version of 
-      <function>PQencryptPasswodConn</function>. The difference is that
-      <function>PQencryptPassword</function> does not 
-      require a connection object, and <literal>md5</literal> is always used as the
-      encryption algorithm.
+      <function>PQencryptPassword</function> est une version ancienne et
+      dépréciée et <function>PQencryptPasswodConn</function>.  La différence
+      est que <function>PQencryptPassword</function> ne nécessite pas d'objet
+      de connexion, et que <literal>md5</literal> est toujours utilisé comme
+      algorithme de chiffrement.
     </para>
    </listitem>
   </varlistentry>
@@ -6540,9 +6555,8 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
      <indexterm>
       <primary><envar>PGPASSFILE</envar></primary>
      </indexterm>
-     <envar>PGPASSFILE</envar>
-     behaves the same as the <xref
-      linkend="libpq-connect-passfile"/> connection parameter.
+     <envar>PGPASSFILE</envar> se comporte de la même façon que le paramètre de
+     connexion <xref linkend="libpq-connect-passfile"/>.
     </para>
    </listitem>
    <listitem>
@@ -6742,8 +6756,9 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
       <indexterm>
        <primary><envar>PGTARGETSESSIONATTRS</envar></primary>
       </indexterm>
-      <envar>PGTARGETSESSIONATTRS</envar> behaves the same as the <xref
-      linkend="libpq-connect-target-session-attrs"/> connection parameter.
+      <envar>PGTARGETSESSIONATTRS</envar> se comporte de la même façon que le
+      paramètre de connexion <xref
+          linkend="libpq-connect-target-session-attrs"/>.
      </para>
     </listitem>
   </itemizedlist>
@@ -6847,9 +6862,9 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
   Sur Microsoft Windows, le fichier est nommé
   <filename>%APPDATA%\postgresql\pgpass.conf</filename> (où <filename>%APPDATA%</filename>
   fait référence au sous-répertoire Application Data du profile de l'utilisateur).
-  Alternatively, a password file can be specified
-  using the connection parameter <xref linkend="libpq-connect-passfile"/>
-  or the environment variable <envar>PGPASSFILE</envar>.
+  De manière alternative, un fichier de mots de passe peut être spécifié en
+  utilisant le paramètre de connexion <xref linkend="libpq-connect-passfile"/>
+  ou la variable d'environnement <envar>PGPASSFILE</envar>.
  </para>
 
  <para>