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 <uklei...@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 via email to