.\"
.\" "$Id: cups-driverd.man.in 11109 2013-07-08 21:15:13Z msweet $"
.\"
.\"   cups-driverd man page for CUPS.
.\"
.\"   Copyright 2007-2013 by Apple Inc.
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Apple Inc. and are protected by Federal copyright
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\"   which should have been included with this file.  If this file is
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH cups\-driverd 8 CUPS "8. Juli 2013" "Apple Inc."
.SH NAME
cups\-driverd \- CUPS\-Treiber\-Daemon
.SH SYNOPSIS
\fBcups\-driverd\fP cat \fIPPD\-Name\fP
.br
\fBcups\-driverd\fP list \fIAnfrage\-ID Grenze Optionen\fP
.SH BESCHREIBUNG
\fIcups\-driverd\fP zeigt PPD\-Dateien an oder listet diese auf. Es wird als
Reaktion auf »CUPS\-Add\-Modify\-Printer«\- oder »CUPS\-Get\-Devices«\-Anfragen
ausgeführt. Die erste Form (»cups\-driverd cat PPD\-Name«) schreibt die
benannte PPD\-Datei nach Stdout. Das Ausgabeformat ist eine unkomprimierte
PPD\-Datei.
.LP
Die zweite Form listet in der Standardausgabe die verfügbaren Hersteller
oder PPD\-Dateien auf, wie diese durch das Argument \fIOptionen\fP angegeben
sind. Die Ausgabe erfolgt im IPP\-Antwortnachrichtenformat. Das Argument
\fIAnfrage\-ID\fP ist die Anfrage\-ID der ursprünglichen IPP\-Anfrage,
typischerweise 1. Das Argument \fIGrenze\fP ist der Grenzwert aus der
ursprünglichen IPP\-Anfrage \- 0 bedeutet keine Grenze. Das Argument
\fIOptionen\fP ist schließlich eine durch Leerzeichen getrennte Liste von
Attributen (»Name=Wert Name=Wert \&…«), die mit der Anfrage eingereicht
wurden. Derzeit schaut \fIcups\-driverd\fP nach den Attributen \fIppd\-make\fP und
\fIrequested\-attributes\fP und passt die Ausgabe entsprechend an.
.SH TREIBER
Treiber können statische PPD\-Dateien unterhalb des Verzeichnisses
\fI/usr/share/cups/model\fP oder Programme unterhalb des Verzeichnisses
\fI/usr/lib/cups/driver\fP oder \fI/usr/libexec/cups/driver\fP (OS X)
sein. Statische PPD\-Dateien müssen der Adobe PPD File Format Specification
Version 4.3 folgen und können mittels \fIgzip(1)\fP komprimiert
sein. Treiberprogramme müssen die in dem nächsten Abschnitt beschriebene
Befehlszeilenschnittstelle implementieren.
.SS TREIBER\-PROGRAMME
Treiberprogramme stellen eine Schnittstelle für dynamisch\-generierte
PPD\-Dateien bereit. Die folgenden Argumente sind aktuell definiert:
.TP  5
drivername list
.br
Listet die unterstützten PPD\-Dateien auf der Standardausgabe auf.
.TP  5
drivername cat PPD\-Name
.br
Schreibt die benannte PPD\-Datei auf die Standardausgabe.
.PP
Treiberprogramme dürfen Hardware NICHT abfragen oder andere, langlaufende
Operationen durchführen, die die Rückkehr aus der Treiberliste verzögern
würden. Lesen Sie den Abschnitt HINWEISE weiter unten für gezielte
Empfehlungen.
.SS "DATEIEN AUFLISTEN (Treibernamenliste)"
Beim Aufruf mit dem einzelnen Argument »list« muss das Programm die
verfügbaren PPD\-Dateien, die es auf die Standardausgabe generieren kann, im
folgenden Format auflisten:
.nf
    "Treibername:PPD\-Name" language "Marke" "Marke und Modell"
    "Treibername:PPD\-Name" language "Marke" "Marke und Modell" "1284\-Geräte\-ID"
    "Treibername:PPD\-Name" language "Marke" "Marke und Modell" "1284\-Geräte\-ID" "(PPD\-Produkt)"
    "Treibername:PPD\-Name" language "Marke" "Marke und Modell" "1284\-Geräte\-ID" "(PPD\-Produkt)" "PostScript\-Version"
    "Treibername:PPD\-Name" language "Marke" "Marke und Modell" "1284\-Geräte\-ID" "(PPD\-Produkt)" "PostScript\-Version" "Typ"
.fi
.LP
\fITreibername\fP ist der Name des Treiberprogramms. \fIPPD\-Name\fP ist der Name,
der zur Auswahl des gegebenen Treibers verwandt wird. \fISprache\fP ist die mit
der Standardsprache der PPD\-Datei assoziierte Lokale (Standorteinstellung),
typischerweise »en«. \fIMarke\fP ist der Herstellername aus der
PPD\-Datei. \fIMarke und Modell\fP ist der »NickName« aus der
PPD\-Datei. \fI1284\-Geräte\-ID\fP ist die 1284DeviceId aus der PPD\-Datei, falls
vorhanden. \fI(PPD\-Produkt)\fP ist die Produktzeichenkette, wie sie in der
PPD\-Datei oder von einer Postscript\-Abfrage erscheinen
könnte. \fIPostScript\-Version\fP ist die PSVersion\-Zeichenkette wie sie in der
PPD\-Datei oder von einer Postscript\-Abfrage erscheinen könnte. \fITyp\fP ist
»postscript« für PostScript\-Drucker, »pdf« für PDF\-Drucker, »raster« für
Raster\-Drucker oder »fax« für Faxgeräte.
.SS "DATEIEN SCHREIBEN (drivername cat PPD\-Name)"
Wenn das Treiberprogramm mit den Argumenten »cat PPD\-Name« ausgeführt wird,
muss es die benannte PPD\-Datei unkomprimiert nach StdOut schreiben. Falls
die benannte PPD\-Datei nicht existiert, so darf das Treiberprogramm nichts
auf die Standardausgabe schreiben und muss stattdessen alle Fehler auf
Stderr melden.
.SS TREIBERFEHLERMELDUNGEN
Fehlernachrichten können an \fIcupsd\fP zurückgeleitet werden, indem Sie auf
Stderr geschrieben werden. Die folgenden Präfixe werden erkannt:
.TP  5
DEBUG: [Treibername]
.br
Fehlersuchenachrichten
.TP  5
ERROR: [Treibername]
.br
Fehlermeldungen
.TP  5
INFO: [Treibername]
.br
Informative Nachrichten
.SH HINWEISE
Aufgrund von Leistungsbetrachtungen wurden Treiberprogramme offiziell als
veraltet erklärt und sollten nicht für neue Entwicklungen benutzt
werden. Derzeit werden nur die CUPS\-Webschnittstelle und der Befehl
\fIlpinfo(8)\fP Listen von allen Treiberprogrammen abfragen.
.SH "SIEHE AUCH"
cupsd(8), cupsd.conf(5), cupstestppd(1), lpinfo(8),
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007\-2013 by Apple Inc.
.\"
.\" End of "$Id: cups-driverd.man.in 11109 2013-07-08 21:15:13Z msweet $".
.\"