← Back to branch summary

~mathiaz/ubuntu/lucid/mysql-dfsg-5.1/zap-bug-552053

« back to all changes in this revision

Viewing changes to man/mysqldump.1

  • Committer: Bazaar Package Importer
  • Author(s): Mathias Gug
  • Date: 2009-06-25 12:55:45 UTC
  • mfrom: (1.1.2 upstream) (0.1.3 experimental)
  • Revision ID: james.westby@ubuntu.com-20090625125545-m8ogs96zzsri74xe
Tags: 5.1.34-1ubuntu1
https://launchpad.net/bugs/319843
https://launchpad.net/bugs/259477
https://launchpad.net/bugs/310211
https://launchpad.net/bugs/201799
https://launchpad.net/bugs/316974
http://bugs.debian.org/314785
http://bugs.debian.org/324834
http://bugs.debian.org/435165
http://bugs.debian.org/444216
https://launchpad.net/bugs/344816
https://launchpad.net/bugs/323755
* Merge from debian experimental (and 5.0 from main), remaining changes:
  - debian/mysql-server-5.1.config:
    + ask for MySQL root password at priority high instead of medium so
      that the password prompt is seen on a default install. (LP: #319843)
    + don't ask for root password when upgrading from a 5.0 install.
  - debian/control:
    + Make libmysqlclient16-dev a transitional package depending on
      libmysqlclient-dev.
    + Make libmysqlclient-dev conflict with libmysqlclient15-dev.
    + Don't build mysql-server, mysql-client, mysql-common and
      libmysqlclient15-dev binary packages since they're still provided
      by mysql-dfsg-5.0.
    + Make mysql-{client,server}-5.1 packages conflict and
      replace mysql-{client,server}-5.0, but not provide
      mysql-{client,server}.
    + Depend on a specific version of mysql-common rather than the src
      version of mysql-dfsg-5.1 since mysql-common is currently part of
      mysql-dfsg-5.0.
    + Lower mailx from a Recommends to a Suggests to avoid pulling in
      a full MTA on all installs of mysql-server. (LP: #259477)
  - debian/rules:
    + added -fno-strict-aliasing to CFLAGS to get around mysql testsuite
      build failures.
    + install mysql-test and sql-bench to /usr/share/mysql/ rather than
      /usr/.
  - debian/additions/debian-start.inc.sh: support ANSI mode (LP: #310211)
  - Add AppArmor profile:
    - debian/apparmor-profile: apparmor profile.
    - debian/rules, debian/mysql-server-5.0.files: install apparmor profile.
    - debian/mysql-server-5.0.dirs: add etc/apparmor.d/force-complain
    - debian/mysql-server-5.0.postrm: remove symlink in force-complain/ on
      purge.
    - debian/mysql-server-5.1.README.Debian: add apparmor documentation.
    - debian/additions/my.cnf: Add warning about apparmor. (LP: #201799)
    - debian/mysql-server-5.1.postinst: reload apparmor profiles.
  - debian/additions/my.cnf: remove language option. Error message files are
    located in a different directory in MySQL 5.0. Setting the language
    option to use /usr/share/mysql/english breaks 5.0. Both 5.0 and 5.1
    use a default value that works. (LP: #316974)
  - debian/mysql-server-5.1.mysql.init:
    + Clearly indicate that we do not support running multiple instances
      of mysqld by duplicating the init script.
      (closes: #314785, #324834, #435165, #444216)
    + Properly parameterize all existing references to the mysql config
      file (/etc/mysql/my.cnf).
  - debian/mysql-server-5.0.postinst: Clear out the second password
    when setting up mysql. (LP: #344816)
  - mysql-server-core-5.1 package for files needed by Akonadi:
    + debian/control: create mysql-server-core-5.1 package.
    + debian/mysql-server-core-5.1.files, debian/mysql-server-5.1.files:
      move core mysqld files to mysql-server-core-5.1 package.
  - Don't package sql-bench and mysql-test file.
* Dropped changes:
  - debian/patches/92_ssl_test_cert.dpatch: certificate expiration in
    test suite (LP: #323755). Included upstream.
* Dropped from 5.0:
  - apparmor profile:
    - debian/control: Recommends apparmor >= 2.1+1075-0ubuntu6. All version
      of apparmor-profile (>hardy) are higher than this version.
    - debian/mysql-server-5.0.preinst: create symlink for force-complain/
      on pre-feisty upgrades, upgrades where apparmor-profiles profile is
      unchanged (ie non-enforcing) and upgrades where the profile
      doesn't exist. Support for pre-hardy upgrades is no longer needed.
* debian/mysql-server-5.1.postinst: fix debian-sys-maint user creation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/mysqldump.1
1
1
.\"     Title: \fBmysqldump\fR
2
2
.\"    Author: 
3
3
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
4
 
.\"      Date: 01/19/2009
 
4
.\"      Date: 03/31/2009
5
5
.\"    Manual: MySQL Database System
6
6
.\"    Source: MySQL 5.1
7
7
.\"
8
 
.TH "\fBMYSQLDUMP\fR" "1" "01/19/2009" "MySQL 5.1" "MySQL Database System"
 
8
.TH "\fBMYSQLDUMP\fR" "1" "03/31/2009" "MySQL 5.1" "MySQL Database System"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
70
70
fall into this category. For example, use of
71
71
\fB\-\-opt\fR
72
72
is the same as specifying
73
 
\fB\-\-add\-drop\-table \-\-add\-locks \-\-create\-options \-\-disable\-keys \-\-extended\-insert \-\-lock\-tables \-\-quick \-\-set\-charset\fR. Note that as of MySQL 5.1, all of the options that
 
73
\fB\-\-add\-drop\-table\fR
 
74
\fB\-\-add\-locks\fR
 
75
\fB\-\-create\-options\fR
 
76
\fB\-\-disable\-keys\fR
 
77
\fB\-\-extended\-insert\fR
 
78
\fB\-\-lock\-tables\fR
 
79
\fB\-\-quick\fR
 
80
\fB\-\-set\-charset\fR. Note that all of the options that
74
81
\fB\-\-opt\fR
75
82
stands for also are on by default because
76
83
\fB\-\-opt\fR
88
95
except for some features, use the
89
96
\fB\-\-skip\fR
90
97
option for each feature. For example, to disable extended inserts and memory buffering, use
91
 
\fB\-\-opt \-\-skip\-extended\-insert \-\-skip\-quick\fR. (As of MySQL 5.1,
92
 
\fB\-\-skip\-extended\-insert \-\-skip\-quick\fR
 
98
\fB\-\-opt\fR
 
99
\fB\-\-skip\-extended\-insert\fR
 
100
\fB\-\-skip\-quick\fR. (As of MySQL 5.1,
 
101
\fB\-\-skip\-extended\-insert\fR
 
102
\fB\-\-skip\-quick\fR
93
103
is sufficient because
94
104
\fB\-\-opt\fR
95
105
is on by default.)
98
108
To reverse
99
109
\fB\-\-opt\fR
100
110
for all features except index disabling and table locking, use
101
 
\fB\-\-skip\-opt \-\-disable\-keys \-\-lock\-tables\fR.
 
111
\fB\-\-skip\-opt\fR
 
112
\fB\-\-disable\-keys\fR
 
113
\fB\-\-lock\-tables\fR.
102
114
.sp
103
115
.RE
104
116
.PP
105
117
When you selectively enable or disable the effect of a group option, order is important because options are processed first to last. For example,
106
 
\fB\-\-disable\-keys \-\-lock\-tables \-\-skip\-opt\fR
 
118
\fB\-\-disable\-keys\fR
 
119
\fB\-\-lock\-tables\fR
 
120
\fB\-\-skip\-opt\fR
107
121
would not have the intended effect; it is the same as
108
122
\fB\-\-skip\-opt\fR
109
123
by itself.
173
187
and
174
188
UNLOCK TABLES
175
189
statements. This results in faster inserts when the dump file is reloaded. See
176
 
Section\ 2.19, \(lqSpeed of INSERT Statements\(rq.
 
190
Section\ 7.2.20, \(lqSpeed of INSERT Statements\(rq.
177
191
.TP 3n
178
192
\(bu
179
193
\fB\-\-all\-databases\fR,
203
217
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
204
218
.sp
205
219
The directory where character sets are installed. See
206
 
Section\ 2, \(lqThe Character Set Used for Data and Sorting\(rq.
 
220
Section\ 9.2, \(lqThe Character Set Used for Data and Sorting\(rq.
207
221
.TP 3n
208
222
\(bu
209
223
\fB\-\-comments\fR,
251
265
no_key_options,
252
266
no_table_options, or
253
267
no_field_options. To use several values, separate them by commas. These values have the same meaning as the corresponding options for setting the server SQL mode. See
254
 
Section\ 1.7, \(lqServer SQL Modes\(rq.
 
268
Section\ 5.1.7, \(lqServer SQL Modes\(rq.
255
269
.sp
256
270
This option does not guarantee compatibility with other servers. It only enables those SQL mode values that are currently available for making dump output more compatible. For example,
257
271
\fB\-\-compatible=oracle\fR
318
332
Use
319
333
\fIcharset_name\fR
320
334
as the default character set. See
321
 
Section\ 2, \(lqThe Character Set Used for Data and Sorting\(rq. If no character set is specified,
 
335
Section\ 9.2, \(lqThe Character Set Used for Data and Sorting\(rq. If no character set is specified,
322
336
\fBmysqldump\fR
323
337
uses
324
338
utf8, and earlier versions use
401
415
\fB\-T\fR
402
416
option and have the same meaning as the corresponding clauses for
403
417
LOAD DATA INFILE. See
404
 
Section\ 2.6, \(lqLOAD DATA INFILE Syntax\(rq.
 
418
Section\ 12.2.6, \(lqLOAD DATA INFILE Syntax\(rq.
405
419
.TP 3n
406
420
\(bu
407
421
\fB\-\-first\-slave\fR,
481
495
\(bu
482
496
\fB\-\-ignore\-table=\fR\fB\fIdb_name.tbl_name\fR\fR
483
497
.sp
484
 
Do not dump the given table, which must be specified using both the database and table names. To ignore multiple tables, use this option multiple times.
 
498
Do not dump the given table, which must be specified using both the database and table names. To ignore multiple tables, use this option multiple times. This option also can be used to ignore views.
485
499
.TP 3n
486
500
\(bu
487
501
\fB\-\-insert\-ignore\fR
499
513
\fB\-T\fR
500
514
option and has the same meaning as the corresponding clause for
501
515
LOAD DATA INFILE. See
502
 
Section\ 2.6, \(lqLOAD DATA INFILE Syntax\(rq.
 
516
Section\ 12.2.6, \(lqLOAD DATA INFILE Syntax\(rq.
503
517
.TP 3n
504
518
\(bu
505
519
\fB\-\-lock\-all\-tables\fR,
539
553
.sp
540
554
Use this option to dump a master replication server to produce a dump file that can be used to set up another server as a slave of the master. It causes the dump output to include a
541
555
CHANGE MASTER TO
542
 
statement that indicates the binary log coordinates (filename and position) of the dumped server. These are the master server coordinates from which the slave should start replicating.
 
556
statement that indicates the binary log coordinates (file name and position) of the dumped server. These are the master server coordinates from which the slave should start replicating.
543
557
.sp
544
558
If the option value is 2, the
545
559
CHANGE MASTER TO
660
674
\fB\-\-opt\fR
661
675
.sp
662
676
This option is shorthand; it is the same as specifying
663
 
\fB\-\-add\-drop\-table \-\-add\-locks \-\-create\-options \-\-disable\-keys \-\-extended\-insert \-\-lock\-tables \-\-quick \-\-set\-charset\fR. It should give you a fast dump operation and produce a dump file that can be reloaded into a MySQL server quickly.
 
677
\fB\-\-add\-drop\-table\fR
 
678
\fB\-\-add\-locks\fR
 
679
\fB\-\-create\-options\fR
 
680
\fB\-\-disable\-keys\fR
 
681
\fB\-\-extended\-insert\fR
 
682
\fB\-\-lock\-tables\fR
 
683
\fB\-\-quick\fR
 
684
\fB\-\-set\-charset\fR. It should give you a fast dump operation and produce a dump file that can be reloaded into a MySQL server quickly.
664
685
.sp
665
686
\fIThe \fR\fI\fB\-\-opt\fR\fR\fI option is enabled by default. Use \fR\fI\fB\-\-skip\-opt\fR\fR\fI to disable it.\fR
666
687
See the discussion at the beginning of this section for information about selectively enabling or disabling certain of the options affected by
690
711
option on the command line, you are prompted for one.
691
712
.sp
692
713
Specifying a password on the command line should be considered insecure. See
693
 
Section\ 5.6, \(lqKeeping Passwords Secure\(rq.
 
714
Section\ 5.5.6.2, \(lqEnd\-User Guidelines for Password Security\(rq.
694
715
.TP 3n
695
716
\(bu
696
717
\fB\-\-pipe\fR,
708
729
\fB\-\-protocol={TCP|SOCKET|PIPE|MEMORY}\fR
709
730
.sp
710
731
The connection protocol to use for connecting to the server. It is useful when the other connection parameters normally would cause a protocol to be used other than the one you want. For details on the allowable values, see
711
 
Section\ 2.2, \(lqConnecting to the MySQL Server\(rq.
 
732
Section\ 4.2.2, \(lqConnecting to the MySQL Server\(rq.
712
733
.TP 3n
713
734
\(bu
714
735
\fB\-\-quick\fR,
757
778
\fB\-\-routines\fR,
758
779
\fB\-R\fR
759
780
.sp
760
 
Dump stored routines (functions and procedures) from the dumped databases. Use of this option requires the
 
781
Dump stored routines (procedures and functions) from the dumped databases. Use of this option requires the
761
782
SELECT
762
783
privilege for the
763
784
mysql.proc
868
889
Options that begin with
869
890
\fB\-\-ssl\fR
870
891
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates. See
871
 
Section\ 5.7.3, \(lqSSL Command Options\(rq.
 
892
Section\ 5.5.7.3, \(lqSSL Command Options\(rq.
872
893
.TP 3n
873
894
\(bu
874
895
\fB\-\-tab=\fR\fB\fIpath\fR\fR,
993
1014
NULL
994
1015
value, an empty string, and the string value
995
1016
\'NULL'
996
 
are distinguished from one another in the output generated by this option as follows:
 
1017
are distinguished from one another in the output generated by this option as follows.
997
1018
.TS
998
1019
allbox tab(:);
999
1020
l l
1177
1198
For point\-in\-time recovery (also known as
1178
1199
\(lqroll\-forward,\(rq
1179
1200
when you need to restore an old backup and replay the changes that happened since that backup), it is often useful to rotate the binary log (see
1180
 
Section\ 2.4, \(lqThe Binary Log\(rq) or at least know the binary log coordinates to which the dump corresponds:
 
1201
Section\ 5.2.4, \(lqThe Binary Log\(rq) or at least know the binary log coordinates to which the dump corresponds:
1181
1202
.sp
1182
1203
.RS 3n
1183
1204
.nf
1203
1224
storage engine.
1204
1225
.PP
1205
1226
For more information on making backups, see
1206
 
Section\ 1, \(lqDatabase Backups\(rq, and
1207
 
Section\ 2, \(lqExample Backup and Recovery Strategy\(rq.
 
1227
Section\ 6.1, \(lqDatabase Backups\(rq, and
 
1228
Section\ 6.2, \(lqExample Backup and Recovery Strategy\(rq.
1208
1229
.PP
1209
1230
If you encounter problems backing up views, please read the section that covers restrictions on views which describes a workaround for backing up views when this fails due to insufficient privileges. See
1210
 
Section\ 4, \(lqRestrictions on Views\(rq.
 
1231
Section\ D.4, \(lqRestrictions on Views\(rq.
1211
1232
.SH "COPYRIGHT"
1212
1233
.PP
1213
 
Copyright 2007\-2008 MySQL AB, 2008 Sun Microsystems, Inc.
 
1234
Copyright 2007\-2008 MySQL AB, 2009 Sun Microsystems, Inc.
1214
1235
.PP
1215
 
This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
 
1236
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.
1216
1237
.PP
1217
1238
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.
1218
1239
.PP