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

NAME

6       pmempool-rm - remove a persistent memory pool
7

SYNOPSIS

9              $ pmempool rm [<options>] <file>..
10

DESCRIPTION

12       The  pmempool rm command removes each specified file.  If the specified
13       file is a pool set file, all  pool  files  (single-file  pool  or  part
14       files)  and  remote  replicas  are removed.  By default the pmempool rm
15       does not remove pool set files.  All local and remote  pool  files  are
16       removed  using  unlink(3)  call, except the pools created on device dax
17       which are zeroed instead.  If specified file does not exist, the remote
18       pool  is  broken  or not accessible, the pmempool rm command terminates
19       with an error code.  By default it prompts before  removing  write-pro‐
20       tected  local  files.   See REMOTE REPLICATION section for more details
21       about support for remote pools.  See EXAMPLES section for example usage
22       of the rm command.
23
24   Available options:
25       -h, --help
26
27       Print help message
28
29       -v, --verbose
30
31       Be verbose and print all removing files.
32
33       -s, --only-pools
34
35       Remove only pool files and do not remove pool set files (default behav‐
36       iour).
37
38       -a, --all
39
40       Remove all pool set files - local and remote.
41
42       -l, --local
43
44       Remove local pool set files.
45
46       -r, --remote
47
48       Remove remote pool set files.
49
50       -f, --force
51
52       Remove all specified files, ignore nonexistent files, never prompt.
53
54       -i, --interactive
55
56       Prompt before removing every single file or remote pool.
57

REMOTE REPLICATION

59       A remote pool is removed using rpmem_remove(3) function if  librpmem(7)
60       library  is  available.  If a pool set file contains remote replication
61       but librpmem(7) is not available, the pmempool  rm  command  terminates
62       with an error code, unless the -f, –force option is specified.
63

EXAMPLE

65              $ pmempool rm pool.obj pool.blk
66
67       Remove specified pool files.
68
69              $ pmempool rm pool.set
70
71       Remove  all  pool files from the “pool.set”, do not remove pool.set it‐
72       self.
73
74              $ pmempool rm -a pool.set
75
76       Remove all pool files from the “pool.set”, remove the  local  pool  set
77       file and all remote pool set files.
78

SEE ALSO

80       pmempool(1),  libpmemblk(7),  libpmemlog(7), libpmemobj(7), librpmem(7)
81       and <https://pmem.io>
82
83
84
85PMDK - pmem Tools version 1.4     2022-05-24                    PMEMPOOL-RM(1)
Impressum