To simplify transfer and management of backup data, you can
keep each backup in a single file (the backup image). The
backup-to-image option performs a
backup directly to a single file, or the options here can pack
an existing backup into a single file or unpack a single-file
backup to a full backup directory structure. For usage and
examples, see Section 3.3.5, “Making a Single-File Backup”.
mysqlbackup [STD-OPTIONS] [
image-to-backup-dirmysqlbackup [STD-OPTIONS] [
backup-dir-to-imagemysqlbackup [STD-OPTIONS] [
list-imagemysqlbackup [STD-OPTIONS] [
Packs an existing backup into a single file. Specify a
--backup-image value of
- (standard output) to stream an
existing backup directory structure to a tape device or
a command that transfers the backup to another server.
--backup-image parameter is either
- or an absolute path outside the
Unpacks an individual file or directory from a
single-file backup. For troubleshooting or restoration
operations that do not require the full set of backup
data. The resulting file or directory goes in the
current directory, or in
if specified. All files and directory contents in the
image with absolute path names are extracted into the
same absolute path names on the local system.
option can be used for selective extraction of a single
file or single directory in image. Specify the path as
it appears in the image.
option, along with
option can be used to extract a single file or single
directory into a user-specified file or directory
respectively. If the
is used, but
--dst-entry option is
omitted, then the selected file or directory is
extracted to the same path in the local file system.
The default destination for the extract is the current
working directory. It can be overridden by the
--backup-dir option. All the
files with relative pathnames in the image are extracted
to pathnames relative to the destination directory.
If the image contains some entries with absolute
pathnames, those entries are extracted to the same
absolute path names even if
--backup-dir option is specified. The
--dst-entry option must be
used to relocate an absolute pathname.