From: jon
Date: December 21 2005 1:12pm
Subject: svn commit - mysqldoc@docsrva: r610 - in trunk: refman-5.0 refman-5.1 refman-common
List-Archive: http://lists.mysql.com/commits/316
Message-Id: <200512211312.jBLDCYDE014156@docsrva.mysql.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Author: jstephens
Date: 2005-12-21 14:12:32 +0100 (Wed, 21 Dec 2005)
New Revision: 610

Log:

Documented fix for Bug #13164.

Updated yaSSL 5.0/5.1 documentation, added index terms. (Thanks, Magnus!)



Modified:
   trunk/refman-5.0/database-administration.xml
   trunk/refman-5.1/database-administration.xml
   trunk/refman-common/news-5.0.xml

Modified: trunk/refman-5.0/database-administration.xml
===================================================================
--- trunk/refman-5.0/database-administration.xml	2005-12-21 12:17:27 UTC (rev 609)
+++ trunk/refman-5.0/database-administration.xml	2005-12-21 13:12:32 UTC (rev 610)
@@ -17466,6 +17466,10 @@
       </indexterm>
 
       <indexterm>
+        <primary>yaSSL</primary>
+      </indexterm>
+
+      <indexterm>
         <primary>SSL and X509 Basics</primary>
       </indexterm>
 
@@ -17642,9 +17646,13 @@
         <title>&title-secure-using-yassl;</title>
 
         <indexterm>
-          <primary>OpenSSL</primary>
+          <primary>SSL</primary>
         </indexterm>
 
+        <indexterm>
+          <primary>yaSSL</primary>
+        </indexterm>
+
         <para>
           Using MySQL's built-in yaSSL support makes it easier to use
           secure connections. You don't have to install OpenSSL and
@@ -17652,9 +17660,16 @@
           <xref linkend="secure-requirements"/>. Also, both MySQL and
           yaSSL employ the same licensing model.
         </para>
+        
+        <para>
+          Beginning with version 5.0.16, all MySQL binaries excepting
+          those for SCO OpenServer 6 version have yaSSL support compiled
+          in.
+        </para>
 
         <para>
-          Currently, yaSSL support is available for these platforms:
+          Previously, yaSSL support was available only for these
+          platforms:
         </para>
 
         <itemizedlist>
@@ -17686,13 +17701,23 @@
         </itemizedlist>
 
         <para>
-          If you want to enable yaSSL when building MySQL from source,
-          you should configure MySQL like this:
+          Previous to MySQL 5.0.10, it was necessary to enable yaSSL
+          when building MySQL from source. For those versions, you
+          should configure MySQL like this:
         </para>
 
 <programlisting>
 ./configure --with-yassl=yes
 </programlisting>
+        
+        <para>
+          Note that yaSSL support on Unix platforms requires that either
+          <filename>/dev/urandom</filename> or
+          <filename>/dev/random</filename> be installed in order to
+          retrieve true random numbers. For additional information
+          (especially regarding yaSSL on Solaris versions prior to 2.8
+          and HP-UX), see Bug #13164.
+        </para>
 
         <para>
           To start the MySQL server with yaSSL support, use the same

Modified: trunk/refman-5.1/database-administration.xml
===================================================================
--- trunk/refman-5.1/database-administration.xml	2005-12-21 12:17:27 UTC (rev 609)
+++ trunk/refman-5.1/database-administration.xml	2005-12-21 13:12:32 UTC (rev 610)
@@ -17378,6 +17378,10 @@
       </indexterm>
 
       <indexterm>
+        <primary>yaSSL</primary>
+      </indexterm>
+
+      <indexterm>
         <primary>SSL and X509 Basics</primary>
       </indexterm>
 
@@ -17554,9 +17558,13 @@
         <title>&title-secure-using-yassl;</title>
 
         <indexterm>
-          <primary>OpenSSL</primary>
+          <primary>SSL</primary>
         </indexterm>
 
+        <indexterm>
+          <primary>yaSSL</primary>
+        </indexterm>
+
         <para>
           Using MySQL's built-in yaSSL support makes it easier to use
           secure connections. You don't have to install OpenSSL and
@@ -17564,39 +17572,13 @@
           <xref linkend="secure-requirements"/>. Also, both MySQL and
           yaSSL employ the same licensing model.
         </para>
-
+        
         <para>
-          Currently, yaSSL support is available for these platforms:
+          Beginning with version 5.0.16, all MySQL binaries excepting
+          those for SCO OpenServer 6 version have yaSSL support compiled
+          in.
         </para>
 
-        <itemizedlist>
-
-          <listitem>
-            <para>
-              Linux/x86-64 Red Hat Enterprise 3.0
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Linux RHAS21 Itanium-2 with gcc, statically linked
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Linux Itanium-2 with gcc
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              Windows (all builds)
-            </para>
-          </listitem>
-
-        </itemizedlist>
-
         <para>
           If you want to enable yaSSL when building MySQL from source,
           you should configure MySQL like this:
@@ -17605,6 +17587,15 @@
 <programlisting>
 ./configure --with-yassl=yes
 </programlisting>
+        
+        <para>
+          Note that yaSSL support on Unix platforms requires that either
+          <filename>/dev/urandom</filename> or
+          <filename>/dev/random</filename> be installed in order to
+          retrieve true random numbers. For additional information
+          (especially regarding yaSSL on Solaris versions prior to 2.8
+          and HP-UX), see Bug #13164.
+        </para>
 
         <para>
           To start the MySQL server with yaSSL support, use the same

Modified: trunk/refman-common/news-5.0.xml
===================================================================
--- trunk/refman-common/news-5.0.xml	2005-12-21 12:17:27 UTC (rev 609)
+++ trunk/refman-common/news-5.0.xml	2005-12-21 13:12:32 UTC (rev 610)
@@ -1033,6 +1033,15 @@
     </para>
 
     <itemizedlist>
+      
+      <listitem>
+        <para>
+          When trying to run the server with yaSSL enabled, MySQL now
+          tries to open <filename>/dev/random</filename> automatically
+          if <filename>/dev/urandom</filename> is not available. (Bug 
+          #13164) 
+        </para>
+      </listitem>
 
       <listitem>
         <para>