.\" .\" ipptool man page. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2010-2019 by Apple Inc. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ipptool 1 CUPS 2021\-10\-20 OpenPrinting .SH NAME ipptool \- Internet\-Printing\-Protocol\-Abfragen durchführen .SH SYNOPSIS \fBipptool\fP [ \fB\-\-help\fP ] [ \fB\-\-ippserver\fP \fIDateiname\fP ] [ \fB\-\-stop\-after\-include\-error\fP ] [ \fB\-\-version\fP ] [ \fB\-4\fP ] [ \fB\-6\fP ] [ \fB\-C\fP ] [ \fB\-E\fP ] [ \fB\-I\fP ] [ \fB\-L\fP ] [ \fB\-P\fP \fIDateiname.plist\fP ] [ \fB\-S\fP ] [ \fB\-T\fP \fISekunden\fP ] [ \fB\-V\fP \fIVersion\fP ] [ \fB\-X\fP ] [ \fB\-c\fP ] [ \fB\-d\fP \fIName=Wert\fP ] [ \fB\-f\fP \fIDateiname\fP ] [ \fB\-h\fP ] [ \fB\-i\fP \fISekunden\fP ] [ \fB\-j\fP ] [ \fB\-n\fP \fIWiederholungszähler\fP ] [ \fB\-q\fP ] [ \fB\-t\fP ] [ \fB\-v ]\fP \fIDrucker\-URI\fP \fITestdatei\fP [ … \fITestdatei\fP ] .SH BESCHREIBUNG \fBipptool\fP sendet IPP\-Anfragen an die angegebene \fIDrucker\-URI\fP und überprüft das Ergebnis oder zeigt es an. Jede benannte \fITestdatei\fP 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 \fITestdatei\fP wird in \fBipptoolfile\fP(5) beschrieben. .SH OPTIONEN Die folgenden Optionen werden von \fBipptool\fP erkannt: .TP 5 \fB\-\-help\fP Zeigt die Programmhilfe. .TP 5 \fB\-\-ippserver \fP\fIDateiname\fP Legt fest, dass die Testergebnisse in die benannte Attributedatei von \fBippserver\fP geschrieben werden sollen. .TP 5 \fB\-\-stop\-after\-include\-error\fP Teilt \fBipptool\fP mit, abzubrechen, falls ein Fehler in der eingebundenen Datei auftritt. Normalerweise wird \fBipptool\fP mit folgenden Tests nach der INCLUDE\-Direktive fortfahren. .TP 5 \fB\-\-version\fP Zeigt die verwendete Version von \fBipptool\fP an. .TP 5 \fB\-4\fP Legt fest, dass \fBipptool\fP sich zu dem Drucker oder Server mit IPv4 verbinden muss. .TP 5 \fB\-6\fP Legt fest, dass \fBipptool\fP sich zu dem Drucker oder Server mit IPv6 verbinden muss. .TP 5 \fB\-C\fP Legt fest, dass Anfragen mit der HTTP/1.1\-Kopfzeile »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. .TP 5 \fB\-E\fP Erzwingt TLS\-Verschlüsselung bei Verbindungen zum Server mit der HTTP\-Kopfzeile »Upgrade«. .TP 5 \fB\-I\fP Legt fest, dass \fBipptool\fP bei Fehlern fortfahren soll. .TP 5 \fB\-L\fP Legt fest, dass Anfragen mit der HTTP/1.0\-Kopfzeile »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. .TP 5 \fB\-P\fP\fI\ Dateiname.plist\fP Legt fest, dass die Ergebnisse der Tests zusätzlich zu dem normalen Testbericht (\fB\-t\fP) in die benannte XML\- (Apple plist\-)Datei geschrieben werden sollen. Diese Option ist inkompatibel zu den Optionen \fB\-i\fP (Intervall) und \fB\-n\fP (Anzahl\-Wiederholungen). .TP 5 \fB\-S\fP Erzwingt (dedizierte) TLS\-Verschlüsselung bei Verbindungen zum Server. .TP 5 \fB\-T\fP\fI\ Sekunden\fP Legt eine Zeitüberschreitung in Sekunden für IPP\-Anfragen fest. .TP 5 \fB\-V\fP\fI\ Version\fP Legt die zu verwendende Standard\-IPP\-Version fest: 1.0, 1.1, 2.0, 2.1 oder 2.2. Falls nicht angegeben, wird Version 1.1 verwandt. .TP 5 \fB\-X\fP Legt fest, dass die XML\- (Apple\-Plist\-)Ausgabe statt des reinen Textberichts erwünscht ist. Diese Option ist inkompatibel zu den Optionen \fB\-i\fP (Intervall) und \fB\-n\fP (Anzahl\-Wiederholungen). .TP 5 \fB\-c\fP Legt fest, dass CVS\- (Kommata\-getrennte Werte\-)Ausgabe statt des reinen Textberichts erwünscht ist. .TP 5 \fB\-d\fP\fI\ Name=Wert\fP Definiert die genannte Variable. .TP 5 \fB\-f\fP\fI\ Dateiname\fP Definiert den Standardanfragedateinamen für Tests. .TP 5 \fB\-h\fP Validiert HTTP\-Antwort\-Kopfzeilen. .TP 5 \fB\-i\fP\fI\ Sekunden\fP Legt fest, dass die (letzte) \fITestdatei\fP mit dem angegebenen Intervall wiederholt werden soll. Diese Option ist inkompatibel zu der Option \fB\-X\fP (XML\-Plist\-Ausgabe). .TP 5 \fB\-j\fP Legt fest, dass \fBipptool\fP JSON\-Ausgabe erstellen soll. .TP 5 \fB\-l\fP Legt fest, dass die Ausgabe als einfacher Text erwünscht ist. .TP 5 \fB\-n\fP\fI\ Anzahl\-Wiederholungen\fP Legt fest, dass die (letzte) \fITestdatei\fP entsprechend der angegeben Zahl wiederholt werden soll. Diese Option ist inkompatibel zu der Option \fI\-X\fP (XML\-Plist\-Ausgabe). .TP 5 \fB\-q\fP Still sein und keine Ausgabe erzeugen. .TP 5 \fB\-t\fP Legt fest, dass CUPS\-Testberichtausgabe statt einfache Textausgabe erwünscht ist. .TP 5 \fB\-v\fP Legt fest, dass alle Anfrage\- und Antwort\-Attribute im CUPS\-Testmodus (\fB\-t\fP) ausgegeben werden sollen. Dies ist die Vorgabe für XML\-Ausgabe. .SH EXIT\-STATUS Das Programm \fBipptool\fP liefert 0 zurück, falls alle Tests erfolgreich waren und ansonsten 1. .SH DATEIEN Die folgenden Standarddateien sind verfügbar: .nf 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 .fi .SH KONFORMITÄT Das Programm \fBipptool\fP ist eine Besonderheit von CUPS und konform zu der Spezifikation »Internet Printing Protocol« bis zu Version 2.2. .SH BEISPIELE Eine Liste von abgeschlossenen Aufträgen für »MeinDrucker« ermitteln: .nf ipptool ipp://localhost/printers/MeinDrucker get\-completed\-jobs.test .fi .LP Eine E\-Mail\-Benachrichtigung an »user@example.com« senden, wenn sich »MeinDrucker« ändert: .nf ipptool \-d recipient=mailto:user@example.com \e ipp://localhost/printers/myprinter create\-printer\-subscription.test .fi .SH "SIEHE AUCH" \fBipptoolfile\fP(5), IANA IPP Registry (https://www.iana.org/assignments/ipp\-registrations), PWG Internet Printing Protocol Workgroup (https://www.pwg.org/ipp), RFC 8011 (https://datatracker.ietf.org/doc/html/rfc8011), .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.