Commit 11ef39ae authored by unknown's avatar unknown

Added the first of Melissa Spurr's (NuSphere's) index additions in.

Sucks when you have to do it the manual way.  bk diffs, patch, xemacs.


Docs/manual.texi:
  Added the first of Melissa Spurr's (NuSphere's) index additions in.
parent 32fc4416
...@@ -957,8 +957,8 @@ Comments on porting to other systems ...@@ -957,8 +957,8 @@ Comments on porting to other systems
@end detailmenu @end detailmenu
@end menu @end menu
@cindex Overview @cindex overview
@cindex General Information @cindex general information
@node Introduction, Questions, Top, Top @node Introduction, Questions, Top, Top
@chapter General Information About MySQL @chapter General Information About MySQL
...@@ -1043,6 +1043,11 @@ For source distributions, the @code{mysqlbug} script can be found in the ...@@ -1043,6 +1043,11 @@ For source distributions, the @code{mysqlbug} script can be found in the
@file{scripts} directory. For binary distributions, @code{mysqlbug} can @file{scripts} directory. For binary distributions, @code{mysqlbug} can
be found in the @file{bin} directory. be found in the @file{bin} directory.
@cindex errors,reporting
@cindex reporting, errors
@cindex mailing list address
@cindex mysqlbug script, location
If you have any suggestions concerning additions or corrections to this If you have any suggestions concerning additions or corrections to this
manual, please send them to the manual team at manual, please send them to the manual team at
(@email{docs@@mysql.com}). (@email{docs@@mysql.com}).
...@@ -1068,6 +1073,8 @@ such as @strong{MySQL}. Since computers are very good at handling large ...@@ -1068,6 +1073,8 @@ such as @strong{MySQL}. Since computers are very good at handling large
amounts of data, database management plays a central role in computing, amounts of data, database management plays a central role in computing,
as stand-alone utilities, or as parts of other applications. as stand-alone utilities, or as parts of other applications.
@cindex databases, defined
@item @strong{MySQL} is a relational database management system. @item @strong{MySQL} is a relational database management system.
A relational database stores data in separate tables rather than putting A relational database stores data in separate tables rather than putting
...@@ -1089,6 +1096,9 @@ feel uncomfortable with the GPL or need to embed @strong{MySQL} into a ...@@ -1089,6 +1096,9 @@ feel uncomfortable with the GPL or need to embed @strong{MySQL} into a
commercial application you can buy a commercially licensed version from commercial application you can buy a commercially licensed version from
us. us.
@cindex open source, defined
@cindex General Public License
@item Why use @strong{MySQL}? @item Why use @strong{MySQL}?
@strong{MySQL} is very fast, reliable, and easy to use. If that is what @strong{MySQL} is very fast, reliable, and easy to use. If that is what
...@@ -1118,11 +1128,14 @@ application/language already supports @strong{MySQL}. ...@@ -1118,11 +1128,14 @@ application/language already supports @strong{MySQL}.
@end table @end table
@cindex How to pronounce @strong{MySQL} @cindex pronounciation, @strong{MySQL}
@cindex @strong{MySQL}, how to pronounce @cindex @strong{MySQL}, pronouniation
@cindex goals of MySQL
The official way to pronounce @strong{MySQL} is ``My Ess Que Ell'' (not The official way to pronounce @strong{MySQL} is ``My Ess Que Ell'' (not
MY-SEQUEL). But we try to avoid correcting people who say MY-SEQUEL. MY-SEQUEL). But we try to avoid correcting people who say MY-SEQUEL.
@strong{MySQL} core values @strong{MySQL} core values
We want @strong{MySQL} to be: We want @strong{MySQL} to be:
...@@ -1159,7 +1172,6 @@ Are a virtual company, networking with others ...@@ -1159,7 +1172,6 @@ Are a virtual company, networking with others
Work against software patents Work against software patents
@end itemize @end itemize
@cindex Manual information
@node Manual-info, History, What-is, Introduction @node Manual-info, History, What-is, Introduction
@section About This Manual @section About This Manual
...@@ -1174,6 +1186,9 @@ The HTML version is produced automatically using a modified version of ...@@ -1174,6 +1186,9 @@ The HTML version is produced automatically using a modified version of
@code{makeinfo}. The Postscript version is produced using @code{texi2dvi} @code{makeinfo}. The Postscript version is produced using @code{texi2dvi}
and @code{dvips}. The PDF version is produced with @code{pdftex}. and @code{dvips}. The PDF version is produced with @code{pdftex}.
@cindex manual, available formats
@cindex Texinfo
This manual is written and maintained by David Axmark, Michael (Monty) This manual is written and maintained by David Axmark, Michael (Monty)
Widenius, Jeremy Cole, and Paul DuBois. For other contributors, Widenius, Jeremy Cole, and Paul DuBois. For other contributors,
see @ref{Credits}. see @ref{Credits}.
...@@ -1183,6 +1198,9 @@ see @ref{Credits}. ...@@ -1183,6 +1198,9 @@ see @ref{Credits}.
This manual uses certain typographical conventions: This manual uses certain typographical conventions:
@cindex manual, typographical conventions
@cindex typographical conventions
@table @asis @table @asis
@item @code{constant} @item @code{constant}
Constant-width font is used for command names and options; SQL statements; Constant-width font is used for command names and options; SQL statements;
...@@ -1229,6 +1247,9 @@ looks like this in Bourne shell syntax: ...@@ -1229,6 +1247,9 @@ looks like this in Bourne shell syntax:
shell> VARNAME=value some_command shell> VARNAME=value some_command
@end example @end example
@cindex shell syntax
@cindex command syntax
For @code{csh}, you would execute the sequence like this: For @code{csh}, you would execute the sequence like this:
@example @example
...@@ -1296,6 +1317,8 @@ alternatives are listed within braces (@samp{@{} and @samp{@}}): ...@@ -1296,6 +1317,8 @@ alternatives are listed within braces (@samp{@{} and @samp{@}}):
@end example @end example
@cindex @strong{MySQL} version @cindex @strong{MySQL} version
@cindex @strong{MySQL} history
@cindex history of @strong{MySQL}
@node History, MySQL-Books, Manual-info, Introduction @node History, MySQL-Books, Manual-info, Introduction
@section History of MySQL @section History of MySQL
...@@ -1315,6 +1338,9 @@ still a mystery, even for us. ...@@ -1315,6 +1338,9 @@ still a mystery, even for us.
@node MySQL-Books, Features, History, Introduction @node MySQL-Books, Features, History, Introduction
@section Books About MySQL @section Books About MySQL
@cindex books, about @strong{MySQL}
@cindex manuals, about @strong{MySQL}
While this manual is still the right place for up to date techical While this manual is still the right place for up to date techical
information, its primary goal is to contain everything there is to know information, its primary goal is to contain everything there is to know
about @strong{MySQL}. It is sometimes nice to have a bound book to read about @strong{MySQL}. It is sometimes nice to have a bound book to read
...@@ -1471,6 +1497,9 @@ No description available. ...@@ -1471,6 +1497,9 @@ No description available.
@node Features, Stability, MySQL-Books, Introduction @node Features, Stability, MySQL-Books, Introduction
@section The Main Features of MySQL @section The Main Features of MySQL
@cindex main features of @strong {MySQL}
@cindex features of @strong {MySQL}
The following list describes some of the important characteristics The following list describes some of the important characteristics
of @strong{MySQL}: of @strong{MySQL}:
...@@ -1658,6 +1687,8 @@ which are things that are design-related. @xref{Bugs}. ...@@ -1658,6 +1687,8 @@ which are things that are design-related. @xref{Bugs}.
modules. These modules are listed below with an indication of how modules. These modules are listed below with an indication of how
well-tested each of them is: well-tested each of them is:
@cindex modules, list of
@table @strong @table @strong
@item The ISAM table handler --- Stable @item The ISAM table handler --- Stable
This manages storage and retrieval of all data in @strong{MySQL} Version 3.22 This manages storage and retrieval of all data in @strong{MySQL} Version 3.22
...@@ -1668,6 +1699,12 @@ that is unlikely to destroy any data beyond rescue, because all data are ...@@ -1668,6 +1699,12 @@ that is unlikely to destroy any data beyond rescue, because all data are
flushed to disk between each query. There hasn't been a single bug flushed to disk between each query. There hasn't been a single bug
report about lost data because of bugs in @strong{MySQL}. report about lost data because of bugs in @strong{MySQL}.
@cindex ISAM table handler
@cindex storing data
@cindex retrieving data
@cindex data, ISAM table handler
@item The MyISAM table handler --- Gamma @item The MyISAM table handler --- Gamma
This is new in @strong{MySQL} Version 3.23. It's largely based on the ISAM This is new in @strong{MySQL} Version 3.23. It's largely based on the ISAM
table code but has a lot of new and very useful features. table code but has a lot of new and very useful features.
...@@ -1894,7 +1931,12 @@ http://www.geocities.com/SiliconValley/Vista/2207/sql1.html. ...@@ -1894,7 +1931,12 @@ http://www.geocities.com/SiliconValley/Vista/2207/sql1.html.
Apart from the following links, you can find and download a lot of Apart from the following links, you can find and download a lot of
@strong{MySQL} programs, tools and APIs from the @strong{MySQL} programs, tools and APIs from the
@uref{http://www.mysql.com/Contrib/, Contrib directory}. @uref{http://www.mysql.com/Contrib/, Contrib directory}.
@cindex Contrib directory
@cindex URLs to @strong{MySQL} information
@cindex related information URLs
@strong{MySQL}
@subheading Tutorials and Manuals @subheading Tutorials and Manuals
@itemize @bullet @itemize @bullet
...@@ -2220,6 +2262,7 @@ Client libraries for the Macintosh. ...@@ -2220,6 +2262,7 @@ Client libraries for the Macintosh.
SCMDB - an add-on for SCM that ports the mysql C library to scheme (SCM). SCMDB - an add-on for SCM that ports the mysql C library to scheme (SCM).
With this library scheme developers can make connections to a mySQL With this library scheme developers can make connections to a mySQL
database and use embedded SQL in their programs. database and use embedded SQL in their programs.
@cindex SCMDB
@end itemize @end itemize
@subheading Other @strong{MySQL}-related Links @subheading Other @strong{MySQL}-related Links
...@@ -2407,7 +2450,7 @@ There are also many Web pages that use ...@@ -2407,7 +2450,7 @@ There are also many Web pages that use
@strong{MySQL} logo somewhere to be added (It is okay to have it on a @strong{MySQL} logo somewhere to be added (It is okay to have it on a
``used tools'' page or something similar.) ``used tools'' page or something similar.)
@cindex Reporting errors @cindex reporting errors
@cindex @strong{MySQL} mailing lists @cindex @strong{MySQL} mailing lists
@node Questions, Licensing and Support, Introduction, Top @node Questions, Licensing and Support, Introduction, Top
@chapter MySQL Mailing Lists @chapter MySQL Mailing Lists
...@@ -2422,6 +2465,9 @@ There are also many Web pages that use ...@@ -2422,6 +2465,9 @@ There are also many Web pages that use
@node Mailing-list, Asking questions, Questions, Questions @node Mailing-list, Asking questions, Questions, Questions
@section The MySQL Mailing Lists @section The MySQL Mailing Lists
@cindex mailing lists
@cindex email lists
To subscribe to the main @strong{MySQL} mailing list, send a message to the To subscribe to the main @strong{MySQL} mailing list, send a message to the
electronic mail address @email{mysql-subscribe@@lists.mysql.com}. electronic mail address @email{mysql-subscribe@@lists.mysql.com}.
...@@ -2543,7 +2589,9 @@ unsubscribe from the @code{myodbc} list, send a message to ...@@ -2543,7 +2589,9 @@ unsubscribe from the @code{myodbc} list, send a message to
@email{myodbc-subscribe@@lists.mysql.com} or @email{myodbc-subscribe@@lists.mysql.com} or
@email{myodbc-unsubscribe@@lists.mysql.com}. @email{myodbc-unsubscribe@@lists.mysql.com}.
@cindex Net etiquette @cindex net etiquette
@cindex mailing lists, archive location
@cindex searching, @strong{MySQL} webpages
@node Asking questions, Bug reports, Mailing-list, Questions @node Asking questions, Bug reports, Mailing-list, Questions
@section Asking Questions or Reporting Bugs @section Asking Questions or Reporting Bugs
...@@ -2574,8 +2622,13 @@ local @strong{MySQL} expert. If you still can't find an answer to your ...@@ -2574,8 +2622,13 @@ local @strong{MySQL} expert. If you still can't find an answer to your
question, go ahead and read the next section about how to send mail to question, go ahead and read the next section about how to send mail to
@email{mysql@@lists.mysql.com}. @email{mysql@@lists.mysql.com}.
@cindex Bug reports @cindex bugs, reporting
@cindex Reporting bugs @cindex reporting, bugs
@cindex problems, reporting
@cindex errors, reporting
@cindex mysqlbug script
@cindex creating, bug reports
@cindex scripts, mysqlbug
@node Bug reports, Answering questions, Asking questions, Questions @node Bug reports, Answering questions, Asking questions, Questions
@section How to Report Bugs or Problems @section How to Report Bugs or Problems
...@@ -2666,6 +2719,7 @@ for output that would exceed the available width for such a display ...@@ -2666,6 +2719,7 @@ for output that would exceed the available width for such a display
example below). example below).
Please include the following information in your report: Please include the following information in your report:
@cindex bug reports, criteria for
@itemize @bullet @itemize @bullet
@item @item
...@@ -2852,6 +2906,10 @@ If you are a support customer, please cross-post the bug report to ...@@ -2852,6 +2906,10 @@ If you are a support customer, please cross-post the bug report to
@email{mysql-support@@mysql.com} for higher priority treatment, as well as to @email{mysql-support@@mysql.com} for higher priority treatment, as well as to
the appropriate mailing list to see if someone else has experienced (and the appropriate mailing list to see if someone else has experienced (and
perhaps solved) the problem. perhaps solved) the problem.
@cindex technical support, mailing address
@cindex support, mailing address
@cindex customer support, mailing address
@cindex mailing address, customer support
For information on reporting bugs in @strong{MyODBC}, see @ref{ODBC For information on reporting bugs in @strong{MyODBC}, see @ref{ODBC
Problems}. Problems}.
...@@ -2863,7 +2921,10 @@ it is considered good etiquette to summarize the answers and send the ...@@ -2863,7 +2921,10 @@ it is considered good etiquette to summarize the answers and send the
summary to the mailing list so that others may have the benefit of summary to the mailing list so that others may have the benefit of
responses you received that helped you solve your problem! responses you received that helped you solve your problem!
@cindex Net etiquette @cindex net etiquette
@cindex questions, answering
@cindex answering questions, etiquette
@cindex mailing lists, guidelines
@node Answering questions, , Bug reports, Questions @node Answering questions, , Bug reports, Questions
@section Guidelines for Answering Question on the Mailing List @section Guidelines for Answering Question on the Mailing List
...@@ -2879,8 +2940,8 @@ obliged to quote the entire original message. ...@@ -2879,8 +2940,8 @@ obliged to quote the entire original message.
Please don't post mail messages from your browser with HTML mode turned on! Please don't post mail messages from your browser with HTML mode turned on!
Many users don't read mail with a browser! Many users don't read mail with a browser!
@cindex Licensing terms @cindex licensing terms
@cindex Support terms @cindex support terms
@node Licensing and Support, Installing, Questions, Top @node Licensing and Support, Installing, Questions, Top
@chapter MySQL Licensing and Support @chapter MySQL Licensing and Support
...@@ -2989,7 +3050,7 @@ is to use the license form on @strong{MySQL}'s secure server at ...@@ -2989,7 +3050,7 @@ is to use the license form on @strong{MySQL}'s secure server at
https://order.mysql.com/license.htmy. Other forms of payment are https://order.mysql.com/license.htmy. Other forms of payment are
discussed in @ref{Payment information}. discussed in @ref{Payment information}.
@cindex Copyright @cindex copyrights
@node Copyright, Licensing examples, Licensing policy, Licensing and Support @node Copyright, Licensing examples, Licensing policy, Licensing and Support
@section Copyrights Used by MySQL @section Copyrights Used by MySQL
...@@ -3024,6 +3085,8 @@ One goal is that the SQL client library should be free enough that it is ...@@ -3024,6 +3085,8 @@ One goal is that the SQL client library should be free enough that it is
possible to add @strong{MySQL} support into commercial products possible to add @strong{MySQL} support into commercial products
without a license. For this reason, we chose the LGPL license for the without a license. For this reason, we chose the LGPL license for the
client code. client code.
@cindex licensing, free
@cindex free licensing
This means that you can use @strong{MySQL} for free with any program that uses This means that you can use @strong{MySQL} for free with any program that uses
any of the free software licenses. @strong{MySQL} is also free for any end any of the free software licenses. @strong{MySQL} is also free for any end
...@@ -3048,6 +3111,10 @@ license. See the documentation for that version for more information. ...@@ -3048,6 +3111,10 @@ license. See the documentation for that version for more information.
* Web server:: Running a web server using @strong{MySQL}. * Web server:: Running a web server using @strong{MySQL}.
@end menu @end menu
@cindex licensing, examples
@cindex selling products
@cindex products, selling
This section describes some situations illustrating whether or not you This section describes some situations illustrating whether or not you
must license the @strong{MySQL} server. Generally these examples must license the @strong{MySQL} server. Generally these examples
involve providing @strong{MySQL} as an integral part of a product. involve providing @strong{MySQL} as an integral part of a product.
...@@ -3103,6 +3170,11 @@ don't need a license. ...@@ -3103,6 +3170,11 @@ don't need a license.
@node ISP, Web server, Products that use MySQL, Licensing examples @node ISP, Web server, Products that use MySQL, Licensing examples
@subsection ISP @strong{MySQL} Services @subsection ISP @strong{MySQL} Services
@cindex ISP services
@cindex services, ISP
@cindex services, web
@cindex Internet Service Providers
Internet Service Providers (ISPs) often host @strong{MySQL} servers for Internet Service Providers (ISPs) often host @strong{MySQL} servers for
their customers. With the GPL license this does not require a license. their customers. With the GPL license this does not require a license.
...@@ -3133,9 +3205,10 @@ version yourself. However, in this case we would like you to purchase ...@@ -3133,9 +3205,10 @@ version yourself. However, in this case we would like you to purchase
@strong{MySQL} support, because @strong{MySQL} is helping your @strong{MySQL} support, because @strong{MySQL} is helping your
enterprise. enterprise.
@cindex Costs, licensing and support @cindex costs, licensing and support
@cindex Licensing costs @cindex licensing costs
@cindex Support costs @cindex support costs
@cindex prices, licensing and support
@node Cost, Support, Licensing examples, Licensing and Support @node Cost, Support, Licensing examples, Licensing and Support
@section @strong{MySQL} Licensing and Support Costs @section @strong{MySQL} Licensing and Support Costs
...@@ -3208,7 +3281,7 @@ You may upgrade from any ...@@ -3208,7 +3281,7 @@ You may upgrade from any
lower level of support to a higher level of support for the difference lower level of support to a higher level of support for the difference
in price between the two support levels. in price between the two support levels.
@cindex Payment information @cindex payment information
@node Payment information, Contact information, Cost, Cost @node Payment information, Contact information, Cost, Cost
@subsection Payment information @subsection Payment information
...@@ -3254,7 +3327,12 @@ us'' in the comment field. You can also mail a message to ...@@ -3254,7 +3327,12 @@ us'' in the comment field. You can also mail a message to
@email{sales@@mysql.com} (@strong{not} @code{mysql@@lists.mysql.com}!) @email{sales@@mysql.com} (@strong{not} @code{mysql@@lists.mysql.com}!)
with your company information and ask us to bill you. with your company information and ask us to bill you.
@cindex Contact information @cindex contact information
@cindex licensing, contact information
@cindex partnering, with @strong{MySQL}
@cindex employment with @strong{MySQL}
@cindex jobs at @strong{MySQL}
@node Contact information, , Payment information, Cost @node Contact information, , Payment information, Cost
@subsection Contact Information @subsection Contact Information
...@@ -3285,8 +3363,9 @@ you to @uref{https://order.mysql.com/, order} one of our ...@@ -3285,8 +3363,9 @@ you to @uref{https://order.mysql.com/, order} one of our
For questions or comments about the workings or content of this Web site, For questions or comments about the workings or content of this Web site,
please send e-mail to @email{webmaster@@mysql.com}. please send e-mail to @email{webmaster@@mysql.com}.
@cindex Support, types @cindex support, types
@cindex Types of support @cindex types, of support
@cindex commercial support, types
@node Support, , Cost, Licensing and Support @node Support, , Cost, Licensing and Support
@section Types of Commercial Support @section Types of Commercial Support
...@@ -3486,6 +3565,7 @@ encounter per year, but we are always very flexible towards our customers! ...@@ -3486,6 +3565,7 @@ encounter per year, but we are always very flexible towards our customers!
@node Installing, Compatibility, Licensing and Support, Top @node Installing, Compatibility, Licensing and Support, Top
@chapter Installing MySQL @chapter Installing MySQL
@cindex installing, overview
@menu @menu
* Getting MySQL:: How to get @strong{MySQL} * Getting MySQL:: How to get @strong{MySQL}
...@@ -3533,10 +3613,12 @@ procedures apply whether you install @strong{MySQL} using a binary or ...@@ -3533,10 +3613,12 @@ procedures apply whether you install @strong{MySQL} using a binary or
source distribution. source distribution.
@end itemize @end itemize
@cindex Downloading @cindex downloading
@cindex @strong{MySQL} version @cindex @strong{MySQL} version
@cindex Version, latest @cindex version, latest
@cindex Getting @strong{MySQL} @cindex getting @strong{MySQL}
@cindex mirror sites
@cindex URLS for downloading @strong{MySQL}
@node Getting MySQL, Which OS, Installing, Installing @node Getting MySQL, Which OS, Installing, Installing
@section How to Get MySQL @section How to Get MySQL
...@@ -4243,9 +4325,9 @@ Win95, Win98, NT, and Win2000. @xref{Windows}. ...@@ -4243,9 +4325,9 @@ Win95, Win98, NT, and Win2000. @xref{Windows}.
@cindex @strong{MySQL} binary distribution @cindex @strong{MySQL} binary distribution
@cindex @strong{MySQL} source distribution @cindex @strong{MySQL} source distribution
@cindex Release numbers @cindex release numbers
@cindex Version, choosing @cindex version, choosing
@cindex Choosing version @cindex choosing, a @strong{MySQL} version
@node Which version, Many versions, Which OS, Installing @node Which version, Many versions, Which OS, Installing
@section Which MySQL Version to Use @section Which MySQL Version to Use
...@@ -4288,6 +4370,9 @@ always the ultimate manual. Source distributions also contain more ...@@ -4288,6 +4370,9 @@ always the ultimate manual. Source distributions also contain more
tests and examples than binary distributions. tests and examples than binary distributions.
@end itemize @end itemize
@cindex naming, releases of @strong{MySQL}
@cindex releases, naming scheme
The @strong{MySQL} naming scheme uses release numbers that consist of three The @strong{MySQL} naming scheme uses release numbers that consist of three
numbers and a suffix. For example, a release name like numbers and a suffix. For example, a release name like
@code{mysql-3.21.17-beta} is interpreted like this: @code{mysql-3.21.17-beta} is interpreted like this:
...@@ -4348,6 +4433,8 @@ All versions of @strong{MySQL} are run through our standard tests and ...@@ -4348,6 +4433,8 @@ All versions of @strong{MySQL} are run through our standard tests and
benchmarks to ensure that they are relatively safe to use. Because the benchmarks to ensure that they are relatively safe to use. Because the
standard tests are extended over time to check for all previously found bugs, standard tests are extended over time to check for all previously found bugs,
the test suite keeps getting better. the test suite keeps getting better.
@cindex releases, testing
@cindex testing, of @strong{MySQL} releases
Note that all releases have been tested at least with: Note that all releases have been tested at least with:
...@@ -4432,6 +4519,11 @@ already working.'' ...@@ -4432,6 +4519,11 @@ already working.''
@node Installation layouts, Installing binary, Many versions, Installing @node Installation layouts, Installing binary, Many versions, Installing
@section Installation Layouts @section Installation Layouts
@cindex installation layouts
@cindex layout, of installation
@cindex directory structure, default
@cindex default installation location
This section describes the default layout of the directories created by This section describes the default layout of the directories created by
installing binary and source distributions. installing binary and source distributions.
...@@ -4509,7 +4601,7 @@ A reasonable @code{tar} to unpack the distribution. GNU @code{tar} is ...@@ -4509,7 +4601,7 @@ A reasonable @code{tar} to unpack the distribution. GNU @code{tar} is
known to work. Sun @code{tar} is known to have problems. known to work. Sun @code{tar} is known to have problems.
@end itemize @end itemize
@cindex RPM @cindex RPM, defined
@cindex RedHat Package Manager @cindex RedHat Package Manager
An alternative installation method under Linux is to use RPM (RedHat Package An alternative installation method under Linux is to use RPM (RedHat Package
Manager) distributions. @xref{Linux-RPM}. Manager) distributions. @xref{Linux-RPM}.
...@@ -4522,6 +4614,7 @@ solve your problem. By not using @code{mysqlbug}, you lessen the likelihood ...@@ -4522,6 +4614,7 @@ solve your problem. By not using @code{mysqlbug}, you lessen the likelihood
of getting a solution to your problem! You will find @code{mysqlbug} in the of getting a solution to your problem! You will find @code{mysqlbug} in the
@file{bin} directory after you unpack the distribution. @xref{Bug reports}. @file{bin} directory after you unpack the distribution. @xref{Bug reports}.
@cindex commands, for binary distribution
The basic commands you must execute to install and use a @strong{MySQL} The basic commands you must execute to install and use a @strong{MySQL}
binary distribution are: binary distribution are:
...@@ -4538,6 +4631,10 @@ shell> chgrp -R mysql /usr/local/mysql ...@@ -4538,6 +4631,10 @@ shell> chgrp -R mysql /usr/local/mysql
shell> bin/safe_mysqld --user=mysql & shell> bin/safe_mysqld --user=mysql &
@end example @end example
@cindex adding, new users
@cindex new users, adding
@cindex users, adding
You can add new users using the @code{bin/mysql_setpermission} script if You can add new users using the @code{bin/mysql_setpermission} script if
you install the @code{DBI} and @code{Msql-Mysql-modules} Perl modules. you install the @code{DBI} and @code{Msql-Mysql-modules} Perl modules.
...@@ -4685,7 +4782,7 @@ shell> bin/safe_mysqld --user=mysql & ...@@ -4685,7 +4782,7 @@ shell> bin/safe_mysqld --user=mysql &
@xref{Post-installation}. @xref{Post-installation}.
@cindex RPM @cindex RPM file
@cindex RedHat Package Manager @cindex RedHat Package Manager
@c This node name is special @c This node name is special
@node Linux-RPM, Building clients, Installing binary, Installing binary @node Linux-RPM, Building clients, Installing binary, Installing binary
...@@ -4761,8 +4858,10 @@ If something goes wrong, you can find more information in the binary ...@@ -4761,8 +4858,10 @@ If something goes wrong, you can find more information in the binary
installation chapter. @xref{Installing binary}. installation chapter. @xref{Installing binary}.
@cindex Client programs, building @cindex client programs, building
@cindex Linking @cindex linking
@cindex building, client programs
@cindex programs, client
@node Building clients, Binary install system issues, Linux-RPM, Installing binary @node Building clients, Binary install system issues, Linux-RPM, Installing binary
@subsection Building Client Programs @subsection Building Client Programs
...@@ -5241,6 +5340,8 @@ other than the default location (normally in the directory @file{/tmp} or ...@@ -5241,6 +5340,8 @@ other than the default location (normally in the directory @file{/tmp} or
shell> ./configure --with-unix-socket-path=/usr/local/mysql/tmp/mysql.sock shell> ./configure --with-unix-socket-path=/usr/local/mysql/tmp/mysql.sock
@end example @end example
Note that the given file must be an absolute pathname! Note that the given file must be an absolute pathname!
@cindex socket location
@item @item
If you want to compile statically linked programs (for example, to make a If you want to compile statically linked programs (for example, to make a
...@@ -5251,6 +5352,7 @@ RedHat distributions), run @code{configure} like this: ...@@ -5251,6 +5352,7 @@ RedHat distributions), run @code{configure} like this:
shell> ./configure --with-client-ldflags=-all-static \ shell> ./configure --with-client-ldflags=-all-static \
--with-mysqld-ldflags=-all-static --with-mysqld-ldflags=-all-static
@end example @end example
@cindex statistically-linked programs
@item @item
If you are using @code{gcc} and don't have @code{libg++} or @code{libstdc++} If you are using @code{gcc} and don't have @code{libg++} or @code{libstdc++}
...@@ -5264,6 +5366,9 @@ compiler: ...@@ -5264,6 +5366,9 @@ compiler:
@example @example
shell> CC=gcc CXX=gcc ./configure shell> CC=gcc CXX=gcc ./configure
@end example @end example
@cindex gcc
@cindex C++ complier, gcc
@cindex compiler, C++ gcc
When you use @code{gcc} as your C++ compiler, it will not attempt to link in When you use @code{gcc} as your C++ compiler, it will not attempt to link in
@code{libg++} or @code{libstdc++}. @code{libg++} or @code{libstdc++}.
...@@ -5287,6 +5392,9 @@ non-@code{NULL} value. To suppress use of default values, run ...@@ -5287,6 +5392,9 @@ non-@code{NULL} value. To suppress use of default values, run
@example @example
shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS ./configure shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS ./configure
@end example @end example
@cindex default values, suppression
@cindex suppression, default values
@item @item
By default, @strong{MySQL} uses the ISO-8859-1 (Latin1) character set. To By default, @strong{MySQL} uses the ISO-8859-1 (Latin1) character set. To
...@@ -5301,6 +5409,8 @@ shell> ./configure --with-charset=CHARSET ...@@ -5301,6 +5409,8 @@ shell> ./configure --with-charset=CHARSET
@code{latin2}, @code{sjis}, @code{swe7}, @code{tis620}, @code{ujis}, @code{latin2}, @code{sjis}, @code{swe7}, @code{tis620}, @code{ujis},
@code{usa7}, or @code{win1251ukr}. @code{usa7}, or @code{win1251ukr}.
@xref{Character sets}. @xref{Character sets}.
@cindex character set
@findex CHARSET
If you want to convert characters between the server and the client, If you want to convert characters between the server and the client,
you should take a look at the @code{SET OPTION CHARACTER SET} command. you should take a look at the @code{SET OPTION CHARACTER SET} command.
...@@ -5728,6 +5838,9 @@ Look under the heading ...@@ -5728,6 +5838,9 @@ Look under the heading
@node ActiveState Perl, Windows Perl, Perl installation, Perl support @node ActiveState Perl, Windows Perl, Perl installation, Perl support
@subsection Installing ActiveState Perl on Windows @subsection Installing ActiveState Perl on Windows
@cindex installing, Perl on Windows
@cindex Perl, installing on Windows
@cindex ActiveState Perl
To install the @strong{MySQL} @code{DBD} module with ActiveState Perl on To install the @strong{MySQL} @code{DBD} module with ActiveState Perl on
Windows, you should do the following: Windows, you should do the following:
...@@ -7171,6 +7284,7 @@ If you want to use @code{gcc}, you must use @code{gcc} 2.95.2 or newer. ...@@ -7171,6 +7284,7 @@ If you want to use @code{gcc}, you must use @code{gcc} 2.95.2 or newer.
@node IBM-AIX, HP-UX 10.20, SCO Unixware, Source install system issues @node IBM-AIX, HP-UX 10.20, SCO Unixware, Source install system issues
@subsection IBM-AIX notes @subsection IBM-AIX notes
@cindex problems, installing on IBM-AIX
Automatic detection of @code{xlC} is missing from Autoconf, so a Automatic detection of @code{xlC} is missing from Autoconf, so a
@code{configure} command something like this is needed when compiling @code{configure} command something like this is needed when compiling
...@@ -7577,6 +7691,9 @@ The last version gives you a debug trace in @file{C:\mysqld.trace}. ...@@ -7577,6 +7691,9 @@ The last version gives you a debug trace in @file{C:\mysqld.trace}.
@node Windows running, Windows and SSH, NT start, Windows @node Windows running, Windows and SSH, NT start, Windows
@subsection Running MySQL on Windows @subsection Running MySQL on Windows
@cindex TCP/IP
@cindex named pipes
@strong{MySQL} supports TCP/IP on all Windows platforms and named pipes on NT. @strong{MySQL} supports TCP/IP on all Windows platforms and named pipes on NT.
The default is to use named pipes for local connections on NT and TCP/IP for The default is to use named pipes for local connections on NT and TCP/IP for
all other cases if the client has TCP/IP installed. The host name specifies all other cases if the client has TCP/IP installed. The host name specifies
...@@ -7693,8 +7810,9 @@ having problems with SSH conflicting with my Win95 network and Wingate - ...@@ -7693,8 +7810,9 @@ having problems with SSH conflicting with my Win95 network and Wingate -
but that'll be the topic of a posting on another software company's but that'll be the topic of a posting on another software company's
usegroup! usegroup!
@findex Symbolic links @cindex symbolic links
@findex Using multiple disks to start data @cindex using multiple disks to start data
@cindex disks, splitting data across
@node Windows symbolic links, Windows compiling, Windows and SSH, Windows @node Windows symbolic links, Windows compiling, Windows and SSH, Windows
@subsection Splitting Data Across Different Disks Under Windows @subsection Splitting Data Across Different Disks Under Windows
...@@ -7857,6 +7975,8 @@ following information: ...@@ -7857,6 +7975,8 @@ following information:
Here are some open issues for anyone who might want to help us with the Windows Here are some open issues for anyone who might want to help us with the Windows
release: release:
@cindex Windows, open issues
@itemize @bullet @itemize @bullet
@item @item
Make a single-user @code{MYSQL.DLL} server. This should include everything in Make a single-user @code{MYSQL.DLL} server. This should include everything in
...@@ -8058,6 +8178,8 @@ starts up and shuts down. ...@@ -8058,6 +8178,8 @@ starts up and shuts down.
Normally you install the grant tables and start the server like this Normally you install the grant tables and start the server like this
for installation from a source distribution: for installation from a source distribution:
@cindex starting, the server
@cindex server, starting
@example @example
shell> ./scripts/mysql_install_db shell> ./scripts/mysql_install_db
...@@ -8077,6 +8199,7 @@ Testing is most easily done from the top-level directory of the @strong{MySQL} ...@@ -8077,6 +8199,7 @@ Testing is most easily done from the top-level directory of the @strong{MySQL}
distribution. For a binary distribution, this is your installation directory distribution. For a binary distribution, this is your installation directory
(typically something like @file{/usr/local/mysql}). For a source (typically something like @file{/usr/local/mysql}). For a source
distribution, this is the main directory of your @strong{MySQL} source tree. distribution, this is the main directory of your @strong{MySQL} source tree.
@cindex testing, the server
In the commands shown below in this section and in the following In the commands shown below in this section and in the following
subsections, @code{BINDIR} is the path to the location in which programs subsections, @code{BINDIR} is the path to the location in which programs
...@@ -8091,6 +8214,7 @@ installed. For a binary distribution, this is the same as ...@@ -8091,6 +8214,7 @@ installed. For a binary distribution, this is the same as
@file{/usr/local/libexec}. @file{/usr/local/libexec}.
Testing is described in detail below: Testing is described in detail below:
@cindex testing, installation
@enumerate @enumerate
@item @item
...@@ -8206,6 +8330,8 @@ invoke it with the @code{--help} option. ...@@ -8206,6 +8330,8 @@ invoke it with the @code{--help} option.
@item @item
Verify that you can shut down the server: Verify that you can shut down the server:
@cindex server, shutdown
@cindex shutting down, the server
@example @example
shell> BINDIR/mysqladmin -u root shutdown shell> BINDIR/mysqladmin -u root shutdown
...@@ -8215,6 +8341,9 @@ shell> BINDIR/mysqladmin -u root shutdown ...@@ -8215,6 +8341,9 @@ shell> BINDIR/mysqladmin -u root shutdown
Verify that you can restart the server. Do this using @code{safe_mysqld} or Verify that you can restart the server. Do this using @code{safe_mysqld} or
by invoking @code{mysqld} directly. For example: by invoking @code{mysqld} directly. For example:
@cindex server, restart
@cindex restarting, the server
@example @example
shell> BINDIR/safe_mysqld --log & shell> BINDIR/safe_mysqld --log &
@end example @end example
...@@ -8288,6 +8417,9 @@ The expected results are shown in the @file{./tests/auto_increment.res} file. ...@@ -8288,6 +8417,9 @@ The expected results are shown in the @file{./tests/auto_increment.res} file.
@node mysql_install_db, Starting server, Post-installation, Post-installation @node mysql_install_db, Starting server, Post-installation, Post-installation
@subsection Problems running @code{mysql_install_db} @subsection Problems running @code{mysql_install_db}
@cindex mysql_install_db script
@cindex scripts, mysql_install_db
The purpose of the @code{mysql_install_db} script is to generate new The purpose of the @code{mysql_install_db} script is to generate new
@strong{MySQL} privilege tables. It will not affect any other data! @strong{MySQL} privilege tables. It will not affect any other data!
...@@ -8362,6 +8494,9 @@ with different sockets and ports. For example, it could invoke ...@@ -8362,6 +8494,9 @@ with different sockets and ports. For example, it could invoke
and @code{--basedir} options for each invocation. and @code{--basedir} options for each invocation.
@item You don't have write access to @file{/tmp} @item You don't have write access to @file{/tmp}
@cindex write access, tmp
@cindex temporary file, write access
@cindex files, tmp
If you don't have write access to create a socket file at the default place If you don't have write access to create a socket file at the default place
(in @file{/tmp}) or permission to create temporary files in @file{/tmp,} (in @file{/tmp}) or permission to create temporary files in @file{/tmp,}
...@@ -8416,6 +8551,8 @@ reload the grant tables. ...@@ -8416,6 +8551,8 @@ reload the grant tables.
@node Starting server, Automatic start, mysql_install_db, Post-installation @node Starting server, Automatic start, mysql_install_db, Post-installation
@subsection Problems starting the MySQL server @subsection Problems starting the MySQL server
@cindex server, starting problems
@cindex problems, starting the server
Generally, you start the @code{mysqld} server in one of three ways: Generally, you start the @code{mysqld} server in one of three ways:
...@@ -8598,6 +8735,9 @@ problems. @xref{Windows}. ...@@ -8598,6 +8735,9 @@ problems. @xref{Windows}.
@node Automatic start, Command-line options, Starting server, Post-installation @node Automatic start, Command-line options, Starting server, Post-installation
@subsection Starting and stopping MySQL automatically @subsection Starting and stopping MySQL automatically
@cindex starting, the server automatically
@cindex stopping, the server
@cindex server, starting and stopping
The @code{mysql.server} script can be used to start or stop the server, The @code{mysql.server} script can be used to start or stop the server,
by invoking it with @code{start} or @code{stop} arguments: by invoking it with @code{start} or @code{stop} arguments:
...@@ -8657,7 +8797,8 @@ The @code{mysql.server} script uses the following variables: ...@@ -8657,7 +8797,8 @@ The @code{mysql.server} script uses the following variables:
@xref{Option files}. @xref{Option files}.
@cindex Command-line options @findex command-line options
@cindex options, command-line
@node Command-line options, Option files, Automatic start, Post-installation @node Command-line options, Option files, Automatic start, Post-installation
@subsection Command-line options @subsection Command-line options
...@@ -8856,8 +8997,10 @@ output version information and exit ...@@ -8856,8 +8997,10 @@ output version information and exit
@end table @end table
@cindex Default options @cindex default options
@cindex Option files @cindex option files
@cindex creating, default startup options
@cindex startup options, default
@node Option files, , Command-line options, Post-installation @node Option files, , Command-line options, Post-installation
@subsection Option files @subsection Option files
...@@ -9003,6 +9146,8 @@ how to do this. ...@@ -9003,6 +9146,8 @@ how to do this.
@node Upgrade, , Post-installation, Installing @node Upgrade, , Post-installation, Installing
@section Is there anything special to do when upgrading/downgrading MySQL? @section Is there anything special to do when upgrading/downgrading MySQL?
@cindex upgrading
@cindex downgrading
You can always move the @strong{MySQL} form and data files between You can always move the @strong{MySQL} form and data files between
different versions on the same architecture as long as you have the same different versions on the same architecture as long as you have the same
...@@ -9045,7 +9190,8 @@ dumping core after you upgrade @strong{MySQL}. ...@@ -9045,7 +9190,8 @@ dumping core after you upgrade @strong{MySQL}.
* Upgrading-to-arch:: Upgrading to another architecture * Upgrading-to-arch:: Upgrading to another architecture
@end menu @end menu
@cindex Compatibility, between MySQL versions @cindex compatibility, between @strong{MySQL} versions
@cindex upgrading, 3.22 to 3.23
@node Upgrading-from-3.22, Upgrading-from-3.21, Upgrade, Upgrade @node Upgrading-from-3.22, Upgrading-from-3.21, Upgrade, Upgrade
@subsection Upgrading from a 3.22 version to 3.23 @subsection Upgrading from a 3.22 version to 3.23
...@@ -9123,9 +9269,10 @@ New restricted words: @code{CASE, THEN, WHEN, ELSE, END and RIGHT} ...@@ -9123,9 +9269,10 @@ New restricted words: @code{CASE, THEN, WHEN, ELSE, END and RIGHT}
on an @code{AND/OR} expression as @code{NOT NULL} = @code{NULL}. on an @code{AND/OR} expression as @code{NOT NULL} = @code{NULL}.
@end itemize @end itemize
@cindex Compatibility, between MySQL versions @cindex compatibility, between MySQL versions
@node Upgrading-from-3.21, Upgrading-from-3.20, Upgrading-from-3.22, Upgrade @node Upgrading-from-3.21, Upgrading-from-3.20, Upgrading-from-3.22, Upgrade
@subsection Upgrading from a 3.21 version to 3.22 @subsection Upgrading from a 3.21 version to 3.22
@cindex upgrading, 3.21 to 3.22
Nothing that affects compatibility has changed between 3.21 and 3.22. The Nothing that affects compatibility has changed between 3.21 and 3.22. The
only pitfall is that new tables that are created with @code{DATE} type only pitfall is that new tables that are created with @code{DATE} type
...@@ -9154,6 +9301,7 @@ startup files. ...@@ -9154,6 +9301,7 @@ startup files.
@node Upgrading-from-3.20, Upgrading-to-arch, Upgrading-from-3.21, Upgrade @node Upgrading-from-3.20, Upgrading-to-arch, Upgrading-from-3.21, Upgrade
@subsection Upgrading from a 3.20 version to 3.21 @subsection Upgrading from a 3.20 version to 3.21
@cindex upgrading, 3.202 to 3.21
If you are running a version older than 3.20.28 and want to If you are running a version older than 3.20.28 and want to
switch to 3.21.x, you need to do the following: switch to 3.21.x, you need to do the following:
...@@ -9222,6 +9370,7 @@ There are some new reserved words. The most notable are @code{DATE}, ...@@ -9222,6 +9370,7 @@ There are some new reserved words. The most notable are @code{DATE},
@node Upgrading-to-arch, , Upgrading-from-3.20, Upgrade @node Upgrading-to-arch, , Upgrading-from-3.20, Upgrade
@subsection Upgrading to another architecture @subsection Upgrading to another architecture
@cindex upgrading, different architecture
If you are using @strong{MySQL} 3.23, you can copy the @code{.frm}, the If you are using @strong{MySQL} 3.23, you can copy the @code{.frm}, the
@code{.MYI} and the @code{.MYD} files between different architectures @code{.MYI} and the @code{.MYD} files between different architectures
...@@ -9313,7 +9462,10 @@ After you import the @code{mysql} database on the new machine, execute ...@@ -9313,7 +9462,10 @@ After you import the @code{mysql} database on the new machine, execute
@code{mysqladmin flush-privileges} so that the server reloads the grant table @code{mysqladmin flush-privileges} so that the server reloads the grant table
information. information.
@cindex Compatibility, with ANSI SQL @cindex compatibility, with ANSI SQL
@cindex standards compatibility
@cindex extensions, to ANSI SQL
@cindex ANSI SQL92, extensions to
@node Compatibility, Privilege system, Installing, Top @node Compatibility, Privilege system, Installing, Top
@chapter How standards-compatible is MySQL? @chapter How standards-compatible is MySQL?
...@@ -9570,6 +9722,8 @@ SELECT @@t1:=(@@t2:=1)+@@t3:=4,@@t1,@@t2,@@t3; ...@@ -9570,6 +9722,8 @@ SELECT @@t1:=(@@t2:=1)+@@t3:=4,@@t1,@@t2,@@t3;
@node Ansi mode, Differences from ANSI, Extensions to ANSI, Compatibility @node Ansi mode, Differences from ANSI, Extensions to ANSI, Compatibility
@section Running MySQL in ANSI mode @section Running MySQL in ANSI mode
@cindex running, ANSI mode
@cindex ANSI mode, running
If you start mysqld with the @code{--ansi} option, the following behaviour If you start mysqld with the @code{--ansi} option, the following behaviour
of @strong{MySQL} changes. of @strong{MySQL} changes.
...@@ -9616,6 +9770,8 @@ extra conditions in this case. ...@@ -9616,6 +9770,8 @@ extra conditions in this case.
@node Missing functions, Standards, Differences from ANSI, Compatibility @node Missing functions, Standards, Differences from ANSI, Compatibility
@section Functionality missing from MySQL @section Functionality missing from MySQL
@cindex missing functionality
@cindex functionality, missing
The following functionality is missing in the current version of The following functionality is missing in the current version of
@strong{MySQL}. For a prioritized list indicating when new extensions may be @strong{MySQL}. For a prioritized list indicating when new extensions may be
...@@ -9636,6 +9792,7 @@ this manual. @xref{TODO}. ...@@ -9636,6 +9792,7 @@ this manual. @xref{TODO}.
@node Missing Sub-selects, Missing SELECT INTO TABLE, Missing functions, Missing functions @node Missing Sub-selects, Missing SELECT INTO TABLE, Missing functions, Missing functions
@subsection Sub-selects @subsection Sub-selects
@cindex sub-selects
The following will not yet work in @strong{MySQL}: The following will not yet work in @strong{MySQL}:
...@@ -9690,6 +9847,7 @@ other contexts, however. ...@@ -9690,6 +9847,7 @@ other contexts, however.
@node Missing SELECT INTO TABLE, Missing Transactions, Missing Sub-selects, Missing functions @node Missing SELECT INTO TABLE, Missing Transactions, Missing Sub-selects, Missing functions
@subsection @code{SELECT INTO TABLE} @subsection @code{SELECT INTO TABLE}
@findex SELECT INTO TABLE
@strong{MySQL} doesn't yet support the Oracle SQL extension: @strong{MySQL} doesn't yet support the Oracle SQL extension:
@code{SELECT ... INTO TABLE ...}. @strong{MySQL} supports instead the @code{SELECT ... INTO TABLE ...}. @strong{MySQL} supports instead the
...@@ -9701,6 +9859,7 @@ TABLE ... SELECT} to solve your problem. ...@@ -9701,6 +9859,7 @@ TABLE ... SELECT} to solve your problem.
@node Missing Transactions, Missing Triggers, Missing SELECT INTO TABLE, Missing functions @node Missing Transactions, Missing Triggers, Missing SELECT INTO TABLE, Missing functions
@subsection Transactions @subsection Transactions
@cindex transactions, support
As @strong{MySQL} does nowadays support transactions, the following As @strong{MySQL} does nowadays support transactions, the following
discussion is only valid if you are only using the non-transaction-safe discussion is only valid if you are only using the non-transaction-safe
...@@ -9814,6 +9973,10 @@ operations, non-transactional, paradigm. Stay tuned. ...@@ -9814,6 +9973,10 @@ operations, non-transactional, paradigm. Stay tuned.
@node Missing Triggers, Missing Foreign Keys, Missing Transactions, Missing functions @node Missing Triggers, Missing Foreign Keys, Missing Transactions, Missing functions
@subsection Stored procedures and triggers @subsection Stored procedures and triggers
@cindex stored procedures and triggers, defined
@cindex procedures, stored
@cindex triggers, stored
A stored procedure is a set of SQL commands that can be compiled and stored A stored procedure is a set of SQL commands that can be compiled and stored
in the server. Once this has been done, clients don't need to keep reissuing in the server. Once this has been done, clients don't need to keep reissuing
...@@ -9836,6 +9999,8 @@ To see when @strong{MySQL} might get stored procedures, see @ref{TODO}. ...@@ -9836,6 +9999,8 @@ To see when @strong{MySQL} might get stored procedures, see @ref{TODO}.
@node Missing Foreign Keys, Missing Views, Missing Triggers, Missing functions @node Missing Foreign Keys, Missing Views, Missing Triggers, Missing functions
@subsection Foreign Keys @subsection Foreign Keys
@cindex foreign keys
@cindex keys, foreign
Note that foreign keys in SQL are not used to join tables, but are used Note that foreign keys in SQL are not used to join tables, but are used
mostly for checking referential integrity. If you want to get results from mostly for checking referential integrity. If you want to get results from
...@@ -9874,6 +10039,7 @@ and may be retrieved by @code{mysqldump} and ODBC. ...@@ -9874,6 +10039,7 @@ and may be retrieved by @code{mysqldump} and ODBC.
@node Broken Foreign KEY, , Missing Foreign Keys, Missing Foreign Keys @node Broken Foreign KEY, , Missing Foreign Keys, Missing Foreign Keys
@subsubsection Reasons NOT to use foreign keys @subsubsection Reasons NOT to use foreign keys
@cindex foreign keys, reasons not to use
There are so many problems with @code{FOREIGN KEY}s that we don't There are so many problems with @code{FOREIGN KEY}s that we don't
know where to start: know where to start:
...@@ -9919,11 +10085,14 @@ made. The current @file{.frm} file format does not have any place for it. ...@@ -9919,11 +10085,14 @@ made. The current @file{.frm} file format does not have any place for it.
@node Missing Views, Missing comments, Missing Foreign Keys, Missing functions @node Missing Views, Missing comments, Missing Foreign Keys, Missing functions
@subsection Views @subsection Views
@cindex views
@strong{MySQL} doesn't support views, but this is on the TODO. @strong{MySQL} doesn't support views, but this is on the TODO.
@node Missing comments, , Missing Views, Missing functions @node Missing comments, , Missing Views, Missing functions
@subsection @samp{--} as the start of a comment @subsection @samp{--} as the start of a comment
@cindex comments, starting
@cindex starting, comments
Some other SQL databases use @samp{--} to start comments. @strong{MySQL} Some other SQL databases use @samp{--} to start comments. @strong{MySQL}
has @samp{#} as the start comment character, even if the @code{mysql} has @samp{#} as the start comment character, even if the @code{mysql}
...@@ -9987,6 +10156,13 @@ Entry level SQL92. ODBC levels 0-2. ...@@ -9987,6 +10156,13 @@ Entry level SQL92. ODBC levels 0-2.
@node Commit-rollback, , Standards, Compatibility @node Commit-rollback, , Standards, Compatibility
@section How to cope without @code{COMMIT}/@code{ROLLBACK} @section How to cope without @code{COMMIT}/@code{ROLLBACK}
@findex COMMIT
@findex ROLLBACK
@cindex transaction safe tables
@cindex tables, updating
@cindex updating, tables
@cindex BDB tables
The following mostly apply only for @code{ISAM}, @code{MyISAM} and The following mostly apply only for @code{ISAM}, @code{MyISAM} and
@code{HEAP} tables; If you only use transaction safe tables (@code{BDB} @code{HEAP} tables; If you only use transaction safe tables (@code{BDB}
...@@ -10116,6 +10292,12 @@ UPDATE tbl_name SET row_flag=1 WHERE id=ID and row_flag <> 1; ...@@ -10116,6 +10292,12 @@ UPDATE tbl_name SET row_flag=1 WHERE id=ID and row_flag <> 1;
@node Privilege system, Reference, Compatibility, Top @node Privilege system, Reference, Compatibility, Top
@chapter The MySQL access privilege system @chapter The MySQL access privilege system
@cindex system, security
@cindex access privileges
@cindex privleges, access
@cindex security system
@cindex ACLs
@strong{MySQL} has an advanced but non-standard security/privilege @strong{MySQL} has an advanced but non-standard security/privilege
system. This section describes how it works. system. This section describes how it works.
...@@ -10316,6 +10498,8 @@ consult with a security expert. ...@@ -10316,6 +10498,8 @@ consult with a security expert.
@node Security, What Privileges, General security, Privilege system @node Security, What Privileges, General security, Privilege system
@section How to make MySQL secure against crackers @section How to make MySQL secure against crackers
@cindex crackers, security against
@cindex security, against crackers
When you connect to a @strong{MySQL} server, you normally should use a When you connect to a @strong{MySQL} server, you normally should use a
password. The password is not transmitted in clear text over the password. The password is not transmitted in clear text over the
...@@ -10442,6 +10626,10 @@ support Unix sockets. ...@@ -10442,6 +10626,10 @@ support Unix sockets.
@node What Privileges, User names, Security, Privilege system @node What Privileges, User names, Security, Privilege system
@section What the privilege system does @section What the privilege system does
@cindex system, privilege
@cindex privilege system
@cindex passwords, security
The primary function of the @strong{MySQL} privilege system is to The primary function of the @strong{MySQL} privilege system is to
authenticate a user connecting from a given host, and to associate that user authenticate a user connecting from a given host, and to associate that user
...@@ -10454,6 +10642,9 @@ DATA INFILE} and administrative operations. ...@@ -10454,6 +10642,9 @@ DATA INFILE} and administrative operations.
@node User names, Connecting, What Privileges, Privilege system @node User names, Connecting, What Privileges, Privilege system
@section MySQL user names and passwords @section MySQL user names and passwords
@cindex user names, and passwords
@cindex passwords, for users
There are several distinctions between the way user names and passwords are There are several distinctions between the way user names and passwords are
used by @strong{MySQL}, and the way they are used by Unix or Windows: used by @strong{MySQL}, and the way they are used by Unix or Windows:
...@@ -10490,6 +10681,10 @@ the the @strong{MySQL} server ! ...@@ -10490,6 +10681,10 @@ the the @strong{MySQL} server !
@node Connecting, Password security, User names, Privilege system @node Connecting, Password security, User names, Privilege system
@section Connecting to the MySQL server @section Connecting to the MySQL server
@cindex connecting, to the server
@cindex default hostname
@cindex hostname, default
@cindex server, connecting to
@strong{MySQL} client programs generally require that you specify connection @strong{MySQL} client programs generally require that you specify connection
parameters when you want to access a @strong{MySQL} server: the host you want parameters when you want to access a @strong{MySQL} server: the host you want
...@@ -10597,6 +10792,8 @@ but there is still a brief interval during which the value is visible.) ...@@ -10597,6 +10792,8 @@ but there is still a brief interval during which the value is visible.)
Use a @code{-p} or @code{--password} option (with no @code{your_pass} value Use a @code{-p} or @code{--password} option (with no @code{your_pass} value
specified). In this case, the client program solicits the password from specified). In this case, the client program solicits the password from
the terminal: the terminal:
@findex -p option
@findex -password option
@example @example
shell> mysql -u user_name -p shell> mysql -u user_name -p
...@@ -10645,6 +10842,7 @@ file. ...@@ -10645,6 +10842,7 @@ file.
@node Privileges provided, Privileges, Password security, Privilege system @node Privileges provided, Privileges, Password security, Privilege system
@section Privileges provided by MySQL @section Privileges provided by MySQL
@cindex privilege information, location
Privilege information is stored in the @code{user}, @code{db}, @code{host}, Privilege information is stored in the @code{user}, @code{db}, @code{host},
@code{tables_priv} and @code{columns_priv} tables in the @code{mysql} @code{tables_priv} and @code{columns_priv} tables in the @code{mysql}
...@@ -10792,6 +10990,7 @@ in a database but not to create or drop the database itself. ...@@ -10792,6 +10990,7 @@ in a database but not to create or drop the database itself.
@node Privileges, Connection access, Privileges provided, Privilege system @node Privileges, Connection access, Privileges provided, Privilege system
@section How the privilege system works @section How the privilege system works
@cindex privilege system, described
The @strong{MySQL} privilege system ensures that all users may do exactly the The @strong{MySQL} privilege system ensures that all users may do exactly the
things that they are supposed to be allowed to do. When you connect to a things that they are supposed to be allowed to do. When you connect to a
...@@ -10993,6 +11192,10 @@ privileges. ...@@ -10993,6 +11192,10 @@ privileges.
@node Connection access, Request access, Privileges, Privilege system @node Connection access, Request access, Privileges, Privilege system
@section Access control, stage 1: Connection verification @section Access control, stage 1: Connection verification
@cindex access control
@cindex control access
@cindex connecting, verification
@cindex testing, connection to the server
When you attempt to connect to a @strong{MySQL} server, the server accepts or When you attempt to connect to a @strong{MySQL} server, the server accepts or
rejects the connection based on your identity and whether or not you can rejects the connection based on your identity and whether or not you can
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment