podman-volume-rm(1)

1podman-volume-rm(1)         General Commands Manual        podman-volume-rm(1)
2
3
4

NAME

6       podman-volume-rm - Remove one or more volumes
7
8

SYNOPSIS

10       podman volume rm [options] volume [...]
11
12

DESCRIPTION

14       Removes  one or more volumes. Only volumes that are not being used will
15       be removed.  If a volume is being used by a container, an error will be
16       returned  unless the --force flag is being used. To remove all volumes,
17       use the --all flag.  Volumes can be removed individually  by  providing
18       their full name or a unique partial name.
19
20

OPTIONS

22   --all, -a
23       Remove all volumes.
24
25
26   --force, -f
27       Remove  a volume by force.  If it is being used by containers, the con‐
28       tainers will be removed first.
29
30
31   --help
32       Print usage statement
33
34
35   --time, -t=seconds
36       Seconds to wait before forcibly stopping running  containers  that  are
37       using the specified volume. The --force option must be specified to use
38       the --time option.
39
40

EXAMPLES

42              $ podman volume rm myvol1 myvol2
43
44              $ podman volume rm --all
45
46              $ podman volume rm --force myvol
47
48
49

Exit Status

51       0   All specified volumes removed
52
53
54       1   One of the specified volumes did not exist, and no other failures
55
56
57       2   One of the specified volumes is being used by a container
58
59
60       125 The command fails for any other reason
61
62

HISTORY

68       November 2018, Originally compiled  by  Urvashi  Mohnani  umohnani@red‐
69       hat.com ⟨mailto:umohnani@redhat.com⟩
70
71
72
73                                                           podman-volume-rm(1)