diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 14:40:05 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 14:40:05 +0000 |
commit | e21fe8c3a4007c4a10f67e9e8107c3f083002f06 (patch) | |
tree | 926b3c2a4d3fd0decde08f6a4d22862ef03a7046 /debian/gnome-ssh-askpass.1 | |
parent | Adding upstream version 1:9.2p1. (diff) | |
download | openssh-debian/1%9.2p1-2+deb12u2.tar.xz openssh-debian/1%9.2p1-2+deb12u2.zip |
Adding debian version 1:9.2p1-2+deb12u2.debian/1%9.2p1-2+deb12u2
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/gnome-ssh-askpass.1')
-rw-r--r-- | debian/gnome-ssh-askpass.1 | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/debian/gnome-ssh-askpass.1 b/debian/gnome-ssh-askpass.1 new file mode 100644 index 0000000..4651b8b --- /dev/null +++ b/debian/gnome-ssh-askpass.1 @@ -0,0 +1,91 @@ +.\" Copyright (c) 2003-2022 Colin Watson <cjwatson@debian.org> +.\" Based on a manual page by Philip Hands for x11-ssh-askpass(1). +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.Dd $Mdocdate: November 14 2022 $ +.Dt GNOME-SSH-ASKPASS 1 +.Os +.Sh NAME +.Nm gnome-ssh-askpass +.Nd prompts a user for a passphrase using GNOME +.Sh SYNOPSIS +.Nm Op Ar message ... +.Sh DESCRIPTION +.Nm +is a GNOME-based passphrase dialog for use with OpenSSH. +It is intended to be called by the +.Xr ssh-add 1 +program and not invoked directly. +It allows +.Xr ssh-add 1 +to obtain a passphrase from a user, even if not connected to a terminal +(assuming that an X display is available). +This happens automatically in the case where +.Xr ssh-add 1 +is invoked from one's +.Pa ~/.xsession +or as one of the GNOME startup programs, for example. +.Pp +In order to be called automatically by +.Xr ssh-add 1 , +the +.Ev SSH_ASKPASS +environment variable should be set to point to the location of +.Nm , +or +.Nm +should be installed as +.Pa /usr/bin/ssh-askpass . +.Sh ENVIRONMENT +The following environment variables are recognized: +.Bl -tag -width "GNOME_SSH_ASKPASS_GRAB_POINTER" +.It Ev GNOME_SSH_ASKPASS_BG_COLOR +Text area background color, specified as hexadecimal RGB or RRGGBB, +optionally prefixed by +.Dq # +or +.Dq 0x . +.It Ev GNOME_SSH_ASKPASS_FG_COLOR +Text area foreground color, specified as hexadecimal RGB or RRGGBB, +optionally prefixed by +.Dq # +or +.Dq 0x . +.It Ev GNOME_SSH_ASKPASS_GRAB_POINTER +If set, causes +.Nm +to grab the mouse pointer before asking for a passphrase. +.It Ev GNOME_SSH_ASKPASS_GRAB_SERVER +If set, causes +.Nm +to grab the X server before asking for a passphrase. +.It Ev SSH_ASKPASS_PROMPT +If set to +.Li confirm , +show a yes-or-no prompt, defaulting to yes. +If set to +.Li none , +show a prompt with only a close button. +Otherwise, show an OK-or-cancel prompt, defaulting to OK. +This environment variable is typically set by +.Xr ssh-add 1 , +and should not normally be set manually. +.El +.Pp +Regardless of whether either +.Ev GNOME_SSH_ASKPASS_GRAB_POINTER +or +.Ev GNOME_SSH_ASKPASS_GRAB_SERVER +is set, +.Nm +will grab the keyboard. |