NAME¶

backend - CUPS Backend-Übertragungsschnittstellen

SYNOPSIS¶

backend
backend Auftrag Benutzer Titel Anzahl-Kopien Optionen [ Dateiname ]

#include <cups/cups.h>
const char *cupsBackendDeviceURI(char **argv);
void cupsBackendReport(const char *device_scheme,


                       const char *device_uri,


                       const char *device_make_and_model,


                       const char *device_info,


                       const char *device_id,


                       const char *device_location);
ssize_t cupsBackChannelWrite(const char *buffer,


                             size_t bytes, double timeout);
int cupsSideChannelRead(cups_sc_command_t *command,


                        cups_sc_status_t *status, char *data,


                        int *datalen, double timeout);
int cupsSideChannelWrite(cups_sc_command_t command,


                         cups_sc_status_t status, const char *data,


                         int datalen, double timeout);

BESCHREIBUNG¶

Backends sind eine besondere Art von filter(7), die verwendet werden, um Daten zu verschiedenen Geräten auf dem System zu senden und entsprechende Geräte zu ermitteln.

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.

Der Befehlsname (argv[0]) wird auf die Geräte-URI des Zieldruckers gesetzt. Jede Authentifizierungsinformation wird aus argv[0] entfernt, daher wird Backend-Entwicklern empfohlen, die Umgebungsvariable DEVICE_URI zu verwenden, wenn immer Authentifizierungsinformationen benötigt werden. Die Funktion cupsBackendDeviceURI() kann zum Ermitteln der korrekten Geräte-URI verwandt werden.

Rückgeleitete Daten vom Gerät sollten an die Filter für die Aufträge mittels der Funktion cupsBackChannelWrite weitergeleitet werden.

Backends sind dafür verantwortlich, mittels der Funktion cupsSideChannelRead() Seitenkanalanfragen zu lesen und mit der Funktion cupsSideChannelWrite() zu antworten. Die Konstante CUPS_SC_FD definiert den Dateideskriptor, der für eingehende Anfragen überwacht werden sollte.

    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"

EXIT-STATUS¶

Die nachfolgenden Exit-Codes sind für Backends definiert:

CUPS_BACKEND_OK

Die Druckdatei wurde erfolgreich an das Gerät oder den fernen Server übertragen.

CUPS_BACKEND_FAILED

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 printer-error-policy.

CUPS_BACKEND_AUTH_REQUIRED

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.

CUPS_BACKEND_HOLD

Die Druckdatei wurde nicht erfolgreich übertragen, da sie derzeit nicht gedruckt werden kann. Der Auftragsplaner wird darauf durch Halten des Auftrags reagieren.

CUPS_BACKEND_STOP

Die Druckdatei wurde nicht erfolgreich übertragen, da sie derzeit nicht gedruckt werden kann. Der Auftragsplaner wird durch Anhalten der Warteschlange darauf reagieren.

CUPS_BACKEND_CANCEL

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.

CUPS_BACKEND_RETRY

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.

CUPS_BACKEND_RETRY_CURRENT

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.

Alle anderen Exit-Codes sind reserviert.

UMGEBUNG¶

Zusätzlich zu den in cups(1) und filter(7) aufgeführten Umgebungsvariablen können CUPS-Backends die folgenden Umgebungsvariablen erwarten:

DEVICE_URI

Die mit dem Drucker verbundene Geräte-URI.

DATEIEN¶

/etc/cups/cups-files.conf

HINWEISE¶

CUPS-Backends wurden im Allgemeinen nicht dafür entwickelt, um vom Benutzer direkt aufgerufen zu werden. Neben der Geräte-URI (argv[0] und der Umgebungsvariablen DEVICE_URI, 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.

Sofern Sie kein Entwickler sind und nicht wissen, was Sie tun, führen Sie kein Backend direkt aus. Verwenden Sie stattdessen die Programme lp(1) oder lpr(1), um Druckaufträge zu übersenden oder das Programm lpinfo(8), um verfügbare Drucker über ein Backend abzufragen. Die einzige Ausnahme ist das SNMP-Backend - lesen Sie cups-snmp(8) für weitere Informationen.

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 ippeveprinter(1) unterstützt werden.

SIEHE AUCH¶

cups(1), cups-files.conf(5), cups-snmp(8), cupsd(8), filter(7), lp(1), lpinfo(8), lpr(1),
CUPS-Online-Hilfe (http://localhost:631/help)

COPYRIGHT¶

Copyright © 2021-2022 by OpenPrinting.