Browse code

Update docs on --sig-proxy to indicate that SIGKILL and SIGSTOP cannot be proxied

Docker-DCO-1.1-Signed-off-by: Matt Heon <mheon@redhat.com> (github: mheon)

Matthew Heon authored on 2014/07/19 01:32:04
Showing 5 changed files
... ...
@@ -1751,7 +1751,7 @@ func (cli *DockerCli) CmdAttach(args ...string) error {
1751 1751
 	var (
1752 1752
 		cmd     = cli.Subcmd("attach", "[OPTIONS] CONTAINER", "Attach to a running container")
1753 1753
 		noStdin = cmd.Bool([]string{"#nostdin", "-no-stdin"}, false, "Do not attach STDIN")
1754
-		proxy   = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify all received signals to the process (even in non-TTY mode). SIGCHLD is not proxied.")
1754
+		proxy   = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxy all received signals to the process (even in non-TTY mode). SIGCHLD, SIGKILL, and SIGSTOP are not proxied.")
1755 1755
 	)
1756 1756
 
1757 1757
 	if err := cmd.Parse(args); err != nil {
... ...
@@ -25,7 +25,7 @@ the client.
25 25
    Do not attach STDIN. The default is *false*.
26 26
 
27 27
 **--sig-proxy**=*true*|*false*
28
-   Proxify all received signals to the process (even in non-TTY mode). SIGCHLD is not proxied. The default is *true*.
28
+   Proxy all received signals to the process (even in non-TTY mode). SIGCHLD, SIGKILL, and SIGSTOP are not proxied. The default is *true*.
29 29
 
30 30
 # EXAMPLES
31 31
 
... ...
@@ -195,8 +195,8 @@ default is *false*. This option is incompatible with **-d**.
195 195
 
196 196
 
197 197
 **--sig-proxy**=*true*|*false*
198
-   When set to true, proxify received signals to the process (even in
199
-non-tty mode). SIGCHLD is not proxied. The default is *true*.
198
+   When set to true, proxy received signals to the process (even in
199
+non-tty mode). SIGCHLD, SIGKILL, and SIGSTOP are not proxied. The default is *true*.
200 200
 
201 201
 
202 202
 **-t**, **-tty**=*true*|*false*
... ...
@@ -135,7 +135,7 @@ like this:
135 135
     Attach to a running container
136 136
 
137 137
       --no-stdin=false    Do not attach STDIN
138
-      --sig-proxy=true    Proxify all received signals to the process (even in non-TTY mode). SIGCHLD is not proxied.
138
+      --sig-proxy=true    Proxy all received signals to the process (even in non-TTY mode). SIGCHLD, SIGKILL, and SIGSTOP are not proxied.
139 139
 
140 140
 The `attach` command will allow you to view or
141 141
 interact with any running container, detached (`-d`)
... ...
@@ -972,7 +972,7 @@ removed before the image is removed.
972 972
                                    (use 'docker port' to see the actual mapping)
973 973
       --privileged=false         Give extended privileges to this container
974 974
       --rm=false                 Automatically remove the container when it exits (incompatible with -d)
975
-      --sig-proxy=true           Proxify received signals to the process (even in non-tty mode). SIGCHLD is not proxied.
975
+      --sig-proxy=true           Proxy received signals to the process (even in non-tty mode). SIGCHLD, SIGKILL, and SIGSTOP are not proxied.
976 976
       -t, --tty=false            Allocate a pseudo-tty
977 977
       -u, --user=""              Username or UID
978 978
       -v, --volume=[]            Bind mount a volume (e.g., from the host: -v /host:/container, from docker: -v /container)
... ...
@@ -71,7 +71,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf
71 71
 		flCpuset          = cmd.String([]string{"-cpuset"}, "", "CPUs in which to allow execution (0-3, 0,1)")
72 72
 		flNetMode         = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container\n'bridge': creates a new network stack for the container on the docker bridge\n'none': no networking for this container\n'container:<name|id>': reuses another container network stack\n'host': use the host network stack inside the container.  Note: the host mode gives the container full access to local system services such as D-bus and is therefore considered insecure.")
73 73
 		// For documentation purpose
74
-		_ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify received signals to the process (even in non-TTY mode). SIGCHLD is not proxied.")
74
+		_ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxy received signals to the process (even in non-TTY mode). SIGCHLD, SIGSTOP, and SIGKILL are not proxied.")
75 75
 		_ = cmd.String([]string{"#name", "-name"}, "", "Assign a name to the container")
76 76
 	)
77 77