Scroll to navigation



pmempool-check - check and repair persistent memory pool


$ pmempool check [<options>] <file>


The pmempool invoked with check command checks consistency of a given pool file. If the pool file is consistent pmempool exits with 0 value. If the pool file is not consistent non-zero error code is returned.

In case of any errors, the proper message is printed. The verbosity level may be increased using -v option. The output messages may be also suppressed using -q option.

It is possible to try to fix encountered problems using -r option. In order to be sure this will not corrupt your data you can either create backup of the pool file using -b option or just print what would be fixed without modifying original pool using -N option.

NOTE: Currently, checking the consistency of a pmemobj pool is not supported.

Available options:

-r, --repair

Try to repair a pool file if possible.

-y, --yes

Answer yes on all questions.

-d, --dry-run

Don’t execute, just show what would be done. Not supported on Device DAX.

-N, --no-exec

Deprecated alias for dry-run.

-b, --backup <file>

Create backup of a pool file before executing. Terminate if it is not possible to create a backup file. This option requires -r option.

-a, --advanced

Perform advanced repairs. This option enables more aggressive steps in attempts to repair a pool. This option requires -r, --repair.

-q, --quiet

Be quiet and don’t print any messages.

-v, --verbose

Be more verbose.

-h, --help

Display help message and exit.


$ pmempool check pool.bin

Check consistency of “pool.bin” pool file

$ pmempool check --repair --backup pool.bin.backup pool.bin

Check consistency of “pool.bin” pool file, create backup and repair if necessary.

$ pmempool check -rvN pool.bin

Check consistency of “pool.bin” pool file, print what would be repaired with increased verbosity level.


pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), libpmempool(7) and <>

2020-10-28 PMDK - pmem Tools version 1.4