Author: paul
Date: 2006-01-13 21:11:16 +0100 (Fri, 13 Jan 2006)
New Revision: 815
Log:
r2168@kite-hub: paul | 2006-01-13 14:10:46 -0600
Move myisamlog section.
More consistent descriptions for --password.
Update password security section.
Modified:
trunk/
trunk/refman-4.1/client-utility-programs.xml
trunk/refman-4.1/database-administration.xml
trunk/refman-5.0/client-utility-programs.xml
trunk/refman-5.0/database-administration.xml
trunk/refman-5.1/client-utility-programs.xml
trunk/refman-5.1/database-administration.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6161
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2162
+ b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:6161
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:2168
Modified: trunk/refman-4.1/client-utility-programs.xml
===================================================================
--- trunk/refman-4.1/client-utility-programs.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-4.1/client-utility-programs.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -51,16 +51,40 @@
<listitem>
<para>
<indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <indexterm>
+ <primary><command>isamlog</command></primary>
+ </indexterm>
+
+ <command>myisamlog</command>, <command>isamlog</command>
+ </para>
+
+ <para>
+ Utilities that process the contents of a
+ <literal>MyISAM</literal> or <literal>ISAM</literal> log file.
+ See <xref linkend="myisampack"/>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <indexterm>
<primary><command>myisampack</command></primary>
</indexterm>
- <command>myisampack</command>
+ <indexterm>
+ <primary><command>pack_isam</command></primary>
+ </indexterm>
+
+ <command>myisampack</command>, <command>pack_isam</command>
</para>
<para>
- A utility that compresses <literal>MyISAM</literal> tables to
- produce smaller read-only tables. See
- <xref linkend="myisampack"/>.
+ Utilities that compress <literal>MyISAM</literal> or
+ <literal>ISAM</literal> tables to produce smaller read-only
+ tables. See <xref linkend="myisampack"/>.
</para>
</listitem>
@@ -91,7 +115,8 @@
<para>
A script that checks the access privileges for a hostname,
- username, and database combination.
+ username, and database combination. See
+ <xref linkend="mysqlaccess"/>.
</para>
</listitem>
@@ -360,6 +385,243 @@
</section>
+ <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+ <title>fake title for myisamlog manpage section wrapper</title>
+
+ <refentry id="myisamlog">
+
+ <indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <indexterm>
+ <primary><command>isamlog</command></primary>
+ </indexterm>
+
+ <refmeta>
+ <refentrytitle><command>myisamlog</command></refentrytitle>
+
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+ <refmiscinfo class="source">MySQL</refmiscinfo>
+ <refmiscinfo class="version">¤t-series;</refmiscinfo>
+ <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>myisamlog</refname>
+
+ <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+ </refnamediv>
+
+ <refnamediv>
+ <refname>isamlog</refname>
+
+ <refpurpose>&title-isamlog-for-manpage;</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+ </cmdsynopsis>
+
+ <cmdsynopsis>
+ <command>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsection id="myisamlog-description">
+
+ <title>Description</title>
+
+ <para>
+ <command>myisamlog</command> processes the contents of a
+ <literal>MyISAM</literal> log file. <command>isamlog</command>
+ is similar, but is used with <literal>ISAM</literal> log
+ files.
+ </para>
+
+ <para>
+ Invoke <command>myisamlog</command> or
+ <command>isamlog</command>like this:
+ </para>
+
+<programlisting>
+shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+shell> <userinput>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+ <para>
+ The normal operation is update (<option>-u</option>). If a
+ recovery is done (<option>-r</option>), all writes and
+ possibly updates and deletes are done and errors are only
+ counted. If no logfile name is given,
+ <filename>myisam.log</filename> is used for
+ <command>myisamlog</command> and <filename>isam.log</filename>
+ for <command>isamlog</command>. If table names are named on
+ the command line, only those tables are updated.
+ </para>
+
+ <para>
+ <command>myisamlog</command> and <command>isamlog</command>
+ understand the following options:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ <option>-?</option>, <option>-I</option>
+ </para>
+
+ <para>
+ Display a help message and exit.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-c <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Do only <replaceable>N</replaceable> commands.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-f <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Specify the maximum number of open files.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-F <replaceable>filepath/</replaceable></option>
+ </para>
+
+ <para>
+ TODO
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-i</option>
+ </para>
+
+ <para>
+ Display extra information before exiting.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-o <replaceable>offset</replaceable></option>
+ </para>
+
+ <para>
+ Specify the starting offset.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-p <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Remove <replaceable>N</replaceable> components from path.
+ </para>
+ </listitem>
+
+<!--
+ <listitem>
+ <para>
+ <option>-P</option>
+ </para>
+
+ <para>
+ UNKNOWN
+ </para>
+ </listitem>
+-->
+
+ <listitem>
+ <para>
+ <option>-r</option>
+ </para>
+
+ <para>
+ Recover.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-R <replaceable>record-pos-file
+ record-pos</replaceable></option>
+ </para>
+
+ <para>
+ Specify record position file and record position.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-u</option>
+ </para>
+
+ <para>
+ Update.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-v</option>
+ </para>
+
+ <para>
+ Verbose mode. Produce more output. This option can be
+ given multiple times to produce more and more output.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-w <replaceable>write-file</replaceable></option>
+ </para>
+
+ <para>
+ Specify write file.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-V</option>
+ </para>
+
+ <para>
+ Display version information.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </refsection>
+
+ </refentry>
+
+ </section>
+
<section id="fake-id-for-myisampack-manpage-section-wrapper">
<title>fake title for myisampack manpage section wrapper</title>
@@ -406,6 +668,7 @@
<refnamediv>
<refname>pack_isam</refname>
+
<refpurpose>&title-pack-isam-for-manpage;</refpurpose>
</refnamediv>
@@ -1702,11 +1965,14 @@
option and the password. If you omit the
<replaceable>password</replaceable> value following the
<option>--password</option> or <option>-p</option> option
- on the command line, you are prompted for one. The
- password should be omitted on SysV-based UNIX systems, as
- the password may be displayed in the output of
- <literal>ps</literal>.
+ on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3159,6 +3425,12 @@
<option>-p</option> option on the command line, you are
prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3227,6 +3499,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3953,6 +4231,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -4335,6 +4619,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -5100,6 +5390,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -5909,6 +6205,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -6551,8 +6853,15 @@
<para>
The password to use when connecting to the server. Note
that the password value is not optional for this option,
- unlike for other MySQL programs.
+ unlike for other MySQL programs. You can use an option
+ file to avoid giving the password on the command line.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -6912,6 +7221,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7281,6 +7596,18 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7492,242 +7819,6 @@
</section>
- <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
- <title>fake title for myisamlog manpage section wrapper</title>
-
- <refentry id="myisamlog">
-
- <indexterm>
- <primary><command>myisamlog</command></primary>
- </indexterm>
-
- <indexterm>
- <primary><command>isamlog</command></primary>
- </indexterm>
-
- <refmeta>
- <refentrytitle><command>myisamlog</command></refentrytitle>
-
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
- <refmiscinfo class="source">MySQL</refmiscinfo>
- <refmiscinfo class="version">¤t-series;</refmiscinfo>
- <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>myisamlog</refname>
-
- <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
- </refnamediv>
-
- <refnamediv>
- <refname>isamlog</refname>
- <refpurpose>&title-isamlog-for-manpage;</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
- </cmdsynopsis>
-
- <cmdsynopsis>
- <command>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsection id="myisamlog-description">
-
- <title>Description</title>
-
- <para>
- <command>myisamlog</command> processes the contents of a
- <literal>MyISAM</literal> log file. <command>isamlog</command>
- is similar, but is used with <literal>ISAM</literal> log
- files.
- </para>
-
- <para>
- Invoke <command>myisamlog</command> or
- <command>isamlog</command>like this:
- </para>
-
-<programlisting>
-shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-shell> <userinput>isamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
- <para>
- The normal operation is update (<option>-u</option>). If a
- recovery is done (<option>-r</option>), all writes and
- possibly updates and deletes are done and errors are only
- counted. If no logfile name is given,
- <filename>myisam.log</filename> is used for
- <command>myisamlog</command> and <filename>isam.log</filename>
- for <command>isamlog</command>. If table names are named on
- the command line, only those tables are updated.
- </para>
-
- <para>
- <command>myisamlog</command> and <command>isamlog</command>
- understand the following options:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- <option>-?</option>, <option>-I</option>
- </para>
-
- <para>
- Display a help message and exit.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-c <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Do only <replaceable>N</replaceable> commands.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-f <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Specify the maximum number of open files.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-F <replaceable>filepath/</replaceable></option>
- </para>
-
- <para>
- TODO
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-i</option>
- </para>
-
- <para>
- Display extra information before exiting.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-o <replaceable>offset</replaceable></option>
- </para>
-
- <para>
- Specify the starting offset.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-p <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Remove <replaceable>N</replaceable> components from path.
- </para>
- </listitem>
-
-<!--
- <listitem>
- <para>
- <option>-P</option>
- </para>
-
- <para>
- UNKNOWN
- </para>
- </listitem>
--->
-
- <listitem>
- <para>
- <option>-r</option>
- </para>
-
- <para>
- Recover.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-R <replaceable>record-pos-file
- record-pos</replaceable></option>
- </para>
-
- <para>
- Specify record position file and record position.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-u</option>
- </para>
-
- <para>
- Update.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-v</option>
- </para>
-
- <para>
- Verbose mode. Produce more output. This option can be
- given multiple times to produce more and more output.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-w <replaceable>write-file</replaceable></option>
- </para>
-
- <para>
- Specify write file.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-V</option>
- </para>
-
- <para>
- Display version information.
- </para>
- </listitem>
-
- </itemizedlist>
-
- </refsection>
-
- </refentry>
-
- </section>
-
<section id="fake-id-for-perror-manpage-section-wrapper">
<title>fake title for perror manpage section wrapper</title>
Modified: trunk/refman-4.1/database-administration.xml
===================================================================
--- trunk/refman-4.1/database-administration.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-4.1/database-administration.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -708,6 +708,7 @@
<refmeta>
<refentrytitle><command>mysqld_safe</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -717,11 +718,13 @@
<refnamediv>
<refname>mysqld_safe</refname>
+
<refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
</refnamediv>
<refnamediv>
<refname>safe_mysqld</refname>
+
<refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -1268,6 +1271,7 @@
<refmeta>
<refentrytitle><command>mysql.server</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1277,6 +1281,7 @@
<refnamediv>
<refname>mysql.server</refname>
+
<refpurpose>&title-mysql-server-for-manpage;</refpurpose>
</refnamediv>
@@ -1370,6 +1375,7 @@
<refmeta>
<refentrytitle><command>mysqld_multi</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1379,6 +1385,7 @@
<refnamediv>
<refname>mysqld_multi</refname>
+
<refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
</refnamediv>
@@ -1938,6 +1945,7 @@
<refmeta>
<refentrytitle><command>mysqld</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1947,6 +1955,7 @@
<refnamediv>
<refname>mysqld</refname>
+
<refpurpose>&title-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -9196,6 +9205,7 @@
<refmeta>
<refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -9205,6 +9215,7 @@
<refnamediv>
<refname>mysql_fix_privilege_tables</refname>
+
<refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
</refnamediv>
@@ -15284,13 +15295,17 @@
</programlisting>
<para>
- This is convenient but insecure, because your password
- becomes visible to system status programs such as
- <command>ps</command> that may be invoked by other users to
- display command lines. MySQL clients typically overwrite the
- command-line password argument with zeros during their
- initialization sequence, but there is still a brief interval
- during which the value is visible.
+ This is convenient <emphasis>but insecure</emphasis>,
+ because your password becomes visible to system status
+ programs such as <command>ps</command> that may be invoked
+ by other users to display command lines. MySQL clients
+ typically overwrite the command-line password argument with
+ zeros during their initialization sequence. However, there
+ is still a brief interval during which the value is visible.
+ On some systems this strategy is ineffective, anyway, and
+ the password remains visible to <command>ps</command>.
+ (SystemV Unix systems and perhaps others are subject to this
+ problem.)
</para>
</listitem>
@@ -15364,15 +15379,16 @@
<para>
Store your password in the <literal>MYSQL_PWD</literal>
environment variable. This method of specifying your MySQL
- password must be considered extremely insecure and should
- not be used. Some versions of <command>ps</command> include
- an option to display the environment of running processes.
- If you set <literal>MYSQL_PWD</literal>, your password is
- exposed to any other user who runs <command>ps</command>.
- Even on systems without such a version of
- <command>ps</command>, it is unwise to assume that there are
- no other methods by which users can examine process
- environments. See <xref linkend="environment-variables"/>.
+ password must be considered <emphasis>extremely
+ insecure</emphasis> and should not be used. Some versions of
+ <command>ps</command> include an option to display the
+ environment of running processes. If you set
+ <literal>MYSQL_PWD</literal>, your password is exposed to
+ any other user who runs <command>ps</command>. Even on
+ systems without such a version of <command>ps</command>, it
+ is unwise to assume that there are no other methods by which
+ users can examine process environments. See
+ <xref linkend="environment-variables"/>.
</para>
</listitem>
@@ -17172,6 +17188,7 @@
<refmeta>
<refentrytitle><command>myisamchk</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -17181,6 +17198,7 @@
<refnamediv>
<refname>myisamchk</refname>
+
<refpurpose>&title-myisamchk-for-manpage;</refpurpose>
</refnamediv>
Modified: trunk/refman-5.0/client-utility-programs.xml
===================================================================
--- trunk/refman-5.0/client-utility-programs.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.0/client-utility-programs.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -51,6 +51,22 @@
<listitem>
<para>
<indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <command>myisamlog</command>
+ </para>
+
+ <para>
+ A utility that processes the contents of a
+ <literal>MyISAM</literal> log file. See
+ <xref linkend="myisampack"/>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <indexterm>
<primary><command>myisampack</command></primary>
</indexterm>
@@ -91,7 +107,8 @@
<para>
A script that checks the access privileges for a hostname,
- username, and database combination.
+ username, and database combination. See
+ <xref linkend="mysqlaccess"/>.
</para>
</listitem>
@@ -360,6 +377,223 @@
</section>
+ <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+ <title>fake title for myisamlog manpage section wrapper</title>
+
+ <refentry id="myisamlog">
+
+ <indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <refmeta>
+ <refentrytitle><command>myisamlog</command></refentrytitle>
+
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+ <refmiscinfo class="source">MySQL</refmiscinfo>
+ <refmiscinfo class="version">¤t-series;</refmiscinfo>
+ <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>myisamlog</refname>
+
+ <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsection id="myisamlog-description">
+
+ <title>Description</title>
+
+ <para>
+ <command>myisamlog</command> processes the contents of a
+ <literal>MyISAM</literal> log file.
+ </para>
+
+ <para>
+ Invoke <command>myisamlog</command> like this:
+ </para>
+
+<programlisting>
+shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+ <para>
+ The normal operation is update (<option>-u</option>). If a
+ recovery is done (<option>-r</option>), all writes and
+ possibly updates and deletes are done and errors are only
+ counted. If no logfile name is given,
+ <filename>myisam.log</filename> is used. If table names are
+ named on the command line, only those tables are updated.
+ </para>
+
+ <para>
+ <command>myisamlog</command> understands the following
+ options:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ <option>-?</option>, <option>-I</option>
+ </para>
+
+ <para>
+ Display a help message and exit.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-c <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Do only <replaceable>N</replaceable> commands.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-f <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Specify the maximum number of open files.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-F <replaceable>filepath/</replaceable></option>
+ </para>
+
+ <para>
+ TODO
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-i</option>
+ </para>
+
+ <para>
+ Display extra information before exiting.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-o <replaceable>offset</replaceable></option>
+ </para>
+
+ <para>
+ Specify the starting offset.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-p <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Remove <replaceable>N</replaceable> components from path.
+ </para>
+ </listitem>
+
+<!--
+ <listitem>
+ <para>
+ <option>-P</option>
+ </para>
+
+ <para>
+ UNKNOWN
+ </para>
+ </listitem>
+-->
+
+ <listitem>
+ <para>
+ <option>-r</option>
+ </para>
+
+ <para>
+ Recover.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-R <replaceable>record-pos-file
+ record-pos</replaceable></option>
+ </para>
+
+ <para>
+ Specify record position file and record position.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-u</option>
+ </para>
+
+ <para>
+ Update.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-v</option>
+ </para>
+
+ <para>
+ Verbose mode. Produce more output. This option can be
+ given multiple times to produce more and more output.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-w <replaceable>write-file</replaceable></option>
+ </para>
+
+ <para>
+ Specify write file.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-V</option>
+ </para>
+
+ <para>
+ Display version information.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </refsection>
+
+ </refentry>
+
+ </section>
+
<section id="fake-id-for-myisampack-manpage-section-wrapper">
<title>fake title for myisampack manpage section wrapper</title>
@@ -1673,11 +1907,14 @@
option and the password. If you omit the
<replaceable>password</replaceable> value following the
<option>--password</option> or <option>-p</option> option
- on the command line, you are prompted for one. The
- password should be omitted on SysV-based UNIX systems, as
- the password may be displayed in the output of
- <literal>ps</literal>.
+ on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3146,6 +3383,12 @@
<option>-p</option> option on the command line, you are
prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3214,6 +3457,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3938,6 +4187,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -4332,6 +4587,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -5247,6 +5508,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -5992,6 +6259,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -6693,8 +6966,15 @@
<para>
The password to use when connecting to the server. Note
that the password value is not optional for this option,
- unlike for other MySQL programs.
+ unlike for other MySQL programs. You can use an option
+ file to avoid giving the password on the command line.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7054,6 +7334,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7423,6 +7709,18 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7647,223 +7945,6 @@
</section>
- <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
- <title>fake title for myisamlog manpage section wrapper</title>
-
- <refentry id="myisamlog">
-
- <indexterm>
- <primary><command>myisamlog</command></primary>
- </indexterm>
-
- <refmeta>
- <refentrytitle><command>myisamlog</command></refentrytitle>
-
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
- <refmiscinfo class="source">MySQL</refmiscinfo>
- <refmiscinfo class="version">¤t-series;</refmiscinfo>
- <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>myisamlog</refname>
-
- <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsection id="myisamlog-description">
-
- <title>Description</title>
-
- <para>
- <command>myisamlog</command> processes the contents of a
- <literal>MyISAM</literal> log file.
- </para>
-
- <para>
- Invoke <command>myisamlog</command> like this:
- </para>
-
-<programlisting>
-shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
- <para>
- The normal operation is update (<option>-u</option>). If a
- recovery is done (<option>-r</option>), all writes and
- possibly updates and deletes are done and errors are only
- counted. If no logfile name is given,
- <filename>myisam.log</filename> is used. If table names are
- named on the command line, only those tables are updated.
- </para>
-
- <para>
- <command>myisamlog</command> understands the following
- options:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- <option>-?</option>, <option>-I</option>
- </para>
-
- <para>
- Display a help message and exit.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-c <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Do only <replaceable>N</replaceable> commands.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-f <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Specify the maximum number of open files.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-F <replaceable>filepath/</replaceable></option>
- </para>
-
- <para>
- TODO
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-i</option>
- </para>
-
- <para>
- Display extra information before exiting.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-o <replaceable>offset</replaceable></option>
- </para>
-
- <para>
- Specify the starting offset.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-p <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Remove <replaceable>N</replaceable> components from path.
- </para>
- </listitem>
-
-<!--
- <listitem>
- <para>
- <option>-P</option>
- </para>
-
- <para>
- UNKNOWN
- </para>
- </listitem>
--->
-
- <listitem>
- <para>
- <option>-r</option>
- </para>
-
- <para>
- Recover.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-R <replaceable>record-pos-file
- record-pos</replaceable></option>
- </para>
-
- <para>
- Specify record position file and record position.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-u</option>
- </para>
-
- <para>
- Update.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-v</option>
- </para>
-
- <para>
- Verbose mode. Produce more output. This option can be
- given multiple times to produce more and more output.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-w <replaceable>write-file</replaceable></option>
- </para>
-
- <para>
- Specify write file.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-V</option>
- </para>
-
- <para>
- Display version information.
- </para>
- </listitem>
-
- </itemizedlist>
-
- </refsection>
-
- </refentry>
-
- </section>
-
<section id="fake-id-for-perror-manpage-section-wrapper">
<title>fake title for perror manpage section wrapper</title>
Modified: trunk/refman-5.0/database-administration.xml
===================================================================
--- trunk/refman-5.0/database-administration.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.0/database-administration.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -717,6 +717,7 @@
<refmeta>
<refentrytitle><command>mysqld_safe</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -726,11 +727,13 @@
<refnamediv>
<refname>mysqld_safe</refname>
+
<refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
</refnamediv>
<refnamediv>
<refname>safe_mysqld</refname>
+
<refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -1274,6 +1277,7 @@
<refmeta>
<refentrytitle><command>mysql.server</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1283,6 +1287,7 @@
<refnamediv>
<refname>mysql.server</refname>
+
<refpurpose>&title-mysql-server-for-manpage;</refpurpose>
</refnamediv>
@@ -1376,6 +1381,7 @@
<refmeta>
<refentrytitle><command>mysqld_multi</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1385,6 +1391,7 @@
<refnamediv>
<refname>mysqld_multi</refname>
+
<refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
</refnamediv>
@@ -1941,6 +1948,7 @@
<refmeta>
<refentrytitle><command>mysqlmanager</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1950,6 +1958,7 @@
<refnamediv>
<refname>mysqlmanager</refname>
+
<refpurpose>&title-instance-manager-for-manpage;</refpurpose>
</refnamediv>
@@ -2794,6 +2803,7 @@
<refmeta>
<refentrytitle><command>mysqld</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -2803,6 +2813,7 @@
<refnamediv>
<refname>mysqld</refname>
+
<refpurpose>&title-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -11228,6 +11239,7 @@
<refmeta>
<refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -11237,6 +11249,7 @@
<refnamediv>
<refname>mysql_fix_privilege_tables</refname>
+
<refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
</refnamediv>
@@ -17433,13 +17446,17 @@
</programlisting>
<para>
- This is convenient but insecure, because your password
- becomes visible to system status programs such as
- <command>ps</command> that may be invoked by other users to
- display command lines. MySQL clients typically overwrite the
- command-line password argument with zeros during their
- initialization sequence, but there is still a brief interval
- during which the value is visible.
+ This is convenient <emphasis>but insecure</emphasis>,
+ because your password becomes visible to system status
+ programs such as <command>ps</command> that may be invoked
+ by other users to display command lines. MySQL clients
+ typically overwrite the command-line password argument with
+ zeros during their initialization sequence. However, there
+ is still a brief interval during which the value is visible.
+ On some systems this strategy is ineffective, anyway, and
+ the password remains visible to <command>ps</command>.
+ (SystemV Unix systems and perhaps others are subject to this
+ problem.)
</para>
</listitem>
@@ -17513,15 +17530,16 @@
<para>
Store your password in the <literal>MYSQL_PWD</literal>
environment variable. This method of specifying your MySQL
- password must be considered extremely insecure and should
- not be used. Some versions of <command>ps</command> include
- an option to display the environment of running processes.
- If you set <literal>MYSQL_PWD</literal>, your password is
- exposed to any other user who runs <command>ps</command>.
- Even on systems without such a version of
- <command>ps</command>, it is unwise to assume that there are
- no other methods by which users can examine process
- environments. See <xref linkend="environment-variables"/>.
+ password must be considered <emphasis>extremely
+ insecure</emphasis> and should not be used. Some versions of
+ <command>ps</command> include an option to display the
+ environment of running processes. If you set
+ <literal>MYSQL_PWD</literal>, your password is exposed to
+ any other user who runs <command>ps</command>. Even on
+ systems without such a version of <command>ps</command>, it
+ is unwise to assume that there are no other methods by which
+ users can examine process environments. See
+ <xref linkend="environment-variables"/>.
</para>
</listitem>
@@ -19423,6 +19441,7 @@
<refmeta>
<refentrytitle><command>myisamchk</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -19432,6 +19451,7 @@
<refnamediv>
<refname>myisamchk</refname>
+
<refpurpose>&title-myisamchk-for-manpage;</refpurpose>
</refnamediv>
Modified: trunk/refman-5.1/client-utility-programs.xml
===================================================================
--- trunk/refman-5.1/client-utility-programs.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.1/client-utility-programs.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -51,6 +51,22 @@
<listitem>
<para>
<indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <command>myisamlog</command>
+ </para>
+
+ <para>
+ A utility that processes the contents of a
+ <literal>MyISAM</literal> log file. See
+ <xref linkend="myisampack"/>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <indexterm>
<primary><command>myisampack</command></primary>
</indexterm>
@@ -91,7 +107,8 @@
<para>
A script that checks the access privileges for a hostname,
- username, and database combination.
+ username, and database combination. See
+ <xref linkend="mysqlaccess"/>.
</para>
</listitem>
@@ -360,6 +377,223 @@
</section>
+ <section id="fake-id-for-myisamlog-manpage-section-wrapper">
+
+ <title>fake title for myisamlog manpage section wrapper</title>
+
+ <refentry id="myisamlog">
+
+ <indexterm>
+ <primary><command>myisamlog</command></primary>
+ </indexterm>
+
+ <refmeta>
+ <refentrytitle><command>myisamlog</command></refentrytitle>
+
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
+ <refmiscinfo class="source">MySQL</refmiscinfo>
+ <refmiscinfo class="version">¤t-series;</refmiscinfo>
+ <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>myisamlog</refname>
+
+ <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsection id="myisamlog-description">
+
+ <title>Description</title>
+
+ <para>
+ <command>myisamlog</command> processes the contents of a
+ <literal>MyISAM</literal> log file.
+ </para>
+
+ <para>
+ Invoke <command>myisamlog</command> like this:
+ </para>
+
+<programlisting>
+shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
+</programlisting>
+
+ <para>
+ The normal operation is update (<option>-u</option>). If a
+ recovery is done (<option>-r</option>), all writes and
+ possibly updates and deletes are done and errors are only
+ counted. If no logfile name is given,
+ <filename>myisam.log</filename> is used. If table names are
+ named on the command line, only those tables are updated.
+ </para>
+
+ <para>
+ <command>myisamlog</command> understands the following
+ options:
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ <option>-?</option>, <option>-I</option>
+ </para>
+
+ <para>
+ Display a help message and exit.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-c <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Do only <replaceable>N</replaceable> commands.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-f <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Specify the maximum number of open files.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-F <replaceable>filepath/</replaceable></option>
+ </para>
+
+ <para>
+ TODO
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-i</option>
+ </para>
+
+ <para>
+ Display extra information before exiting.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-o <replaceable>offset</replaceable></option>
+ </para>
+
+ <para>
+ Specify the starting offset.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-p <replaceable>N</replaceable></option>
+ </para>
+
+ <para>
+ Remove <replaceable>N</replaceable> components from path.
+ </para>
+ </listitem>
+
+<!--
+ <listitem>
+ <para>
+ <option>-P</option>
+ </para>
+
+ <para>
+ UNKNOWN
+ </para>
+ </listitem>
+-->
+
+ <listitem>
+ <para>
+ <option>-r</option>
+ </para>
+
+ <para>
+ Recover.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-R <replaceable>record-pos-file
+ record-pos</replaceable></option>
+ </para>
+
+ <para>
+ Specify record position file and record position.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-u</option>
+ </para>
+
+ <para>
+ Update.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-v</option>
+ </para>
+
+ <para>
+ Verbose mode. Produce more output. This option can be
+ given multiple times to produce more and more output.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-w <replaceable>write-file</replaceable></option>
+ </para>
+
+ <para>
+ Specify write file.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <option>-V</option>
+ </para>
+
+ <para>
+ Display version information.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </refsection>
+
+ </refentry>
+
+ </section>
+
<section id="fake-id-for-myisampack-manpage-section-wrapper">
<title>fake title for myisampack manpage section wrapper</title>
@@ -1673,11 +1907,14 @@
option and the password. If you omit the
<replaceable>password</replaceable> value following the
<option>--password</option> or <option>-p</option> option
- on the command line, you are prompted for one. The
- password should be omitted on SysV-based UNIX systems, as
- the password may be displayed in the output of
- <literal>ps</literal>.
+ on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3145,6 +3382,12 @@
<option>-p</option> option on the command line, you are
prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3213,6 +3456,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -3937,6 +4186,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -4344,6 +4599,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -5271,6 +5532,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -6015,6 +6282,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -6726,8 +6999,15 @@
<para>
The password to use when connecting to the server. Note
that the password value is not optional for this option,
- unlike for other MySQL programs.
+ unlike for other MySQL programs. You can use an option
+ file to avoid giving the password on the command line.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7087,6 +7367,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7456,6 +7742,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -7815,6 +8107,12 @@
<option>--password</option> or <option>-p</option> option
on the command line, you are prompted for one.
</para>
+
+ <para>
+ Specifying a password on the command line should be
+ considered insecure. See
+ <xref linkend="password-security"/>.
+ </para>
</listitem>
<listitem>
@@ -8068,223 +8366,6 @@
</section>
- <section id="fake-id-for-myisamlog-manpage-section-wrapper">
-
- <title>fake title for myisamlog manpage section wrapper</title>
-
- <refentry id="myisamlog">
-
- <indexterm>
- <primary><command>myisamlog</command></primary>
- </indexterm>
-
- <refmeta>
- <refentrytitle><command>myisamlog</command></refentrytitle>
-
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">MySQL Database System</refmiscinfo>
- <refmiscinfo class="source">MySQL</refmiscinfo>
- <refmiscinfo class="version">¤t-series;</refmiscinfo>
- <refmiscinfo class="refman">&title-myisamlog-for-manual;</refmiscinfo>
- </refmeta>
-
- <refnamediv>
- <refname>myisamlog</refname>
-
- <refpurpose>&title-myisamlog-for-manpage;</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</command>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsection id="myisamlog-description">
-
- <title>Description</title>
-
- <para>
- <command>myisamlog</command> processes the contents of a
- <literal>MyISAM</literal> log file.
- </para>
-
- <para>
- Invoke <command>myisamlog</command> like this:
- </para>
-
-<programlisting>
-shell> <userinput>myisamlog [<replaceable>options</replaceable>] [<replaceable>logfile-name</replaceable> [<replaceable>tbl_name</replaceable>] ...]</userinput>
-</programlisting>
-
- <para>
- The normal operation is update (<option>-u</option>). If a
- recovery is done (<option>-r</option>), all writes and
- possibly updates and deletes are done and errors are only
- counted. If no logfile name is given,
- <filename>myisam.log</filename> is used. If table names are
- named on the command line, only those tables are updated.
- </para>
-
- <para>
- <command>myisamlog</command> understands the following
- options:
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para>
- <option>-?</option>, <option>-I</option>
- </para>
-
- <para>
- Display a help message and exit.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-c <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Do only <replaceable>N</replaceable> commands.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-f <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Specify the maximum number of open files.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-F <replaceable>filepath/</replaceable></option>
- </para>
-
- <para>
- TODO
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-i</option>
- </para>
-
- <para>
- Display extra information before exiting.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-o <replaceable>offset</replaceable></option>
- </para>
-
- <para>
- Specify the starting offset.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-p <replaceable>N</replaceable></option>
- </para>
-
- <para>
- Remove <replaceable>N</replaceable> components from path.
- </para>
- </listitem>
-
-<!--
- <listitem>
- <para>
- <option>-P</option>
- </para>
-
- <para>
- UNKNOWN
- </para>
- </listitem>
--->
-
- <listitem>
- <para>
- <option>-r</option>
- </para>
-
- <para>
- Recover.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-R <replaceable>record-pos-file
- record-pos</replaceable></option>
- </para>
-
- <para>
- Specify record position file and record position.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-u</option>
- </para>
-
- <para>
- Update.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-v</option>
- </para>
-
- <para>
- Verbose mode. Produce more output. This option can be
- given multiple times to produce more and more output.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-w <replaceable>write-file</replaceable></option>
- </para>
-
- <para>
- Specify write file.
- </para>
- </listitem>
-
- <listitem>
- <para>
- <option>-V</option>
- </para>
-
- <para>
- Display version information.
- </para>
- </listitem>
-
- </itemizedlist>
-
- </refsection>
-
- </refentry>
-
- </section>
-
<section id="fake-id-for-perror-manpage-section-wrapper">
<title>fake title for perror manpage section wrapper</title>
Modified: trunk/refman-5.1/database-administration.xml
===================================================================
--- trunk/refman-5.1/database-administration.xml 2006-01-13 20:10:16 UTC (rev 814)
+++ trunk/refman-5.1/database-administration.xml 2006-01-13 20:11:16 UTC (rev 815)
@@ -717,6 +717,7 @@
<refmeta>
<refentrytitle><command>mysqld_safe</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -726,11 +727,13 @@
<refnamediv>
<refname>mysqld_safe</refname>
+
<refpurpose>&title-mysqld-safe-for-manpage;</refpurpose>
</refnamediv>
<refnamediv>
<refname>safe_mysqld</refname>
+
<refpurpose>&title-safe-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -1274,6 +1277,7 @@
<refmeta>
<refentrytitle><command>mysql.server</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1283,6 +1287,7 @@
<refnamediv>
<refname>mysql.server</refname>
+
<refpurpose>&title-mysql-server-for-manpage;</refpurpose>
</refnamediv>
@@ -1376,6 +1381,7 @@
<refmeta>
<refentrytitle><command>mysqld_multi</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1385,6 +1391,7 @@
<refnamediv>
<refname>mysqld_multi</refname>
+
<refpurpose>&title-mysqld-multi-for-manpage;</refpurpose>
</refnamediv>
@@ -1941,6 +1948,7 @@
<refmeta>
<refentrytitle><command>mysqlmanager</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -1950,6 +1958,7 @@
<refnamediv>
<refname>mysqlmanager</refname>
+
<refpurpose>&title-instance-manager-for-manpage;</refpurpose>
</refnamediv>
@@ -2778,6 +2787,7 @@
<refmeta>
<refentrytitle><command>mysqld</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -2787,6 +2797,7 @@
<refnamediv>
<refname>mysqld</refname>
+
<refpurpose>&title-mysqld-for-manpage;</refpurpose>
</refnamediv>
@@ -11205,6 +11216,7 @@
<refmeta>
<refentrytitle><command>mysql_fix_privilege_tables</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -11214,6 +11226,7 @@
<refnamediv>
<refname>mysql_fix_privilege_tables</refname>
+
<refpurpose>&title-mysql-fix-privilege-tables-for-manpage;</refpurpose>
</refnamediv>
@@ -17382,13 +17395,17 @@
</programlisting>
<para>
- This is convenient but insecure, because your password
- becomes visible to system status programs such as
- <command>ps</command> that may be invoked by other users to
- display command lines. MySQL clients typically overwrite the
- command-line password argument with zeros during their
- initialization sequence, but there is still a brief interval
- during which the value is visible.
+ This is convenient <emphasis>but insecure</emphasis>,
+ because your password becomes visible to system status
+ programs such as <command>ps</command> that may be invoked
+ by other users to display command lines. MySQL clients
+ typically overwrite the command-line password argument with
+ zeros during their initialization sequence. However, there
+ is still a brief interval during which the value is visible.
+ On some systems this strategy is ineffective, anyway, and
+ the password remains visible to <command>ps</command>.
+ (SystemV Unix systems and perhaps others are subject to this
+ problem.)
</para>
</listitem>
@@ -17462,15 +17479,16 @@
<para>
Store your password in the <literal>MYSQL_PWD</literal>
environment variable. This method of specifying your MySQL
- password must be considered extremely insecure and should
- not be used. Some versions of <command>ps</command> include
- an option to display the environment of running processes.
- If you set <literal>MYSQL_PWD</literal>, your password is
- exposed to any other user who runs <command>ps</command>.
- Even on systems without such a version of
- <command>ps</command>, it is unwise to assume that there are
- no other methods by which users can examine process
- environments. See <xref linkend="environment-variables"/>.
+ password must be considered <emphasis>extremely
+ insecure</emphasis> and should not be used. Some versions of
+ <command>ps</command> include an option to display the
+ environment of running processes. If you set
+ <literal>MYSQL_PWD</literal>, your password is exposed to
+ any other user who runs <command>ps</command>. Even on
+ systems without such a version of <command>ps</command>, it
+ is unwise to assume that there are no other methods by which
+ users can examine process environments. See
+ <xref linkend="environment-variables"/>.
</para>
</listitem>
@@ -19372,6 +19390,7 @@
<refmeta>
<refentrytitle><command>myisamchk</command></refentrytitle>
+
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">MySQL Database System</refmiscinfo>
<refmiscinfo class="source">MySQL</refmiscinfo>
@@ -19381,6 +19400,7 @@
<refnamediv>
<refname>myisamchk</refname>
+
<refpurpose>&title-myisamchk-for-manpage;</refpurpose>
</refnamediv>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r815 - in trunk: . refman-4.1 refman-5.0 refman-5.1 | paul | 13 Jan |
