.Dd 17 Septembre 2001 .Dt x11-ssh-askpass 1 .Os "Version 1.2.4.1"

Nom

.Nm x11-ssh-askpass .Nd une boîte de dialogue X11 de demande de mot de passe à utiliser avec OpenSSH

Résumé

.Nm x11-ssh-askpass .Op options .Op label

Description

.Nm est une une boîte de dialogue X11 de demande de mot de passe (passphrase) à utiliser avec OpenSSH. Le programme .Xr ssh-add 1 l'appelle, et il n'est pas lancé directement par l'utilisateur.

.Nm supporte la plupart des options des boîtes à outils graphiques, à l'exception des suivantes : .Ar -geometry , .Ar -borderwidth , .Ar -iconic , .Ar -rv , et .Ar -title . Voir .Xr X 1 .

Si une et une seule non-option est fournie sur la ligne de commande, .Nm l'affiche dans la boîte de dialogue à la place de l'étiquette par défaut. Si cet argument contient le caractère nouvelle ligne (newline) «
», .Nm affiche chaque ligne de texte sur une ligne différente dans la boîte de dialogue.

Les fonctionnalités de .Nm sont les suivantes : .Bl -dash -offset indent .It Configurable à l'aide des mécanismes standard liés aux ressources X .Pa /usr/X11R6/lib/X11/app-defaults , .Pa ~/.Xdefaults , .Xr xrdb 1 , etc. .It Nécessite seulement les librairies X11 de base (%libXt, %libX11, %libSM, %libICE). .It Configurable pour utiliser le clavier et/ou la souris (par défaut, n'utilise que le clavier et pas la souris). .El

L'interface utilisateur est assez différente de la plupart des boîtes de dialogue de demande de mots de passe, et est plus proche de la boîte de dialogue X11 fournie avec la distribution de SSH habituelle. À la place d'un champ textuel qu'on emplit avec des astérisques ou d'autres caractères quand on saisit un mot de passe, une série de zones qui ressemblent à des diodes s'allument l'une après l'autre à chaque caractère saisi, à partir du bord gauche. Quand les diodes atteignent le bord droit, elles s'éteignent une par une, et ainsi de suite ... Ceci permet à l'utilisateur de voir qu'il a saisi un caractère, mais ne donne aucune indication sur la longueur du mot de passe.

