Rework Podman description

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Rework the Podman Description.  I'm starting off with the Podman man page
to build consensus and we can then add to other places as appropriate.

This partially addresses: #1636

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
This commit is contained in:
TomSweeneyRedHat
2019-01-29 16:59:22 -05:00
parent e6426af30b
commit b58b95b408

View File

@ -1,19 +1,21 @@
% podman(1) % podman(1)
## NAME ## NAME
podman - Simple management tool for containers and images podman - Simple management tool for pods, containers and images
## SYNOPSIS ## SYNOPSIS
**podman** [*options*] *command* **podman** [*options*] *command*
## DESCRIPTION ## DESCRIPTION
podman is a simple client only tool to help with debugging issues when daemons Podman (Pod Manager) is a fully featured container engine that is a simple daemonless tool.
such as CRI runtime and the kubelet are not responding or failing. A shared API Podman provides a Docker-CLI comparable command line that eases the transition from other
layer could be created to share code between the daemon and podman. podman does not container engines and allows the management of pods, containers and images. Simply put: `alias docker=podman`.
require any daemon running. podman utilizes the same underlying components that Most Podman commands can be run as a regular user, without requiring additional
crio uses i.e. containers/image, container/storage, oci-runtime-tool/generate, privileges.
runc or any other OCI compatible runtime. podman shares state with crio and so
has the capability to debug pods/images created by crio. Podman uses Buildah(1) internally to create container images. Both tools share image
(not container) storage, hence each can use or manipulate images (but not containers)
created by the other.
**podman [GLOBAL OPTIONS]** **podman [GLOBAL OPTIONS]**
@ -220,7 +222,7 @@ Images are pulled under `XDG_DATA_HOME` when specified, otherwise in the home di
Currently the slirp4netns package is required to be installed to create a network device, otherwise rootless containers need to run in the network namespace of the host. Currently the slirp4netns package is required to be installed to create a network device, otherwise rootless containers need to run in the network namespace of the host.
## SEE ALSO ## SEE ALSO
`containers-mounts.conf(5)`, `containers-registries.conf(5)`, `containers-storage.conf(5)`, `crio(8)`, `libpod.conf(5)`, `oci-hooks(5)`, `policy.json(5)`, `subuid(5)`, `subgid(5)`, `slirp4netns(1)` `containers-mounts.conf(5)`, `containers-registries.conf(5)`, `containers-storage.conf(5)`, `buildah(1)`, `crio(8)`, `libpod.conf(5)`, `oci-hooks(5)`, `policy.json(5)`, `subuid(5)`, `subgid(5)`, `slirp4netns(1)`
## HISTORY ## HISTORY
Dec 2016, Originally compiled by Dan Walsh <dwalsh@redhat.com> Dec 2016, Originally compiled by Dan Walsh <dwalsh@redhat.com>