- markus@cvs.openbsd.org 2001/06/26 17:25:34

     [ssh.1]
     document SSH_ASKPASS; fubob@MIT.EDU

diff --git a/ChangeLog b/ChangeLog
index 9b742a7b98396cfe3ae1cea29725ed45c18e82e7..36aaa42c0eac86e6f3b561fc57262adc7dd4e83a 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -59,6 +59,9 @@
       servconf.c servconf.h session.c sshconnect1.c sshd.c]
      Kerberos v5 support for SSH1, mostly from Assar Westerlund 
      <assar@freebsd.org> and Bjorn Gronvall <bg@sics.se>. markus@ ok
+   - markus@cvs.openbsd.org 2001/06/26 17:25:34
+     [ssh.1]
+     document SSH_ASKPASS; fubob@MIT.EDU
 
 20010629
  - (bal) Removed net_aton() since we don't use it any more

diff --git a/ssh.1 b/ssh.1
index f56b330f1e55b2e858e4a0b0bf5166f5d94cf09a..05112812c39710572fc830c99166c47e3c06ef6f 100644 (file)
--- a/ssh.1
+++ b/ssh.1
@@ -34,7 +34,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $OpenBSD: ssh.1,v 1.117 2001/06/23 17:48:19 itojun Exp $
+.\" $OpenBSD: ssh.1,v 1.118 2001/06/26 17:25:34 markus Exp $
 .Dd September 25, 1999
 .Dt SSH 1
 .Os
@@ -1138,6 +1138,29 @@ Set to the default
 .Ev PATH ,
 as specified when compiling
 .Nm ssh .
+.It Ev SSH_ASKPASS
+If
+.Nm
+needs a passphrase, it will read the passphrase from the current
+terminal if it was run from a terminal.
+If
+.Nm
+does not have a terminal associated with it but
+.Ev DISPLAY
+and
+.Ev SSH_ASKPASS
+are set, it will execute the program specified by
+.Ev SSH_ASKPASS
+and open an X11 window to read the passphrase.
+This is particularly useful when calling
+.Nm
+from a
+.Pa .Xsession
+or related script.
+(Note that on some machines it
+may be necessary to redirect the input from
+.Pa /dev/null
+to make this work.)
 .It Ev SSH_AUTH_SOCK
 indicates the path of a unix-domain socket used to communicate with the
 agent.