man-pages(7) has [1]: > For commands, this shows the syntax of the command and its arguments > (including options); boldface is used for as-is text and italics are > used to indicate replaceable arguments. Brackets ([]) surround > optional arguments, vertical bars (|) separate choices, and ellipses > (...) can be repeated. I've adjusted our SYNOPSIS entries to match that formatting, and generally tried to make them more consistent with the precedent set by the man-pages project. Outside of the SYNOPSIS entry, I prefer using backticks for literals, although in some places I've left the ** bolding to keep things visually similar to a nearby SYNOPSIS entry. [1]: http://man7.org/linux/man-pages/man7/man-pages.7.html Signed-off-by: W. Trevor King <wking@tremily.us> Closes: #1027 Approved by: rhatdan
2.2 KiB
% podman-load "1"
NAME
podman-load - Load an image from docker archive
SYNOPSIS
podman load name[:tag|@digest]
DESCRIPTION
podman load copies an image from either docker-archive or oci-archive stored
on the local machine. podman load reads from stdin by default or a file if the input flag is set.
The quiet flag suppresses the output when set.
Note: :
is a restricted character and cannot be part of the file name.
podman [GLOBAL OPTIONS]
podman load [GLOBAL OPTIONS]
podman load [OPTIONS] NAME[:TAG|@DIGEST]
OPTIONS
--input, -i
Read from archive file, default is STDIN
--quiet, -q
Suppress the output
--signature-policy="PATHNAME"
Pathname of a signature policy file to use. It is not recommended that this option be used, as the default behavior of using the system-wide default policy (frequently /etc/containers/policy.json) is most often preferred
--help, -h
Print usage statement
EXAMPLES
# podman load --quiet -i fedora.tar
# podman load -q --signature-policy /etc/containers/policy.json -i fedora.tar
# podman load < fedora.tar
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
0 B / 4.03 MB [---------------------------------------------------------------]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
0 B / 1.48 KB [---------------------------------------------------------------]
Writing manifest to image destination
Storing signatures
Loaded image: registry.fedoraproject.org/fedora:latest
# cat fedora.tar | podman load
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
0 B / 4.03 MB [---------------------------------------------------------------]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
0 B / 1.48 KB [---------------------------------------------------------------]
Writing manifest to image destination
Storing signatures
Loaded image: registry.fedoraproject.org/fedora:latest
SEE ALSO
podman(1), podman-save(1), crio(8)
HISTORY
July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com