automation-tests/docs/source/markdown/podman-volume-prune.1.md

1.9 KiB
Raw Blame History

% podman-volume-prune(1)

NAME

podman-volume-prune - Remove all unused volumes

SYNOPSIS

podman volume prune [options]

DESCRIPTION

Removes unused volumes. By default all unused volumes will be removed, the --filter flag can be used to filter specific volumes. You will be prompted to confirm the removal of all the unused volumes. To bypass the confirmation, use the --force flag.

OPTIONS

--force, -f

Do not prompt for confirmation.

--filter

Provide filter values.

The filters argument format is of key=value. If there is more than one filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.

Supported filters:

Filter Description
until Only remove volumes created before given timestamp.
label Only remove volumes, with (or without, in the case of label!=[...] is used) the specified labels.

The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machines time.

The label filter accepts two formats. One is the label=key or label=key=value, which removes volumes with the specified labels. The other format is the label!=key or label!=key=value, which removes volumes without the specified labels.

--help

Print usage statement

EXAMPLES

$ podman volume prune

$ podman volume prune --force

$ podman volume prune --filter label=mylabel=mylabelvalue

SEE ALSO

podman(1), podman-volume(1)

HISTORY

November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com