Author: paul
Date: 2010-12-09 16:57:23 +0100 (Thu, 09 Dec 2010)
New Revision: 24350
Log:
r36976@dhcp-215: paul | 2010-12-09 09:56:20 -0500
Combine two similar sections on linking to the client library
Modified:
trunk/refman-4.1/apis-c.xml
trunk/refman-4.1/errors-problems.xml
trunk/refman-4.1/installing.xml
trunk/refman-4.1/renamed-nodes.txt
trunk/refman-5.0/apis-c.xml
trunk/refman-5.0/errors-problems.xml
trunk/refman-5.0/installing.xml
trunk/refman-5.0/renamed-nodes.txt
trunk/refman-5.1/apis-c.xml
trunk/refman-5.1/errors-problems.xml
trunk/refman-5.1/renamed-nodes.txt
trunk/refman-5.5/apis-c.xml
trunk/refman-5.5/errors-problems.xml
trunk/refman-5.5/renamed-nodes.txt
trunk/refman-5.6/apis-c.xml
trunk/refman-5.6/errors-problems.xml
trunk/refman-6.0/apis-c.xml
trunk/refman-6.0/errors-problems.xml
trunk/refman-6.0/installing.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:45239
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:66486
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
ebeeeee4-b232-4669-a521-231442eced53:/mysqldoc-local/mysqldoc/trunk:36973
+ 07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/mysqldoc/trunk:35498
07c7e7b4-24e3-4b51-89d0-6dc09fec6bec:/mysqldoc-local/trunk:45239
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:43968
4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/trunk:44480
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:66486
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:39036
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/trunk:39546
ebeeeee4-b232-4669-a521-231442eced53:/mysqldoc-local/mysqldoc/trunk:36976
Modified: trunk/refman-4.1/apis-c.xml
===================================================================
--- trunk/refman-4.1/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes
@@ -14131,18 +14131,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -14177,6 +14192,121 @@
(<literal>libmysqlclient_r</literal>).
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>
+ Another way to solve this problem is by linking your program
+ statically with the <literal>-static</literal> option, or by
+ removing the dynamic MySQL libraries before linking your code.
+ Before trying the second method, you should be sure that no
+ other programs are using the dynamic libraries.
+ </para>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-4.1/errors-problems.xml
===================================================================
--- trunk/refman-4.1/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes
@@ -1393,9 +1393,10 @@
<para>
Increasing <option role="mysqld">open-files-limit</option> may
- be necessary. Also see <xref linkend="linux-postinstallation"/>,
- for how to raise the operating system limit on how many
- handles can be used by MySQL.
+ be necessary. Also see
+ <xref linkend="linux-postinstallation"/>, for how to raise the
+ operating system limit on how many handles can be used by
+ MySQL.
</para>
</section>
@@ -2799,144 +2800,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- <para>
- Another way to solve this problem is by linking your program
- statically with the <literal>-static</literal> option, or by
- removing the dynamic MySQL libraries before linking your code.
- Before trying the second method, you should be sure that no
- other programs are using the dynamic libraries.
- </para>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-4.1/installing.xml
===================================================================
--- trunk/refman-4.1/installing.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/installing.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes
@@ -6649,7 +6649,7 @@
</para>
<para>
- See <xref linkend="link-errors"/>.
+ See <xref linkend="c-api-linking-problems"/>.
</para>
</section>
Modified: trunk/refman-4.1/renamed-nodes.txt
===================================================================
--- trunk/refman-4.1/renamed-nodes.txt 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-4.1/renamed-nodes.txt 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 600 bytes
@@ -49,6 +49,7 @@
installing-source source-installation 2011-10-22
installing-source-tree installing-development-tree 2011-11-28
internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
linux-post-install linux-postinstallation 2011-12-03
linux-rpm linux-installation-rpm 2011-10-22
log-files server-logs 2010-03-24
Modified: trunk/refman-5.0/apis-c.xml
===================================================================
--- trunk/refman-5.0/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes
@@ -14405,18 +14405,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -14451,6 +14466,121 @@
(<literal>libmysqlclient_r</literal>).
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>
+ Another way to solve this problem is by linking your program
+ statically with the <literal>-static</literal> option, or by
+ removing the dynamic MySQL libraries before linking your code.
+ Before trying the second method, you should be sure that no
+ other programs are using the dynamic libraries.
+ </para>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-5.0/errors-problems.xml
===================================================================
--- trunk/refman-5.0/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes
@@ -1393,9 +1393,10 @@
<para>
Increasing <option role="mysqld">open-files-limit</option> may
- be necessary. Also see <xref linkend="linux-postinstallation"/>,
- for how to raise the operating system limit on how many
- handles can be used by MySQL.
+ be necessary. Also see
+ <xref linkend="linux-postinstallation"/>, for how to raise the
+ operating system limit on how many handles can be used by
+ MySQL.
</para>
</section>
@@ -2715,144 +2716,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- <para>
- Another way to solve this problem is by linking your program
- statically with the <literal>-static</literal> option, or by
- removing the dynamic MySQL libraries before linking your code.
- Before trying the second method, you should be sure that no
- other programs are using the dynamic libraries.
- </para>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-5.0/installing.xml
===================================================================
--- trunk/refman-5.0/installing.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/installing.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes
@@ -3467,7 +3467,7 @@
</para>
<para>
- See <xref linkend="link-errors"/>.
+ See <xref linkend="c-api-linking-problems"/>.
</para>
</section>
Modified: trunk/refman-5.0/renamed-nodes.txt
===================================================================
--- trunk/refman-5.0/renamed-nodes.txt 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.0/renamed-nodes.txt 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 600 bytes
@@ -53,6 +53,7 @@
installing-source source-installation 2011-10-22
installing-source-tree installing-development-tree 2011-11-28
internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
linux-post-install linux-postinstallation 2011-12-03
linux-rpm linux-installation-rpm 2011-10-22
log-files server-logs 2010-03-24
Modified: trunk/refman-5.1/apis-c.xml
===================================================================
--- trunk/refman-5.1/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes
@@ -14481,18 +14481,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -14527,6 +14542,121 @@
(<literal>libmysqlclient_r</literal>).
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>
+ Another way to solve this problem is by linking your program
+ statically with the <literal>-static</literal> option, or by
+ removing the dynamic MySQL libraries before linking your code.
+ Before trying the second method, you should be sure that no
+ other programs are using the dynamic libraries.
+ </para>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-5.1/errors-problems.xml
===================================================================
--- trunk/refman-5.1/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 138; 5472 bytes
@@ -2717,144 +2717,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- <para>
- Another way to solve this problem is by linking your program
- statically with the <literal>-static</literal> option, or by
- removing the dynamic MySQL libraries before linking your code.
- Before trying the second method, you should be sure that no
- other programs are using the dynamic libraries.
- </para>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-5.1/renamed-nodes.txt
===================================================================
--- trunk/refman-5.1/renamed-nodes.txt 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.1/renamed-nodes.txt 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 594 bytes
@@ -56,6 +56,7 @@
installing-source source-installation 2011-10-22
installing-source-tree installing-development-tree 2011-11-28
internal-use optimization 2010-10-26
+link-errors c-api-linking-problems 2011-12-09
linux linux-installation 2010-10-20
linux-os linux-installation 2010-10-01
linux-post-install linux-installation 2010-10-01
Modified: trunk/refman-5.5/apis-c.xml
===================================================================
--- trunk/refman-5.5/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 126, Lines Deleted: 4; 5351 bytes
@@ -15499,18 +15499,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -15532,6 +15547,113 @@
compile/link line.
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-5.5/errors-problems.xml
===================================================================
--- trunk/refman-5.5/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 130; 5097 bytes
@@ -2702,136 +2702,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-5.5/renamed-nodes.txt
===================================================================
--- trunk/refman-5.5/renamed-nodes.txt 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.5/renamed-nodes.txt 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 0; 598 bytes
@@ -53,6 +53,7 @@
installing-i5os i5os-installation 2011-10-22
installing-source source-installation 2011-10-22
installing-source-tree installing-development-tree 2011-11-28
+link-errors c-api-linking-problems 2011-12-09
linux-alpha linux-installation 2011-10-23
linux-ia-64 linux-installation 2011-10-23
linux linux-installation 2011-10-23
Modified: trunk/refman-5.6/apis-c.xml
===================================================================
--- trunk/refman-5.6/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.6/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 126, Lines Deleted: 4; 5351 bytes
@@ -15459,18 +15459,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -15492,6 +15507,113 @@
compile/link line.
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-5.6/errors-problems.xml
===================================================================
--- trunk/refman-5.6/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-5.6/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 0, Lines Deleted: 130; 5097 bytes
@@ -2702,136 +2702,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-6.0/apis-c.xml
===================================================================
--- trunk/refman-6.0/apis-c.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/apis-c.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 134, Lines Deleted: 4; 5732 bytes
@@ -15284,18 +15284,33 @@
<section id="c-api-linking-problems">
- <title>Problems Linking with the C API</title>
+ <title>Problems Linking to the MySQL Client Library</title>
<indexterm>
+ <primary>C API</primary>
+ <secondary>linking problems</secondary>
+ </indexterm>
+
+ <indexterm>
<primary>linking</primary>
- <secondary>problems</secondary>
+ <secondary>errors</secondary>
</indexterm>
<indexterm>
- <primary>C API</primary>
- <secondary>linking problems</secondary>
+ <primary>errors</primary>
+ <secondary>linking</secondary>
</indexterm>
+ <indexterm>
+ <primary>problems</primary>
+ <secondary>linking</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>linking</primary>
+ <secondary>problems</secondary>
+ </indexterm>
+
<para>
When linking with the C API, the following errors may occur on
some systems:
@@ -15330,6 +15345,121 @@
(<literal>libmysqlclient_r</literal>).
</para>
+ <para>
+ When you are linking an application program to use the MySQL
+ client library, you might get undefined reference errors for
+ symbols that start with <literal>mysql_</literal>, such as those
+ shown here:
+ </para>
+
+<programlisting>
+/tmp/ccFKsdPa.o: In function `main':
+/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
+/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
+/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
+/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
+</programlisting>
+
+ <para>
+ You should be able to solve this problem by adding
+ <literal>-Ldir_path -lmysqlclient</literal> at the end of your
+ link command, where <literal>dir_path</literal> represents the
+ path name of the directory where the client library is located.
+ To determine the correct directory, try this command:
+ </para>
+
+<programlisting>
+shell> <userinput>mysql_config --libs</userinput>
+</programlisting>
+
+ <para>
+ The output from <command>mysql_config</command> might indicate
+ other libraries that should be specified on the link command as
+ well.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for the
+ <literal>uncompress</literal> or <literal>compress</literal>
+ function, add <literal>-lz</literal> to the end of your link
+ command and try again.
+ </para>
+
+ <para>
+ If you get <literal>undefined reference</literal> errors for a
+ function that should exist on your system, such as
+ <literal>connect</literal>, check the manual page for the
+ function in question to determine which libraries you should add
+ to the link command.
+ </para>
+
+ <para>
+ You might get <literal>undefined reference</literal> errors such
+ as the following for functions that don't exist on your system:
+ </para>
+
+<programlisting>
+mf_format.o(.text+0x201): undefined reference to `__lxstat'
+</programlisting>
+
+ <para>
+ This usually means that your MySQL client library was compiled
+ on a system that is not 100% compatible with yours. In this
+ case, you should download the latest MySQL source distribution
+ and compile MySQL yourself. See
+ <xref linkend="source-installation"/>.
+ </para>
+
+ <para>
+ You might get undefined reference errors at runtime when you try
+ to execute a MySQL program. If these errors specify symbols that
+ start with <literal>mysql_</literal> or indicate that the
+ <literal>mysqlclient</literal> library can't be found, it means
+ that your system can't find the shared
+ <filename>libmysqlclient.so</filename> library. The fix for this
+ is to tell your system to search for shared libraries where the
+ library is located. Use whichever of the following methods is
+ appropriate for your system:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY_PATH</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add the path to the directory where
+ <filename>libmysqlclient.so</filename> is located to the
+ <literal>LD_LIBRARY</literal> environment variable.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Copy <filename>libmysqlclient.so</filename> to some
+ directory that is searched by your system, such as
+ <filename>/lib</filename>, and update the shared library
+ information by executing <literal>ldconfig</literal>.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>
+ Another way to solve this problem is by linking your program
+ statically with the <literal>-static</literal> option, or by
+ removing the dynamic MySQL libraries before linking your code.
+ Before trying the second method, you should be sure that no
+ other programs are using the dynamic libraries.
+ </para>
+
</section>
<section id="threaded-clients">
Modified: trunk/refman-6.0/errors-problems.xml
===================================================================
--- trunk/refman-6.0/errors-problems.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/errors-problems.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 2, Lines Added: 4, Lines Deleted: 141; 5989 bytes
@@ -1394,9 +1394,10 @@
<para>
Increasing <option role="mysqld">open-files-limit</option> may
- be necessary. Also see <xref linkend="linux-postinstallation"/>,
- for how to raise the operating system limit on how many
- handles can be used by MySQL.
+ be necessary. Also see
+ <xref linkend="linux-postinstallation"/>, for how to raise the
+ operating system limit on how many handles can be used by
+ MySQL.
</para>
</section>
@@ -2706,144 +2707,6 @@
<title>Installation-Related Issues</title>
- <section id="link-errors">
-
- <title>Problems Linking to the MySQL Client Library</title>
-
- <indexterm>
- <primary>linking</primary>
- <secondary>errors</secondary>
- </indexterm>
-
- <indexterm>
- <primary>errors</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <indexterm>
- <primary>problems</primary>
- <secondary>linking</secondary>
- </indexterm>
-
- <para>
- When you are linking an application program to use the MySQL
- client library, you might get undefined reference errors for
- symbols that start with <literal>mysql_</literal>, such as
- those shown here:
- </para>
-
-<programlisting>
-/tmp/ccFKsdPa.o: In function `main':
-/tmp/ccFKsdPa.o(.text+0xb): undefined reference to `mysql_init'
-/tmp/ccFKsdPa.o(.text+0x31): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x57): undefined reference to `mysql_real_connect'
-/tmp/ccFKsdPa.o(.text+0x69): undefined reference to `mysql_error'
-/tmp/ccFKsdPa.o(.text+0x9a): undefined reference to `mysql_close'
-</programlisting>
-
- <para>
- You should be able to solve this problem by adding
- <literal>-Ldir_path -lmysqlclient</literal> at the end of your
- link command, where <literal>dir_path</literal> represents the
- path name of the directory where the client library is
- located. To determine the correct directory, try this command:
- </para>
-
-<programlisting>
-shell> <userinput>mysql_config --libs</userinput>
-</programlisting>
-
- <para>
- The output from <command>mysql_config</command> might indicate
- other libraries that should be specified on the link command
- as well.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for
- the <literal>uncompress</literal> or
- <literal>compress</literal> function, add
- <literal>-lz</literal> to the end of your link command and try
- again.
- </para>
-
- <para>
- If you get <literal>undefined reference</literal> errors for a
- function that should exist on your system, such as
- <literal>connect</literal>, check the manual page for the
- function in question to determine which libraries you should
- add to the link command.
- </para>
-
- <para>
- You might get <literal>undefined reference</literal> errors
- such as the following for functions that don't exist on your
- system:
- </para>
-
-<programlisting>
-mf_format.o(.text+0x201): undefined reference to `__lxstat'
-</programlisting>
-
- <para>
- This usually means that your MySQL client library was compiled
- on a system that is not 100% compatible with yours. In this
- case, you should download the latest MySQL source distribution
- and compile MySQL yourself. See
- <xref linkend="source-installation"/>.
- </para>
-
- <para>
- You might get undefined reference errors at runtime when you
- try to execute a MySQL program. If these errors specify
- symbols that start with <literal>mysql_</literal> or indicate
- that the <literal>mysqlclient</literal> library can't be
- found, it means that your system can't find the shared
- <filename>libmysqlclient.so</filename> library. The fix for
- this is to tell your system to search for shared libraries
- where the library is located. Use whichever of the following
- methods is appropriate for your system:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY_PATH</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add the path to the directory where
- <filename>libmysqlclient.so</filename> is located to the
- <literal>LD_LIBRARY</literal> environment variable.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Copy <filename>libmysqlclient.so</filename> to some
- directory that is searched by your system, such as
- <filename>/lib</filename>, and update the shared library
- information by executing <literal>ldconfig</literal>.
- </para>
- </listitem>
-
- </itemizedlist>
-
- <para>
- Another way to solve this problem is by linking your program
- statically with the <literal>-static</literal> option, or by
- removing the dynamic MySQL libraries before linking your code.
- Before trying the second method, you should be sure that no
- other programs are using the dynamic libraries.
- </para>
-
- </section>
-
<section id="file-permissions">
<title>Problems with File Permissions</title>
Modified: trunk/refman-6.0/installing.xml
===================================================================
--- trunk/refman-6.0/installing.xml 2010-12-09 15:37:26 UTC (rev 24349)
+++ trunk/refman-6.0/installing.xml 2010-12-09 15:57:23 UTC (rev 24350)
Changed blocks: 1, Lines Added: 1, Lines Deleted: 1; 438 bytes
@@ -2161,7 +2161,7 @@
</para>
<para>
- See <xref linkend="link-errors"/>.
+ See <xref linkend="c-api-linking-problems"/>.
</para>
</section>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r24350 - in trunk: . refman-4.1 refman-5.0 refman-5.1 refman-5.5 refman-5.6 refman-6.0 | paul.dubois | 9 Dec |
