1PMEMPOOL-DUMP(1)           PMDK Programmer's Manual           PMEMPOOL-DUMP(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

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

RANGE

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

EXAMPLE

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

SEE ALSO

85       pmempool(1),   libpmemblk(7),    libpmemlog(7),    libpmemobj(7)    and
86       <https://pmem.io>
87
88
89
90PMDK - pmem Tools version 1.4     2022-05-24                  PMEMPOOL-DUMP(1)
Impressum