Update docs/usage for 'plink -shareexists'.

diff --git a/doc/config.but b/doc/config.but
index 82656cd27fc4415e859a77dd8cf9984f30a6231d..5107858c5f54d4f52c2b06927c21466738817108 100644 (file)
--- a/doc/config.but
+++ b/doc/config.but
@@ -2353,6 +2353,9 @@ with sharing enabled, then it can act as a downstream and use an
 existing SSH connection set up by an instance of GUI PuTTY. The one
 special case is that PSCP and PSFTP will \e{never} act as upstreams.
 
+It is possible to test programmatically for the existence of a live
+upstream using Plink. See \k{plink-option-shareexists}.
+
 \H{config-ssh-kex} The Kex panel
 
 The Kex panel (short for \q{\i{key exchange}}) allows you to configure

diff --git a/doc/index.but b/doc/index.but
index 77b3493a59b2f75742817527157281b36cc2dbe2..204430ce80396b6fad6855b99bb3da708b1e17ba 100644 (file)
--- a/doc/index.but
+++ b/doc/index.but
@@ -766,6 +766,7 @@ saved sessions from
 
 \IM{-batch-plink} \c{-batch} Plink command-line option
 \IM{-s-plink} \c{-s} Plink command-line option
+\IM{-shareexists-plink} \c{-shareexists} Plink command-line option
 
 \IM{subsystem} subsystem, SSH
 \IM{subsystem} SSH subsystem

diff --git a/doc/plink.but b/doc/plink.but
index c45312c56ae8d57cfcdb1f33091f0738b235e906..553639e6e97cc8bf2d237f84db195491cb5801c1 100644 (file)
--- a/doc/plink.but
+++ b/doc/plink.but
@@ -41,7 +41,7 @@ use Plink:
 
 \c Z:\sysosd>plink
 \c Plink: command-line connection utility
-\c Release 0.65
+\c Release 0.XX
 \c Usage: plink [options] [user@]host [command]
 \c        ("host" can also be a PuTTY saved session name)
 \c Options:
@@ -80,6 +80,8 @@ use Plink:
 \c   -N        don't start a shell/command (SSH-2 only)
 \c   -nc host:port
 \c             open tunnel in place of session (SSH-2 only)
+\c   -shareexists
+\c             test whether a connection-sharing upstream exists
 
 Once this works, you are ready to use Plink.
 
@@ -230,6 +232,27 @@ line.
 
 (This option is only meaningful with the SSH-2 protocol.)
 
+\S2{plink-option-shareexists} \I{-shareexists-plink}\c{-shareexists}:
+test for connection-sharing upstream
+
+This option does not make a new connection; instead it allows testing
+for the presence of an existing connection that can be shared.
+(See \k{config-ssh-sharing} for more information about SSH connection
+sharing.)
+
+A Plink invocation of the form:
+
+\c plink -shareexists <session>
+\e                    iiiiiiiii
+
+will test whether there is currently a viable \q{upstream} for the
+session in question, which can be specified using any syntax you'd
+normally use with Plink to make an actual connection (a host/port
+number, a bare saved session name, \c{-load}, etc). It returns a
+zero exit status if a usable \q{upstream} exists, nonzero otherwise.
+
+(This option is only meaningful with the SSH-2 protocol.)
+
 \H{plink-batch} Using Plink in \i{batch files} and \i{scripts}
 
 Once you have set up Plink to be able to log in to a remote server

diff --git a/unix/uxplink.c b/unix/uxplink.c
index ad122e9da4b3959f65a71f3824de1e7f3c86eb77..8351a6ea7280528acbe8660a0db18e66237823c0 100644 (file)
--- a/unix/uxplink.c
+++ b/unix/uxplink.c
@@ -581,6 +581,8 @@ static void usage(void)
     printf("  -N        don't start a shell/command (SSH-2 only)\n");
     printf("  -nc host:port\n");
     printf("            open tunnel in place of session (SSH-2 only)\n");
+    printf("  -shareexists\n");
+    printf("            test whether a connection-sharing upstream exists\n");
     exit(1);
 }
 

diff --git a/windows/winplink.c b/windows/winplink.c
index 8ffa4651030c9901b5a2f3d0923af1424f29b381..78311b59ed7fa5c424905f87dd1fbcbe0de6e053 100644 (file)
--- a/windows/winplink.c
+++ b/windows/winplink.c
@@ -212,6 +212,8 @@ static void usage(void)
     printf("  -N        don't start a shell/command (SSH-2 only)\n");
     printf("  -nc host:port\n");
     printf("            open tunnel in place of session (SSH-2 only)\n");
+    printf("  -shareexists\n");
+    printf("            test whether a connection-sharing upstream exists\n");
     exit(1);
 }