.\" .\" ippeveprinter man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2014-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 ippeveprinter 1 CUPS 2021\-02\-28 OpenPrinting .SH NAME ippeveprinter \- eine IPP\-Everywhere\-Druckeranwendung für CUPS .SH SYNOPSIS \fBippeveprinter\fP [ \fB\-\-help\fP ] [ \fB\-\-no\-web\-forms\fP ] [ \fB\-\-pam\-service\fP \fIDienst\fP ][ \fB\-\-version\fP ] [ \fB\-2\fP ] [ \fB\-A\fP ] [ \fB\-D\fP \fIGeräte\-URI\fP ] [ \fB\-F\fP \fIAusgabetyp/\-untertyp\fP ] [ \fB\-K\fP \fISchlüsselpfad\fP ] [ \fB\-M\fP \fIHersteller\fP ] [ \fB\-P\fP \fIDateiname.ppd\fP ] [ \fB\-V\fP \fIIPP\-Version\fP ] [ \fB\-a\fP \fIDateiname.conf\fP ] [ \fB\-c\fP \fIBefehl\fP ] [ \fB\-d\fP \fISpool\-Verzeichnis\fP ] [ \fB\-f\fP \fITyp/Untertyp[,…]\fP ] [ \fB\-i\fP \fIIcon\-Datei.png\fP ] [ \fB\-k\fP ] [ \fB\-l\fP \fIOrt\fP ] [ \fB\-m\fP \fIModell\fP ] [ \fB\-n\fP \fIRechnername\fP ] [ \fB\-p\fP \fIPort\fP ] [ \fB\-r\fP \fIUntertyp[,Untertyp]\fP ] [ \fB\-s\fP \fIGeschwindigkeit[,Farbgeschwindigkeit]\fP ] [ \fB\-v[vvv]\fP ] \fIDienstename\fP .SH BESCHREIBUNG \fBippeveprinter\fP ist ein einfacher Internet Printing Protocol (IPP)\-Server, der der Spezifikation »IPP Everywhere (PWG 5100.14)« folgt. Er kann zum Testen von Client\-Software dienen oder als sehr rudimentärer Server, der für jeden Druckauftrag einen Befehl ausführt, verwandt werden. .SH OPTIONEN Die folgenden Optionen werden von \fIippeveprinter\fP erkannt: .TP 5 \fB\-\-help\fP Zeigt die Programm\-Verwendung. .TP 5 \fB\-\-no\-web\-forms\fP Deaktiviert die zur Aktualisierung der Medien\- und Bereitstellungsstufen verwandte Webschnittstellenformulare. .TP 5 \fB\-\-pam\-service \fP\fIDienst\fP Legt den PAM\-Dienstenamen fest. Der Vorgabedienst ist »cups«. .TP 5 \fB\-\-version\fP Zeigt die CUPS\-Version an. .TP 5 \fB\-2\fP Meldet die Unterstützung für zweiseitigen (Duplex\-)Druck. .TP 5 \fB\-A\fP Aktiviert Authentisierung für erstellte Drucker. \fBippeveprinter\fP verwendet PAM, um »HTTP Basic«\-Zugriffsberechtigungen zu authentisieren. .TP 5 \fB\-D \fP\fIGeräte\-URI\fP Setzt die Geräte\-URI für Druckausgabe. Die URI kann ein Dateiname, ein Verzeichnis oder eine Netzwerk\-Socket\-URI der Form »Socket://ADRESSE[:PORT]« sein (wobei die Vorgabe\-Portnummer 9100 ist). Wird ein Verzeichnis angegeben, wird \fBippeveprinter\fP eine Ausgabedatei mittels der Auftragskennung und dem Namen erzeugen. .TP 5 \fB\-F \fP\fIAusgabetyp/Untertyp[,…]\fP Legt den Ausgabe\-MIME\-Medientyp fest. Die Vorgabe ist »application/postscript«, wenn die Option \fB\-P\fP festgelegt ist. .TP 5 \fB\-M \fP\fIHersteller\fP Setzt den Hersteller des Druckers. Die Vorgabe ist »Example«. .TP 5 \fB\-P \fP\fIDateiname.ppd\fP Druckerattribute aus der festgelegten PPD\-Datei laden. Diese Option wird typischerweise in Zusammenhang mit dem Druckerbefehl \fBippeveps\fP(7)("\-c ippeveps") verwandt. .TP 5 \fB\-V 1.1\fP .TP 5 \fB\-V 2.0\fP Legt die maximal zu berichtende IPP\-Version fest. 2.0 ist die Vorgabe. .TP 5 \fB\-c \fP\fIBefehl\fP Führt den festgelegten Befehl für jedes ausgedruckte Dokument aus. Falls »Befehl« kein absoluter Pfad ist (»/Pfad/zu/Befehl«), sucht \fBippeveprinter\fP nach dem Befehl im Unterverzeichnis »Befehl« des CUPS\-Programmverzeichnisses, typischerweise /usr/lib/cups/Befehl oder /usr/libexec/cups/Befehl. Der Befehl \fBcups\-config\fP(1) kann zum Erkennen des korrekten Programmpfades verwandt werden (»cups\-config \-\-serverbin«). Zusätzlich kann die Umgebungsvariable CUPS_SERVERBIN zum Außerkraftsetzen des Standardortes dieses Verzeichnisses verwandt werden \- siehe die Handbuchseite \fBcups\fP(1) für weitere Details. .TP 5 \fB\-d \fP\fISpool\-Verzeichnis\fP Legt das Verzeichnis, in denen die Druckaufträge gehalten werden, fest. Die Vorgabe ist ein Verzeichnis unter dem aktuellen temporären Verzeichnis des Benutzers. .TP 5 \fB\-f \fP\fITyp/Untertyp[,…]\fP Legt eine Liste von MIME\-Medientypen fest, die der Server akzeptiert. Die Vorgabe hängt vom Typ des erstellten Druckers ab. .TP 5 \fB\-i \fP\fIIcon\-Datei.png\fP Legt die Drucker\-Icon\-Datei für den Server fest. Die Datei muss ein Bild im Format PNG sein. Die Vorgabe ist ein intern bereitgestelltes PNG\-Bild. .TP 5 \fB\-k\fP Belässt die Druckdokumente im Spool\-Verzeichnis, statt sie zu löschen. .TP 5 \fB\-l \fP\fIOrt\fP Legt die menschenlesbare Ortszeichenkette fest, die vom Server berichtet wird. Die Vorgabe ist die leere Zeichenkette. .TP 5 \fB\-m \fP\fIModell\fP Legt den Modellnamen des Druckers fest. Die Vorgabe ist »Printer«. .TP 5 \fB\-n \fP\fIRechnername\fP Legt den Rechnernamen, der vom Server gemeldet wird, fest. Die Vorgabe ist der durch den Befehl \fBhostname\fP(1) zurückgelieferte Name. .TP 5 \fB\-p \fP\fIPort\fP Legt den Port fest, bei dem auf Anfragen gewartet werden soll. Die Vorgabe ist eine benutzerspezifische Nummer zwischen 8000 und 8999. .TP 5 \fB\-r off\fP Schaltet DNS\-SD\-Dienstebewerbung komplett aus. .TP 5 \fB\-r \fP\fIUntertyp[,Untertyp]\fP Legt den/die DNS\-SD\-Untertyp(en) fest, die bekanntgegeben werden sollen. Mehrere Untertypen werden mit Kommata getrennt. Die Vorgabe ist »_print«. .TP 5 \fB\-s \fP\fIGeschwindigkeit[,Farb\-Geschwindigkeit]\fP Legt die Druckergeschwindigkeit in Seiten pro Minute fest. Falls zwei Nummern angegeben werden und die zweite Nummer größer als 0 ist, wird der Server angeben, dass er Farbdruck unterstützt. Die Vorgabe ist »10,0«. .TP 5 \fB\-v[vvv]\fP Das Protokollieren der Aktivitäten auf die Standardfehlerausgabe erfolgt (sehr) ausführlich. .SH EXIT\-STATUS Das Programm \fBippeveprinter\fP liefert 1 zurück, falls es nicht in der Lage ist, die Befehlszeilenargumente zu verarbeiten oder den IPP\-Dienst zu registrieren. Andernfalls läuft \fBippeveprinter\fP dauerhaft, bis er beendet wird. .SH KONFORMITÄT Das Programm \fBippeveprinter\fP ist eine Besonderheit von CUPS und konform zu der Spezifikation »IPP Everywhere (PWG 5100.14)«. .SH UMGEBUNG \fBippeveprinter\fP fügt für alle IPP\-Auftragsattribute in der Druckanfrage Umgebungsvariablen hinzu, die mit »IPP_« beginnen. Wird beispielsweise ein Befehl für einen IPP\-Auftrag ausgeführt, der das Attribut »media« des »Job Template« enthält, wird die Umgebungsvariable »IPP_MEDIA« auf den Wert des Attributes gesetzt. .LP Zusätzlich werden alle IPP\-»xxx\-default« und »pwg\-xxx«\-Druckerbeschreibungsattribute zu der Umgebung hinzugefügt. Beispielsweise wird die Umgebungsvariable »IPP_MEDIA_DEFAULT« auf den Vorgabewert für das Auftragsvorlagenattribut »media« gesetzt. .LP Aufgezählte Werte werden in ihre Schlüsselwort\-Äquivalente umgewandelt. Beispielsweise wird ein Auftrags\-Attribut »print\-quality« mit dem aufgezählten Wert 3 die Umgebungsvariablen »IPP_PRINT_QUALITY« mit dem Wert »draft« werden. Die Zeichenkettenumwandlung erfolgt nur für standardmäßige »Job Template«\-Attribute, derzeit »finishings«, »orientation\-requested« und »print\-quality«. .LP Schließlich enthält die Umgebungsvariable »CONTENT_TYPE« den MIME\-Medientyp des auszudruckenden Dokuments, die Umgebungsvariable »DEVICE_URI« enthält die Geräte\-URI, wie mit der Option »\-D« angegeben, die Umgebungsvariable »OUTPUT_FORMAT« enhält den Ausgabe\-MIME\-Medientyp und die Umgebungsvariable »PPD« enthält den PPD\-Dateinamen, wie mit der Option »\-P« angegeben. .SH BEFEHLSAUSGABE Druckbefehle schicken druckbereite Daten in die Standardausgabe, außer sie kommunizieren direkt mit einem Drucker. .LP Druckbefehle können auf der Standardfehlerausgabe Nachrichten an \fBippeveprinter\fP mit den folgenden Präfixen zurückschicken: .TP 5 \fBATTR: \fP\fIAttribut=Wert[ Attribut=Wert]\fP Setzt das/die benannten Attribut(e) auf den gegebenen Wert. Derzeit können die Auftragsattribute »job\-impressions« und »job\-impressions\-completed« und die Druckerstatusattribute »marker\-xxx«, »printer\-alert«, »printer\-alert\-description«, »printer\-supply« und »printer\-supply\-description« gesetzt werden. .TP 5 \fBDEBUG: \fP\fIFehlersuchnachricht\fP Protokolliert eine Fehlersuchnachricht, falls mindestens zwei »\-v« angegeben wurden. .TP 5 \fBERROR: \fP\fIFehlernachricht\fP Protokolliert eine Fehlernachricht und kopiert die Nachricht in das Attribut »job\-state\-message«. .TP 5 \fBINFO: \fP\fIinformative Nachricht\fP Protokolliert eine informative/Fortschrittsnachricht, falls ein »\-v« angegeben wurde und kopiert die Nachricht in das Attribut »job\-state\-message«, falls kein Fehler berichtet wurde. .TP 5 \fBSTATE: \fP\fISchlüsselwort[,Schlüsselwort,…]\fP Setzt das Attribut »printer\-state\-reasons« des Druckers auf die aufgeführten Schlüsselwörter. .TP 5 \fBSTATE: \-\fP\fISchlüsselwort[,Schlüsselwort,…]\fP Entfernt die aufgeführten Schlüsselwörter aus dem Attribut »printer\-state\-reasons« des Druckers. .TP 5 \fBSTATE: +\fP\fISchlüsselwort[,Schlüsselwort,…]\fP Fügt das aufgeführte Schlüsselwort zu dem Attribut »printer\-state\-reasons« des Druckers hinzu. .SH BEISPIELE \fBippeveprinter\fP mit dem Dienstnamen »Mein Toller Drucker« ausführen: .nf ippeveprinter "Mein Toller Drucker" .fi .LP Den Befehl \fBfile\fP(1) immer ausführen, wenn ein Auftrag an den Server gesendet wird: .nf ippeveprinter \-c /usr/bin/file "Mein Toller Drucker" .fi .SH "SIEHE AUCH" \fBippevepcl\fP(7), \fBippeveps\fP(7), PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.