Quand on appuie sur le bouton « OK », on valide le mot de passe (même s'il est vide), qui est affiché sur la sortie standard, et la boîte de dialogue se termine avec un code de retour de 0 (succès). Si on appuie sur le bouton « Cancel », on annule le mot de passe, et la boîte de dialogue se ferme avec un code de retour non nul.

Les saisies des séquences suivantes fonctionnent comme décrit ci-après : .Bl -tag -width "[Backspace]" -offset indent -compact

.It Bq <-- .It Bq Suppr Efface le caractère précédent

.It Bq Ctrl+U .It Bq Ctrl+X Efface le mot de passe en entier

.It Bq Entrée .It Bq Ctrl+M .It Bq Ctrl+J Valide le mot de passe (OK)

.It Bq Échap Annule le mot de passe (Cancel) .El

Widgets

La fenêtre principale de .Nm dispose d'une hiérarchie de widgets (éléments graphiques) comme décrite ci-après. Le nom de la classe du widget apparaît en premier, suivi du nom de l'instance. .Bl -tag -width "Dialog" -offset indent .It Dialog dialog

.Bl -tag -width "Indicator" -compact .It Indicator indicator .It Button okButton .It Button cancelButton .El .El

Ressources

Les ressources suivantes sont utilisées pour personnaliser globalement l'application : .Bl -tag -width 2n -offset indent .It Cm grabKeyboard ( No classe Cm GrabKeyboard ) .Bl -inset -compact .It Spécifie si l'application doit utiliser le clavier. .It Par défaut « True ». .El .It Cm grabPointer ( No classe Cm GrabPointer ) .Bl -inset -compact .It Spécifie si l'application doit utiliser la souris. .It Par défaut « False ». .El .It Cm grabServer ( No classe Cm GrabServer ) .Bl -inset -compact .It Spécifie si l'application doit utiliser le serveur. .It Par défaut « False ». .El .It Cm inputTimeout ( No classe Cm InputTimeout ) .Bl -inset -compact .It Nombre de secondes d'attente avant d'appuyer sur une touche du clavier ou sur un bouton de la boîte de dialogue. Si cette temporisation est dépassée, .Nm abandonne et se termine. Une temporisation de « 0 » signifie que .Nm attend sans fin. .It Par défaut « 0 ». .El .It Cm defaultXResolution ( No classe Cm DefaultXResolution ) .Bl -inset -compact .It Nombre de pixels par unité de longueur pour les largeurs et les espacements horizontaux. Si la résolution horizontale (x) du serveur X est dans des proportions significatives plus grande ou plus petite que cette valeur, des parties de la boîte de dialogue sont étirées ou réduites horizontalement pour prendre en compte la différence. La valeur est un entier positif, suivi d'une barre (slash) « / », puis d'une abréviation d'unité sur un ou deux caractères. Les unités acceptées sont les pouces .Cm ( in ou .Cm i ) et les mètres .Cm ( m ) . .It Par défaut « 75/in » (75 pixels par pouce). .El .It Cm defaultYResolution ( No classe Cm DefaultYResolution ) .Bl -inset -compact .It Nombre de pixels par unité de longueur pour les largeurs et les espacements verticaux. Si la résolution verticale (y) du serveur X est dans des proportions significatives plus grande ou plus petite que cette valeur, des parties de la boîte de dialogue sont étirées ou réduites verticalement pour prendre en compte la différence. Les valeurs acceptées sont identiques à celles décrites ci-avant. .It Par défaut « 75/in » (75 pixels par pouce). .El .It Cm xResolutionFuzz ( No classe Cm XResolutionFuzz ) .Bl -inset -compact .It Variation au-delà de laquelle on ne redimensionne pas horizontalement pour correspondre à la résolution horizontale réelle. Les résolutions acceptées sont les mêmes que pour .Cm defaultXResolution . Par exemple, si la résolution X est « 75/in » et la variation est « 50/in », les widgets ne seront redimensionnés horizontalement que si la résolution réelle est inférieure à 25 pixels par pouce ou supérieure à 125 pixels par pouce. .It Par défaut « 20/in » (20 pixels par pouce). .El .It Cm yResolutionFuzz ( No classe Cm YResolutionFuzz ) .Bl -inset -compact .It Variation au-delà de laquelle on ne redimensionne pas horizontalement pour correspondre à la résolution horizontale réelle. Les résolutions acceptées sont les mêmes que pour .Cm defaultXResolution . .It Par défaut « 20/in » (20 pixels par pouce). .El .El

Les ressources suivantes sont reconnues par le widget « Dialog » : .Bl -tag -width 2n -offset indent .It Cm title ( No classe Cm Title ) Titre de l'application tel qu'il est spécifié au gestionnaire de fenêtres. .It Cm label ( No classe Cm Label ) Étiquette affichée au-dessus des indicateurs en forme de diode. .It Cm font ( No classe Cm Font ) Police de caractères utilisée pour afficher l'étiquette. .El

Les ressources suivantes sont reconnues par les widgets boîte de dialogue, bouton, indicateurs et le widget principal pour personnaliser l'apparence 3D (toutes les tailles sont en pixels) : .Bl -tag -width 2n -offset indent .It Cm foreground ( No classe Cm Foreground ) Couleur d'avant-plan du widget. C'est la couleur du texte pour les boutons et la boîte de dialogue, et la couleur de la diode active pour l'indicateur. .It Cm background ( No classe Cm Background ) Couleur d'arrière-plan du widget. Pour l'indicateur, c'est la couleur de la diode inactive. .It Cm topShadowColor ( No classe Cm TopShadowColor ) Couleur des bords du widget exposés à la lumière (haut et gauche). .It Cm bottomShadowColor ( No classe Cm BottomShadowColor ) Couleur des bords du widget à l'ombre (bas et droite). .It Cm shadowThickness ( No classe Cm ShadowTickness ) Épaisseur de la bordure 3D du widget. .It Cm borderColor ( No classe Cm BorderColor ) Couleur de la bordure autour du widget. .It Cm borderWidth ( No classe Cm BorderWidth ) Largeur de la bordure autour du widget. .It Cm horizontalSpacing ( No classe Cm HorizontalSpacing ) Espacement sur la gauche et la droite du widget. .It Cm verticalSpacing ( No classe Cm VerticalSpacing ) Espacement en haut et en bas du widget. .El

Les ressources suivantes sont reconnues par les widgets « indicateurs » : .Bl -tag -width 2n -offset indent .It Cm minimumCount ( No classe Cm MinimumCount ) Nombre minimal d'indicateurs à afficher dans la boîte de dialogue. .It Cm maximumCount ( No classe Cm MaximumCount ) Nombre maximal d'indicateurs à afficher dans la boîte de dialogue. .El

Chaque bouton utilise les ressources suivantes pour personnaliser son étiquette : .Bl -tag -width 2n -offset indent .It Cm label ( No classe Cm Label ) Chaîne de caractères à afficher sur le bouton. .It Cm font ( No classe Cm Font ) Police de caractères à appliquer à l'étiquette du bouton. .El

Fichiers

.Bl -tag -width "/usr/X11R6/lib/X11/app-defaults/SshAskpass" -compact .It Pa /usr/X11R6/lib/X11/app-defaults/SshAskpass .El

Voir aussi

.Xr X 1 , .Xr ssh 1 , .Xr ssh-agent 1

Licence

Des morceaux de .Nm sont dérivés directement ou indirectement de morceaux de xscreensaver de Jamie Zawinski <jwz@jwz.org>, alors que d'autres sont des travaux originaux.

xscreensaver, Copyright (co 1991-1999 Jamie Zawinski .Aq jwz@jwz.org

Permission d'utiliser, copier, modifier, distribuer, et vendre ce logiciel et sa documentation dans n'importe quel but sans honoraires, à condition que le susdit avis de droit d'auteur apparaisse dans toutes les copies et que tant cet avis de droit d'auteur que cet avis de permission apparaissent dans la documentation l'accompagnant. Aucune représentation n'est faite de la pertinence de ce logiciel pour aucun but. On le fournit "tel quel" sans garantie expresse ou implicite.

Les morceaux restants sont sous les licence et copyright suivants :

.Nm par Jim Knoble .Aq jmknoble@pobox.com Copyright (co 1999,2000,2001 Jim Knoble

Permission d'utiliser, copier, modifier, distribuer et vendre ce logiciel et sa documentation pour n'importe quel but sans honoraires, à condition que le susdit avis de droit d'auteur apparaisse dans toutes les copies et que tant cet avis de droit d'auteur que cet avis de permission apparaissent dans la documentation l'accompagnant.

(Ndt : Pour les textes originaux des licences et avis de copyright, se référer aux textes originaux des pages de manuel)

Traduction

Laurent GAUTROT <l dot gautrot at free dot fr> 13/11/2002