[Bug 1087697] New: man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Bug ID: 1087697
           Summary: man page inaccuracy about --sig-proxy and --tty
           Product: Fedora
           Version: 20
         Component: docker-io
          Assignee: [e-mail]
          Reporter: [e-mail]
        QA Contact: [e-mail]
                CC: [e-mail], [e-mail],
                    [e-mail], [e-mail],
                    [e-mail], [e-mail],
                    [e-mail]

Description of problem:
Hi guys,

the man page states:
            --sig-proxy=true: Proxify all received signal to the process (even
in non-tty mode)

But the real behavior is, that sig-proxy doesn't work when --tty=true. It
should be mentioned in there, taht --sig-proxy is incompatible with --tty.

Version-Release number of selected component (if applicable):
docker-io-0.9.1-1.fc21.x86_64

How reproducible:
always

Steps to Reproduce:
1. man docker

Actual results:
man page says it works even in non-tty

Expected results:
man page warns that --tty can't be used with --sig-proxy

How to verify:
1. docker run --tty=true -i --rm fedora bash -c 'for NUM in `seq 1 64`; do trap
"echo Received $NUM, ignoring..." $NUM; done; while :; do sleep 1; done'
2. ps -ax | grep docker
3. kill -SIGUSR1 $PID
4. (with --tty=true no signals are received, when you try the same with
--tty=false, signals are proxified and messages are displayed)

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Lokesh Mandvekar  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |[e-mail]

--- Comment #1 from Lokesh Mandvekar  ---
Copying William (he recently got per subcommand manpages merged upstream).

this seems to be the case even in the latest manpage (I'm guessing this was
inherited from the original manpage).

William, was there any discussion about this in your PR?

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #2 from Lokesh Mandvekar  ---
btw, the 0.10 rpm includes the latest manpages (should be in yum soon)

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #3 from Lukas Doktor  ---
Thanks for a quick reply. I tried the docker-io-0.10.0-2.fc20.x86_64 which
says:
       --sig-proxy=true|false:
              When set to true, proxify all received signals  to  the  process
              (even in non-tty mode). The default is true.

I'd really like to change it to "only in non-tty" with possible warning that
--tty=true is incompatible with --sig-proxy.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #4 from William Henry  ---
I go this text from upstream. I'll check.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #5 from William Henry  ---
Lukas,according to the folks upstream, this is a bug in docker run and attach.
It should be as the text suggests.

Can you file a bug upstream with docker? Here:
https://github.com/dotcloud/docker/issues

Please just take the information you posted above and post it there.

Thanks. Well spotted.

Best,
William

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #6 from Lukas Doktor  ---
Upstream tracer:

https://github.com/dotcloud/docker/issues/5547

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Lukas Doktor  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Blocks|                            |1096296

Referenced Bugs:

https://bugzilla.redhat.com/show_bug.cgi?id=1096296
[Bug 1096296] man page inaccuracy about --sig-proxy and --tty

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|[e-mail]             |[e-mail]

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Blocks|                            |1096269

--- Comment #7 from Daniel Walsh  ---
*** Bug 1087700 has been marked as a duplicate of this bug. ***

Referenced Bugs:

https://bugzilla.redhat.com/show_bug.cgi?id=1096269
[Bug 1096269] lost signals when sending lots of signals using --sig-proxy
to docker

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|[e-mail]           |[e-mail]

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |ASSIGNED

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #8 from Matthew Heon  ---
Considering there's no action on the upstream bug, I've started work on a fix.

Right now, it's working for all signals save 17 and 20-22. 17 is expected,
Docker itself blocks that, but 20-22 not going through is a regression. I'm
debugging this, and once that issue is fixed, I'll submit the patch upstream.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #9 from Matthew Heon  ---
Pull request sent to upstream for this
(https://github.com/dotcloud/docker/pull/6955). Solution has some quirks
(SIGTTIN, SIGTTOU, SIGTSTP are not proxied, for example), but does enable
signal proxying with TTY mode specified.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |MODIFIED

--- Comment #10 from Daniel Walsh  ---
Fixed in docker-1.2

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #11 from Lukas Doktor  ---
Well I disagree. I just tried the reproducer on docker-1.2.0-19.el7.x86_64 and
-SIGUSR didn't generate any output, -2 killed the process. The only proxified
signal were the one I generated using keyboard (ctrl+z, ctrl+c). But when I use
`kill -... $PID` the signal is processed only by the attach process and is not
forwarded.

With --tty=true it works fine.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

John Skeoch  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|[e-mail]            |[e-mail]

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|MODIFIED                    |ASSIGNED
           Assignee|[e-mail]          |[e-mail]

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Daniel Walsh  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|[e-mail]           |[e-mail]

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Matthew Heon  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |MODIFIED

--- Comment #13 from Matthew Heon  ---
Upstream rejected the patch proxying signals in TTY mode. Fortunately, they
fixed the inaccuracy in the man pages at the same time.

As of docker-io-1.4.1-5 on F21 and docker-1.4.1-14 on RHEL7, we have these
updated manpages reflecting that signal proxying is incompatible with TTY mode.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

--- Comment #14 from Fedora End Of Life  ---
This message is a reminder that Fedora 20 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 20. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as EOL if it remains open with a Fedora  'version'
of '20'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 20 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

[Bug 1087697] man page inaccuracy about --sig-proxy and --tty

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1087697

Fedora End Of Life  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|MODIFIED                    |CLOSED
         Resolution|---                         |EOL
        Last Closed|                            |2015-06-29 21:27:58

--- Comment #15 from Fedora End Of Life  ---
Fedora 20 changed to end-of-life (EOL) status on 2015-06-23. Fedora 20 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version. If you
are unable to reopen this bug, please file a new report against the
current release. If you experience problems, please add a comment to this
bug.

Thank you for reporting this bug and we are sorry it could not be fixed.