[Bug 3968] New: Confusing command-line parsing error and incomplete ssh manpage

bugzilla-daemon at mindrot.org bugzilla-daemon at mindrot.org
Tue Jun 16 00:33:02 AEST 2026


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

            Bug ID: 3968
           Summary: Confusing command-line parsing error and incomplete
                    ssh manpage
           Product: Portable OpenSSH
           Version: 10.3p1
          Hardware: Other
                OS: Linux
            Status: NEW
          Severity: minor
          Priority: P5
         Component: ssh
          Assignee: unassigned-bugs at mindrot.org
          Reporter: xspielinbox+mindrot at protonmail.com

Created attachment 3964
  --> https://bugzilla.mindrot.org/attachment.cgi?id=3964&action=edit
proposed fix for ssh error handling and manpage

1. The Match directive is not supported on the command-line but the
error references the Host directive.
2. The RefuseConnection, VersionAddendum and WarnWeakCrypto are not
documented in ssh.1 even though there are allowed there.
3. The directives Host and Include are listed in ssh.1, but actually
are not supported there. It is confusing to list them there.
4. The options in ssh_config.5 are sorted alphabetically, but the list
of options in ssh.1 is not. This is confusing.
5. The Host and Match directive that are exclusive to the ssh config
files are documented at the top of ssh_config.5, but Include is hidden
in the rest of the options, even though it is exclusive to the config
files in the same way.

The attached patch fixes all of the above.

If any of the above-mentioned is actually intentional and should not be
changed in the proposed way, I can also provide an updated patch.

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


More information about the openssh-bugs mailing list