Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
buildah-images(1)	    General Commands Manual	     buildah-images(1)

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 lo-
       cal 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 inderme-
       diate 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	"addi-
       tionalimagestores" in the /etc/containers/storage.conf file.

       reference=reference
	   Show	images matching	the specified reference.  Wildcards  are  sup-
       ported (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)

buildah				  March	2017		     buildah-images(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=buildah-images&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help