summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2020-10-12 07:01:10 -0400
committerGitHub <noreply@github.com>2020-10-12 07:01:10 -0400
commit212011f166d6f56421fcc5260def999e71156d32 (patch)
tree662725e76b8bc04a5ede4f8a3d40b375add1d334 /docs/source
parentdce30de594c6206659104a1208f4012a32a82bdc (diff)
parent66798e993a1d3c111f15a85242cac1427c39f53e (diff)
downloadpodman-212011f166d6f56421fcc5260def999e71156d32.tar.gz
podman-212011f166d6f56421fcc5260def999e71156d32.tar.bz2
podman-212011f166d6f56421fcc5260def999e71156d32.zip
Merge pull request #7836 from QiWang19/search-tags
Search repository tags using --list-tags
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/markdown/podman-search.1.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-search.1.md b/docs/source/markdown/podman-search.1.md
index 2c2a8f012..fc09d96ea 100644
--- a/docs/source/markdown/podman-search.1.md
+++ b/docs/source/markdown/podman-search.1.md
@@ -56,6 +56,9 @@ Valid placeholders for the Go template are listed below:
| .Stars | Star count of image |
| .Official | "[OK]" if image is official |
| .Automated | "[OK]" if image is automated |
+| .Tag | Repository tag |
+
+Note: use .Tag only if the --list-tags is set.
**--limit**=*limit*
@@ -65,6 +68,12 @@ Example if limit is 10 and two registries are being searched, the total
number of results will be 20, 10 from each (if there are at least 10 matches in each).
The order of the search results is the order in which the API endpoint returns the results.
+**--list-tags**
+
+List the available tags in the repository for the specified image.
+**Note:** --list-tags requires the search term to be a fully specified image name.
+The result contains the Image name and its tag, one line for every tag associated with the image.
+
**--no-trunc**
Do not truncate the output
@@ -140,6 +149,15 @@ fedoraproject.org registry.fedoraproject.org/f25/kubernetes-proxy
fedoraproject.org registry.fedoraproject.org/f25/kubernetes-scheduler 0
fedoraproject.org registry.fedoraproject.org/f25/mariadb 0
```
+
+```
+$ podman search --list-tags registry.redhat.io/rhel
+NAME TAG
+registry.redhat.io/rhel 7.3-74
+registry.redhat.io/rhel 7.6-301
+registry.redhat.io/rhel 7.1-9
+...
+```
Note: This works only with registries that implement the v2 API. If tried with a v1 registry an error will be returned.
## FILES