mirror of
https://github.com/containers/podman.git
synced 2025-10-20 12:43:58 +08:00
f5a2e578eb
Make the order of short and long flag names in the documentation consistent. Also adjust the man page validaten script to only allow the `**--long**, **-s**` syntax. Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
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
|
|
|
|
#### **--all**, **-a**
|
|
|
|
Remove all volumes.
|
|
|
|
#### **--force**, **-f**
|
|
|
|
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
|
|
```
|
|
|
|
## Exit Status
|
|
**0** All specified volumes removed
|
|
|
|
**1** One of the specified volumes did not exist, and no other failures
|
|
|
|
**2** One of the specified volumes is being used by a container
|
|
|
|
**125** The command fails for any other reason
|
|
|
|
## SEE ALSO
|
|
podman-volume(1)
|
|
|
|
## HISTORY
|
|
November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|