217 lines
8.6 KiB
HTML
217 lines
8.6 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of ipptool</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>ipptool</H1>
|
||
Section: Apple Inc. (1)<BR>Updated: CUPS<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>NOM</H2>
|
||
|
||
ipptool - Réaliser des requêtes d’impression par internet
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
<B>ipptool</B> [ <B>--help</B> ] [ <B>--ippserver</B> <I>filename</I> ] [
|
||
<B>--stop-after-include-error</B> ] [ <B>--version</B> ] [ <B>-4</B> ] [ <B>-6</B> ] [ <B>-C</B>
|
||
] [ <B>-E</B> ] [ <B>-I</B> ] [ <B>-L</B> ] [ <B>-P</B> <I>filename.plist</I> ] [ <B>-S</B> ] [
|
||
<B>-T</B> <I>seconds</I> ] [ <B>-V</B> <I>version</I> ] [ <B>-X</B> ] [ <B>-c</B> ] [ <B>-d</B>
|
||
<I>name=value</I> ] [ <B>-f</B> <I>filename</I> ] [ <B>-h</B> ] [ <B>-i</B> <I>seconds</I> ] [ <B>-n</B>
|
||
<I>repeat-count</I> ] [ <B>-q</B> ] [ <B>-t</B> ] [ <B>-v ]</B> <I>printer-uri</I> <I>testfile</I> [
|
||
... <I>testfile</I> ]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
<B>ipptool</B> envoie des requêtes IPP à l’<I>uri_imprimante</I> indiqué puis teste
|
||
et/ou affiche les résultats. Chaque fichier nommé <I>fichier_test</I> définit
|
||
une ou plusieurs requêtes, incluant les états, les attributs, et les valeurs
|
||
des réponses attendues. La sortie est soit du texte pur, du texte formaté,
|
||
du CSV ou un compte-rendu XML affiché sur la sortie standard, avec un état
|
||
d’erreur non nul signifiant qu’un ou plusieurs tests ont échoués. Le format
|
||
du <I>fichier_test</I> est décrit dans <B><A HREF="/cgi-bin/man/man2html?5+ipptoolfile">ipptoolfile</A></B>(5).
|
||
<A NAME="lbAE"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
Les options suivantes sont reconnues par <B>ipptool</B> :
|
||
<DL COMPACT>
|
||
<DT id="1"><B>--help</B><DD>
|
||
Afficher l’aide du programme.
|
||
<DT id="2"><B>--ippserver </B><I>filename</I><DD>
|
||
Specifies that the test results should be written to the named <B>ippserver</B>
|
||
attributes file.
|
||
<DT id="3"><B>--stop-after-include-error</B><DD>
|
||
Indiquer à <B>ipptool</B> d’arrêter si une erreur survient dans un fichier
|
||
inclus. Normalement <B>ipptool</B> continuera les tests suivants après la
|
||
directive INCLUDE.
|
||
<DT id="4"><B>--version</B><DD>
|
||
Afficher la version de <B>ipptool</B> utilisée.
|
||
<DT id="5"><B>-4</B><DD>
|
||
Indiquer que <B>ipptool</B> doit se connecter à l’imprimante ou au serveur en
|
||
utilisant IPv4.
|
||
<DT id="6"><B>-6</B><DD>
|
||
Indiquer que <B>ipptool</B> doit se connecter à l’imprimante ou au serveur en
|
||
utilisant IPv6.
|
||
<DT id="7"><B>-C</B><DD>
|
||
Indiquer que les requêtes doivent être envoyées avec l’en-tête de HTTP/1.1
|
||
« Transfer-Encoding: chunked », comme exigé pour conformité par toutes les
|
||
versions d’IPP. Par défaut « Transfer-Encoding: chunked » est utilisé pour
|
||
les requêtes avec des fichiers joints et « Content-Length: » pour des
|
||
requêtes sans fichier joint
|
||
<DT id="8"><B>-E</B><DD>
|
||
Forcer le chiffrement TLS lors de la connexion au serveur en utilisant
|
||
l’en-tête HTTP « Upgrade ».
|
||
<DT id="9"><B>-I</B><DD>
|
||
Indiquer que <B>ipptool</B> continuera après les erreurs.
|
||
<DT id="10"><B>-L</B><DD>
|
||
Indiquer que les requêtes seront envoyées avec l’en-tête HTTP/1.0
|
||
« Content-Length: », comme exigé pour conformité par toutes les versions
|
||
d’IPP. Par défaut « Transfer-Encoding: chunked » est utilisé pour les
|
||
requêtes avec fichiers joints et « Content-Length: » pour celles sans
|
||
fichier joint.
|
||
<DT id="11"><B>-P</B><I> nom_fichier.plist</I><DD>
|
||
Indiquer que les résultats de test devront être écrits dans le XML nommé
|
||
(plist d’Apple) en plus du rapport de test normal <B>-t</B>. Cette option est
|
||
incompatible avec les options <B>-i</B> (intervalle) et <B>-n</B>
|
||
(nombre_répétitions).
|
||
<DT id="12"><B>-S</B><DD>
|
||
Forcer le chiffrement TLS dédié lors de la connexion au serveur.
|
||
<DT id="13"><B>-T</B><I> secondes</I><DD>
|
||
Définir le délai d'attente des requêtes IPP (en seconde).
|
||
<DT id="14"><B>-V</B><I> version</I><DD>
|
||
Définir la version par défaut d’IPP à utiliser : 1.0, 1.1, 2.0, 2.1, ou
|
||
2.2. Sans indication, la version 1.1 sera utilisée.
|
||
<DT id="15"><B>-X</B><DD>
|
||
Indiquer qu’une sortie XML (plist d’Apple) est demandée plutôt qu’en texte
|
||
pur. Cette option est incompatible avec les options <B>-i</B> (intervalle) et
|
||
<B>-n</B> (nombre_répétitions).
|
||
<DT id="16"><B>-c</B><DD>
|
||
Indiquer qu’une sortie CSV (valeurs séparées par des virgules) est demandée
|
||
plutôt qu’en texte pur.
|
||
<DT id="17"><B>-d</B><I> nom=valeur</I><DD>
|
||
Définir la variable nommée.
|
||
<DT id="18"><B>-f</B><I> nom_fichier</I><DD>
|
||
Indiquer le nom du fichier de requêtes par défaut pour les tests.
|
||
<DT id="19"><B>-h</B><DD>
|
||
Valider les en-têtes de réponse HTTP.
|
||
<DT id="20"><B>-i</B><I> secondes</I><DD>
|
||
Indiquer que le (dernier) fichier <I>fichier_test</I> sera repris après
|
||
l’intervalle donné. Cette option est incompatible avec l’option <B>-X</B>
|
||
(sortie plist XML).
|
||
<DT id="21"><B>-l</B><DD>
|
||
Définir si une sortie en texte pur est désirée.
|
||
<DT id="22"><B>-n</B> <I> nombre_répétitions</I><DD>
|
||
Indiquer que le (dernier) fichier <I>fichier_test</I> sera repris le nombre de
|
||
fois donné. Cette option est incompatible avec l’option <B>-X</B> (sortie plist
|
||
XML).
|
||
<DT id="23"><B>-q</B><DD>
|
||
Rester silencieux et ne produire aucune sortie
|
||
<DT id="24"><B>-t</B><DD>
|
||
Définir si le rapport de test de CUPS plutôt qu’une sortie en texte pur est
|
||
désiré.
|
||
<DT id="25"><B>-v</B><DD>
|
||
Indiquer que tous les attributs de requête et réponse seront affichés lors
|
||
du mode test (<B>-t</B>) de CUPS. C’est la sortie XML par défaut.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>CODE DE RETOUR</H2>
|
||
|
||
Le programme <B>ipptool</B> retourne <B>0</B> si tous les tests réussissent, sinon
|
||
<B>1</B>.
|
||
<A NAME="lbAG"> </A>
|
||
<H2>FICHIERS</H2>
|
||
|
||
Les fichiers standard suivants sont disponibles :
|
||
<PRE>
|
||
<I>color.jpg</I>
|
||
<I>create-printer-subscription.test</I>
|
||
<I>document-a4.pdf</I>
|
||
<I>document-a4.ps</I>
|
||
<I>document-letter.pdf</I>
|
||
<I>document-letter.ps</I>
|
||
<I>get-completed-jobs.test</I>
|
||
<I>get-jobs.test</I>
|
||
<I>get-notifications.test</I>
|
||
<I>get-printer-attributes.test</I>
|
||
<I>get-subscriptions.test</I>
|
||
<I>gray.jpg</I>
|
||
<I>ipp-1.1.test</I>
|
||
<I>ipp-2.0.test</I>
|
||
<I>ipp-2.1.test</I>
|
||
<I>ipp-2.2.test</I>
|
||
<I>ipp-everywhere.test</I>
|
||
<I>onepage-a4.pdf</I>
|
||
<I>onepage-a4.ps</I>
|
||
<I>onepage-letter.pdf</I>
|
||
<I>onepage-letter.ps</I>
|
||
<I>print-job.test</I>
|
||
<I>print-job-deflate.test</I>
|
||
<I>print-job-gzip.test</I>
|
||
<I>testfile.jpg</I>
|
||
<I>testfile.pcl</I>
|
||
<I>testfile.pdf</I>
|
||
<I>testfile.ps</I>
|
||
<I>testfile.txt</I>
|
||
<I>validate-job.test</I>
|
||
</PRE>
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>CONFORMITÉ</H2>
|
||
|
||
Le programme <B>ipptool</B> est particulier à CUPS et est conforme au protocole
|
||
IPP jusqu’à la version 2.2.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>EXEMPLES</H2>
|
||
|
||
Obtenir une liste de travaux terminés pour « mon_imprimante » :
|
||
<PRE>
|
||
|
||
ipptool <A HREF="ipp://localhost/printers/mon_imprimante">ipp://localhost/printers/mon_imprimante</A> get-completed-jobs.test
|
||
</PRE>
|
||
|
||
<P>
|
||
|
||
Envoyer des notifications par courriel à « <A HREF="mailto:user@example.com">user@example.com</A> » quand
|
||
« mon_imprimante » change :
|
||
<PRE>
|
||
|
||
ipptool -d recipient=mailto:<A HREF="mailto:user@example.com">user@example.com</A> \
|
||
<A HREF="ipp://localhost/printers/mon_imprimante">ipp://localhost/printers/mon_imprimante</A> create-printer-subscription.test
|
||
</PRE>
|
||
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>VOIR AUSSI</H2>
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?5+ipptoolfile">ipptoolfile</A></B>(5), IANA IPP Registry
|
||
(<URL:<I><A HREF="http://www.iana.org/assignments/ipp-registrations1">http://www.iana.org/assignments/ipp-registrations1</A></I>>), PWG
|
||
Internet Printing Protocol Workgroup
|
||
(<URL:<I><A HREF="http://www.pwg.org/ipp1">http://www.pwg.org/ipp1</A></I>>), RFC 8011
|
||
(<URL:<I><A HREF="http://tools.ietf.org/html/rfc80111">http://tools.ietf.org/html/rfc80111</A></I>>)
|
||
<A NAME="lbAK"> </A>
|
||
<H2>COPYRIGHT</H2>
|
||
|
||
Copyright 2007-2019 par Apple Inc.
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="26"><A HREF="#lbAB">NOM</A><DD>
|
||
<DT id="27"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||
<DT id="28"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||
<DT id="29"><A HREF="#lbAE">OPTIONS</A><DD>
|
||
<DT id="30"><A HREF="#lbAF">CODE DE RETOUR</A><DD>
|
||
<DT id="31"><A HREF="#lbAG">FICHIERS</A><DD>
|
||
<DT id="32"><A HREF="#lbAH">CONFORMITÉ</A><DD>
|
||
<DT id="33"><A HREF="#lbAI">EXEMPLES</A><DD>
|
||
<DT id="34"><A HREF="#lbAJ">VOIR AUSSI</A><DD>
|
||
<DT id="35"><A HREF="#lbAK">COPYRIGHT</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:05:01 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|