pmem Tools version 1.3

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.

comment: <> (SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT) comment: <> (LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,) comment: <> (DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY) comment: <> (THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT) comment: <> ((INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE) comment: <> (OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.)

NAME
SYNOPSIS
DESCRIPTION
RANGE
EXAMPLE
SEE ALSO

NAME

pmempool-dump – Dump user data from specified pool

SYNOPSIS

$ pmempool dump [<options>] <file>

DESCRIPTION

The pmempool invoked with dump command dumps user data from specified pool file. The output format may be either binary or hexadecimal.

By default the output format is hexadecimal.

By default data is dumped to standard output. It is possible to dump data to other file by specifying -o option. In this case data will be appended to this file.

Using -r option you can specify number of blocks/bytes/data chunks using special text format. See RANGE section for details.

Available options:

-b, --binary

Dump data in binary format.

-r, --range <range>

Range of pool file to dump. This may be number of blocks for blk pool type or either number of bytes or number of data chunks for log pool type.

-c, --chunk <size>

Size of chunk for log pool type. See pmemlog_walk() in libpmemlog(3) for details.

-o, --output <file>

Name of output file.

-h, --help

Display help message and exit.

RANGE

Using -r, –range option it is possible to dump only a range of user data. This section describes valid format of <range> string.

You can specify multiple ranges separated by commas.

<first>-<last>

All blocks/bytes/data chunks from <first> to <last> will be dumped.

-<last>

All blocks/bytes/data chunks up to <last> will be dumped.

<first>-

All blocks/bytes/data chunks starting from <first> will be dumped.

<number>

Only <number> block/byte/data chunk will be dumped.

EXAMPLE

$ pmempool dump pool.bin

Dump user data from pool.bin file to standard output

$ pmempool dump -o output.bin -r1,10-100 pool_blk.bin

Dump block number 1 and blocks from 10 to 100 from pool_blk.bin containing pmem blk pool to output.bin file

$ pmempool dump -r 1K-2K pool.bin

Dump data form 1K to 2K from pool.bin file.

SEE ALSO

pmempool(1), libpmemlog(3), libpmemblk(3), libpmemobj(3) and http://pmem.io

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