0ct0pu5/moby
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Add a note about PID 1 not terminating on SIGINT/SIGTERM.

Browse source 
Also re-arranged the description of CTRL-c to make it clearer.

Signed-off-by: Bryan Boreham <bjboreham@gmail.com>
This commit is contained in:
Bryan Boreham 2015-04-13 17:33:59 +01:00
parent 12eff0c26f
commit 5ad15479a0
2 changed files with 15 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
docs/sources/reference/commandline/cli.md
View file

@ -516,10 +516,16 @@ 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
daemonized process. daemonized process.
You can detach from the container (and leave it running) with `CTRL-p CTRL-q` You can detach from the container and leave it running with `CTRL-p
(for a quiet exit) or `CTRL-c` which will send a `SIGKILL` to the container. CTRL-q` (for a quiet exit) or with `CTRL-c` if `--sig-proxy` is false.
When you are attached to a container, and exit its main process, the process's
exit code will be returned to the client. If `--sig-proxy` is true (the default),`CTRL-c` sends a `SIGINT`
to the container.
>**Note**: A process running as PID 1 inside a container is treated
>specially by Linux: it ignores any signal with the default action.
>So, the process will not terminate on `SIGINT` or `SIGTERM` unless it is
>coded to do so.
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`).

5
docs/sources/reference/run.md
View file

@ -111,6 +111,11 @@ as you'll see in later examples. Specifying `-t` is forbidden when the client
standard output is redirected or piped, such as in: standard output is redirected or piped, such as in:
`echo test | docker run -i busybox cat`. `echo test | docker run -i busybox cat`.
>**Note**: A process running as PID 1 inside a container is treated
>specially by Linux: it ignores any signal with the default action.
>So, the process will not terminate on `SIGINT` or `SIGTERM` unless it is
>coded to do so.
## Container identification ## Container identification
### Name (--name) ### Name (--name)