Changeset 744

Show
Ignore:
Timestamp:
10/10/07 19:22:34 (1 year ago)
Author:
gleu
Message:

Dernier fichier du merge 8.3b1.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/manuel/libpq.xml

    r682 r744  
    135135      l'application d'éviter une recherche de nom d'hôte, qui pourrait être 
    136136      importante pour les applications ayant des contraintes de temps. 
    137       Néanmoins, l'authentification Kerberos requiert un nom d'hôte. Du coup, ce 
     137      Néanmoins, les authentifications Kerberos et GSSAPI requièrent un nom 
     138      d'hôte. Du coup, ce 
    138139      qui suit s'applique&nbsp;: si <literal>host</literal> est spécifié sans 
    139140      <literal>hostaddr</literal>, une recherche de nom d'hôte a lieu. Si 
    …… 
    284285      <para> 
    285286       Nom du service Kerberos à utiliser lors de l'authentification avec 
    286        Kerberos 5. Il doit correspondre avec le nom du service spécifié dans 
     287       Kerberos 5 et GSSAPI. Il doit correspondre avec le nom du service spécifié dans 
    287288       la configuration du serveur pour que l'authentification Kerberos puisse 
    288        réussir (voir aussi la <xref linkend="kerberos-auth"/>). 
    289       </para> 
    290      </listitem> 
    291     </varlistentry> 
     289       réussir (voir aussi la <xref linkend="kerberos-auth"/> and <xref linkend="gssapi-auth">.) 
     290          </para> 
     291         </listitem> 
     292        </varlistentry> 
     293 
     294        <varlistentry> 
     295         <term><literal>gsslib</literal></term> 
     296         <listitem> 
     297          <para> 
     298           GSS library to use for GSSAPI authentication. Only used on Windows. 
     299           Set to <literal>gssapi</literal> to force libpq to use the GSSAPI 
     300           library for authentication instead of the default SSPI. 
     301          </para> 
     302         </listitem> 
     303        </varlistentry> 
    292304 
    293305    <varlistentry> 
    …… 
    335347   paramètres fixes dont vous souhaitez utiliser la valeur par défaut. 
    336348   </para> 
     349 
     350      <para> 
     351        If the <parameter>dbName</parameter> contains an <symbol>=</symbol> sign, it 
     352        is taken as a <parameter>conninfo</parameter> string in exactly the same way as 
     353        if it had been passed to <function>PQconnectdb</function>, and the remaining 
     354        parameters are then applied as above. 
     355      </para> 
    337356  </listitem> 
    338357 </varlistentry> 
    …… 
    10301049 
    10311050    <varlistentry> 
     1051     <term><function>PQconnectionUsedPassword</function><indexterm><primary>PQconnectionUsedPassword</primary></indexterm></term> 
     1052     <listitem> 
     1053      <para> 
     1054       Returns true (1) if the connection authentication method 
     1055       required a password to be supplied. Returns false (0) if not. 
     1056 
     1057       <synopsis> 
     1058        int PQconnectionUsedPassword(const PGconn *conn); 
     1059       </synopsis> 
     1060 
     1061      </para> 
     1062 
     1063      <para> 
     1064       This function can be applied after either successful or failed 
     1065       connection attempts.  In the case of failure, it can for example 
     1066       be used to decide whether to prompt the user for a password. 
     1067      </para> 
     1068     </listitem> 
     1069    </varlistentry> 
     1070 
     1071    <varlistentry> 
    10321072     <term><function>PQgetssl</function><indexterm><primary>PQgetssl</primary></indexterm></term> 
    10331073     <listitem> 
    …… 
    12701310paramètre ou choisit un type différent de celui que vous voulez. Dans le texte 
    12711311de commande SQL, attachez une conversion explicite au symbole de paramètre pour 
    1272 montrer le type de données que vous enverrez. Par exemple, 
    1273 <programlisting>select * from ma_table where x = $1::bigint; 
     1312montrer le type de données que vous enverrez. Par exemple&nbsp;: 
     1313<programlisting>SELECT * FROM ma_table WHERE x = $1::bigint; 
    12741314</programlisting> 
    12751315Ceci impose le traitement du paramètre <literal>$1</literal> en tant que <type>bigint</type> 
    …… 
    18681908<listitem> 
    18691909<para> 
    1870           Renvoie le nombre de lignes (tuples) du résultat de la requête. 
     1910          Renvoie le nombre de lignes (tuples) du résultat de la requête. Because 
     1911       it returns an integer result, large result sets might overflow the 
     1912       return value on 32-bit operating systems. 
    18711913<synopsis>int PQntuples(const PGresult *res); 
    18721914</synopsis> 
    …… 
    19261968        guillemets doubles. Par exemple, pour le résultat de la requête 
    19271969        suivante 
    1928 <programlisting>select 1 as FOO, 2 as "BAR"; 
     1970<programlisting>SELECT 1 AS FOO, 2 AS "BAR"; 
    19291971</programlisting> 
    19301972        nous devons obtenir les résultats suivants&nbsp;: 
    …… 
    23602402  <title>Chaîne d'échappement à inclure dans les commandes SQL</title> 
    23612403 
    2362    <indexterm zone="libpq-exec-escape-string"><primary>PQescapeStringConn</primary></indexterm> 
    2363    <indexterm zone="libpq-exec-escape-string"><primary>PQescapeString</primary></indexterm> 
    23642404   <indexterm zone="libpq-exec-escape-string"> 
    2365      <primary>chaînes d'échappement</primary> 
    2366      <secondary>dans libpq</secondary> 
     2405    <primary>PQescapeStringConn</primary> 
     2406   </indexterm> 
     2407   <indexterm zone="libpq-exec-escape-string"> 
     2408    <primary>PQescapeString</primary> 
     2409   </indexterm> 
     2410   <indexterm zone="libpq-exec-escape-string"> 
     2411    <primary>chaînes d'échappement</primary> 
     2412    <secondary>dans libpq</secondary> 
    23672413   </indexterm> 
    23682414 
    …… 
    41614207</para> 
    41624208</listitem> 
     4209    <listitem> 
     4210     <para> 
     4211      <indexterm> 
     4212       <primary><envar>PGSSLKEY</envar></primary> 
     4213      </indexterm> 
     4214      <envar>PGSSLKEY</envar> specifies the hardware token that stores the 
     4215      secret key for the client certificate. The value of this variable 
     4216      should consist of a colon-separated engine name (engines are 
     4217      <productname>OpenSSL</productname> loadable modules) and an engine-specific key 
     4218      identifier.  If this is not set, the secret key must be kept in a 
     4219      file. 
     4220     </para> 
     4221    </listitem> 
     4222 
    41634223<listitem> 
    41644224<para> 
    …… 
    41674227</indexterm> 
    41684228<envar>PGKRBSRVNAME</envar> configure le nom du service Kerberos à utiliser 
    4169 lors de l'authentification avec Kerberos 5. 
    4170 </para> 
    4171 </listitem> 
     4229lors de l'authentification avec Kerberos 5 ou GSSAPI. 
     4230</para> 
     4231</listitem> 
     4232 
     4233    <listitem> 
     4234     <para> 
     4235      <indexterm> 
     4236       <primary><envar>PGGSSLIB</envar></primary> 
     4237      </indexterm> 
     4238      <envar>PGGSSLIB</envar> sets the GSS library to use for GSSAPI 
     4239      authentication. 
     4240     </para> 
     4241    </listitem> 
    41724242<listitem> 
    41734243<para> 
    …… 
    43094379 
    43104380<para> 
    4311 Les droits sur <filename>.pgpass</filename> doivent interdire l'accès aux 
    4312 autres et au groupe&nbsp;; réalisez ceci avec la commande 
    4313 <command>chmod 0600 ~/.pgpass</command>. 
    4314 Si les droits du fichier sont moins stricts, le fichier sera ignoré 
    4315 (néanmoins, les droits du fichier ne sont actuellement pas vérifiés sur 
    4316 Microsoft Windows). 
     4381   On Unix systems, the permissions on <filename>.pgpass</filename> must 
     4382   disallow any access to world or group; achieve this by the command 
     4383   <command>chmod 0600 ~/.pgpass</command>.  If the permissions are less 
     4384   strict than this, the file will be ignored.  On Microsoft Windows, it 
     4385   is assumed that the file is stored in a directory that is secure, so 
     4386   no special permissions check is made. 
    43174387</para> 
    43184388</sect1> 
    …… 
    44094479</synopsis> 
    44104480</para> 
     4481 
     4482  <para> 
     4483   You can also mix regular service file entries with LDAP lookups. 
     4484   A complete example for a stanza in <filename>pg_service.conf</filename> 
     4485   would be: 
     4486   <synopsis> 
     4487    # only host and port are stored in LDAP, specify dbname and user explicitly 
     4488    [customerdb] 
     4489    dbname=customer 
     4490    user=appuser 
     4491    ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*) 
     4492   </synopsis> 
     4493  </para> 
    44114494</sect1> 
    44124495 
    …… 
    44274510 
    44284511  <para> 
    4429     Si le serveur demande un certificat au client,  
    4430     <application>libpq</application> enverra le certificat stocké dans le 
    4431     fichier <filename>~/.postgresql/postgresql.crt</filename> se trouvant à 
    4432     l'intérieur du répertoire personnel de l'utilisateur. Un fichier de la clé 
    4433     privée correspondante, <filename>~/.postgresql/postgresql.key</filename>, doit 
    4434     aussi être présent et ne doit pas être lisible par tout le monde (sur les 
    4435     systèmes Microsoft Windows, ces fichiers sont nommés 
    4436     <filename>%APPDATA%\postgresql\postgresql.crt</filename> et 
    4437     <filename>%APPDATA%\postgresql\postgresql.key</filename>). 
     4512   <application>libpq</application> reads the system-wide 
     4513   <productname>OpenSSL</productname> configuration file. By default, this 
     4514   file is named <filename>openssl.cnf</filename> and is located in the 
     4515   directory reported by <literal>openssl version -d</literal>.  This default 
     4516   can be overridden by setting environment variable 
     4517   <envar>OPENSSL_CONF</envar> to the name of the desired configuration 
     4518   file. 
    44384519  </para> 
     4520 
     4521  <para> 
     4522   If the server demands a client certificate, 
     4523   <application>libpq</application> will send the certificate stored in 
     4524   file <filename>~/.postgresql/postgresql.crt</filename> within the user's home 
     4525   directory.  A matching private key file 
     4526   <filename>~/.postgresql/postgresql.key</filename> must also be present, unless 
     4527   the secret key for the certificate is stored in a hardware token, as 
     4528   specified by <envar>PGSSLKEY</envar>.  (On Microsoft Windows these 
     4529   files are named <filename>%APPDATA%\postgresql\postgresql.crt</filename> 
     4530   and <filename>%APPDATA%\postgresql\postgresql.key</filename>.) The 
     4531   private key file must not be world-readable. 
     4532  </para> 
     4533 
     4534  <para> 
     4535   If the environment variable <envar>PGSSLKEY</envar> is set, its value 
     4536   should consist of a colon-separated engine name and key identifier. In 
     4537   this case, <application>libpq</application> will load the specified 
     4538   engine, i.e. the <productname>OpenSSL</productname> module which supports special 
     4539   hardware, and reference the key with the specified identifier. 
     4540   Identifiers are engine-specific. Typically, cryptography hardware tokens 
     4541   do not reveal secret keys to the application. Instead, applications 
     4542   delegate all cryptography operations which require the secret key to 
     4543   the hardware token. 
     4544  </para> 
     4545 
    44394546 
    44404547  <para>