Rename all references to kpod to podman

The decision is in, kpod is going to be named podman.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #145
Approved by: umohnani8

1 files changed, 46 insertions, 0 deletions

diff --git a/docs/podman-cp.1.md b/docs/podman-cp.1.md
new file mode 100644
index 000000000..0c23d6f10
--- /dev/null
+++ b/docs/podman-cp.1.md
@@ -0,0 +1,46 @@
+% podman(1) podman-cp - Copy content between container's file system and the host
+% Dan Walsh
+# podman-cp "1" "August 2017" "podman"
+
+## NAME
+podman-cp - Copy files/folders between a container and the local filesystem.
+
+## Description
+We chose not to implement the `cp` feature in `podman` even though the upstream Docker
+project has it. We have a much stronger capability.  Using standard podman-mount
+and podman-umount, we can take advantage of the entire linux tool chain, rather
+then just cp.
+
+If a user wants to copy contents out of a container or into a container, they
+can execute a few simple commands.
+
+You can copy from the container's file system to the local machine or the
+reverse, from the local filesystem to the container.
+
+If you want to copy the /etc/foobar directory out of a container and onto /tmp
+on the host, you could execute the following commands:
+
+	mnt=$(podman mount CONTAINERID)
+	cp -R ${mnt}/etc/foobar /tmp
+	podman umount CONTAINERID
+
+If you want to untar a tar ball into a container, you can execute these commands:
+
+	mnt=$(podman mount CONTAINERID)
+	tar xf content.tgz -C ${mnt}
+	podman umount CONTAINERID
+
+One last example, if you want to install a package into a container that
+does not have dnf installed, you could execute something like:
+
+	mnt=$(podman mount CONTAINERID)
+	dnf install --installroot=${mnt} httpd
+	chroot ${mnt} rm -rf /var/log/dnf /var/cache/dnf
+	podman umount CONTAINERID
+
+This shows that using `podman mount` and `podman umount` you can use all of the
+standard linux tools for moving files into and out of containers, not just
+the cp command.
+
+## SEE ALSO
+podman(1), podman-mount(1), podman-umount(1)