.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "" "" "2023-05-31" "PMDK - " "PMDK Programmer's Manual"
.hy
.\" SPDX-License-Identifier: BSD-3-Clause
.\" Copyright 2016-2023, Intel Corporation
.SH NAME
.PP
\f[B]pmempool-rm\f[R] - remove a persistent memory pool
.SH SYNOPSIS
.IP
.nf
\f[C]
$ pmempool rm [<options>] <file>..
\f[R]
.fi
.SH NOTE
.RS
.PP
NOTICE: The \f[B]libpmemblk\f[R] and \f[B]libpmemlog\f[R] libraries are
deprecated since PMDK 1.13.0 release.
.RE
.SH DESCRIPTION
.PP
The \f[B]pmempool rm\f[R] command removes each specified file.
If the specified file is a pool set file, all pool files (single-file
pool or part files) are removed.
By default the \f[B]pmempool rm\f[R] does not remove pool set files.
All pool files are removed using \f[B]unlink\f[R](3) call, except the
pools created on \f[B]device dax\f[R] which are zeroed instead.
If specified file does not exist the \f[B]pmempool rm\f[R] command
terminates with an error code.
By default it prompts before removing \f[I]write-protected\f[R] files.
See \f[B]EXAMPLES\f[R] section for example usage of the \f[I]rm\f[R]
command.
.SS Available options:
.PP
\f[C]-h, --help\f[R]
.PP
Print help message
.PP
\f[C]-v, --verbose\f[R]
.PP
Be verbose and print all removing files.
.PP
\f[C]-s, --only-pools\f[R]
.PP
Remove only pool files and do not remove pool set files (default
behaviour).
.PP
\f[C]-a, --all\f[R]
.PP
Remove all pool set files.
.PP
\f[C]-l, --local\f[R]
.PP
Remove local pool set files.
.PP
\f[C]-f, --force\f[R]
.PP
Remove all specified files, ignore nonexistent files, never prompt.
.PP
\f[C]-i, --interactive\f[R]
.PP
Prompt before removing every single file.
.SH EXAMPLE
.IP
.nf
\f[C]
$ pmempool rm pool.obj pool.blk
\f[R]
.fi
.PP
Remove specified pool files.
.IP
.nf
\f[C]
$ pmempool rm pool.set
\f[R]
.fi
.PP
Remove all pool files from the \[lq]pool.set\[rq], do not remove
\f[I]pool.set\f[R] itself.
.IP
.nf
\f[C]
$ pmempool rm -a pool.set
\f[R]
.fi
.PP
Remove all pool files from the \[lq]pool.set\[rq].
.SH SEE ALSO
.PP
\f[B]pmempool\f[R](1), \f[B]libpmemblk\f[R](7), \f[B]libpmemlog\f[R](7),
\f[B]libpmemobj\f[R](7) and \f[B]<https://pmem.io>\f[R]