|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | COPYRIGHT | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
INNOCHECKSUM(1) MariaDB Database System INNOCHECKSUM(1)
innochecksum - offline InnoDB file checksum utility
innochecksum [options] file_name
innochecksum prints checksums for InnoDB files. This tool reads an
InnoDB tablespace file, calculates the checksum for each page,
compares the calculated checksum to the stored checksum, and
reports mismatches, which indicate damaged pages. It was
originally developed to speed up verifying the integrity of
tablespace files after power outages but can also be used after
file copies. Because checksum mismatches will cause InnoDB to
deliberately shut down a running server, it can be preferable to
use this tool rather than waiting for a server in production usage
to encounter the damaged pages.
innochecksum cannot be used on tablespace files that the server
already has open. For such files, you should use CHECK TABLE to
check tables within the tablespace.
If checksum mismatches are found, you would normally restore the
tablespace from backup or start the server and attempt to use
mariadb-dump to make a backup of the tables within the tablespace.
Invoke innochecksum like this:
shell> innochecksum [options] file_name
innochecksum supports the following options. For options that
refer to page numbers, the numbers are zero-based.
• -?, --help
Displays help and exits.
• -a num, --allow-mismatches=#
Maximum checksum mismatch allowed before innochecksum
terminates. Defaults to 0, which terminates on the first
mismatch.
• -c, --count
Print a count of the number of pages in the file.
• -e num, --end-page=#
End at this page number.
• -i, --per-page-details
Print out per-page detail information.
• -I, --info
Synonym for --help.
• -f, --leaf
Examine leaf index pages.
• -l fn, --log=fn
Log output to the specified filename, fn.
• -m num, --merge=#
Leaf page count if merge given number of consecutive pages.
• -n, --no-check
Ignore the checksum verification. Until MariaDB 10.6, must be
used with the --write option.
• -p num, --page-num=#
Check only this page number.
• -D name, --page-type-dump=name
Dump the page type info for each page in a tablespace.
• -S, --page-type-summary
Display a count of each page type in a tablespace.
• -s num, --start-page
Start at this page number.
• -u, --skip-corrupt
Skip corrupt pages.
• -C name, --strict-check=name
Specify the strict checksum algorithm. One of: crc32, innodb,
none. If not specified, validates against innodb, crc32 and
none. Removed in MariaDB 10.6.
• -w name, --write=name
Rewrite the checksum algorithm. One of crc32, innodb, none. An
exclusive lock is obtained during use. Use in conjunction with
the -no-check option to rewrite an invalid checksum. Removed
in MariaDB 10.6.
• -v, --verbose
Verbose mode; print a progress indicator every five seconds.
• -V, --version
Displays version information and exits.
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.,
2010-2025 MariaDB Foundation
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.
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.
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-1335 USA or see http://www.gnu.org/licenses/.
For more information, please refer to the MariaDB Knowledge Base,
available online at https://mariadb.com/kb/
MariaDB Foundation (http://www.mariadb.org/).
This page is part of the MariaDB (MariaDB database server)
project. Information about the project can be found at
⟨http://mariadb.org/⟩. If you have a bug report for this manual
page, see ⟨https://mariadb.com/kb/en/mariadb/reporting-bugs/⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/MariaDB/server⟩ on 2025-08-11. (At that time,
the date of the most recent commit that was found in the
repository was 2025-08-04.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
MariaDB 11.8 5 March 2025 INNOCHECKSUM(1)
Pages that refer to this page: innochecksum(1)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|