Files
podman/docs/source/markdown/podman-rmi.1.md
Paul Holzinger bc48211924 Fix long option format on docs.podman.io
Escape the two dashes, otherwise they are combined into one long dash.
I tested that this change is safe and still renders correctly on github
and with the man pages.

This commit also contains a small change to make it build locally.
Assuming you have the dependencies installed you can do:
```
cd docs
make html
```
Preview the html files in docs/build/html with
`python -m http.server 8000 --directory build/html`.

Fixes containers/podman.io#373

Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
2021-03-29 14:38:25 +02:00

1.1 KiB

% podman-rmi(1)

NAME

podman-rmi - Removes one or more locally stored images

SYNOPSIS

podman rmi [options] image [...]

podman image rm [options] image [...]

DESCRIPTION

Removes one or more locally stored images.

OPTIONS

--all, -a

Remove all images in the local storage.

--force, -f

This option will cause podman to remove all containers that are using the image before removing the image from the system.

Remove an image by its short ID

$ podman rmi c0ed59d05ff7

Remove an image and its associated containers.

$ podman rmi --force imageID

Remove multiple images by their shortened IDs.

$ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7

Remove all images and containers.

$ podman rmi -a -f

Exit Status

0 All specified images removed

1 One of the specified images did not exist, and no other failures

2 One of the specified images has child images or is being used by a container

125 The command fails for any other reason

SEE ALSO

podman(1)

HISTORY

March 2017, Originally compiled by Dan Walsh dwalsh@redhat.com