f2462ca59e
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
3.3 KiB
% podman-save "1"
NAME
podman-save - Save an image to docker-archive or oci-archive
SYNOPSIS
podman save [options] name[:tag]
DESCRIPTION
podman save saves an image to either docker-archive, oci-archive, oci-dir (directory
with oci manifest type), or docker-dir (directory with v2s2 manifest type) on the local machine,
default is docker-archive. podman save writes to STDOUT by default and can be redirected to a
file using the output flag. 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 save [GLOBAL OPTIONS]
podman save [OPTIONS] NAME[:TAG]
OPTIONS
--compress
Compress tarball image layers when pushing to a directory using the 'dir' transport. (default is same compression type, compressed or uncompressed, as source) Note: This flag can only be set when using the dir transport i.e --format=oci-dir or --format-docker-dir
--output, -o
Write to a file, default is STDOUT
--format
Save image to oci-archive, oci-dir (directory with oci manifest type), or docker-dir (directory with v2s2 manifest type)
--format oci-archive
--format oci-dir
--format docker-dir
--quiet, -q
Suppress the output
--help, -h
Print usage statement
EXAMPLES
# podman save --quiet -o alpine.tar alpine:2.6
# podman save > alpine-all.tar alpine
# podman save -o oci-alpine.tar --format oci-archive alpine
# podman save --compress --format oci-dir -o alp-dir alpine
Getting image source signatures
Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d
1.97 MB / 1.97 MB [========================================================] 0s
Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be
584 B / 584 B [============================================================] 0s
Writing manifest to image destination
Storing signatures
# podman save --format docker-dir -o ubuntu-dir ubuntu
Getting image source signatures
Copying blob sha256:660c48dd555dcbfdfe19c80a30f557ac57a15f595250e67bfad1e5663c1725bb
45.55 MB / 45.55 MB [======================================================] 8s
Copying blob sha256:4c7380416e7816a5ab1f840482c9c3ca8de58c6f3ee7f95e55ad299abbfe599f
846 B / 846 B [============================================================] 0s
Copying blob sha256:421e436b5f80d876128b74139531693be9b4e59e4f1081c9a3c379c95094e375
620 B / 620 B [============================================================] 0s
Copying blob sha256:e4ce6c3651b3a090bb43688f512f687ea6e3e533132bcbc4a83fb97e7046cea3
849 B / 849 B [============================================================] 0s
Copying blob sha256:be588e74bd348ce48bb7161350f4b9d783c331f37a853a80b0b4abc0a33c569e
169 B / 169 B [============================================================] 0s
Copying config sha256:20c44cd7596ff4807aef84273c99588d22749e2a7e15a7545ac96347baa65eda
3.53 KB / 3.53 KB [========================================================] 0s
Writing manifest to image destination
Storing signatures
SEE ALSO
podman(1), podman-load(1), crio(8)
HISTORY
July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com