mirror of
https://github.com/containers/podman.git
synced 2025-06-18 15:39:08 +08:00

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
80 lines
2.2 KiB
Markdown
80 lines
2.2 KiB
Markdown
% 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>
|