Files
podman/docs/podman-start.1.md
W. Trevor King f2462ca59e docs: Follow man-pages(7) suggestions for SYNOPSIS
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
2018-07-04 09:40:37 +00:00

1.5 KiB

% podman-start "1"

NAME

podman-start - Start one or more containers

SYNOPSIS

podman start [options] container ...

DESCRIPTION

Start one or more containers. You may use container IDs or names as input. The attach and interactive options cannot be used to override the --tty* and --interactive options from when the container was created. If you attempt to start a running container with the --attach option, podman will simply attach to the container.

OPTIONS

--attach, -a

Attach container's STDOUT and STDERR. The default is false. This option cannot be used when starting multiple containers.

--detach-keys

Override the key sequence for detaching a container. Format is a single character [a-Z] or ctrl- where is one of: a-z, @, ^, [, , or _.

--interactive, -i

Attach container's STDIN. The default is false.

--latest, -l

Instead of providing the container name or ID, use the last created container. If you use methods other than Podman to run containers such as CRI-O, the last started container could be from either of those methods.

--sig-proxy=true|false

Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied. The default is false.

EXAMPLE

podman start mywebserver

podman start 860a4b23 5421ab4

podman start -i -a 860a4b23

podman start -i -l

SEE ALSO

podman(1), podman-create(1)

HISTORY

November 2018, Originally compiled by Brent Baude bbaude@redhat.com