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

NAME

6       pmempool-dump - dump user data from persistent memory pool
7

SYNOPSIS

9              $ pmempool dump [<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 dump command dumps user data  from  specified
17       pool file.  The output format may be either binary or hexadecimal.
18
19       By default the output format is hexadecimal.
20
21       By  default  data is dumped to standard output.  It is possible to dump
22       data to other file by specifying -o option.  In this case data will  be
23       appended to this file.
24
25       Using  -r option you can specify number of blocks/bytes/data chunks us‐
26       ing special text format.  See RANGE section for details.
27
28   Available options:
29       -b, --binary
30
31       Dump data in binary format.
32
33       -r, --range <range>
34
35       Range of pool file to dump.  This may be number of blocks for blk  pool
36       type  or  either  number of bytes or number of data chunks for log pool
37       type.
38
39       -c, --chunk <size>
40
41       Size of chunk for log pool type.  See pmemlog_walk(3) in  libpmemlog(7)
42       for details.
43
44       -o, --output <file>
45
46       Name of output file.
47
48       -h, --help
49
50       Display help message and exit.
51

RANGE

53       Using -r, –range option it is possible to dump only a range of user da‐
54       ta.  This section describes valid format of <range> string.
55
56       You can specify multiple ranges separated by commas.
57
58       <first>-<last>
59
60       All blocks/bytes/data chunks from <first> to <last> will be dumped.
61
62       -<last>
63
64       All blocks/bytes/data chunks up to <last> will be dumped.
65
66       <first>-
67
68       All blocks/bytes/data chunks starting from <first> will be dumped.
69
70       <number>
71
72       Only <number> block/byte/data chunk will be dumped.
73

EXAMPLE

75              $ pmempool dump pool.bin
76
77       Dump user data from pool.bin file to standard output
78
79              $ pmempool dump -o output.bin -r1,10-100 pool_blk.bin
80
81       Dump block number 1 and blocks from 10 to 100  from  pool_blk.bin  con‐
82       taining pmem blk pool to output.bin file
83
84              $ pmempool dump -r 1K-2K pool.bin
85
86       Dump data form 1K to 2K from pool.bin file.
87

SEE ALSO

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