sane-dll(5) SANE Scanner Access Now Easy sane-dll(5) BEZEICHNUNG sane-dll - Dynamischer Backend-Lader fur SANE BESCHREIBUNG Die Bibliothek sane-dll implementiert ein SANE-(Scanner Access Now Easy) Backend, das Zugriff auf eine beliebige Anzahl weiterer SANE-Backends ermoglicht. Diese Backends konnen entweder zum Zeitpunkt des Erstellens von sane-dll vorab geladen werden oder auf Systemen, die das dynamische Laden von dynamischen Bibliotheken erlauben, konnen die Backends zur Laufzeit geladen werden. In letzterem Falle besteht das Hinzufugen von Unterstutzung fur neue Backends einfach darin, die relevante Bibliothek in /usr/lib/sane zu installieren und einen Eintrag in die Konfigurationsdatei dll.conf hinzuzufugen. Mit anderen Worten, es muss keine Anwendung verandert oder neu kompiliert werden, um die Unterstutzung fur neue Gerate hinzuzufugen. GERATENAMEN Dieses Backend erwartet Geratenamen der folgenden Form: Backend:Gerat Hierbei ist Backend der Name des Backends und Gerat der Name des Gerats in diesem Backend, das adressiert werden soll. Falls der Geratename keinen Doppelpunkt (:) enthalt, dann wird die gesamte Zeichenkette als Gerat-Zeichenkette fur das Standard-Backend betrachtet. Das Standard-Backend ist das Backend, das als letztes in der Konfigurationsdatei (siehe unten) aufgefuhrt ist oder das erste vorab-geladene Backend (falls vorhanden). KONFIGURATION Der Inhalt der Datei dll.conf ist eine Liste von Backend-Namen, die bei Bedarf dynamisch geladen werden konnen. Leere Zeilen sowie alles nach einem Rautezeichen (#) wird ignoriert. Nachfolgend ist eine Beispieldatei dargestellt: net # Dies ist ein Kommentar pnm mustek Es besteht auch die Moglichkeit, eine Datei in /etc/sane.d/dll.d hinzuzufugen, die eine Liste von hinzuzufugenden Backends enthalt. Backends, die in einer in diesem Verzeichnis enthaltenen Datei erwahnt werden, werden vor allen in dll.conf aufgefuhrten Backends hinzugefugt. Der Name der Dateien in /etc/sane.d/dll.d kann frei ausgesucht werden. Sie mussen den Formatkonventionen folgen, die fur dll.conf gelten. Beachten Sie, dass Backends, die zum Erstellungszeitpunkt vorab geladen wurden, nicht in dieser Konfigurationsdatei aufgefuhrt werden mussen. Das heisst, dass das Backend immer vorhanden sein wird, unabhangig davon, ob es in der Konfigurationsdatei aufgefuhrt ist oder nicht, falls es vorab geladen wurde. Die Liste der vorab geladenen Backends wird durch das Makro PRELOADABLE_BACKENDS in der Datei backend/Makefile.in in der SANE-Quellcode-Distribution bestimmt. Nach dem Andern des Wertes dieses Makros ist es notwendig, SANE erneut zu konfigurieren, zu bauen und zu installieren, damit die Anderung wirksam wird. In der Konfigurationsdatei dll.aliases sind Aliase definiert. Sie enthalt Eintrage der Form alias EinName SaneGerateName alias "Ein Name" SaneGerateName hide SaneGerateName Beispiel: alias Epson net:einrechner:epson:/dev/sgX alias "Siemens ST400" st400:/dev/sgY hide net:einrechner:pnm:0 hide net:einrechner:pnm:1 alias "Aus Datei lesen" pnm:0 hide pnm:1 Geratenamen mit Alias werden automatisch versteckt. Die Idee dahinter ist, dass Benutzer nicht mit komplizierten Geratenamen umgehen sollen (insbesondere fur vernetzte Gerate) und andere exportierte Gerate versteckt werden sollen, die sie verwirren konnten. Beachten Sie, dass auf versteckte Geratenamen immer noch zugegriffen werden kann, falls der Geratename bekannt ist, sie erscheinen nur nicht auf der Liste. DATEIEN /etc/sane.d/dll.aliases Die Liste der mit Alias versehenen oder versteckten Backends. /etc/sane.d/dll.conf Die Backend-Konfigurationsdatei (siehe auch die nachfolgende Beschreibung von SANE_CONFIG_DIR). /usr/lib/sane/libsane-dll.a Die statische Bibliothek, die dieses Backend implementiert. /usr/lib/sane/libsane-dll.so Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfugbar, die dynamisches Laden unterstutzen). UMGEBUNGSVARIABLEN SANE_CONFIG_DIR Diese Umgebungsvariable gibt eine Liste von Verzeichnissen an, die die Konfigurationsdatei enthalten konnen. Auf *NIX-Systemen sind die Verzeichnisse durch Doppelpunkte (:) getrennt, unter OS/2 durch Semikola (;). Falls diese Variable nicht gesetzt ist, wird in zwei Standardverzeichnissen nach der Konfigurationsdatei gesucht: zuerst im aktuellen Arbeitsverzeichnis (.) und dann in /etc/sane.d. Falls der Wert der Umgebungsvariable mit dem Verzeichnis-Trennzeichen endet, dann werden die Standardverzeichnisse nach den explizit angegebenen Verzeichnissen durchsucht. Wenn Sie beispielsweise SANE_CONFIG_DIR auf >>/tmp/config:<< setzen, wird in den Verzeichnissen >>tmp/config<<, >>.<< und >>/etc/sane.d<< gesucht (in dieser Reihenfolge). SANE_DEBUG_DLL Falls die Bibliothek mit Debug-Unterstutzung kompiliert wurde, steuert diese Umgebungsvariable die Debug-Stufe fur dieses Backend. Beispielsweise bewirkt ein Wert von 128 die Anzeige samtlicher Debug-Ausgaben. Kleinere Werte reduzieren die Ausfuhrlichkeit. Wert Beschreibung 0 Ausgabe nur schwerer Fehler 1 Ausgabe normaler Fehler und wichtiger Meldungen 2 Ausgabe normaler Meldungen 3 Ausgabe von Debugging-Meldungen 4 Ausgabe von allem Beispiel: export SANE_DEBUG_DLL=3 SIEHE AUCH sane(7), scanimage(1), sane->>Backendname<<(5) AUTOR David Mosberger UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Mario Blattermann und Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . 13. Juli 2008 sane-dll(5)