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

FreeBSD Manual Pages

  
 
  

home | help
podman-artifact-ls(1)	     General Commands Manual	   podman-artifact-ls(1)

NAME
     podman-artifact-ls - List OCI artifacts in local store

SYNOPSIS
     podman artifact ls [options]

DESCRIPTION
     List all local artifacts in your local store.

OPTIONS
   --format
     Print results with a Go template.

     +--------------+-----------------------------+
     | Placeholder  | Description		  |
     +--------------+-----------------------------+
     | .Created     | Elapsed  time since the ar- |
     |		    | tifact was created	  |
     +--------------+-----------------------------+
     | .CreatedAt   | Full timestamp of when  the |
     |		    | artifact was created	  |
     +--------------+-----------------------------+
     | .Digest	    | The  computed digest of the |
     |		    | artifact's manifest	  |
     +--------------+-----------------------------+
     | .Repository  | Repository name of the  ar- |
     |		    | tifact			  |
     +--------------+-----------------------------+
     | .Size	    | Size   artifact	in  human |
     |		    | readable units		  |
     +--------------+-----------------------------+
     | .Tag	    | Tag of the artifact name	  |
     +--------------+-----------------------------+
     | .VirtualSize | Size of artifact in bytes   |
     +--------------+-----------------------------+

   --no-trunc
     Do not truncate the output (default false).

   --noheading, -n
     Omit the table headings from the listing.

EXAMPLES
     List artifacts in the local store

     $ podman artifact ls
     REPOSITORY 	       TAG	   DIGEST	  CREATED	   SIZE
     quay.io/artifact/foobar1  latest	   ab609fad386d   6 hours ago	   2.097GB
     quay.io/artifact/foobar2  special	   cd734b558ceb   53 seconds ago   12.58MB

     List artifacts in the local store without truncating the digest

     $ podman artifact ls --no-trunc
     REPOSITORY 	       TAG	   DIGEST							       CREATED		SIZE
     quay.io/artifact/foobar1  latest	   ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29    6 hours ago	2.097GB
     quay.io/artifact/foobar2  special	   cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0    53 seconds ago	12.58MB

     List artifacts in the local store without the title header

     $ podman artifact ls --noheading
     quay.io/artifact/foobar1  latest	   ab609fad386d   6 hours ago	   2.097GB
     quay.io/artifact/foobar2  special	   cd734b558ceb   53 seconds ago   12.58MB

     List artifact digests and size using a --format

     $ podman artifact ls --format "{{.Digest}} {{.Size}}"
     ab609fad386d 2.097GB
     cd734b558ceb 12.58MB

SEE ALSO
     podman(1), podman-artifact(1)

HISTORY
     Jan  2025,   Originally   compiled   by   Brent   Baude   bbaude@redhat.com
     <mailto:bbaude@redhat.com>

							   podman-artifact-ls(1)

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

home | help