244 lines
11 KiB
HTML
244 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of ippeveprinter</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>ippeveprinter</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>NAME</H2>
|
|
|
|
ippeveprinter - eine IPP-Everywhere-Druckeranwendung für CUPS
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ippeveprinter</B> [ <B>--help</B> ] [ <B>--no-web-forms</B> ] [ <B>--pam-service</B>
|
|
<I>Dienst</I> ][ <B>--version</B> ] [ <B>-2</B> ] [ <B>-A</B> ] [ <B>-D</B> <I>Geräte-URI</I> ] [
|
|
<B>-F</B> <I>Ausgabetyp/-untertyp</I> ] [ <B>-K</B> <I>Schlüsselpfad</I> ] [ <B>-M</B>
|
|
<I>Hersteller</I> ] [ <B>-P</B> <I>Dateiname.ppd</I> ] [ <B>-V</B> <I>IPP-Version</I> ] [ <B>-a</B>
|
|
<I>Dateiname.conf</I> ] [ <B>-c</B> <I>Befehl</I> ] [ <B>-d</B> <I>Spool-Verzeichnis</I> ] [
|
|
<B>-f</B> <I>Typ/Untertyp[,…]</I> ] [ <B>-i</B> <I>Icon-Datei.png</I> ] [ <B>-k</B> ] [ <B>-l</B>
|
|
<I>Ort</I> ] [ <B>-m</B> <I>Modell</I> ] [ <B>-n</B> <I>Rechnername</I> ] [ <B>-p</B> <I>Port</I> ] [
|
|
<B>-r</B> <I>Untertyp[,Untertyp]</I> ] [ <B>-s</B>
|
|
<I>Geschwindigkeit[,Farbgeschwindigkeit]</I> ] [ <B>-v[vvv]</B> ] <I>Dienstename</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHREIBUNG</H2>
|
|
|
|
<B>ippeveprinter</B> 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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONEN</H2>
|
|
|
|
Die folgenden Optionen werden von <I>ippeveprinter</I> erkannt:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--help</B><DD>
|
|
Zeigt die Programm-Verwendung.
|
|
<DT id="2"><B>--no-web-forms</B><DD>
|
|
Deaktiviert die zur Aktualisierung der Medien- und Bereitstellungsstufen
|
|
verwandte Webschnittstellenformulare.
|
|
<DT id="3"><B>--pam-service </B><I>Dienst</I><DD>
|
|
Legt den PAM-Dienstenamen fest. Der Vorgabedienst ist »cups«.
|
|
<DT id="4"><B>--version</B><DD>
|
|
Zeigt die CUPS-Version an.
|
|
<DT id="5"><B>-2</B><DD>
|
|
Meldet die Unterstützung für zweiseitigen (Duplex-)Druck.
|
|
<DT id="6"><B>-A</B><DD>
|
|
Aktiviert Authentisierung für erstellte Drucker. <B>ippeveprinter</B> verwendet
|
|
PAM, um »HTTP Basic«-Zugriffsberechtigungen zu authentisieren.
|
|
<DT id="7"><B>-D </B><I>Geräte-URI</I><DD>
|
|
Setzt die Geräte-URI für Druckausgabe. Die URI kann ein Dateiname, ein
|
|
Verzeichnis oder eine Netzwerk-Socket-URI der Form »S<A HREF="ocket://ADRESSE[:PORT]«">ocket://ADRESSE[:PORT]«</A>
|
|
sein (wobei die Vorgabe-Portnummer 9100 ist). Wird ein Verzeichnis
|
|
angegeben, wird <B>ippeveprinter</B> eine Ausgabedatei mittels der
|
|
Auftragskennung und dem Namen erzeugen.
|
|
<DT id="8"><B>-F </B><I>Ausgabetyp/Untertyp[,…]</I><DD>
|
|
Legt den Ausgabe-MIME-Medientyp fest. Die Vorgabe ist
|
|
»application/postscript«, wenn die Option <B>-P</B> festgelegt ist.
|
|
<DT id="9"><B>-M </B><I>Hersteller</I><DD>
|
|
Setzt den Hersteller des Druckers. Die Vorgabe ist »Example«.
|
|
<DT id="10"><B>-P </B><I>Dateiname.ppd</I><DD>
|
|
Druckerattribute aus der festgelegten PPD-Datei laden. Diese Option wird
|
|
typischerweise in Zusammenhang mit dem Druckerbefehl <B><A HREF="/cgi-bin/man/man2html?7+ippeveps">ippeveps</A></B>(7)("-c
|
|
ippeveps") verwandt.
|
|
<DT id="11"><B>-V 1.1</B><DD>
|
|
<DT id="12"><B>-V 2.0</B><DD>
|
|
Legt die maximal zu berichtende IPP-Version fest. 2.0 ist die Vorgabe.
|
|
<DT id="13"><B>-c </B><I>Befehl</I><DD>
|
|
Führt den festgelegten Befehl für jedes ausgedruckte Dokument aus. Falls
|
|
»Befehl« kein absoluter Pfad ist (»/Pfad/zu/Befehl«), sucht <B>ippeveprinter</B>
|
|
nach dem Befehl im Unterverzeichnis »Befehl« des
|
|
CUPS-Programmverzeichnisses, typischerweise /usr/lib/cups/Befehl oder
|
|
/usr/libexec/cups/Befehl. Der Befehl <B><A HREF="/cgi-bin/man/man2html?1+cups-config">cups-config</A></B>(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 <B><A HREF="/cgi-bin/man/man2html?1+cups">cups</A></B>(1) für weitere Details.
|
|
<DT id="14"><B>-d </B><I>Spool-Verzeichnis</I><DD>
|
|
Legt das Verzeichnis, in denen die Druckaufträge gehalten werden, fest. Die
|
|
Vorgabe ist ein Verzeichnis unter dem aktuellen temporären Verzeichnis des
|
|
Benutzers.
|
|
<DT id="15"><B>-f </B><I>Typ/Untertyp[,…]</I><DD>
|
|
Legt eine Liste von MIME-Medientypen fest, die der Server akzeptiert. Die
|
|
Vorgabe hängt vom Typ des erstellten Druckers ab.
|
|
<DT id="16"><B>-i </B><I>Icon-Datei.png</I><DD>
|
|
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.
|
|
<DT id="17"><B>-k</B><DD>
|
|
Belässt die Druckdokumente im Spool-Verzeichnis, statt sie zu löschen.
|
|
<DT id="18"><B>-l </B><I>Ort</I><DD>
|
|
Legt die menschenlesbare Ortszeichenkette fest, die vom Server berichtet
|
|
wird. Die Vorgabe ist die leere Zeichenkette.
|
|
<DT id="19"><B>-m </B><I>Modell</I><DD>
|
|
Legt den Modellnamen des Druckers fest. Die Vorgabe ist »Printer«.
|
|
<DT id="20"><B>-n </B><I>Rechnername</I><DD>
|
|
Legt den Rechnernamen, der vom Server gemeldet wird, fest. Die Vorgabe ist
|
|
der durch den Befehl <B><A HREF="/cgi-bin/man/man2html?1+hostname">hostname</A></B>(1) zurückgelieferte Name.
|
|
<DT id="21"><B>-p </B><I>Port</I><DD>
|
|
Legt den Port fest, bei dem auf Anfragen gewartet werden soll. Die Vorgabe
|
|
ist eine benutzerspezifische Nummer zwischen 8000 und 8999.
|
|
<DT id="22"><B>-r off</B><DD>
|
|
Schaltet DNS-SD-Dienstebewerbung komplett aus.
|
|
<DT id="23"><B>-r </B><I>Untertyp[,Untertyp]</I><DD>
|
|
Legt den/die DNS-SD-Untertyp(en) fest, die bekanntgegeben werden
|
|
sollen. Mehrere Untertypen werden mit Kommata getrennt. Die Vorgabe ist
|
|
»_print«.
|
|
<DT id="24"><B>-s </B><I>Geschwindigkeit[,Farb-Geschwindigkeit]</I><DD>
|
|
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«.
|
|
<DT id="25"><B>-v[vvv]</B><DD>
|
|
Das Protokollieren der Aktivitäten auf die Standardfehlerausgabe erfolgt
|
|
(sehr) ausführlich.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXIT-STATUS</H2>
|
|
|
|
Das Programm <B>ippeveprinter</B> liefert 1 zurück, falls es nicht in der Lage
|
|
ist, die Befehlszeilenargumente zu verarbeiten oder den IPP-Dienst zu
|
|
registrieren. Andernfalls läuft <B>ippeveprinter</B> dauerhaft, bis er beendet
|
|
wird.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>KONFORMITÄT</H2>
|
|
|
|
Das Programm <B>ippeveprinter</B> ist eine Besonderheit von CUPS und konform zu
|
|
der Spezifikation »IPP Everywhere (PWG 5100.14)«.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>UMGEBUNG</H2>
|
|
|
|
<B>ippeveprinter</B> 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.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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«.
|
|
<P>
|
|
|
|
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.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BEFEHLSAUSGABE</H2>
|
|
|
|
Druckbefehle schicken druckbereite Daten in die Standardausgabe, außer sie
|
|
kommunizieren direkt mit einem Drucker.
|
|
<P>
|
|
|
|
Druckbefehle können auf der Standardfehlerausgabe Nachrichten an
|
|
<B>ippeveprinter</B> mit den folgenden Präfixen zurückschicken:
|
|
<DL COMPACT>
|
|
<DT id="26"><B>ATTR: </B><I>Attribut=Wert[ Attribut=Wert]</I><DD>
|
|
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.
|
|
<DT id="27"><B>DEBUG: </B><I>Fehlersuchnachricht</I><DD>
|
|
Protokolliert eine Fehlersuchnachricht, falls mindestens zwei »-v« angegeben
|
|
wurden.
|
|
<DT id="28"><B>ERROR: </B><I>Fehlernachricht</I><DD>
|
|
Protokolliert eine Fehlernachricht und kopiert die Nachricht in das Attribut
|
|
»job-state-message«.
|
|
<DT id="29"><B>INFO: </B><I>informative Nachricht</I><DD>
|
|
Protokolliert eine informative/Fortschrittsnachricht, falls ein »-v«
|
|
angegeben wurde und kopiert die Nachricht in das Attribut
|
|
»job-state-message«, falls kein Fehler berichtet wurde.
|
|
<DT id="30"><B>STATE: </B><I>Schlüsselwort[,Schlüsselwort,…]</I><DD>
|
|
Setzt das Attribut »printer-state-reasons« des Druckers auf die aufgeführten
|
|
Schlüsselwörter.
|
|
<DT id="31"><B>STATE: -</B><I>Schlüsselwort[,Schlüsselwort,…]</I><DD>
|
|
Entfernt die aufgeführten Schlüsselwörter aus dem Attribut
|
|
»printer-state-reasons« des Druckers.
|
|
<DT id="32"><B>STATE: +</B><I>Schlüsselwort[,Schlüsselwort,…]</I><DD>
|
|
Fügt das aufgeführte Schlüsselwort zu dem Attribut »printer-state-reasons«
|
|
des Druckers hinzu.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BEISPIELE</H2>
|
|
|
|
<B>ippeveprinter</B> mit dem Dienstnamen »Mein Toller Drucker« ausführen:
|
|
<PRE>
|
|
|
|
ippeveprinter "Mein Toller Drucker"
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
Den Befehl <B><A HREF="/cgi-bin/man/man2html?1+file">file</A></B>(1) immer ausführen, wenn ein Auftrag an den Server
|
|
gesendet wird:
|
|
<PRE>
|
|
|
|
ippeveprinter -c /usr/bin/file "Mein Toller Drucker"
|
|
</PRE>
|
|
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SIEHE AUCH</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+ippevepcl">ippevepcl</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?7+ippeveps">ippeveps</A></B>(7), PWG Internet Printing Protocol Workgroup
|
|
(<A HREF="http://www.pwg.org/ipp)">http://www.pwg.org/ipp)</A>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2007-2019 by Apple Inc.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="33"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="34"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="35"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
|
|
<DT id="36"><A HREF="#lbAE">OPTIONEN</A><DD>
|
|
<DT id="37"><A HREF="#lbAF">EXIT-STATUS</A><DD>
|
|
<DT id="38"><A HREF="#lbAG">KONFORMITÄT</A><DD>
|
|
<DT id="39"><A HREF="#lbAH">UMGEBUNG</A><DD>
|
|
<DT id="40"><A HREF="#lbAI">BEFEHLSAUSGABE</A><DD>
|
|
<DT id="41"><A HREF="#lbAJ">BEISPIELE</A><DD>
|
|
<DT id="42"><A HREF="#lbAK">SIEHE AUCH</A><DD>
|
|
<DT id="43"><A HREF="#lbAL">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:04:56 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|