Author: paul
Date: 2008-07-11 19:16:03 +0200 (Fri, 11 Jul 2008)
New Revision: 11218
Log:
r32543@frost: paul | 2008-07-11 11:18:31 -0500
Add info describing how session/global values of character_set_client
are used. (Info from Bar)
(Bug#35372)
Modified:
trunk/refman-4.1/dba-core.xml
trunk/refman-5.0/dba-core.xml
trunk/refman-5.1/dba-core.xml
trunk/refman-6.0/dba-core.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:35828
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:32538
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:32106
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:35828
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:32543
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:32106
Modified: trunk/refman-4.1/dba-core.xml
===================================================================
--- trunk/refman-4.1/dba-core.xml 2008-07-11 16:43:52 UTC (rev 11217)
+++ trunk/refman-4.1/dba-core.xml 2008-07-11 17:16:03 UTC (rev 11218)
Changed blocks: 1, Lines Added: 43, Lines Deleted: 0; 2221 bytes
@@ -3246,6 +3246,49 @@
The character set for statements that arrive from the
client. This variable was added in MySQL 4.1.1.
</para>
+
+ <para>
+ The session value of this variable is set using the
+ character set requested by the client when the client
+ connects to the server. (Many clients support a
+ <option>--default-character-set</option> option to enable
+ this character set to be specified explicitly. See also
+ <xref linkend="charset-connection"/>.) The global value of
+ the variable is used to set the session value in cases when
+ the client-requested value is unknown or not available, or
+ the server is configured to ignore client requests:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ The client is from a version of MySQL older than MySQL
+ 4.1, and thus does not request a character set.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ The client requests a character set not known to the
+ server. For example, a Japanese-enabled client requests
+ <literal>sjis</literal> when connecting to a server not
+ configured with <literal>sjis</literal> support.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>mysqld</command> was started with the
+ <option>--skip-character-set-client-handshake</option>
+ option, which causes it to ignore client character set
+ configuration. This reproduces MySQL 4.0 behavior and is
+ useful should you wish to upgrade the server without
+ upgrading all the clients.
+ </para>
+ </listitem>
+
+ </itemizedlist>
</listitem>
<listitem>
Modified: trunk/refman-5.0/dba-core.xml
===================================================================
--- trunk/refman-5.0/dba-core.xml 2008-07-11 16:43:52 UTC (rev 11217)
+++ trunk/refman-5.0/dba-core.xml 2008-07-11 17:16:03 UTC (rev 11218)
Changed blocks: 1, Lines Added: 40, Lines Deleted: 1; 2171 bytes
@@ -3822,8 +3822,47 @@
<para>
The character set for statements that arrive from the
- client.
+ client. The session value of this variable is set using the
+ character set requested by the client when the client
+ connects to the server. (Many clients support a
+ <option>--default-character-set</option> option to enable
+ this character set to be specified explicitly. See also
+ <xref linkend="charset-connection"/>.) The global value of
+ the variable is used to set the session value in cases when
+ the client-requested value is unknown or not available, or
+ the server is configured to ignore client requests:
</para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ The client is from a version of MySQL older than MySQL
+ 4.1, and thus does not request a character set.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ The client requests a character set not known to the
+ server. For example, a Japanese-enabled client requests
+ <literal>sjis</literal> when connecting to a server not
+ configured with <literal>sjis</literal> support.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>mysqld</command> was started with the
+ <option>--skip-character-set-client-handshake</option>
+ option, which causes it to ignore client character set
+ configuration. This reproduces MySQL 4.0 behavior and is
+ useful should you wish to upgrade the server without
+ upgrading all the clients.
+ </para>
+ </listitem>
+
+ </itemizedlist>
</listitem>
<listitem>
Modified: trunk/refman-5.1/dba-core.xml
===================================================================
--- trunk/refman-5.1/dba-core.xml 2008-07-11 16:43:52 UTC (rev 11217)
+++ trunk/refman-5.1/dba-core.xml 2008-07-11 17:16:03 UTC (rev 11218)
Changed blocks: 1, Lines Added: 40, Lines Deleted: 1; 2171 bytes
@@ -3958,8 +3958,47 @@
<para>
The character set for statements that arrive from the
- client.
+ client. The session value of this variable is set using the
+ character set requested by the client when the client
+ connects to the server. (Many clients support a
+ <option>--default-character-set</option> option to enable
+ this character set to be specified explicitly. See also
+ <xref linkend="charset-connection"/>.) The global value of
+ the variable is used to set the session value in cases when
+ the client-requested value is unknown or not available, or
+ the server is configured to ignore client requests:
</para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ The client is from a version of MySQL older than MySQL
+ 4.1, and thus does not request a character set.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ The client requests a character set not known to the
+ server. For example, a Japanese-enabled client requests
+ <literal>sjis</literal> when connecting to a server not
+ configured with <literal>sjis</literal> support.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>mysqld</command> was started with the
+ <option>--skip-character-set-client-handshake</option>
+ option, which causes it to ignore client character set
+ configuration. This reproduces MySQL 4.0 behavior and is
+ useful should you wish to upgrade the server without
+ upgrading all the clients.
+ </para>
+ </listitem>
+
+ </itemizedlist>
</listitem>
<listitem>
Modified: trunk/refman-6.0/dba-core.xml
===================================================================
--- trunk/refman-6.0/dba-core.xml 2008-07-11 16:43:52 UTC (rev 11217)
+++ trunk/refman-6.0/dba-core.xml 2008-07-11 17:16:03 UTC (rev 11218)
Changed blocks: 1, Lines Added: 40, Lines Deleted: 1; 2171 bytes
@@ -3895,8 +3895,47 @@
<para>
The character set for statements that arrive from the
- client.
+ client. The session value of this variable is set using the
+ character set requested by the client when the client
+ connects to the server. (Many clients support a
+ <option>--default-character-set</option> option to enable
+ this character set to be specified explicitly. See also
+ <xref linkend="charset-connection"/>.) The global value of
+ the variable is used to set the session value in cases when
+ the client-requested value is unknown or not available, or
+ the server is configured to ignore client requests:
</para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ The client is from a version of MySQL older than MySQL
+ 4.1, and thus does not request a character set.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ The client requests a character set not known to the
+ server. For example, a Japanese-enabled client requests
+ <literal>sjis</literal> when connecting to a server not
+ configured with <literal>sjis</literal> support.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <command>mysqld</command> was started with the
+ <option>--skip-character-set-client-handshake</option>
+ option, which causes it to ignore client character set
+ configuration. This reproduces MySQL 4.0 behavior and is
+ useful should you wish to upgrade the server without
+ upgrading all the clients.
+ </para>
+ </listitem>
+
+ </itemizedlist>
</listitem>
<listitem>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r11218 - in trunk: . refman-4.1 refman-5.0 refman-5.1 refman-6.0 | paul | 11 Jul |
