Merge pull request #3163 from KGB33/923_cleanup_docker_container_attach_man

Cleaned up formatting/typesetting.
This commit is contained in:
Sebastiaan van Stijn 2021-07-05 17:25:11 +02:00 committed by GitHub
commit d7a311ba74
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 28 deletions

View File

@ -4,13 +4,13 @@ interactively. You can attach to the same contained process multiple times
simultaneously, screen sharing style, or quickly view the progress of your simultaneously, screen sharing style, or quickly view the progress of your
detached process. detached process.
To stop a container, use `CTRL-c`. This key sequence sends `SIGKILL` to the To stop a container, use `CTRL-c`. This key sequence sends **SIGKILL** to the
container. You can detach from the container (and leave it running) using a container. You can detach from the container (and leave it running) using a
configurable key sequence. The default sequence is `CTRL-p CTRL-q`. You configurable key sequence. The default sequence is `CTRL-p CTRL-q`. You
configure the key sequence using the **--detach-keys** option or a configuration configure the key sequence using the **--detach-keys** option or a configuration
file. See **config-json(5)** for documentation on using a configuration file. file. See **config-json(5)** for documentation on using a configuration file.
It is forbidden to redirect the standard input of a `docker attach` command while It is forbidden to redirect the standard input of a **docker attach** command while
attaching to a tty-enabled container (i.e.: launched with `-t`). attaching to a tty-enabled container (i.e.: launched with `-t`).
# Override the detach sequence # Override the detach sequence
@ -22,18 +22,18 @@ sequence, as a per-container override or as a configuration property on your
entire configuration. entire configuration.
To override the sequence for an individual container, use the To override the sequence for an individual container, use the
`--detach-keys="<sequence>"` flag with the `docker attach` command. The format of **--detach-keys**=*key* flag with the **docker attach** command. The format of
the `<sequence>` is either a letter [a-Z], or the `ctrl-` combined with any of the *key* is either a letter [a-Z], or the **ctrl**-*value*, where *value* is one
the following: of the following:
* `a-z` (a single lowercase alpha character ) * **a-z** (a single lowercase alpha character )
* `@` (at sign) * **@** (at sign)
* `[` (left bracket) * **[** (left bracket)
* `\\` (two backward slashes) * **\\\\** (two backward slashes)
* `_` (underscore) * **_** (underscore)
* `^` (caret) * **^** (caret)
These `a`, `ctrl-a`, `X`, or `ctrl-\\` values are all examples of valid key These **a**, **ctrl-a**, **X**, or **ctrl-\\** values are all examples of valid key
sequences. To configure a different configuration default key sequence for all sequences. To configure a different configuration default key sequence for all
containers, see **docker(1)**. containers, see **docker(1)**.
@ -45,22 +45,22 @@ In this example the top command is run inside a container, from an image called
fedora, in detached mode. The ID from the container is passed into the **docker fedora, in detached mode. The ID from the container is passed into the **docker
attach** command: attach** command:
$ ID=$(sudo docker run -d fedora /usr/bin/top -b) $ ID=$(sudo docker run -d ubuntu:20.04 /usr/bin/top -b)
$ sudo docker attach $ID $ sudo docker attach $ID
top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 top - 00:07:01 up 4:54, 0 users, load average: 0.83, 0.91, 0.82
Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie
Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st %Cpu(s): 2.3 us, 1.6 sy, 0.0 ni, 95.9 id, 0.0 wa, 0.1 hi, 0.1 si, 0.0 st
Mem: 373572k total, 355560k used, 18012k free, 27872k buffers MiB Mem : 15846.2 total, 5729.2 free, 2592.5 used, 7524.4 buff/cache
Swap: 786428k total, 0k used, 786428k free, 221740k cached MiB Swap: 16384.0 total, 16384.0 free, 0.0 used. 12097.3 avail Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
1 root 20 0 17200 1116 912 R 0 0.3 0:00.03 top 1 root 20 0 5976 3256 2828 R 0.0 0.0 0:00.04 top
top - 02:05:55 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 top - 00:07:04 up 4:54, 0 users, load average: 0.76, 0.89, 0.81
Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie
Cpu(s): 0.0%us, 0.2%sy, 0.0%ni, 99.8%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st %Cpu(s): 2.0 us, 1.4 sy, 0.0 ni, 96.5 id, 0.0 wa, 0.1 hi, 0.0 si, 0.0 st
Mem: 373572k total, 355244k used, 18328k free, 27872k buffers MiB Mem : 15846.2 total, 5727.5 free, 2594.4 used, 7524.3 buff/cache
Swap: 786428k total, 0k used, 786428k free, 221776k cached MiB Swap: 16384.0 total, 16384.0 free, 0.0 used. 12095.6 avail Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top 1 root 20 0 5976 3256 2828 R 0.0 0.0 0:00.04 top