...

2025-08-05 15:33:03 +02:00
parent 7856fc0a4e
commit 0c02d0e99f
326 changed files with 334 additions and 0 deletions
--- a/packages/system/virt/src/buildah/buildahdocs/buildah-images.1.md
+++ b/packages/system/virt/src/buildah/buildahdocs/buildah-images.1.md
@@ -0,0 +1,137 @@
+# buildah-images "1" "March 2017" "buildah"
+
+## NAME
+buildah\-images - List images in local storage.
+
+## SYNOPSIS
+**buildah images** [*options*] [*image*]
+
+## DESCRIPTION
+Displays locally stored images, their names, sizes, created date and their IDs.
+The created date is displayed in the time locale of the local machine.
+
+## OPTIONS
+
+**--all**, **-a**
+
+Show all images, including intermediate images from a build.
+
+**--digests**
+
+Show the image digests.
+
+**--filter**, **-f**=[]
+
+Filter output based on conditions provided (default []).
+
+  Filters:
+
+  **after,since=image**
+    Filter on images created since the given image.
+
+  **before=image**
+    Filter on images created before the given image.
+
+  **dangling=true|false**
+    Show dangling images. An images is considered to be dangling if it has no associated names and tags.
+
+  **id=id**
+    Show image with this specific ID.
+
+  **intermediate=true|false**
+    Show intermediate images. An images is considered to be an indermediate image if it is dangling and has no children.
+
+  **label=key[=value]**
+    Filter by images labels key and/or value.
+
+  **readonly=true|false**
+    Show only read only images or Read/Write images. The default is to show both.  Read/Only images can be configured by modifying the  "additionalimagestores" in the /etc/containers/storage.conf file.
+
+  **reference=reference**
+    Show images matching the specified reference. Wildcards are supported (e.g., "reference=*fedora:3*").
+
+**--format**="TEMPLATE"
+
+Pretty-print images using a Go template.
+
+Valid placeholders for the Go template are listed below:
+
+| **Placeholder** | **Description**                          |
+| --------------- | -----------------------------------------|
+| .Created        | Creation date in epoch time              |
+| .CreatedAt      | Creation date Pretty Formatted           |
+| .CreatedAtRaw   | Creation date in raw format              |
+| .Digest         | Image Digest                             |
+| .ID             | Image ID                                 |
+| .Name           | Image Name                               |
+| .ReadOnly       | Indicates if image came from a R/O store |
+| .Size           | Image Size                               |
+| .Tag            | Image Tag                                |
+
+**--history**
+
+Display the image name history.
+
+**--json**
+
+Display the output in JSON format.
+
+**--no-trunc**
+
+Do not truncate output.
+
+**--noheading**, **-n**
+
+Omit the table headings from the listing of images.
+
+**--quiet**, **-q**
+
+Displays only the image IDs.
+
+## EXAMPLE
+
+buildah images
+
+buildah images fedora:latest
+
+buildah images --json
+
+buildah images --quiet
+
+buildah images -q --noheading --no-trunc
+
+buildah images --quiet fedora:latest
+
+buildah images --filter dangling=true
+
+buildah images --format "ImageID: {{.ID}}"
+
+```
+$ buildah images
+REPOSITORY                        TAG        IMAGE ID       CREATED        SIZE
+registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
+docker.io/library/busybox         latest     16ea53ea7c65   3 weeks ago    1.46 MB
+quay.io/libpod/testimage          20210610   9f9ec7f2fdef   4 months ago   7.99 MB
+```
+
+```
+# buildah images -a
+IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
+registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
+<none>                                                   <none>               8c6e16890c2b         Jun 13, 2018 15:52     4.42 MB
+localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
+```
+
+```
+# buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
+3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
+8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
+```
+
+```
+# buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
+3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
+8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
+```
+## SEE ALSO
+buildah(1), containers-storage.conf(5)