Bug#979868: /usr/share/man/man1/ssh.1.gz: ssh(1) doesn't document -D supporting named Unix sockets
Package: openssh-client
Version: 1:8.4p1-3
Severity: minor
File: /usr/share/man/man1/ssh.1.gz
Tags: upstream patch
Hello,
while I experimented with ssh I noticed that -D supports using Unix
sockets but this is undocumented in the manpage.
I have no experience about bug/patch submitting upstream, so I'm just
reporting here with a patch. Feel free to forward accordingly.
Best regards
Uwe
-------->8--------
From: Uwe Kleine-König <ukleinek@debian.org>
Date: Tue, 12 Jan 2021 09:13:28 +0100
Subject: [PATCH] ssh(1): Document -D supporting Unix sockets
The option -D supports (similar to -L) to use a named Unix socket
instead of binding to a port. Add this feature to the manpage.
---
ssh.1 | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
diff --git a/ssh.1 b/ssh.1
index ad48fc8c816a..f67ee14d12f1 100644
--- a/ssh.1
+++ b/ssh.1
@@ -46,7 +46,7 @@
.Op Fl B Ar bind_interface
.Op Fl b Ar bind_address
.Op Fl c Ar cipher_spec
-.Op Fl D Oo Ar bind_address : Oc Ns Ar port
+.Op Fl D Ar socketspec
.Op Fl E Ar log_file
.Op Fl e Ar escape_char
.Op Fl F Ar configfile
@@ -173,14 +173,21 @@ for more information.
.Ar port
.Sm on
.Xc
+.It Fl D Xo
+.Sm off
+.Ar local_socket
+.Sm on
+.Xc
Specifies a local
.Dq dynamic
application-level port forwarding.
This works by allocating a socket to listen to
.Ar port
on the local side, optionally bound to the specified
-.Ar bind_address .
-Whenever a connection is made to this port, the
+.Ar bind_address
+or the specified Unix socket
+.Ar local_socket .
+Whenever a connection is made to this socket, the
connection is forwarded over the secure channel, and the application
protocol is then used to determine where to connect to from the
remote machine.
--
2.29.2
-- System Information:
Debian Release: bullseye/sid
APT prefers testing-debug
APT policy: (700, 'testing-debug'), (700, 'stable-updates'), (700, 'testing'), (700, 'stable'), (600, 'unstable'), (500, 'unstable-debug'), (500, 'stable-debug'), (500, 'oldstable-updates'), (500, 'oldstable'), (499, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386, armhf
Kernel: Linux 5.10.0-1-amd64 (SMP w/4 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Versions of packages openssh-client depends on:
ii adduser 3.118
ii dpkg 1.20.5
ii libc6 2.31-9
ii libedit2 3.1-20191231-2+b1
ii libfido2-1 1.5.0-2
ii libgssapi-krb5-2 1.18.3-4
ii libselinux1 3.1-2+b2
ii libssl1.1 1.1.1i-1
ii passwd 1:4.8.1-1
ii zlib1g 1:1.2.11.dfsg-2
Versions of packages openssh-client recommends:
ii xauth 1:1.0.10-1
Versions of packages openssh-client suggests:
pn keychain <none>
pn libpam-ssh <none>
pn monkeysphere <none>
pn ssh-askpass <none>
-- no debconf information
Reply to: