Files
podman/docs/source/markdown/podman-attach.1.md.in
Daniel J Walsh d3a49fdedb Add information about --latest support on man pages
On Mac and Windows systems the --latest option is not supported
this PR mentions this fact in the examples section of the man page.
Also added documentation and consistency to the man pages examples
sections.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2024-01-23 07:28:40 -05:00

51 lines
1.5 KiB
Markdown

% podman-attach 1
## NAME
podman\-attach - Attach to a running container
## SYNOPSIS
**podman attach** [*options*] *container*
**podman container attach** [*options*] *container*
## DESCRIPTION
**podman attach** attaches to a running *container* using the *container's name* or *ID*, to either view its ongoing output or to control it interactively.\
The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for more information.
## OPTIONS
@@option detach-keys
@@option latest
#### **--no-stdin**
Do not attach STDIN. The default is **false**.
@@option sig-proxy
The default is **true**.
## EXAMPLES
Attach to a container called "foobar".
```
$ podman attach foobar
```
Attach to the latest created container. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
```
$ podman attach --latest
```
Attach to a container that start with the ID "1234".
```
$ podman attach 1234
```
Attach to a container without attaching STDIN.
```
$ podman attach --no-stdin foobar
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**