File: podman-artifact-ls.1.md.in

package info (click to toggle)
podman 5.4.2%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 23,124 kB
  • sloc: sh: 6,119; perl: 2,710; python: 2,258; ansic: 1,556; makefile: 1,022; xml: 121; ruby: 42; awk: 12; csh: 8
file content (73 lines) | stat: -rw-r--r-- 2,145 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
% podman-artifact-ls 1


## WARNING: Experimental command
*This command is considered experimental and still in development. Inputs, options, and outputs are all
subject to change.*

## 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**                                |
|-----------------|------------------------------------------------|
| .Digest         | The computed digest of the artifact's manifest |
| .Repository     | Repository name of the artifact                |
| .Size           | Size artifact in human readable units          |
| .Tag            | Tag of the artifact name                       |

@@option no-trunc

@@option noheading

## EXAMPLES

List artifacts in the local store
```
$ podman artifact ls
REPOSITORY                TAG         DIGEST             SIZE
quay.io/artifact/foobar1  latest      ab609fad386d       2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb       12.58MB
```

List artifacts in the local store without truncating the digest
```
$ podman artifact ls --no-trunc
REPOSITORY                TAG         DIGEST                                                              SIZE
quay.io/artifact/foobar1  latest      ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29    2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0    12.58MB
```

List artifacts in the local store without the title header
```
$ podman artifact ls --noheading
quay.io/artifact/foobar1  latest      ab609fad386d       2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb       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.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**

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