summaryrefslogtreecommitdiff
path: root/docs/podman-images.1.md
diff options
context:
space:
mode:
authorDaniel J Walsh <dwalsh@redhat.com>2017-12-15 16:58:36 -0500
committerAtomic Bot <atomic-devel@projectatomic.io>2017-12-18 16:46:05 +0000
commit5770dc2640c216525ab84031e3712fcc46b3b087 (patch)
tree8a1c5c4e4a6ce6a35a3767247623a62bfd698f77 /docs/podman-images.1.md
parentde3468e120d489d046c08dad72ba2262e222ccb1 (diff)
downloadpodman-5770dc2640c216525ab84031e3712fcc46b3b087.tar.gz
podman-5770dc2640c216525ab84031e3712fcc46b3b087.tar.bz2
podman-5770dc2640c216525ab84031e3712fcc46b3b087.zip
Rename all references to kpod to podman
The decision is in, kpod is going to be named podman. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #145 Approved by: umohnani8
Diffstat (limited to 'docs/podman-images.1.md')
-rw-r--r--docs/podman-images.1.md125
1 files changed, 125 insertions, 0 deletions
diff --git a/docs/podman-images.1.md b/docs/podman-images.1.md
new file mode 100644
index 000000000..cb0c52bef
--- /dev/null
+++ b/docs/podman-images.1.md
@@ -0,0 +1,125 @@
+% podman(1) podman-images - List images in local storage
+% Dan Walsh
+# podman-images "1" "March 2017" "podman"
+
+## NAME
+podman images - List images in local storage
+
+## SYNOPSIS
+**podman** **images** [*options* [...]]
+
+## DESCRIPTION
+Displays locally stored images, their names, and their IDs.
+
+## OPTIONS
+
+**--digests**
+
+Show image digests
+
+**--filter, -f=[]**
+
+Filter output based on conditions provided (default [])
+
+**--format**
+
+Change the default output format. This can be of a supported type like 'json'
+or a Go template.
+
+**--noheading, -n**
+
+Omit the table headings from the listing of images.
+
+**--no-trunc, --notruncate**
+
+Do not truncate output.
+
+**--quiet, -q**
+
+Lists only the image IDs.
+
+
+## EXAMPLE
+
+```
+# podman images
+REPOSITORY TAG IMAGE ID CREATED SIZE
+docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251kB
+<none> <none> ebb91b73692b 4 weeks ago 27.2MB
+docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126MB
+```
+
+```
+# podman images --quiet
+e3d42bcaf643
+ebb91b73692b
+4526339ae51c
+```
+
+```
+# podman images --noheading
+docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251kB
+<none> <none> ebb91b73692b 4 weeks ago 27.2MB
+docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126MB
+```
+
+```
+# podman images --no-trunc
+REPOSITORY TAG IMAGE ID CREATED SIZE
+docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251kB
+<none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2MB
+docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126MB
+```
+
+```
+# podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
+IMAGE ID REPOSITORY TAG
+e3d42bcaf643 docker.io/kubernetes/pause latest
+ebb91b73692b <none> <none>
+4526339ae51c docker.io/library/ubuntu latest
+```
+
+```
+# podman images --filter dangling=true
+REPOSITORY TAG IMAGE ID CREATED SIZE
+<none> <none> ebb91b73692b 4 weeks ago 27.2MB
+```
+
+```
+# podman images --format json
+[
+ {
+ "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
+ "names": [
+ "docker.io/kubernetes/pause:latest"
+ ],
+ "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
+ "created": "2014-07-19T07:02:32.267701596Z",
+ "size": 250665
+ },
+ {
+ "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
+ "names": [
+ "\u003cnone\u003e"
+ ],
+ "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
+ "created": "2017-10-26T03:07:22.796184288Z",
+ "size": 27170520
+ },
+ {
+ "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
+ "names": [
+ "docker.io/library/ubuntu:latest"
+ ],
+ "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
+ "created": "2017-10-10T20:59:05.10196344Z",
+ "size": 126085200
+ }
+]
+```
+
+## SEE ALSO
+podman(1)
+
+## HISTORY
+March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>