openssh bugs - Mar 2021 - [Bug 3285] New: Wrong documentation on -D The bind_address

https://bugzilla.mindrot.org/show_bug.cgi?id=3285

            Bug ID: 3285
           Summary: Wrong documentation on -D The bind_address
           Product: Portable OpenSSH
           Version: 8.5p1
          Hardware: All
                OS: Linux
            Status: NEW
          Severity: trivial
          Priority: P5
         Component: Documentation
          Assignee: unassigned-bugs at mindrot.org
          Reporter: dewijones92 at gmail.com

The man page says this:
The bind_address of ?localhost? indicates that the listening port be
bound for local use only, while an empty address or ?*? indicates that
the port should be available from all interfaces.

However each of the following commands results in a different interface
binding
./ssh -D 1337 -vvvv -C -N  dewi at 192.168.1.1
tcp   LISTEN    0      128                                            
127.0.0.1:1337                0.0.0.0:*     
users:(("ssh",pid=75605,fd=5)) uid:1000 ino:336020 sk:474 <->  


./ssh -D *:1337 -vvvv -C -N  dewi at 192.168.1.1
tcp   LISTEN    0      128                                             
 0.0.0.0:1337                0.0.0.0:*     
users:(("ssh",pid=74357,fd=4)) uid:1000 ino:320497 sk:464 <-> 

So many the documentation should be different? or the code?
Many thanks

-- 
You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.mindrot.org/show_bug.cgi?id=3285

dewi jones <dewijones92 at gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |dewijones92 at gmail.com

-- 
You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.mindrot.org/show_bug.cgi?id=3285

Damien Miller <djm at mindrot.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |djm at mindrot.org

--- Comment #1 from Damien Miller <djm at mindrot.org> ---
You're missing this critical sentence, which comes immediately before:
> By default, the local port is bound in accordance with
> the GatewayPorts setting
-- 
You are receiving this mail because:
You are watching the assignee of the bug.
You are watching someone on the CC list of the bug.

https://bugzilla.mindrot.org/show_bug.cgi?id=3285

--- Comment #2 from dewi jones <dewijones92 at gmail.com> ---
ah nice catch.
But surely the following two statements contradict eachother? 
> The bind_address of ?localhost? indicates that the listening port be >
> bound for local use only, while an empty address or ?*? indicates that >
the port should be available from all interfaces.
> By default, the local port is bound in accordance with the GatewayPorts
setting.
An empty address' behaviour is governed by the second statement and is
not necessarily "available from all interfaces"

Many thanks

-- 
You are receiving this mail because:
You are watching someone on the CC list of the bug.
You are watching the assignee of the bug.