.\" .\" ipptoolfile man page. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2010-2021 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 ipptoolfile 5 CUPS 2021\-09\-20 OpenPrinting .SH NAME ipptoolfile \- ipptool\-Dateiformat .SH BESCHREIBUNG Das Programm \fBipptool\fP(1) akzeptiert frei formatierte einfache Textdateien, die eine oder mehrere IPP\-Anfragen beschreiben. Kommentare beginnen mit dem Zeichen »#« und gehen bis zum Zeilenende. Jede Anfrage ist in geschweiften Klammern eingeschlossen. Beispiel: .nf # Dies ist ein Kommentar { # Der Name des Tests NAME "Drucke PDF\-Datei" # Die zu sendende Anfrage OPERATION Print\-Job GROUP operation\-attributes\-tag ATTR charset attributes\-charset utf\-8 ATTR language attributes\-natural\-language en ATTR uri printer\-uri $uri ATTR name requesting\-user\-name $user ATTR mimeMediaType document\-format application/pdf GROUP job\-attributes\-tag ATTR collection media\-col { # US Letter, einfaches Papier aus dem »Haupt«\-Fach MEMBER collection media\-size { MEMBER integer x\-dimension 21590 MEMBER integer y\-dimension 27940 } MEMBER integer media\-top\-margin 423 MEMBER integer media\-bottom\-margin 423 MEMBER integer media\-left\-margin 423 MEMBER integer media\-right\-margin 423 MEMBER keyword media\-source "main" MEMBER keyword media\-type "stationery" } FILE Testdatei.pdf # Die zu erwartende Antwort STATUS successful\-ok EXPECT job\-id OF\-TYPE integer WITH\-VALUE >0 EXPECT job\-uri OF\-TYPE uri } { # Der Name des Tests NAME "Warte auf Fertigstellung des Auftrags" # Die zu sendende Anfrage OPERATION Get\-Job\-Attributes GROUP operation\-attributes\-tag ATTR charset attributes\-charset utf\-8 ATTR language attributes\-natural\-language en ATTR uri printer\-uri $uri ATTR integer job\-id $job\-id ATTR name requesting\-user\-name $user # Die zu erwartende Antwort STATUS successful\-ok EXPECT job\-id OF\-TYPE integer WITH\-VALUE $job\-id EXPECT job\-uri OF\-TYPE uri EXPECT job\-state OF\-TYPE enum WITH\-VALUE >5 REPEAT\-NO\-MATCH EXPECT job\-originating\-user\-name OF\-TYPE name WITH\-VALUE "$user" # Den Auftragsstatus zeigen, bis fertig… DISPLAY job\-state DISPLAY job\-state\-reasons } .fi .SS "OBERSTE DIREKTIVEN" Die folgenden Direktiven können außerhalb eines \fITests\fP verwandt werden: .TP 5 \fB{ \fP\fITest \fP\fB}\fP Definiert einen Test. .TP 5 \fBDEFINE \fP\fIVariablennamen Wert\fP Definiert die benannte Variable auf den angegebenen Wert. Dies ist zur Angabe von \fI\-d Variablennamen=Wert\fP auf der \fBipptool\fP(8)\-Befehlszeile äquivalent. .TP 5 \fBDEFINE\-DEFAULT \fP\fIVariablennamen Wert\fP Definiert die benannte Variable auf den angegebenen Wert, falls sie nicht bereits einen Wert hat. .TP 5 \fBFILE\-ID "\fP\fIBezeichner\fP\fB"\fP Legt einen Bezeichner als Zeichenkette für die aktuelle Datei fest. .TP 5 \fBIGNORE\-ERRORS yes\fP .TP 5 \fBIGNORE\-ERRORS no\fP Legt fest, ob \fBipptool\fP(8) standardmäßig Fehler ignorieren und mit folgenden Tests fortfahren wird. .TP 5 \fBINCLUDE "\fP\fIDateiname\fP\fB"\fP .TP 5 \fBINCLUDE <\fP\fIDateiname\fP\fB>\fP Bindet eine andere Testdatei ein. Die erste Form bindet eine Datei relativ zu der aktuellen Testdatei ein, während die zweite Form eine Datei aus dem \fBipptool\fP(8)\-Einbindeverzeichnis einbindet. .TP 5 \fBINCLUDE\-IF\-DEFINED \fP\fIName \fP\fB"\fP\fIDateiname\fP\fB"\fP .TP 5 \fBINCLUDE\-IF\-DEFINED \fP\fIName \fP\fB<\fP\fIDateiname\fP\fB>\fP Bindet eine andere Testdatei ein, falls die benannte Variable definiert ist. Die erste Form bindet eine Datei relativ zu der aktuellen Testdatei ein, während die zweite Form eine Datei aus dem \fBipptool\fP(8)\-Einbindeverzeichnis einbindet. .TP 5 \fBINCLUDE\-IF\-NOT\-DEFINED \fP\fIName \fP\fB"\fP\fIDateiname\fP\fB"\fP .TP 5 \fBINCLUDE\-IF\-NOT\-DEFINED \fP\fIName \fP\fB<\fP\fIDateiname\fP\fB>\fP Bindet eine andere Testdatei ein, falls die benannte Variable nicht definiert ist. Die erste Form bindet eine Datei relativ zu der aktuellen Testdatei ein, während die zweite Form eine Datei aus dem \fBipptool\fP(8)\-Einbindeverzeichnis einbindet. .TP 5 \fBSKIP\-IF\-DEFINED \fP\fIVariablenname\fP .TP 5 \fBSKIP\-IF\-NOT\-DEFINED \fP\fIVariablenname\fP Legt fest, dass der Rest der Testdatei übersprungen werden soll, wenn die Variable (nicht) definiert ist. .TP 5 \fBSTOP\-AFTER\-INCLUDE\-ERROR no\fP .TP 5 \fBSTOP\-AFTER\-INCLUDE\-ERROR yes\fP Legt fest, ob Tests nach einem Fehler in einer eingebundenen Datei angehalten werden oder nicht. .TP 5 \fBTRANSFER auto\fP Legt fest, dass der Test standardmäßig »Transfer\-Encoding: chunked« für Anfragen mit angehängten Dateien und »Content\-Length:« für Anfragen ohne angehängte Dateien verwenden wird. .TP 5 \fBTRANSFER chunked\fP Legt fest, dass die Tests standardmäßig die HTTP/1.1\-Kopfzeile »Transfer\-Encoding: chunked« verwenden. Dies ist die Vorgabe und äquivalent zur Angabe von \fI\-c\fP auf der Befehlszeile von \fBipptool\fP(8). Die Unterstützung für blockweise Abfragen wird für die Konformität mit allen Versionen von IPP benötigt. .TP 5 \fBTRANSFER length\fP Legt fest, dass die Tests standardmäßig die HTTP/1.0\-Kopfzeile »Content\-Length« verwenden. Dies ist die Vorgabe und äquivalent zur Angabe von \fI\-l\fP auf der Befehlszeile von \fBipptool\fP(8). Die Unterstützung für Inhaltslängen\-Abfragen wird für die Konformität mit allen Versionen von IPP benötigt. .TP 5 \fBVERSION 1.0\fP .TP 5 \fBVERSION 1.1\fP .TP 5 \fBVERSION 2.0\fP .TP 5 \fBVERSION 2.1\fP .TP 5 \fBVERSION 2.2\fP Legt die Standard\-IPP\-Versionsnummer, die für die nachfolgenden Tests verwandt werden soll, fest. .SS TESTDIREKTIVEN Die nachfolgenden Direktiven werden innerhalb eines \fITest\fP verstanden: .TP 5 \fBATTR \fP\fIAußerbandmarkierung Attributname\fP .TP 5 \fBATTR \fP\fIMarkierung Attributname Wert(e)\fP Fügt ein Attribut zu der Testanfrage hinzu. Außerbandmarkierungen (admin\-define, delete\-attribute, no\-value, not\-settable, unknown, unsupported) haben keinen Wert. Werte für die anderen Markierungen werden durch Kommata (»,«) getrennt \-\- schützen Sie Kommata mittels des Anführungszeichens (»"«). Häufige Attribute und Werte sind in der »IANA IPP registry« aufgeführt, siehe Referenz unten. .TP 5 \fBATTR collection \fP\fIAttributname \fP\fB{ MEMBER \fP\fIMarkierung Mitgliedsname Wert(e) … \fP\fB}\fP [ \fI… \fP\fB,{ \fP\fI… \fP\fB} \fP] Fügt der Testanfrage ein Sammlungsattribut hinzu. Mitgliedsattribute folgen der gleichen Syntax wie reguläre Attribute und können selbst wieder verschachtelte Sammlungen sein. Mehrere Sammlungswerte können, durch Kommata getrennt, wie benötigt angegeben werden. .TP 5 \fBCOMPRESSION deflate\fP .TP 5 \fBCOMPRESSION gzip\fP .TP 5 \fBCOMPRESSION none\fP Verwendet die angegebene Komprimierung auf die Dokumentendaten, die den Attributen in einer Print\-Job\- oder Send\-Document\-Anfrage folgen. .TP 5 \fBDELAY \fP\fISekunden\fP[\fI,Wiederholungssekunden\fP] Specifies a delay in seconds before this test will be run. If two values are specified, the second value is used as the delay between repeated tests. A default repeat interval of 5 seconds is used if this directive is not provided. .TP 5 \fBDISPLAY \fP\fIAttributname\fP Legt fest, dass der Wert des benannten Attributes als Teil des Testberichts ausgegeben werden soll. .TP 5 \fBEXPECT \fP\fIAttributname \fP[ \fIEigenschaft(en) \fP] .TP 5 \fBEXPECT ?\fP\fIAttributname Eigenschaft(en)\fP .TP 5 \fBEXPECT !\fP\fIAttributname\fP Legt fest, dass die Antwort das benannte Attribut enthalten muss/kann/nicht darf. Zusätzliche Anforderungen können als Eigenschaften hinzugefügt werden \- siehe den Abschnitt »EXPECT\-EIGENSCHAFTEN« für weitere Informationen über Eigenschaften. Attributnamen können weitere Mitgliederattribute festlegen, indem die Attribut\- und Mitgliedernamen durch einen normalen Schrägstrich getrennt werden. Beispiel: »media\-col/media\-size/x\-dimension«. .TP 5 \fBEXPECT\-ALL \fP\fIAttributname \fP[ \fIEigenschaft(en) \fP] .TP 5 \fBEXPECT\-ALL ?\fP\fIAttributname Eigenschaft(en)\fP Legt fest, dass die Antwort das benannte Attribut enthalten muss/kann und dass alle Vorkommen dieses Attributs auf die angegebenen Eigenschaften passen müssen. .TP 5 \fBFILE Dateiname\fP Legt eine Datei, die am Ende der Anfrage eingefügt werden soll, fest. Dies wird typischerweise verwandt, wenn eine Testausdrucksdatei gesandt wird. .TP 5 \fBGROUP Markierung\fP Legt die Gruppenmarkierung für nachfolgende Attribute in der Anfrage fest. .TP 5 \fBIGNORE\-ERRORS yes\fP .TP 5 \fBIGNORE\-ERRORS no\fP Legt fest, ob \fBipptool\fP(8) Fehler in nachfolgenden Tests ignorieren und fortfahren soll. .TP 5 \fBMONITOR\-PRINTER\-STATE \fP[ \fIDrucker\-URI \fP] \fB{ EXPECT \fP\fIAttributname\fP[ \fIEigenschaft(en) \fP] \fB}\fP Legt die Druckerzustandsüberwachungstests fest, die parallel zu den Testaktionen ausgeführt werden sollen. Die Überwachungstests werden ausgeführt, bis alle \fBEXPECT\fP\-Bedingungen erfüllt sind oder die primäre Testaktion abgeschlossen wurde; es zählt das erste der Ereignisse. .TP 5 \fBNAME "\fP\fI Zeichenkette\fP\fB"\fP Legt den menschenlesbaren Namen des Tests fest. .TP 5 \fBOPERATION \fP\fIVorgangscode\fP Legt den auszuführenden Vorgang fest. .TP 5 \fBPASS\-IF\-DEFINED \fP\fIVariablenname\fP .TP 5 \fBPASS\-IF\-NOT\-DEFINED \fP\fIVariablenname\fP Legt fest, dass der aktuelle Test automatisch bestanden werden soll, wenn die Variable (nicht) definiert ist. .TP 5 \fBPAUSE "\fP\fINachricht\fP\fB"\fP Zeigt die bereitgestellte Nachricht an und warten darauf, dass der Benutzer eine Taste zum Fortfahren drückt. .TP 5 \fBREQUEST\-ID \fP\fINummer\fP .TP 5 \fBREQUEST\-ID random\fP Legt die in der Anfrage zu verwendende Anfrage\-ID, entweder eine Ganzzahl oder das Wort »random«, um einen zufällig erzeugten Wert zu verwenden (Vorgabe), fest. .TP 5 \fBRESOURCE \fP\fIPfad\fP Legt einen alternativen Ressourcen\-Pfad, der für HTTP\-POST\-Anfragen verwandt wird, fest. Die Vorgabe ist die Ressource, die aus der an das Programm \fBipptool\fP(8) übergebenen URI entstammt. .TP 5 \fBSKIP\-IF\-DEFINED \fP\fIVariablenname\fP .TP 5 \fBSKIP\-IF\-NOT\-DEFINED \fP\fIVariablenname\fP Legt fest, dass der aktuelle Test übersprungen werden soll, wenn die Variable (nicht) definiert ist. .TP 5 \fBSKIP\-PREVIOUS\-ERROR yes\fP .TP 5 \fBSKIP\-PREVIOUS\-ERROR no\fP Legt fest, ob \fBipptool\fP(8) den aktuellen Test überspringt, falls der vorhergehende Test zu einem Fehler/Fehlschlag führte. .TP 5 \fBSTATUS \fP\fIStatus\-Code \fP[ \fIEigenschaft\fP ] Legt den Status\-Code\-Wert einer erwarteten Antwort fest. Zusätzliche Anforderungen können als Eigenschaften hinzugefügt werden \- siehe den Abschnitt »EXPECT\-EIGENSCHAFTEN« für weitere Informationen über Eigenschaften. .TP 5 \fBTEST\-ID "\fP\fIBezeichner\fP" Legt einen Bezeichner als Zeichenkette für den aktuellen Test fest. .TP 5 \fBTRANSFER auto\fP Legt fest, dass dieser Test »Transfer\-Encoding: chunked« verwendet, falls er eine angehängt Datei hat und »Content\-Length:« andernfalls. .TP 5 \fBTRANSFER chunked\fP Legt fest, dass dieser Test die HTTP/1.1\-Kopfzeile »Transfer\-Encoding: chunked« verwenden wird. .TP 5 \fBTRANSFER length\fP Legt fest, dass dieser Test die HTTP/1.0\-Kopfzeile »Content\-Length:« verwenden wird. .TP 5 \fBVERSION 1.0\fP .TP 5 \fBVERSION 1.1\fP .TP 5 \fBVERSION 2.0\fP .TP 5 \fBVERSION 2.1\fP .TP 5 \fBVERSION 2.2\fP Legt die für diesen Test zu verwendende IPP\-Versionsnummer fest. .SS EXPECT\-EIGENSCHAFTEN Die folgenden Eigenschaften (Prädikate) werden angehängt an die \fBEXPECT\fP\-Test\-Direktiven verstanden: .TP 5 \fBCOUNT \fP\fIAnzahl\fP Verlangt, dass das Attribut von \fBEXPECT\fP die angegebene Anzahl an Werten hat. .TP 5 \fBDEFINE\-MATCH \fP\fIVariablenname\fP Setzt die Variable auf »1«, wenn die \fBEXPECT\fP\-Bedingung passt. Ein Seiteneffekt dieser Eigenschaft ist, dass dieser \fBEXPECT\fP niemals bei einem Test fehlschlägt. .TP 5 \fBDEFINE\-NO\-MATCH \fP\fIVariablenname\fP Setzt die Variable auf »1«, wenn die \fBEXPECT\fP\-Bedingung nicht passt. Ein Seiteneffekt dieser Eigenschaft ist, dass dieser \fBEXPECT\fP niemals bei einem Test fehlschlägt. .TP 5 \fBDEFINE\-VALUE \fP\fIVariablenname\fP Setzt die Variable auf den Wert des Attributes, wenn die \fBEXPECT\fP\-Bedingung passt. Ein Seiteneffekt dieser Eigenschaft ist, dass dieser \fBEXPECT\fP niemals bei einem Test fehlschlägt. .TP 5 \fBDISPLAY\-MATCH \fP\fI"Nachricht"\fP Zeigt die festgelegte Nachricht, wenn die \fBEXPECT\fP\-Bedingung passt. .TP 5 \fBIF\-DEFINED \fP\fIVariablenname\fP Die \fBEXPECT\fP\-Bedingung wird nur angewandt, falls die angegebene Variable definiert ist. .TP 5 \fBIF\-NOT\-DEFINED \fP\fIVariablenname\fP Die \fBEXPECT\fP\-Bedingung wird nur angewandt, falls die angegebene Variable nicht definiert ist. .TP 5 \fBIN\-GROUP \fP\fIMarkierung\fP Verlangt, dass das \fBEXPECT\fP\-Attribut in der angegebenen Gruppenmarkierung ist. .TP 5 \fBOF\-TYPE \fP\fIMarkierung[(Begrenzungen)|Markierung|…]\fP Verlangt, dass das \fBEXPECT\fP\-Attribut eines der festgelegten Attribut(e) verwendet. Die meisten Wertemarkierungen unterstützen auch die Angabe von Beschränkungen in Klammern, beispielsweise würde »name(42)« nameWith/WithoutLanguage\-Zeichenketten bis zu einer Länge von 42 Oktetten, »name(4:MAX)« würde nameWith/WithoutLanguage\-Zeichenketten zwischen 4 und 255 Oktetten erlauben und »integer(\-273:MAX)« würde Ganzzahlen zwischen \-273 und 2147483647 erlauben. .TP 5 \fBREPEAT\-LIMIT \fP\fIAnzahl\fP .br Legt die maximale Anzahl an Wiederholungen, falls die Eigenschaft \fBREPEAT\-MATCH\fP oder \fBREPEAT\-NO\-MATCH\fP festgelegt ist, fest. Die Vorgabe ist 1000. .TP 5 \fBREPEAT\-MATCH\fP .TP 5 \fBREPEAT\-NO\-MATCH\fP Legt fest, dass der aktuelle Test wiederholt werden soll, wenn die \fBEXPECT\fP\-Bedingung (nicht) passt. .TP 5 \fBSAME\-COUNT\-AS \fP\fIAttributname\fP Verlangt, dass das \fBEXPECT\fP\-Attribut die gleiche Anzahl von Werten wie das festgelegte parallele Attribut hat. .TP 5 \fBWITH\-ALL\-HOSTNAMES "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-ALL\-HOSTNAMES "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass alle URI\-Werte einen passenden Rechnernamen enthalten. .TP 5 \fBWITH\-ALL\-RESOURCES "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-ALL\-RESOURCES "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass alle URI\-Werte eine passende Ressource (einschließlich des führenden /) enthalten. .TP 5 \fBWITH\-ALL\-SCHEMES "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-ALL\-SCHEMES "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass alle URI\-Werte ein passendes Schema enthalten. .TP 5 \fBWITH\-ALL\-VALUES "\fP\fIZeichenkette\fP\fB"\fP Verlangt, dass alle Werte des \fBEXPECT\fP\-Attributs auf die Zeichenkette passen. Vergleiche berücksichtigen die Groß\- und Kleinschreibung. .TP 5 \fBWITH\-ALL\-VALUES <\fP\fIZahl\fP .TP 5 \fBWITH\-ALL\-VALUES =\fP\fIZahl\fP .TP 5 \fBWITH\-ALL\-VALUES >\fP\fIZahl\fP .TP 5 \fBWITH\-ALL\-VALUES \fP\fIZahl\fP[\fI,…,Zahl\fP] Verlangt, dass alle Werte des \fBEXPECT\fP\-Attributs auf die Zahl(en) passen oder den numerischen Vergleich erfüllen. Beim Vergleich von rangeOfInteger\-Werten prüfen die Operatoren »<« und »>« nur die obere Grenze der Bereiche. .TP 5 \fBWITH\-ALL\-VALUES "false"\fP .TP 5 \fBWITH\-ALL\-VALUES "true"\fP Verlangt, dass alle Werte des \fBEXPECT\fP\-Attributs auf den übergebenen logischen Wert passen. .TP 5 \fBWITH\-ALL\-VALUES "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass alle Werte des \fBEXPECT\fP\-Attributes auf den regulären Ausdruck passen. Dieser muss die Syntax regulärer POSIX\-Ausdrücke erfüllen. Vergleiche berücksichtigen Groß\- und Kleinschreibung. .TP 5 \fBWITH\-DISTINCT\-VALUES\fP Verlangt, dass alle Werte des \fBEXPECT\fP\-Attributs eindeutig sind. Vergleiche berücksichtigen Groß\-/Kleinschreibung. Nur die Attribute charset, collection, enum, integer, keyword, mimeMediaType, naturalLanguage, rangeOfInteger, resolution, uriScheme unterstützen diese Eigenschaft. .TP 5 \fBWITH\-HOSTNAME "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-HOSTNAME "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass mindestens ein URI\-Wert einen passenden Rechnernamen enthält. .TP 5 \fBWITH\-RESOURCE "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-RESOURCE "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass mindestens ein URI\-Wert eine passende Ressource (einschließlich des führenden /) enthält. .TP 5 \fBWITH\-SCHEME "\fP\fIZeichenkette\fP\fB"\fP .TP 5 \fBWITH\-SCHEME "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass mindestens ein URI\-Wert ein passendes Schema enthält. .TP 5 \fBWITH\-VALUE "\fP\fIZeichenkette\fP\fB"\fP Verlangt, dass mindestens ein Wert des \fBEXPECT\fP\-Attributs auf die Zeichenkette passt. Vergleiche berücksichtigen Groß\- und Kleinschreibung. .TP 5 \fBWITH\-VALUE <\fP\fIZahl\fP .TP 5 \fBWITH\-VALUE =\fP\fIZahl\fP .TP 5 \fBWITH\-VALUE >\fP\fIZahl\fP .TP 5 \fBWITH\-VALUE \fP\fIZahl\fP[\fI,…,Zahl\fP] Verlangt, dass mindestens ein Wert des \fBEXPECT\fP\-Attributs auf die Zahl(en) passt oder den numerischen Vergleich erfüllt. Beim Vergleich von rangeOfInteger\-Werten prüfen die Operatoren »<« und »>« nur die obere Grenze der Bereiche. .TP 5 \fBWITH\-VALUE "false"\fP .TP 5 \fBWITH\-VALUE "true"\fP Verlangt, dass mindestens ein Wert des \fBEXPECT\fP\-Attributs auf den übergebenen logischen Wert passt. .TP 5 \fBWITH\-VALUE "/\fP\fIregulärer Ausdruck\fP\fB/"\fP Verlangt, dass mindestens ein Wert des \fBEXPECT\fP\-Attributes auf den regulären Ausdruck passt. Dieser muss die Syntax regulärer POSIX\-Ausdrücke erfüllen. Vergleiche berücksichtigen Groß\- und Kleinschreibung. .TP 5 \fBWITH\-VALUE\-FROM \fP\fIAttributname\fP Verlangt, dass der Wert/die Werte des Attributes \fBEXPECT\fP auf den Wert/die Werte in dem angegebenen Attribut passt/passen. Beispielsweise verlangt »EXPECT job\-sheets WITH\-VALUE\-FROM job\-sheets\-supported«, dass der Wert »job\-sheets« als Wert im Attribut »job\-sheets\-supported« aufgeführt ist. .SS STATUS\-EIGENSCHAFTEN Die folgenden Eigenschaften werden nach der \fBSTATUS\fP\-Testdirektive verstanden: .TP 5 \fBDEFINE\-MATCH \fP\fIVariablenname\fP Setzt die Variable auf »1« wenn der \fBSTATUS\fP passt. Ein Seiteneffekt dieser Eigenschaft ist, dass dieser \fBSTATUS\fP niemals bei einem Test fehlschlägt. .TP 5 \fBDEFINE\-NO\-MATCH \fP\fIVariablenname\fP Setzt die Variable auf »1« wenn der \fBSTATUS\fP nicht passt. Ein Seiteneffekt dieser Eigenschaft ist, dass dieser \fBSTATUS\fP niemals bei einem Test fehlschlägt. .TP 5 \fBIF\-DEFINED \fP\fIVariablenname\fP Führt dazu, dass der \fBSTATUS\fP nur angewandt wird, falls die angegebene Variable definiert ist. .TP 5 \fBIF\-NOT\-DEFINED \fP\fIVariablenname\fP Führt dazu, dass der \fBSTATUS\fP nur angewandt wird, falls die angegebene Variable nicht definiert ist. .TP 5 \fBREPEAT\-LIMIT \fP\fIAnzahl\fP .br Legt die maximale Anzahl an Wiederholungen fest. Die Vorgabe ist 1000. .TP 5 \fBREPEAT\-MATCH\fP .TP 5 \fBREPEAT\-NO\-MATCH\fP Legt fest, dass der aktuelle Test wiederholt werden soll, wenn der Rückgabestatuscode (nicht) auf den durch die STATUS\-Direktive angegebenen Wert passt. .SS VORGANGSCODES Vorgangscodes entsprechen hexadezimalen Zahlen (0xHHHH) und Namen aus RFC 8011 und anderen IPP\-Erweiterungsspezifikationen. Hier ist die komplette Liste der von \fBipptool\fP(8) unterstützten Namen: .nf Acknowledge\-Document Acknowledge\-Identify\-Printer Acknowledge\-Job Activate\-Printer Add\-Document\-Images Allocate\-Printer\-Resources Cancel\-Current\-Job Cancel\-Job Cancel\-Jobs Cancel\-My\-Jobs Cancel\-Resource Cancel\-Subscription Close\-Job Create\-Job Create\-Job\-Subscriptions Create\-Printer Create\-Printer\-Subscriptions Create\-Resource Create\-Resource\-Subscriptions Create\-System\-Subscriptions CUPS\-Accept\-Jobs CUPS\-Accept\-Jobs CUPS\-Add\-Modify\-Class CUPS\-Add\-Modify\-Printer CUPS\-Authenticate\-Job CUPS\-Create\-Local\-Printer CUPS\-Delete\-Class CUPS\-Delete\-Printer CUPS\-Get\-Classes CUPS\-Get\-Default CUPS\-Get\-Devices CUPS\-Get\-Document CUPS\-Get\-PPD CUPS\-Get\-PPDs CUPS\-Get\-Printers CUPS\-Move\-Job CUPS\-Reject\-Jobs CUPS\-Set\-Default Deactivate\-Printer Deallocate\-Printer\-Resources Delete\-Printer Deregister\-Output\-Device Disable\-All\-Printers Disable\-Printer Enable\-All\-Printers Enable\-Printer Fetch\-Document Fetch\-Job Get\-Job\-Attributes Get\-Jobs Get\-Next\-Document\-Data Get\-Notifications Get\-Output\-Device\-Attributes Get\-Printer\-Attributes Get\-Printer\-Support\-Files Get\-Printer\-Supported\-Values Get\-Printers Get\-Subscription\-Attributes Get\-Subscriptions Get\-System\-Attributes Get\-System\-Supported\-Values Hold\-Job Hold\-New\-Jobs Identify\-Printer Install\-Resource Pause\-All\-Printers Pause\-All\-Printers\-After\-Current\-Job Pause\-Printer Pause\-Printer\-After\-Current\-Job Print\-Job Print\-URI Promote\-Job Purge\-Jobs Register\-Output\-Device Release\-Held\-New\-Jobs Release\-Job Renew\-Subscription Reprocess\-Job Restart\-Job Restart\-Printer Restart\-System Resubmit\-Job Resume\-All\-Printers Resume\-Job Resume\-Printer Schedule\-Job\-After Send\-Document Send\-Hardcopy\-Document Send\-Notifications Send\-Resource\-Data Send\-URI Set\-Job\-Attributes Set\-Printer\-Attributes Set\-Resource\-Attributes Set\-System\-Attributes Shutdown\-All\-Printers Shutdown\-One\-Printer Shutdown\-Printer Startup\-All\-Printers Startup\-One\-Printer Startup\-Printer Suspend\-Current\-Job Update\-Active\-Jobs Update\-Document\-Status Update\-Job\-Status Update\-Output\-Device\-Attributes Validate\-Document Validate\-Job .fi .SS STATUS\-CODES Status\-Codes entsprechend den hexadezimalen Zahlen (0xHHHH) und Namen aus RFC 8011 und anderen IPP\-Erweiterungsspezifikationen. Hier ist die komplette Liste der von \fBipptool\fP(8) unterstützten Namen: .nf client\-error\-account\-authorization\-failed client\-error\-account\-closed client\-error\-account\-info\-needed client\-error\-account\-limit\-reached client\-error\-attributes\-not\-settable client\-error\-attributes\-or\-values\-not\-supported client\-error\-bad\-request client\-error\-charset\-not\-supported client\-error\-compression\-error client\-error\-compression\-not\-supported client\-error\-conflicting\-attributes client\-error\-document\-access\-error client\-error\-document\-format\-error client\-error\-document\-format\-not\-supported client\-error\-document\-password\-error client\-error\-document\-permission\-error client\-error\-document\-security\-error client\-error\-document\-unprintable\-error client\-error\-forbidden client\-error\-gone client\-error\-ignored\-all\-notifications client\-error\-ignored\-all\-subscriptions client\-error\-not\-authenticated client\-error\-not\-authorized client\-error\-not\-fetchable client\-error\-not\-found client\-error\-not\-possible client\-error\-print\-support\-file\-not\-found client\-error\-request\-entity\-too\-large client\-error\-request\-value\-too\-long client\-error\-timeout client\-error\-too\-many\-subscriptions client\-error\-uri\-scheme\-not\-supported cups\-error\-account\-authorization\-failed cups\-error\-account\-closed cups\-error\-account\-info\-needed cups\-error\-account\-limit\-reached cups\-see\-other redirection\-other\-site server\-error\-busy server\-error\-device\-error server\-error\-internal\-error server\-error\-job\-canceled server\-error\-multiple\-document\-jobs\-not\-supported server\-error\-not\-accepting\-jobs server\-error\-operation\-not\-supported server\-error\-printer\-is\-deactivated server\-error\-service\-unavailable server\-error\-temporary\-error server\-error\-version\-not\-supported successful\-ok successful\-ok\-but\-cancel\-subscription successful\-ok\-conflicting\-attributes successful\-ok\-events\-complete successful\-ok\-ignored\-notifications successful\-ok\-ignored\-or\-substituted\-attributes successful\-ok\-ignored\-subscriptions successful\-ok\-too\-many\-events .fi .SS MARKIERUNGEN Werte\- und Gruppenmarkierungen entsprechen den Namen aus RFC 8011 und anderen IPP\-Erweiterungsspezifikationen. Hier sind die Gruppenmarkierungen: .nf document\-attributes\-tag event\-notification\-attributes\-tag job | job\-attributes\-tag operation | operation\-attributes\-tag printer | printer\-attributes\-tag resource\-attributes\-tag subscription\-attributes\-tag system\-attributes\-tag unsupported\-attributes\-tag .fi .LP Hier sind die Wertemarkierungen: .nf admin\-define boolean charset collection | begCollection dateTime default delete\-attribute enum integer keyword language | naturalLanguage mimetype | mimeMediaType name | nameWithLanguage | nameWithoutLanguage no\-value not\-settable octetString rangeOfInteger resolution text | textWithLanguage | textWithoutLanguage unknown unsupported uri uriScheme .fi .SS VARIABLEN Das Programm \fBipptool\fP(8) verwaltet eine Liste von Variablen, die in jeder Zeichenkette oder jedem Attributswert über Angabe von »\fI$variable\-name\fP« verwandt werden können. Neben den durch die Option \fI\-d\fP oder der Direktiven \fBDEFINE\fP angegebenen Variablen sind folgende vordefinierte Variablen verfügbar: .TP 5 \fB$$\fP Fügt ein einzelnes »$«\-Zeichen ein. .TP 5 \fB$ENV[\fP\fIName\fP\fB]\fP Fügt den Wert der benannten Umgebungsvariablen oder eine leere Zeichenkette, falls die Umgebungsvariable nicht definiert ist, ein. .TP 5 \fB$date\-current\fP Fügt das aktuelle Datum und die aktuelle Zeit im ISO\-8601\-Format (»yyyy\-mm\-ddThh:mm:ssZ«) ein. .TP 5 \fB$date\-start\fP Fügt das Startdatum und die Startzeit im ISO\-8601\-Format (»yyyy\-mm\-ddThh:mm:ssZ«) ein. .TP 5 \fB$filename\fP Fügt den mit der Option \fI\-f\fP an \fBipptool\fP(8) bereitgestellten Dateinamen ein. .TP 5 \fB$filetype\fP Fügt den MIME\-Medientyp für den mit der Option \fI\-f\fP an \fBipptool\fP(8) bereitgestellten Dateinamen ein. .TP 5 \fB$hostname\fP Fügt den Rechnernamen aus der \fBipptool\fP(8) bereitgestellten URI ein. .TP 5 \fB$job\-id\fP Fügt den letzten in einer Testantwort zurückgelieferten »job\-id«\-Attributwert oder 0, falls kein Attribut »job\-id« gesehen wurde, ein. .TP 5 \fB$job\-uri\fP Fügt den letzten in einer Testantwort zurückgelieferten »job\-uri«\-Attributwert oder eine leere Zeichenkette, falls kein Attribut »job\-uri« gesehen wurde, ein. .TP 5 \fB$notify\-subscription\-id\fP Fügt den letzten in einer Testantwort zurückgelieferten »notify\-subscription\-id«\-Attributwert oder 0, falls kein Attribut »notify\-subscription\-id« gesehen wurde, ein. .TP 5 \fB$port\fP Fügt die Portnummer aus der an \fBipptool\fP(8) übergebenen URI ein. .TP 5 \fB$resource\fP Fügt den Ressourcenpfad aus der an \fBipptool\fP(8) übergebenen URI ein. .TP 5 \fB$scheme\fP Fügt das Schema aus der \fBipptool\fP(8) übergebenen URI ein. .TP 5 \fB$uri\fP Fügt die an \fBipptool\fP(8) übergebene URI ein. .TP 5 \fB$uriuser\fP Fügt den Benutzernamen aus der \fBipptool\fP(8) übergebenen URI ein, falls vorhanden. .TP 5 \fB$user\fP Fügt den Anmeldenamen des aktuellen Benutzers ein. .SH "SIEHE AUCH" \fBipptool\fP(1), 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.