diff options
| author | Ed Santiago <santiago@redhat.com> | 2022-09-13 13:49:24 -0600 |
|---|---|---|
| committer | Ed Santiago <santiago@redhat.com> | 2022-09-14 08:15:46 -0600 |
| commit | b6c75a3cc572b9a8299aaad5af287ec82c424ba8 (patch) | |
| tree | e49313e885f46ae4cd6b10bcbe975f7fcf59b1fc /docs/source/markdown/podman-start.1.md | |
| parent | e1b3d9811a5655f4468b2b56a93513418e6678a2 (diff) | |
| download | podman-b6c75a3cc572b9a8299aaad5af287ec82c424ba8.tar.gz podman-b6c75a3cc572b9a8299aaad5af287ec82c424ba8.tar.bz2 podman-b6c75a3cc572b9a8299aaad5af287ec82c424ba8.zip | |
Man pages: refactor common options: --preserve-fds, -it
Three simple options shared among podman-create, exec, run.
I mostly went with the podman-run versions. For --tty, this
means that create and exec get the long stdout/stderr note.
(The example, though, remains only in podman-run). For -i,
mostly boldspace changes.
For --preserve-fds, podman-exec now has the "not with remote"
note (which it didn't until now)
Signed-off-by: Ed Santiago <santiago@redhat.com>
Diffstat (limited to 'docs/source/markdown/podman-start.1.md')
| -rw-r--r-- | docs/source/markdown/podman-start.1.md | 83 |
1 files changed, 0 insertions, 83 deletions
diff --git a/docs/source/markdown/podman-start.1.md b/docs/source/markdown/podman-start.1.md deleted file mode 100644 index fd24c6bf4..000000000 --- a/docs/source/markdown/podman-start.1.md +++ /dev/null @@ -1,83 +0,0 @@ -% podman-start 1 - -## NAME -podman\-start - Start one or more containers - -## SYNOPSIS -**podman start** [*options*] *container* ... - -**podman container 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 - -#### **--all** - -Start all the containers created by Podman, default is only running containers. - -#### **--attach**, **-a** - -Attach container's STDOUT and STDERR. The default is false. This option cannot be used when -starting multiple containers. - -#### **--detach-keys**=*sequence* - -Specify the key sequence for detaching a container. Format is a single character `[a-Z]` or one or more `ctrl-<value>` characters where `<value>` is one of: `a-z`, `@`, `^`, `[`, `,` or `_`. Specifying "" will disable this feature. The default is *ctrl-p,ctrl-q*. - -#### **--filter**, **-f** - -Filter what containers are going to be started from the given arguments. -Multiple filters can be given with multiple uses of the --filter flag. -Filters with the same key work inclusive with the only exception being -`label` which is exclusive. Filters with different keys always work exclusive. - -Valid filters are listed below: - -| **Filter** | **Description** | -| --------------- | -------------------------------------------------------------------------------- | -| id | [ID] Container's ID (accepts regex) | -| name | [Name] Container's name (accepts regex) | -| label | [Key] or [Key=Value] Label assigned to a container | -| exited | [Int] Container's exit code | -| status | [Status] Container's status: 'created', 'exited', 'paused', 'running', 'unknown' | -| ancestor | [ImageName] Image or descendant used to create container | -| before | [ID] or [Name] Containers created before this container | -| since | [ID] or [Name] Containers created since this container | -| volume | [VolumeName] or [MountpointDestination] Volume mounted in container | -| health | [Status] healthy or unhealthy | -| pod | [Pod] name or full or partial ID of pod | -| network | [Network] name or full ID of network | - -#### **--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. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines) - -#### **--sig-proxy** - -Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied. The default is *true* when attaching, *false* otherwise. - -## EXAMPLE - -podman start mywebserver - -podman start 860a4b231279 5421ab43b45 - -podman start --interactive --attach 860a4b231279 - -podman start -i -l - -## SEE ALSO -**[podman(1)](podman.1.md)** - -## HISTORY -November 2018, Originally compiled by Brent Baude <bbaude@redhat.com> |