1()                         PMDK Programmer's Manual                         ()
2
3
4

NAME

6       pmempool-check - check and repair persistent memory pool
7

SYNOPSIS

9              $ pmempool check [<options>] <file>
10

NOTE

12              NOTICE:  The  libpmemblk and libpmemlog libraries are deprecated
13              since PMDK 1.13.0 release.
14

DESCRIPTION

16       The pmempool invoked with check command checks consistency of  a  given
17       pool file.  If the pool file is consistent pmempool exits with 0 value.
18       If the pool file is not consistent non-zero error code is returned.
19
20       In case of any errors, the proper message is  printed.   The  verbosity
21       level may be increased using -v option.  The output messages may be al‐
22       so suppressed using -q option.
23
24       It is possible to try to fix encountered problems using -r option.   In
25       order  to be sure this will not corrupt your data you can either create
26       backup of the pool file using -b option or just  print  what  would  be
27       fixed without modifying original pool using -N option.
28
29              NOTE:  Currently,  checking the consistency of a pmemobj pool is
30              not supported.
31
32   Available options:
33       -r, --repair
34
35       Try to repair a pool file if possible.
36
37       -y, --yes
38
39       Answer yes on all questions.
40
41       -d, --dry-run
42
43       Don’t execute, just show what would be done.  Not supported  on  Device
44       DAX.
45
46       -N, --no-exec
47
48       Deprecated alias for dry-run.
49
50       -b, --backup <file>
51
52       Create  backup of a pool file before executing.  Terminate if it is not
53       possible to create a backup file.  This option requires -r option.
54
55       -a, --advanced
56
57       Perform advanced repairs.  This option enables more aggressive steps in
58       attempts to repair a pool.  This option requires -r, --repair.
59
60       -q, --quiet
61
62       Be quiet and don’t print any messages.
63
64       -v, --verbose
65
66       Be more verbose.
67
68       -h, --help
69
70       Display help message and exit.
71

EXAMPLE

73              $ pmempool check pool.bin
74
75       Check consistency of “pool.bin” pool file
76
77              $ pmempool check --repair --backup pool.bin.backup pool.bin
78
79       Check  consistency of “pool.bin” pool file, create backup and repair if
80       necessary.
81
82              $ pmempool check -rvN pool.bin
83
84       Check consistency of “pool.bin” pool file, print what would be repaired
85       with increased verbosity level.
86

SEE ALSO

88       pmempool(1),   libpmemblk(7),  libpmemlog(7),  libpmemobj(7),  libpmem‐
89       pool(7) and <https://pmem.io>
90
91
92
93PMDK -                            2023-06-05                                ()
Impressum