database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-08 22:02:03 +03:00
Code

pgcrypto doc updates

Browse Source 
Marko Kreen
This commit is contained in:
Magnus Hagander 2008-01-17 11:06:28 +00:00
parent c7d7c15bb1
commit 98bb697f33
1 changed files with 10 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/src/sgml/pgcrypto.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.4 2008/01/05 13:17:00 petere Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.5 2008/01/17 11:06:28 mha Exp $ -->
<sect1 id="pgcrypto"> <sect1 id="pgcrypto">
<title>pgcrypto</title> <title>pgcrypto</title>
@ -26,8 +26,10 @@
<para> <para>
Computes a binary hash of the given <parameter>data</>. Computes a binary hash of the given <parameter>data</>.
<parameter>type</> is the algorithm to use. <parameter>type</> is the algorithm to use.
Standard algorithms are <literal>md5</literal> and Standard algorithms are <literal>md5</literal>, <literal>sha1</literal>,
<literal>sha1</literal>. If <filename>pgcrypto</> was built with <literal>sha224</literal>, <literal>sha256</literal>,
<literal>sha384</literal> and <literal>sha512</literal>.
If <filename>pgcrypto</> was built with
OpenSSL, more algorithms are available, as detailed in OpenSSL, more algorithms are available, as detailed in
<xref linkend="pgcrypto-with-without-openssl">. <xref linkend="pgcrypto-with-without-openssl">.
</para> </para>
@ -390,7 +392,7 @@
<title>PGP encryption functions</title> <title>PGP encryption functions</title>
<para> <para>
The functions here implement the encryption part of the OpenPGP (RFC 2440) The functions here implement the encryption part of the OpenPGP (RFC 4880)
standard. Supported are both symmetric-key and public-key encryption. standard. Supported are both symmetric-key and public-key encryption.
</para> </para>
@ -657,7 +659,7 @@
<para> <para>
Which compression algorithm to use. Only available if Which compression algorithm to use. Only available if
<filename>pgcrypto</> was built with zlib. <productname>PostgreSQL<productname/> was built with zlib.
</para> </para>
<programlisting> <programlisting>
Values: Values:
@ -689,7 +691,7 @@
<para> <para>
Whether to convert <literal>\n</literal> into <literal>\r\n</literal> when Whether to convert <literal>\n</literal> into <literal>\r\n</literal> when
encrypting and <literal>\r\n</literal> to <literal>\n</literal> when encrypting and <literal>\r\n</literal> to <literal>\n</literal> when
decrypting. RFC 2440 specifies that text data should be stored using decrypting. RFC 4880 specifies that text data should be stored using
<literal>\r\n</literal> line-feeds. Use this to get fully RFC-compliant <literal>\r\n</literal> line-feeds. Use this to get fully RFC-compliant
behavior. behavior.
</para> </para>
@ -706,7 +708,7 @@
<para> <para>
Do not protect data with SHA-1. The only good reason to use this Do not protect data with SHA-1. The only good reason to use this
option is to achieve compatibility with ancient PGP products, predating option is to achieve compatibility with ancient PGP products, predating
the addition of SHA-1 protected packets to RFC 2440. the addition of SHA-1 protected packets to RFC 4880.
Recent gnupg.org and pgp.com software supports it fine. Recent gnupg.org and pgp.com software supports it fine.
</para> </para>
<programlisting> <programlisting>
@ -1172,15 +1174,9 @@
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><ulink url="http://www.ietf.org/rfc/rfc2440.txt"></ulink></para> <para><ulink url="http://www.ietf.org/rfc/rfc4880.txt"></ulink></para>
<para>OpenPGP message format.</para> <para>OpenPGP message format.</para>
</listitem> </listitem>
<listitem>
<para>
<ulink url="http://www.imc.org/draft-ietf-openpgp-rfc2440bis"></ulink>
</para>
<para>New version of RFC 2440.</para>
</listitem>
<listitem> <listitem>
<para><ulink url="http://www.ietf.org/rfc/rfc1321.txt"></ulink></para> <para><ulink url="http://www.ietf.org/rfc/rfc1321.txt"></ulink></para>
<para>The MD5 Message-Digest Algorithm.</para> <para>The MD5 Message-Digest Algorithm.</para>