1PMEMPOOL-RM(1) PMDK Programmer's Manual PMEMPOOL-RM(1)
2
3
4
6 pmempool-rm - remove a persistent memory pool
7
9 $ pmempool rm [<options>] <file>..
10
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
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
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
80 pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), librpmem(7)
81 and <http://pmem.io>
82
83
84
85PMDK - pmem Tools version 1.4 2018-07-18 PMEMPOOL-RM(1)