.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKNOTIFY "1" "juillet 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
pknotify \- page de manuel de pknotify 1.26_unofficial
.SH DESCRIPTION
pknotify v1.26_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
.PP
Notifie ou pose des questions aux utilisateurs finaux qui ont lancé l'application PyKotIcon.
.PP
ligne de commande :
.TP
pknotify
[options]  [arguments]
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Affiche le numéro de version de pknotify et quitte.
.TP
\fB\-h\fR | \fB\-\-help\fR
Affiche ce message et quitte.
.TP
\fB\-d\fR | \fB\-\-destination\fR h[:p]
Indique l'hôte destination et le port optionel
sur lesquels contacter l'application distante
PyKotIcon. Cette option est obligatoire.
S'il n'est pas spécifié, le port par défaut
est 7654.
.TP
\fB\-a\fR | \fB\-\-ask\fR
Indique à pknotify de demander quelque chose à
l'utilisateur distant. Ensuite pknotify va
afficher le résultat.
.TP
\fB\-C\fR | \fB\-\-checkauth\fR
Quand \fB\-\-ask\fR est utilisé et qu'à la fois un
champ 'username' et un champ 'password' sont
demandés à l'utilisateur final, alors pkotify
tentera d'authentifier l'utilisateur avec
PAM. Si l'authentification réussit, ce programme
affichera "AUTH=YES", sinon "AUTH=NO".
Si un champ manque, "AUTH=IMPOSSIBLE" sera
affiché. Si l'utilisateur est authentifié, alors
"USERNAME=xxxx" sera également affiché.
.TP
\fB\-c\fR | \fB\-\-confirm\fR
Indique à pknotify de demander si l'utilisateur
veut confirmer ou annuler.
.TP
\fB\-D\fR | \fB\-\-denyafter\fR N
Avec l'option \fB\-\-checkauth\fR ci\-dessus, indique à
pknotify de faire jusqu'à N tentatives tant que
le mot de passe est incorrect.
Après avoir atteint la limite, "DENY" sera
affiché, ce qui rejettera en fait le travail.
La valeur par défaut de N est 1, qui indique
que le travail sera rejeté dès la première
tentative infructueuse.
.TP
\fB\-N\fR | \fB\-\-noremote\fR action
S'il est impossible de se connecter à la machine
PyKotIcon distante, fait cette action à la place.
Les actions autorisées sont 'CONTINUE' et 'CANCEL',
qui vont respectivement autoriser le traitement du
travail d'impression à continuer, ou bien le travail
sera annulé. La valeur par défaut est CANCEL.
.TP
\fB\-n\fR | \fB\-\-notify\fR
Indique à pknotify d'envoyer un message
d'information à l'utilisateur final.
.TP
\fB\-q\fR | \fB\-\-quit\fR
Indique à pknotify d'envoyer un message demandant
à l'application PyKotIcon de quitter. Cette option
peut être combinée avec les autres pour faire en
sort que PyKotIcon quitte après avoir renvoyé la
réponse de la boite de dialogue.
.TP
\fB\-t\fR | \fB\-\-timeout\fR T
Indique à pknotify d'ignorer la réponse venant de
l'utilisateur s'il a mis plus de T secondes à
répondre après que la boite de dialogue ait été
ouverte. La valeur par défaut est 0 seconde, qui
indique à pknotify d'attendre indéfiniment.
Utilisez cette option pour éviter qu'un
utilisateur qui a quitté son ordinateur ne
bloque inutilement la file d'impression.
.IP
Vous DEVEZ spécifier soit \fB\-\-ask\fR, \fB\-\-confirm\fR, \fB\-\-notify\fR ou \fB\-\-quit\fR.
.IP
arguments :
.HP
\fB\-a\fR | \fB\-\-ask\fR : Plusieurs arguments sont acceptés, de la forme
.IP
"label:varname:defaultvalue". Le résultat sera
envoyé sur stdout dans le format suivant :
NOMVARIABLE1=VALEURVARIABLE1
NOMVARIABLE2=VALEURVARIABLE2
\&...
Si le dialogue à été annulé, rien ne sera affiché.
Si l'un des noms de variables est 'password'
alors ce champ sera saisi comme un mot de passe (vous ne
verrez pas ce que vous tapez), et il NE SERA PAS affiché.
Bien qu'il ne soit pas affiché, il sera utilisé pour
vérifier si l'authentification est valide si vous avez
utilisé \fB\-\-checkauth\fR.
.TP
\fB\-c\fR | \fB\-\-confirm\fR : Un unique argument est attendu, qui représente le
message à afficher. Si le dialogue est confirmé
alors pknotify affichera OK, sinon CANCEL.
.TP
\fB\-n\fR | \fB\-\-notify\fR : Un unique argument est attendu, qui représente le
message à afficher. Dans ce cas pknotify affichera
toujours OK.
.PP
exemples :
.IP
pknotify \fB\-d\fR client:7654 \fB\-\-noremote\fR CONTINUE \fB\-\-confirm\fR "Ce travail coûte 10 crédits"
.IP
Ceci afficherait le coût du travail d'impression et demanderait une confirmation.
Si l'utilisateur final n'a pas PyKotIcon actif et acceptant les connexions entrantes
depuis le serveur d'impression, PyKota considèrera que l'utilisateur a accepté
d'imprimer ce travail.
.IP
pknotify \fB\-\-destination\fR $PYKOTAJOBORIGINATINGHOSTNAME:7654 \e
.IP
\fB\-\-checkauth\fR \fB\-\-ask\fR "Votre nom:username:" "Votre mot de passe:password:"
.IP
Demandera un nom d'utilisateur et un mot de passe, et vérifiera s'ils sont
valides.
NB : La variable d'environnement PYKOTAJOBORIGINATINGHOSTNAME est
seulement positionnée lorsque vous lancez pknotify depuis cupspykota
grâce à une directive de ~pykota/pykota.conf
.IP
Le port TCP que vous utiliserez doit être ouvert sur le client et joignable
depuis le serveur d'impression.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Merci d'envoyer les rapports de bugs à : Jerome Alet \- alet@librelogiciel.com