.\" .\" Backend man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2007-2019 by Apple Inc. .\" Copyright © 1997-2006 by Easy Software Products. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH Backend 7 CUPS 2021\-02\-28 OpenPrinting .SH NAME backend \- CUPS Backend\-Übertragungsschnittstellen .SH SYNOPSIS \fBbackend\fP .br \fBbackend\fP \fIAuftrag\fP \fIBenutzer\fP \fITitel\fP \fIAnzahl\-Kopien\fP \fIOptionen\fP [ \fIDateiname\fP ] .nf \fB#include \fP \fBconst char *cupsBackendDeviceURI\fP(\fBchar **\fP\fIargv\fP); \fBvoid cupsBackendReport\fP(\fBconst char *\fP\fIdevice_scheme\fP, \fBconst char *\fP\fIdevice_uri\fP, \fBconst char *\fP\fIdevice_make_and_model\fP, \fBconst char *\fP\fIdevice_info\fP, \fBconst char *\fP\fIdevice_id\fP, \fBconst char *\fP\fIdevice_location\fP); \fBssize_t cupsBackChannelWrite\fP(\fBconst char *\fP\fIbuffer\fP, \fBsize_t \fP\fIbytes\fP, \fBdouble \fP\fItimeout\fP); \fBint cupsSideChannelRead\fP(\fBcups_sc_command_t *\fP\fIcommand\fP, \fBcups_sc_status_t *\fP\fIstatus\fP, \fBchar *\fP\fIdata\fP, \fBint *\fP\fIdatalen\fP, \fBdouble \fP\fItimeout\fP); \fBint cupsSideChannelWrite\fP(\fBcups_sc_command_t \fP\fIcommand\fP, \fBcups_sc_status_t \fP\fIstatus\fP, \fBconst char *\fP\fIdata\fP, \fBint \fP\fIdatalen\fP, \fBdouble \fP\fItimeout\fP); .fi .SH BESCHREIBUNG Backends sind eine besondere Art von \fBfilter\fP(7), die verwendet werden, um Daten zu verschiedenen Geräten auf dem System zu senden und entsprechende Geräte zu ermitteln. .LP Wie Filter müssen Backends in der Lage sein, aus Dateinamen auf der Befehlszeile oder von der Standardeingabe zu lesen, die Standardeingabe in eine temporäre Datei zu kopieren, wie dies von der physischen Schnittstelle gefordert wird. .LP Der Befehlsname (\fIargv[0]\fP) wird auf die Geräte\-URI des Zieldruckers gesetzt. Jede Authentifizierungsinformation wird aus \fIargv[0]\fP entfernt, daher wird Backend\-Entwicklern empfohlen, die Umgebungsvariable \fBDEVICE_URI\fP zu verwenden, wenn immer Authentifizierungsinformationen benötigt werden. Die Funktion \fBcupsBackendDeviceURI\fP() kann zum Ermitteln der korrekten Geräte\-URI verwandt werden. .LP Rückgeleitete Daten vom Gerät sollten an die Filter für die Aufträge mittels der Funktion \fIcupsBackChannelWrite\fP weitergeleitet werden. .LP Backends sind dafür verantwortlich, mittels der Funktion \fBcupsSideChannelRead\fP() Seitenkanalanfragen zu lesen und mit der Funktion \fBcupsSideChannelWrite\fP() zu antworten. Die Konstante \fBCUPS_SC_FD\fP definiert den Dateideskriptor, der für eingehende Anfragen überwacht werden sollte. .SS GERÄTE\-ERMITTLUNG Beim Aufruf ohne Argumente sollte das Backend die Geräte und unterstützten oder beworbenen Schemata auf der Standardausgabe aufführen. Die Ausgabe besteht aus null oder mehr Zeilen, die in einer der folgenden Formen vorliegen: .nf device\-class scheme "Unknown" "device\-info" device\-class device\-uri "device\-make\-and\-model" "device\-info" device\-class device\-uri "device\-make\-and\-model" "device\-info" "device\-id" device\-class device\-uri "device\-make\-and\-model" "device\-info" "device\-id" "device\-location" .fi .LP Die Funktion \fBcupsBackendReport\fP() kann dazu verwandt werden, um diese Zeilen zu erzeugen und in den verschiedenen Zeichenketten alle notwendigen Zeichen zu maskieren. .LP Das Feld \fIdevice\-class\fP enthält einen der folgenden Werte: .TP 5 \fBdirect\fP Die Geräte\-URI bezieht sich auf spezielle Geräte mit direktem Zugriff ohne Optionen, wie z.B. Parallelport\-, USB\- oder SCSI\-Geräte. .TP 5 \fBfile\fP Die Geräte\-URI bezieht sich auf eine Datei auf dem Speichermedium. .TP 5 \fBnetwork\fP Die Geräte\-URI bezieht sich auf ein vernetztes Gerät und folgt der allgemeinen Form für vernetzte URIs. .TP 5 \fBserial\fP Die Geräte\-URI bezieht sich auf ein serielles Gerät mit einer konfigurierbaren Baudrate und anderen Optionen. Falls die Geräte\-URI einen Baud\-Wert enthält, repräsentiert er die maximale vom Gerät unterstützte Baudrate. .LP Das Feld \fIscheme\fP stellt das vom Backend unterstützte URI\-Schema bereit. Backends sollten diese Form nur verwenden, wenn das Backend irgendeine dem Schema folgende URI unterstützt. Das Feld \fIdevice\-uri\fP legt die komplette URI, die bei der Kommunikation mit dem Gerät verwandt werden soll, fest. .LP Das Feld \fIdevice\-make\-and\-model\fP legt die Marke und das Modell des Gerätes, z.B. »Beispiel Foojet 2000«, fest. Falls die Marke und das Modell nicht bekannt ist, müssen Sie »Unknown« melden. .LP Das Feld \fIdevice\-info\fP legt zusätzliche Informationen über das Gerät fest. Typischerweise enthält es die Marke und das Modell zusammen mit der Port\-Nummer oder der Netz\-Adresse, z.B. »Beispiel Foojet 2000 USB #1«. .LP Das optionale Feld \fIdevice\-id\fP legt die IEEE\-1284\-Geräte\-ID\-Zeichenkette für das Gerät, die zur Auswahl des passenden Treibers verwandt wird, fest. .LP Das optionale Feld \fIdevice\-location\fP legt den physischen Standort des Geräts fest. Es wird oft dazu verwandt, die Drucker\-Standort\-Attribute vorab zu belegen, wenn ein Drucker hinzugefügt wird. .SS RECHTE Backends, denen die Lese\- und Ausführungsrechte für »world« (andere) fehlen, werden als Benutzer »root« ausgeführt. Andernfalls läuft das Backend unter einem unprivilegierten Benutzerkonto, typischerweise »lp«. .SH EXIT\-STATUS Die nachfolgenden Exit\-Codes sind für Backends definiert: .TP 5 \fBCUPS_BACKEND_OK\fP Die Druckdatei wurde erfolgreich an das Gerät oder den fernen Server übertragen. .TP 5 \fBCUPS_BACKEND_FAILED\fP .br Die Druckdatei wurde nicht erfolgreich zum Gerät oder fernen Server übertragen. Der Auftragsplaner (Scheduler) wird daraufhin den Auftrag abbrechen, den Auftrag erneut versuchen oder die Warteschlange anhalten, abhängig vom Zustand des Attributs \fIprinter\-error\-policy\fP. .TP 5 \fBCUPS_BACKEND_AUTH_REQUIRED\fP Die Druckdatei wurde nicht erfolgreich übertragen, da gültige Authentifizierungsinformationen benötigt werden. Der Auftragsplaner wird darauf durch Halten des Auftrags reagieren und das Schlüsselwort »cups\-held\-for\-authentication« zu dem Auftragsbeschreibungsattribut »job\-reasons« hinzufügen. .TP 5 \fBCUPS_BACKEND_HOLD\fP Die Druckdatei wurde nicht erfolgreich übertragen, da sie derzeit nicht gedruckt werden kann. Der Auftragsplaner wird darauf durch Halten des Auftrags reagieren. .TP 5 \fBCUPS_BACKEND_STOP\fP Die Druckdatei wurde nicht erfolgreich übertragen, da sie derzeit nicht gedruckt werden kann. Der Auftragsplaner wird durch Anhalten der Warteschlange darauf reagieren. .TP 5 \fBCUPS_BACKEND_CANCEL\fP Die Druckdatei wurde nicht erfolgreich übertragen, da eine oder mehrere der Attribute nicht unterstützt werden oder der Auftrag am Drucker abgebrochen wurde. Der Auftragsplaner wird durch Abbruch des Auftrages darauf reagieren. .TP 5 \fBCUPS_BACKEND_RETRY\fP Die Druckdatei wurde aufgrund eines temporären Problems nicht erfolgreich übertragen. Der Auftragsplaner wird den Auftrag zu einem zukünftigen Zeitpunkt erneut versuchen \- andere Aufträge können vor diesem gedruckt werden. .TP 5 \fBCUPS_BACKEND_RETRY_CURRENT\fP Die Druckdatei wurde aufgrund eines temporären Problems nicht erfolgreich übertragen. Der Auftragsplaner wird den Auftrag sofort erneut versuchen, ohne andere Aufträge dazwischen zu erlauben. .PP Alle anderen Exit\-Codes sind reserviert. .SH UMGEBUNG Zusätzlich zu den in \fBcups\fP(1) und \fBfilter\fP(7) aufgeführten Umgebungsvariablen können CUPS\-Backends die folgenden Umgebungsvariablen erwarten: .TP 5 \fBDEVICE_URI\fP Die mit dem Drucker verbundene Geräte\-URI. .SH DATEIEN \fI/etc/cups/cups\-files.conf\fP .SH HINWEISE CUPS\-Backends wurden im Allgemeinen nicht dafür entwickelt, um vom Benutzer direkt aufgerufen zu werden. Neben der Geräte\-URI (\fIargv[0]\fP und der Umgebungsvariablen \fBDEVICE_URI\fP, die die Geräte\-URI enthält) erwarten die CUPS\-Backends auch bestimmte Umgebungsvariablen und Dateideskriptoren und laufen typischerweise auch in einer Benutzersitzung, die (unter macOS) zusätzlichen Beschränkungen unterliegt, die die Ausführung betreffen. Backends können auch mit eingeschränkten Rechten installiert werden (0500 oder 0700), die dem Auftragsplaner mitteilen, sie als Benutzer »root« statt des unprivilegierten Benutzers (typischerweise »lp«) auszuführen. .LP Sofern Sie kein Entwickler sind und nicht wissen, was Sie tun, führen Sie kein Backend direkt aus. Verwenden Sie stattdessen die Programme \fBlp\fP(1) oder \fBlpr\fP(1), um Druckaufträge zu übersenden oder das Programm \fBlpinfo\fP(8), um verfügbare Drucker über ein Backend abzufragen. Die einzige Ausnahme ist das SNMP\-Backend \- lesen Sie \fBcups\-snmp\fP(8) für weitere Informationen. .SH HINWEISE CUPS\-Druckertreiber und \-Backends sind veraltet und werden in einer zukünftigen Funktionsveröffentlichung von CUPS nicht mehr unterstützt. Drucker, die IPP nicht unterstützen, können mittels Anwendungen wie \fBippeveprinter\fP(1) unterstützt werden. .SH "SIEHE AUCH" \fIcups\fP(1), \fIcups\-files.conf\fP(5), \fIcups\-snmp\fP(8), \fIcupsd\fP(8), \fIfilter\fP(7), \fIlp\fP(1), \fIlpinfo\fP(8), \fIlpr\fP(1), .br CUPS\-Online\-Hilfe (http://localhost:631/help) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.