X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=blobdiff_plain;f=doc%2Fplink.but;h=cecdcb03d8ac1fe5f07fdd767ed6631ff1bad647;hb=15386cbe927fc85ac2fed0bb47704645c4b67dad;hp=ec5d162c57920c801d0bc03993a693ad919c43b6;hpb=830b7f8898bf05c95e97ba6cc88692637cc8f60a;p=PuTTY.git

diff --git a/doc/plink.but b/doc/plink.but
index ec5d162c..cecdcb03 100644
--- a/doc/plink.but
+++ b/doc/plink.but
@@ -233,6 +233,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