.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKNOTIFY "1" "mars 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
pknotify \- page de manuel de pknotify 1.24beta_unofficial
.SH DESCRIPTION
pknotify v1.24beta_unofficial (c) 2003, 2004, 2005, 2006 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\-\-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
You MUST specify either \fB\-\-ask\fR, \fB\-\-confirm\fR, \fB\-\-notify\fR or \fB\-\-quit\fR.
.IP
arguments :
.HP
\fB\-a\fR | \fB\-\-ask\fR : Several arguments are accepted, or the form
.IP
"label:varname:defaultvalue". The result will
be printed to stdout in the following format :
VAR1NAME=VAR1VALUE
VAR2NAME=VAR2VALUE
\&...
If the dialog was cancelled, nothing will be
printed. If one of the varname is 'password'
then this field is asked as a password (you won't
see what you type in), and is NOT printed. Although
it is not printed, it will be used to check if
authentication is valid if you specify \fB\-\-checkauth\fR.
.TP
\fB\-c\fR | \fB\-\-confirm\fR : A single argument is expected, representing the
message to display. If the dialog is confirmed
then pknotify will print OK, else CANCEL.
.TP
\fB\-n\fR | \fB\-\-notify\fR : A single argument is expected, representing the
message to display. In this case pknotify will
always print OK.
.PP
examples :
.IP
pknotify \fB\-d\fR client:7654 \fB\-\-confirm\fR "This job costs :
.PP
10 credits !"
.IP
Would display the cost of a print job and asks for confirmation.
.IP
pknotify \fB\-\-destination\fR $PYKOTAJOBORIGINATINGHOSTNAME:7654 \e
.IP
\fB\-\-checkauth\fR \fB\-\-ask\fR "Your name:username:" "Your password:password:"
.IP
Asks an username and password, and checks if they are valid.
NB : The PYKOTAJOBORIGINATINGHOSTNAME environment variable is
only set if you launch pknotify from cupspykota through a directive
in ~pykota/pykota.conf
.IP
The TCP port you'll use must be reachable on the client from the
print server.
.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