初版
This commit is contained in:
root
539
build/lib/mysql/man/man1/mysqlhotcopy.1
Normal file
539
build/lib/mysql/man/man1/mysqlhotcopy.1
Normal file
@@ -0,0 +1,539 @@
|
||||
'\" t
|
||||
.\" Title: \fBmysqlhotcopy\fR
|
||||
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
|
||||
.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/>
|
||||
.\" Date: 11/04/2013
|
||||
.\" Manual: MySQL Database System
|
||||
.\" Source: MySQL 5.1
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "\FBMYSQLHOTCOPY\FR" "1" "11/04/2013" "MySQL 5\&.1" "MySQL Database System"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" mysqlhotcopy
|
||||
.\" dumping: databases and tables
|
||||
.\" backups: databases and tables
|
||||
.\" databases: dumping
|
||||
.\" tables: dumping
|
||||
.SH "NAME"
|
||||
mysqlhotcopy \- a database backup program
|
||||
.SH "SYNOPSIS"
|
||||
.HP \w'\fBmysqlhotcopy\ \fR\fB\fIarguments\fR\fR\ 'u
|
||||
\fBmysqlhotcopy \fR\fB\fIarguments\fR\fR
|
||||
.SH "DESCRIPTION"
|
||||
.PP
|
||||
\fBmysqlhotcopy\fR
|
||||
is a Perl script that was originally written and contributed by Tim Bunce\&. It uses
|
||||
FLUSH TABLES,
|
||||
LOCK TABLES, and
|
||||
cp
|
||||
or
|
||||
scp
|
||||
to make a database backup\&. It is a fast way to make a backup of the database or single tables, but it can be run only on the same machine where the database directories are located\&.
|
||||
\fBmysqlhotcopy\fR
|
||||
works only for backing up
|
||||
MyISAM
|
||||
and
|
||||
ARCHIVE
|
||||
tables\&. It runs on Unix and NetWare\&.
|
||||
.PP
|
||||
To use
|
||||
\fBmysqlhotcopy\fR, you must have read access to the files for the tables that you are backing up, the
|
||||
SELECT
|
||||
privilege for those tables, the
|
||||
RELOAD
|
||||
privilege (to be able to execute
|
||||
FLUSH TABLES), and the
|
||||
LOCK TABLES
|
||||
privilege (to be able to lock the tables)\&.
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fI/path/to/new_directory\fR\fR\fB]\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
shell> \fBmysqlhotcopy \fR\fB\fIdb_name_1\fR\fR\fB \&.\&.\&. \fR\fB\fIdb_name_n\fR\fR\fB \fR\fB\fI/path/to/new_directory\fR\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
Back up tables in the given database that match a regular expression:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./\fR\fB\fIregex\fR\fR\fB/\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
The regular expression for the table name can be negated by prefixing it with a tilde (\(lq~\(rq):
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./~\fR\fB\fIregex\fR\fR\fB/\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBmysqlhotcopy\fR
|
||||
supports the following options, which can be specified on the command line or in the
|
||||
[mysqlhotcopy]
|
||||
and
|
||||
[client]
|
||||
groups of an option file\&. For information about option files, see
|
||||
Section\ \&4.2.3.3, \(lqUsing Option Files\(rq\&.
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: help option
|
||||
.\" help option: mysqlhotcopy
|
||||
\fB\-\-help\fR,
|
||||
\fB\-?\fR
|
||||
.sp
|
||||
Display a help message and exit\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: addtodest option
|
||||
.\" addtodest option: mysqlhotcopy
|
||||
\fB\-\-addtodest\fR
|
||||
.sp
|
||||
Do not rename target directory (if it exists); merely add files to it\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: allowold option
|
||||
.\" allowold option: mysqlhotcopy
|
||||
\fB\-\-allowold\fR
|
||||
.sp
|
||||
Do not abort if a target exists; rename it by adding an
|
||||
_old
|
||||
suffix\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: checkpoint option
|
||||
.\" checkpoint option: mysqlhotcopy
|
||||
\fB\-\-checkpoint=\fR\fB\fIdb_name\fR\fR\fB\&.\fR\fB\fItbl_name\fR\fR
|
||||
.sp
|
||||
Insert checkpoint entries into the specified database
|
||||
\fIdb_name\fR
|
||||
and table
|
||||
\fItbl_name\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: chroot option
|
||||
.\" chroot option: mysqlhotcopy
|
||||
\fB\-\-chroot=\fR\fB\fIpath\fR\fR
|
||||
.sp
|
||||
Base directory of the
|
||||
\fBchroot\fR
|
||||
jail in which
|
||||
\fBmysqld\fR
|
||||
operates\&. The
|
||||
\fIpath\fR
|
||||
value should match that of the
|
||||
\fB\-\-chroot\fR
|
||||
option given to
|
||||
\fBmysqld\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: debug option
|
||||
.\" debug option: mysqlhotcopy
|
||||
\fB\-\-debug\fR
|
||||
.sp
|
||||
Enable debug output\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: dryrun option
|
||||
.\" dryrun option: mysqlhotcopy
|
||||
\fB\-\-dryrun\fR,
|
||||
\fB\-n\fR
|
||||
.sp
|
||||
Report actions without performing them\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: flushlog option
|
||||
.\" flushlog option: mysqlhotcopy
|
||||
\fB\-\-flushlog\fR
|
||||
.sp
|
||||
Flush logs after all tables are locked\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: host option
|
||||
.\" host option: mysqlhotcopy
|
||||
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
|
||||
\fB\-h \fR\fB\fIhost_name\fR\fR
|
||||
.sp
|
||||
The host name of the local host to use for making a TCP/IP connection to the local server\&. By default, the connection is made to
|
||||
localhost
|
||||
using a Unix socket file\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: keepold option
|
||||
.\" keepold option: mysqlhotcopy
|
||||
\fB\-\-keepold\fR
|
||||
.sp
|
||||
Do not delete previous (renamed) target when done\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: method option
|
||||
.\" method option: mysqlhotcopy
|
||||
\fB\-\-method=\fR\fB\fIcommand\fR\fR
|
||||
.sp
|
||||
The method for copying files (cp
|
||||
or
|
||||
scp)\&. The default is
|
||||
cp\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: noindices option
|
||||
.\" noindices option: mysqlhotcopy
|
||||
\fB\-\-noindices\fR
|
||||
.sp
|
||||
Do not include full index files for
|
||||
MyISAM
|
||||
tables in the backup\&. This makes the backup smaller and faster\&. The indexes for reloaded tables can be reconstructed later with
|
||||
\fBmyisamchk \-rq\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: password option
|
||||
.\" password option: mysqlhotcopy
|
||||
\fB\-\-password=\fR\fB\fIpassword\fR\fR,
|
||||
\fB\-p\fR\fB\fIpassword\fR\fR
|
||||
.sp
|
||||
The password to use when connecting to the server\&. The password value is not optional for this option, unlike for other MySQL programs\&.
|
||||
.sp
|
||||
Specifying a password on the command line should be considered insecure\&. See
|
||||
Section\ \&6.1.2.1, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: port option
|
||||
.\" port option: mysqlhotcopy
|
||||
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
|
||||
\fB\-P \fR\fB\fIport_num\fR\fR
|
||||
.sp
|
||||
The TCP/IP port number to use when connecting to the local server\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: quiet option
|
||||
.\" quiet option: mysqlhotcopy
|
||||
\fB\-\-quiet\fR,
|
||||
\fB\-q\fR
|
||||
.sp
|
||||
Be silent except for errors\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: record_log_pos option
|
||||
.\" record_log_pos option: mysqlhotcopy
|
||||
\fB\-\-record_log_pos=\fR\fB\fIdb_name\fR\fR\fB\&.\fR\fB\fItbl_name\fR\fR
|
||||
.sp
|
||||
Record master and slave status in the specified database
|
||||
\fIdb_name\fR
|
||||
and table
|
||||
\fItbl_name\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: regexp option
|
||||
.\" regexp option: mysqlhotcopy
|
||||
\fB\-\-regexp=\fR\fB\fIexpr\fR\fR
|
||||
.sp
|
||||
Copy all databases with names that match the given regular expression\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: resetmaster option
|
||||
.\" resetmaster option: mysqlhotcopy
|
||||
\fB\-\-resetmaster\fR
|
||||
.sp
|
||||
Reset the binary log after locking all the tables\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: resetslave option
|
||||
.\" resetslave option: mysqlhotcopy
|
||||
\fB\-\-resetslave\fR
|
||||
.sp
|
||||
Reset the
|
||||
master\&.info
|
||||
file after locking all the tables\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: socket option
|
||||
.\" socket option: mysqlhotcopy
|
||||
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
|
||||
\fB\-S \fR\fB\fIpath\fR\fR
|
||||
.sp
|
||||
The Unix socket file to use for connections to
|
||||
localhost\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: suffix option
|
||||
.\" suffix option: mysqlhotcopy
|
||||
\fB\-\-suffix=\fR\fB\fIstr\fR\fR
|
||||
.sp
|
||||
The suffix to use for names of copied databases\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: tmpdir option
|
||||
.\" tmpdir option: mysqlhotcopy
|
||||
\fB\-\-tmpdir=\fR\fB\fIpath\fR\fR
|
||||
.sp
|
||||
The temporary directory\&. The default is
|
||||
/tmp\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
.\" mysqlhotcopy: user option
|
||||
.\" user option: mysqlhotcopy
|
||||
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
|
||||
\fB\-u \fR\fB\fIuser_name\fR\fR
|
||||
.sp
|
||||
The MySQL user name to use when connecting to the server\&.
|
||||
.RE
|
||||
.PP
|
||||
Use
|
||||
perldoc
|
||||
for additional
|
||||
\fBmysqlhotcopy\fR
|
||||
documentation, including information about the structure of the tables needed for the
|
||||
\fB\-\-checkpoint\fR
|
||||
and
|
||||
\fB\-\-record_log_pos\fR
|
||||
options:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
shell> \fBperldoc mysqlhotcopy\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "COPYRIGHT"
|
||||
.br
|
||||
.PP
|
||||
Copyright \(co 1997, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.PP
|
||||
This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
|
||||
.PP
|
||||
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
||||
.PP
|
||||
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
|
||||
.sp
|
||||
.SH "SEE ALSO"
|
||||
For more information, please refer to the MySQL Reference Manual,
|
||||
which may already be installed locally and which is also available
|
||||
online at http://dev.mysql.com/doc/.
|
||||
.SH AUTHOR
|
||||
Oracle Corporation (http://dev.mysql.com/).
|
||||
Reference in New Issue
Block a user