cri-o/docs/kpod-history.1.md
baude 78c6151519 Modify kpod diff --json to --format json
We want all kpod subcommands to use the formats code to output
formats like json.  Altering kpod diff --json to kpod diff --format json
like the kpod images command.

Signed-off-by: baude <bbaude@redhat.com>
2017-08-18 21:05:58 -05:00

2.3 KiB

% kpod(1) kpod-history - Simple tool to view the history of an image % Urvashi Mohnani % kpod-history "1" "JULY 2017" "kpod"

NAME

kpod-history - Shows the history of an image

SYNOPSIS

kpod history [OPTIONS] IMAGE[:TAG|DIGEST]

DESCRIPTION

kpod history displays the history of an image by printing out information about each layer used in the image. The information printed out for each layer include Created (time and date), Created By, Size, and Comment. The output can be truncated or not using the --no-trunc flag. If the --human flag is set, the time of creation and size are printed out in a human readable format. The --quiet flag displays the ID of the image only when set and the --format flag is used to print the information using the Go template provided by the user.

Valid placeholders for the Go template are listed below:

Placeholder Description
.ID Image ID
.Created if --human, time elapsed since creation, otherwise time stamp of creation
.CreatedBy Command used to create the layer
.Size Size of layer on disk
.Comment Comment for the layer

kpod [GLOBAL OPTIONS]

kpod [GLOBAL OPTIONS] history [OPTIONS]

GLOBAL OPTIONS

--help, -h Print usage statement

OPTIONS

--human, -H Display sizes and dates in human readable format

--no-trunc Do not truncate the output

--quiet, -q Print the numeric IDs only

--format Alter the output for a format like 'json' or a Go template.

COMMANDS

kpod history debian

kpod history --no-trunc=true --human=false debian

kpod history --format "{{.ID}} {{.Created}}" debian

kpod history --format json debian

history

Show the history of an image

SEE ALSO

kpod(1), crio(8), crio.conf(5)

HISTORY

July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com