From: Bruce Momjian <bruce@momjian.us> Date: Fri, 18 Jan 2002 20:32:54 +0000 (+0000) Subject: Improve description of autocommit behavior in ecpg manual pages. X-Git-Tag: REL7_2_RC1~11 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9600ccad132556e1f72f1feaec5ece14b8d30db1;p=postgresql Improve description of autocommit behavior in ecpg manual pages. --- diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml index 1c0ab5c645..4e1fc95daa 100644 --- a/doc/src/sgml/ecpg.sgml +++ b/doc/src/sgml/ecpg.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/ecpg.sgml,v 1.33 2002/01/07 02:29:11 petere Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/ecpg.sgml,v 1.34 2002/01/18 20:32:53 momjian Exp $ --> <chapter id="ecpg"> @@ -1053,14 +1053,16 @@ ECPGdo(__LINE__, NULL, "select res from mytable where index = ? ", </para> <para> - All <acronym>SQL</acronym> statements are performed in one - transaction unless you issue a commit transaction. To accomplish - this auto-transaction behavior, the first statement and the first - statement after a commit or rollback always begins a new transaction. To - disable this feature, use the <option>-t</option> command-line - option. + In the default mode, queries are committed only when <command>exec + sql commit</command> is issued. <application>Ecpg</application> + also supports auto-commit of transactions via the + <option>-t</option> command-line option or via the <literal>exec + sql set autocommit to on</literal> statement. In + <literal>autocommit<literal> mode, each query is automatically + committed unless it is inside an explicit transaction block. This + mode can be explicitly turned off using <literal>exec sql set + autocommit to off</literal>. </para> - </sect2> </sect1> </chapter> diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index 62f08501fa..3e9fb16ef3 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.85 2002/01/07 02:29:12 petere Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.86 2002/01/18 20:32:54 momjian Exp $ --> <chapter id="libpq"> @@ -2109,10 +2109,17 @@ for information on correct values for these environment variables. <para> <filename>libpq</filename> is thread-safe as of <productname>PostgreSQL</productname> 7.0, so long as no two threads -attempt to manipulate the same <structname>PGconn</> object at the same time. In particular, -you cannot issue concurrent queries from different threads through the same -connection object. (If you need to run concurrent queries, start up multiple -connections.) +attempt to manipulate the same <structname>PGconn</> object at the same +time. In particular, you cannot issue concurrent queries from different +threads through the same connection object. (If you need to run +concurrent queries, start up multiple connections.) +</para> +<para> +However, <filename>libpq</filename> clients using the +<literal>crypt</literal> encryption method rely on the +<literal>crypt()</literal> operating system function, which often is not +thread-safe. It is better to use <literal>MD5</literal> encryption, +which is guarantted to be thread-safe on all platforms. </para> <para> diff --git a/doc/src/sgml/ref/ecpg-ref.sgml b/doc/src/sgml/ref/ecpg-ref.sgml index 30295b6d5b..1d6019b628 100644 --- a/doc/src/sgml/ref/ecpg-ref.sgml +++ b/doc/src/sgml/ref/ecpg-ref.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.16 2002/01/06 18:12:00 momjian Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.17 2002/01/18 20:32:54 momjian Exp $ PostgreSQL documentation --> @@ -57,7 +57,10 @@ PostgreSQL documentation <term>-t</term> <listitem> <para> - Turn on auto-commit of transactions. + Turn on auto-commit of transactions. In this mode, each query is + automatically committed unless it is inside an explicit + transaction block. In the default mode, queries are committed + only when <command>exec sql commit</command> is issued. </para> </listitem> </varlistentry> @@ -404,32 +407,6 @@ EXEC SQL COMMIT; missing features. </para> -<!-- -.SH FILES -.PD 0 -.TP -.B /usr/src/pgsql/postgresql-${ver}/src/interfaces... - ./ecpg/include.......source for \fIecpg\fP header files. - ./ecpg/lib...........source for \fIecpg\fP libraries. - ./ecpg/preproc.......source for \fIecpg\fP header files. - ./ecpg/test..........source for \fIecpg\fP libraries. - (test contains examples of syntax for ecpg SQL-C.) -.PD -.TP -.B /usr/local/pgsql/bin -\fIPostgreSQL\fP binaries including \fIecpg\fP. -.PD -.TP -.B /usr/local/pgsql/include -\fIPostgreSQL\fP headers including \fIecpglib.h\fP \fIecpgtype.h\fP -and \fIsqlca.h\fP. -.PD -.TP -.B /usr/local/pgsql/lib -\fIPostgreSQL\fP libraries including \fIlibecpg.a\fP and -\fIlibecpg.so\fP. ---> - </refsect1> </refentry>