NAME

       ipptool - Internet-Printing-Protocol-Abfragen durchführen

SYNOPSIS

       ipptool  [ --help ] [ --stop-after-include-error ] [ --version ] [ -4 ] [ -6 ] [ -C ] [ -E
       ] [ -I ] [ -L ] [ -P Dateiname.plist ] [ -S ] [ -T Sekunden ] [ -V Version ] [ -X ] [ -c ]
       [ -d Name=Wert ] [ -f Dateiname ] [ -i Sekunden ] [ -n Anzahl-Wiederholungen ] [ -q ] [ -t
       ] [ -v ] Drucker-URI Testdatei [ …  Testdatei ]

BESCHREIBUNG

       ipptool sendet IPP-Anfragen an die angegebene Drucker-URI und überprüft das Ergebnis  oder
       zeigt  es  an.  Jede benannte Testdatei definiert eine oder mehrere Anfragen, dazu gehören
       der erwartete Antwortstatus, die Attribute und Werte.  Die  Ausgabe  ist  entweder  reiner
       Text,  formatierter  Text,  CSV oder ein XML-Bericht auf der Standardausgabe. Ein von Null
       verschiedener Exit-Status gibt an, dass eine oder mehrere Tests fehlgeschlagen  sind.  Das
       Format der Testdatei wird in ipptoolfile(5) beschrieben.

OPTIONEN

       Die folgenden Optionen werden von ipptool erkannt:

       --help
            Zeigt die Programmhilfe.

       --stop-after-include-error
            Teilt ipptool mit, abzubrechen, falls ein Fehler in der eingebundenen Datei auftritt.
            Normalerweise wird ipptool mit folgenden Tests nach der INCLUDE-Direktive fortfahren.

       --version
            Zeigt die verwandte Version von ipptool an.

       -4   Spezifiziert, dass ipptool sich zu dem Drucker oder Server mit IPv4 verbinden muss.

       -6   Spezifiziert, dass ipptool sich zu dem Drucker oder Server mit IPv6 verbinden muss.

       -C   Spezifiziert, dass Anfragen  mit  dem  HTTP/1.1-Header  »Transfer-Encoding:  chunked«
            gesendet  werden  sollen,  der für Konformität von allen IPP-Versionen verlangt wird.
            Standardmäßig wird »Transfer-Encoding: chunked« für Anfragen mit anhängenden  Dateien
            und »Content-Length:« für Anfragen ohne anhängende Dateien verwandt.

       -E   Erzwingt   TLS-Verschlüsselung  bei  Verbindungen  zum  Server  mit  dem  HTTP-Header
            »Upgrade«.

       -I   Spezifiziert, dass ipptool bei Fehlern fortfahren soll.

       -L   Spezifiziert, dass Anfragen mit dem HTTP/1.0-Header »Content-Length:« gesendet werden
            sollen, der für Konformität von allen IPP-Versionen verlangt wird. Standardmäßig wird
            »Transfer-Encoding:   chunked«   für   Anfragen   mit   anhängenden    Dateien    und
            »Content-Length:« für Anfragen ohne anhängende Dateien verwandt.

       -P Dateiname.plist
            Spezifiziert,  dass  die  Ergebnisse der Tests zusätzlich zu dem normalen Testbericht
            (-t) in die benannte XML- (Apple plist-)Datei geschrieben werden sollen. Diese Option
            ist inkompatibel zu den Optionen -i (Interval) und -n (Anzahl-Wiederholungen).

       -S   Erzwingt (dedizierte) TLS-Verschlüsselung bei Verbindungen zum Server.

       -T Sekunden
            Spezifiziert eine Zeitüberschreitung in Sekunden für IPP-Anfragen.

       -V Version
            Spezifiziert  die  zu  verwendende Standard-IPP-Version: 1.0, 1.1, 2.0, 2.1 oder 2.2.
            Falls nicht angegeben, wird Version 1.1 verwandt.

       -X   Spezifiziert, dass die  XML-  (Apple-Plist-)Ausgabe  statt  des  reinen  Textberichts
            erwünscht  ist.  Diese  Option  ist inkompatibel zu den Optionen -i (Interval) und -n
            (Anzahl-Wiederholungen).

       -c   Spezifiziert,  dass  CVS-  (Kommata-getrennte   Werte-)Ausgabe   statt   des   reinen
            Textberichts erwünscht ist.

       -d Name=Wert
            Definiert die genannte Variable.

       -f Dateiname
            Definiert den Standardanfragedateinamen für Tests.

       -i Sekunden
            Spezifiziert,  dass  die  (letzte) Testdatei mit dem angegebenen Intervall wiederholt
            werden soll. Diese Option ist inkompatibel zu der Option -X (XML-Plist-Ausgabe).

       -l   Spezifiziert, dass die Ausgabe als einfacher Text erwünscht ist.

       -n Anzahl-Wiederholungen
            Spezifiziert, dass die (letzte) Testdatei entsprechend der angegeben Zahl  wiederholt
            werden soll. Diese Option ist inkompatibel zu der Option -X (XML-Plist-Ausgabe).

       -q   Still sein und keine Ausgabe erzeugen.

       -t   Spezifiziert, dass CUPS-Testberichtausgabe statt einfache Textausgabe erwünscht ist.

       -v   Spezifiziert,   dass  alle  Anfrag-  und  Antwort-Attribute  im  CUPS-Testmodus  (-t)
            ausgegeben werden sollen. Dies ist die Vorgabe für XML-Ausgabe.

EXIT-STATUS

       Das Programm ipptool liefert 0 zurück, falls alle Tests erfolgreich waren und ansonsten 1.

DATEIEN

       Die folgenden Standarddateien sind verfügbar:
       color.jpg
       create-printer-subscription.test
       document-a4.pdf
       document-a4.ps
       document-letter.pdf
       document-letter.ps
       get-completed-jobs.test
       get-jobs.test
       get-notifications.test
       get-printer-attributes.test
       get-subscriptions.test
       gray.jpg
       ipp-1.1.test
       ipp-2.0.test
       ipp-2.1.test
       ipp-2.2.test
       ipp-everywhere.test
       onepage-a4.pdf
       onepage-a4.ps
       onepage-letter.pdf
       onepage-letter.ps
       print-job.test
       print-job-deflate.test
       print-job-gzip.test
       testfile.jpg
       testfile.pcl
       testfile.pdf
       testfile.ps
       testfile.txt
       validate-job.test

KONFORMITÄT

       Das Programm ipptool ist eine Besonderheit von  CUPS  und  konform  zu  der  Spezifikation
       »Internet Printing Protocol« bis zu Version 2.2.

BEISPIELE

       Eine Liste von abgeschlossenen Aufträgen für »MeinDrucker« ermitteln:

           ipptool ipp://localhost/printers/MeinDrucker get-completed-jobs.test

       Eine E-Mail-Benachrichtigung an »user@example.com« senden, wenn sich »MeinDrucker« ändert:

           ipptool -d recipient=mailto:user@example.com \
               ipp://localhost/printers/myprinter create-printer-subscription.test

SIEHE AUCH

       ipptoolfile(5),   CUPS-Online-Hilfe   (http://localhost:631/help),   IANA   IPP   Registry
       (http://www.iana.org/assignments/ipp-registrations),  PWG   Internet   Printing   Protocol
       Workgroup (http://www.pwg.org/ipp)  RFC 2911 (http://tools.ietf.org/html/rfc2911),

COPYRIGHT

       Copyright © 2007-2015 by Apple Inc.