From f28c79766c279e67d475b5da60561507a9680baa Mon Sep 17 00:00:00 2001 From: Vincent Demeester Date: Thu, 17 Nov 2016 15:34:17 +0100 Subject: [PATCH] Update `images` cli reference with reference filter Signed-off-by: Vincent Demeester --- docs/reference/commandline/images.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/reference/commandline/images.md b/docs/reference/commandline/images.md index e6d2da52d9..3b9ea1fe17 100644 --- a/docs/reference/commandline/images.md +++ b/docs/reference/commandline/images.md @@ -28,6 +28,7 @@ Options: - label= or label== - before=([:tag]||) - since=([:tag]||) + - reference=(pattern of an image reference) --format string Pretty-print images using a Go template --help Print usage --no-trunc Don't truncate output @@ -229,6 +230,24 @@ Filtering with `since` would give: image1 latest eeae25ada2aa 4 minutes ago 188.3 MB image2 latest dea752e4e117 9 minutes ago 188.3 MB +#### Reference + +The `reference` filter shows only images whose reference matches +the specified pattern. + + $ docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + busybox latest e02e811dd08f 5 weeks ago 1.09 MB + busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB + busybox musl 733eb3059dce 5 weeks ago 1.21 MB + busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB + +Filtering with `reference` would give: + + $ docker images --filter=reference='busy*:*libc' + REPOSITORY TAG IMAGE ID CREATED SIZE + busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB + busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB ## Formatting