pmem Tools version 1.4

The PMDK repository on GitHub is the ultimate source of information on PMDK from release 2.0! For all questions and to submit eventual issues please follow to that repository. The PMDK documentation collected here should be valid up to the 1.13.1 release but is maintained only on a best-effort basis and may not reflect the latest state of the art.

NAME
SYNOPSIS
DESCRIPTION
EXAMPLE
SEE ALSO

NAME

pmempool-check - check and repair persistent memory pool

SYNOPSIS

$ pmempool check [<options>] <file>

DESCRIPTION

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.

EXAMPLE

$ 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.

SEE ALSO

pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), libpmempool(7) and https://pmem.io

The contents of this web site and the associated GitHub repositories are BSD-licensed open source.