Files
podman/docs/podman-volume-rm.1.md
Matthew Heon 046178e55f Add function for looking up volumes by partial name
This isn't included in Docker, but seems handy enough.

Use the new API for 'volume rm' and 'volume inspect'.

Fixes #3891

Signed-off-by: Matthew Heon <matthew.heon@pm.me>
2019-09-09 12:06:10 -04:00

47 lines
931 B
Markdown

% podman-volume-rm(1)
## NAME
podman\-volume\-rm - Remove one or more volumes
## SYNOPSIS
**podman volume rm** [*options*] *volume* [...]
## DESCRIPTION
Removes one or more volumes. Only volumes that are not being used will be removed.
If a volume is being used by a container, an error will be returned unless the **--force**
flag is being used. To remove all volumes, use the **--all** flag.
Volumes can be removed individually by providing their full name or a unique partial name.
## OPTIONS
**-a**, **--all**
Remove all volumes.
**-f**, **--force**
Remove a volume by force.
If it is being used by containers, the containers will be removed first.
**--help**
Print usage statement
## EXAMPLES
```
$ podman volume rm myvol1 myvol2
$ podman volume rm --all
$ podman volume rm --force myvol
```
## SEE ALSO
podman-volume(1)
## HISTORY
November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>