[Bug 3175] New: ssh_config(5) - ProxyCommand should explain semantics

[bugzilla-daemon at mindrot.org]

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

            Bug ID: 3175
           Summary: ssh_config(5) - ProxyCommand should explain semantics
           Product: Portable OpenSSH
           Version: 8.3p1
          Hardware: Other
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P5
         Component: ssh
          Assignee: unassigned-bugs at mindrot.org
          Reporter: frederik-openssh at ofb.net

ssh_config(5) says:

     ProxyCommand
             Specifies the command to use to connect to the server. 
The com-
             mand string extends to the end of the line, and is
executed using
             the user's shell `exec' directive to avoid a lingering
shell
             process.

Personally, I would find this explanation much more transparent if it
mentioned up front that the ssh command line arguments "destination"
and "-p port" are ignored when ProxyCommand is specified. Perhaps
something like:

     ProxyCommand
             Specifies the command to use to connect to the server. If
             this option is provided then ssh will ignore command line
             arguments such as "destination" and "-p port". Instead,
             Ssh will run the given command, and will attempt to
             communicate with the remote server via the standard input
             and output of the command's process. Specifying no proxy
             command is equivalent to "ProxyCommand nc host port"
             (where "nc" is the "netcat" utility).

             The command string extends to the end of the line. The
             command is executed using the user's shell `exec'
             directive to avoid a lingering shell process. [...]

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