From 52b92023edeba3a5e2c466d92d742e54b14a85cb Mon Sep 17 00:00:00 2001 From: baude Date: Thu, 24 Oct 2019 14:54:57 -0500 Subject: Restructure documentation dir Restructuring the docs dir to make integration with sphinx easier. man pages now exist in docs/source/man and the sphinx make files exists in docs. Signed-off-by: baude --- docs/podman-import.1.md | 111 ------------------------------------------------ 1 file changed, 111 deletions(-) delete mode 100644 docs/podman-import.1.md (limited to 'docs/podman-import.1.md') diff --git a/docs/podman-import.1.md b/docs/podman-import.1.md deleted file mode 100644 index 946b680dd..000000000 --- a/docs/podman-import.1.md +++ /dev/null @@ -1,111 +0,0 @@ -% podman-import(1) - -## NAME -podman\-import - Import a tarball and save it as a filesystem image - -## SYNOPSIS -**podman import** [*options*] *path* [*reference*] - -**podman image import** [*options*] *path* [*reference*] - -## DESCRIPTION -**podman import** imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) -and saves it as a filesystem image. Remote tarballs can be specified using a URL. -Various image instructions can be configured with the **--change** flag and -a commit message can be set using the **--message** flag. -**reference**, if present, is a tag to assign to the image. -Note: `:` is a restricted character and cannot be part of the file name. - -## OPTIONS - -**-c**, **--change**=*instruction* - -Apply the following possible instructions to the created image: -**CMD** | **ENTRYPOINT** | **ENV** | **EXPOSE** | **LABEL** | **STOPSIGNAL** | **USER** | **VOLUME** | **WORKDIR** -Can be set multiple times - -**--message**, **-m**=*message* - -Set commit message for imported image - -**--quiet**, **-q** - -Shows progress on the import - -**-verbose** - -Print additional debugging information - -**--help**, **-h** - -Print usage statement - -## EXAMPLES - -``` -$ podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported -Getting image source signatures -Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86 - 25.80 MB / 25.80 MB [======================================================] 0s -Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd - 448 B / 448 B [============================================================] 0s -Writing manifest to image destination -Storing signatures -db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3 -``` - -``` -$ podman import --change "ENTRYPOINT ["/bin/sh","-c","test-image"]" --change LABEL=blue=image test-image.tar image-imported -Getting image source signatures -Copying blob e3b0c44298fc skipped: already exists -Copying config 1105523502 done -Writing manifest to image destination -Storing signatures -110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b -``` -``` -$ podman import --change "CMD /bin/sh" --change LABEL=blue=image test-image.tar image-imported -Getting image source signatures -Copying blob e3b0c44298fc skipped: already exists -Copying config ae9a27e249 done -Writing manifest to image destination -Storing signatures -ae9a27e249f801aff11a4ba54a81751ea9fbc9db45a6df3f1bfd63fc2437bb9c -``` - - -``` -$ cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported -db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3 -``` - -``` -$ cat ctr.tar | podman import - -Getting image source signatures -Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86 - 25.80 MB / 25.80 MB [======================================================] 0s -Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645 - 378 B / 378 B [============================================================] 0s -Writing manifest to image destination -Storing signatures -db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3 -``` - -``` -$ podman import http://example.com/ctr.tar url-image -Downloading from "http://example.com/ctr.tar" -Getting image source signatures -Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86 - 25.80 MB / 25.80 MB [======================================================] 0s -Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a - 419 B / 419 B [============================================================] 0s -Writing manifest to image destination -Storing signatures -db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3 -``` - -## SEE ALSO -podman(1), podman-export(1) - -## HISTORY -November 2017, Originally compiled by Urvashi Mohnani -- cgit v1.2.3-54-g00ecf