SANE-AIRSCAN(5) AirScan- (eSCL-) und WSD-SANE-Backend SANE-AIRSCAN(5) BEZEICHNUNG sane-airscan - SANE-Backend fur AirScan- (eSCL-) und WSD-Scanner und MFP BESCHREIBUNG sane-airscan ist das universelle Backend fur >>treiberloses<< Dokumenten-Scannen. Derzeit werden zwei Protokolle unterstutzt: 1. eSCL, auch als AirScan oder AirPrint-Scan bekannt 2. WSD, auch als WS-Scan bekannt KONFIGURATION sane-airscan ladt seine Konfigurationsdatei aus den folgenden Orten: 1. /etc/sane.d/airscan.conf 2. /etc/sane.d/airscan.d/* Die Konfigurationsdateisyntax ist sehr ahnlich der .INI-Dateisyntax. Sie besteht aus Abschnitten; jeder Abschnitt enthalt einige Variablen. Kommentare beginnen mit dem Zeichen >>#<< oder >>;<< und gehen bis zum Zeilenende. # Dies ist ein Kommentar [section 1] Variable 1 = Wert 1 ; und ein weiterer Kommentar Variable 2 = Wert 2 Leerzeichen vor und nach Variablennamen und -werten werden entfernt. Falls Sie sie erhalten mochten, stellen Sie den Namen oder den Wert in englische Anfuhrungszeichen ("so wie hier"). GERATEKONFIGURATION Falls der Scanner und der Computer im gleichen LAN-Segment verbunden sind, sollte alles Erwartete >>einfach funktionieren<<, ohne irgendwelche manuelle Konfiguration. Allerdings kann in manchen Fallen eine manuelle Konfiguration nutzlich sein, beispielsweise: 1. Falls der Computer und Scanner uber einen IP-Router verbunden sind 2. Im Firmennetzwerk gibt es viele Gerate, aber nur ein paar davon sind von Interesse 3. Die automatische Erkennung funktioniert unzuverlassig Um ein Gerat manuell zu konfigurieren, fugen Sie den folgenden Abschnitt zur Konfigurationsdatei hinzu: [devices] "Kyocera eSCL" = http://192.168.1.102:9095/eSCL, eSCL "Kyocera WSD" = http://192.168.1.102:5358/WSDScanner, WSD "Gerate, die ich nicht sehen mochte" = disable Der Abschnitt [devices] enthalt alle manuell konfigurierten Gerate, eine Zeile pro Gerat und jede Zeile enthalt einen Geratenamen auf der linken Seite der Gleichung und eine Gerate-URL auf der rechten Seite, gefolgt vom Protokoll (eSCL oder WSD). Falls das Protokoll nicht angegeben ist, wird eSCL angenommen. Sie konnen ein bestimmtes Gerat auch mit dem Schlusselwort disable an Stelle der URL deaktivieren. Zusatzlich konnen Sie ein Gerat manuell konfigurieren, indem Sie seine URL in einem Geratenamen ubergeben, ohne sie zur Konfigurationsdatei hinzuzufugen. Das Format ist hier Protokoll:Geratename:URL. Die obigen Beispiele konnen damit als escl:Kyocera eSCL:http://192.168.1.102:9095/eSCL und wsd:Kyocera WSD:http://192.168.1.102:5358/WSDScanner geschrieben werden. Um die URLs der verfugbaren Gerate herauszufinden, ist es am einfachsten, das Werkzeug airscan-discover(1) auf einem Computer auszufuhren, der mit dem Scanner auf dem gleichen LAN-Segment verbunden ist. Im Erfolgsfall wird das Programm auf seiner Standardausgabe eine Liste von erkannten Geraten in einem Format rausschreiben, das fur die Einbindung in die Konfigurationsdatei geeignet ist. Falls es nicht moglich ist, airscan-discover(1) in dem gleichen LAN-Segment wie der Scanner auszufuhren, mussen Sie die aufwandige Methode wahlen. Ihr Administrator muss die Gerate-IP-Adressen kennen, lesen Sie das Geratehandbuch fur den eSCL-Port und die URL-Pfadkomponente ist hochstwahrscheinlich >>/eSCL<< (allerdings kann sie auf einigen Geraten auch anders lauten). Die Ermittlung von WSD-URLs auf diese Weise ist viel aufwandiger, da es sehr schwer ist, den TCP-Port und den URL-Pfad zu raten (als im Falle von eSCL). Fur eSCL-Gerate kann die URL auch dem Schema unix:// folgen, wie bei unix://Scanner.Socket/eSCL. Der Rechneranteil aus der URL ist ein Dateiname, nach dem in dem durch socket_dir festgelegten Verzeichnis gesucht wird (siehe unten). Bei der Verbindung mit dem Scanner wird samtlicher Datenverkehr zu dem angegebenen UNIX-Socket statt zu einer TCP-Verbindung gesandt. KONFIGURATIONSOPTIONEN In den Abschnitt [options] gehen verschiedene Optionen. Derzeit werden die folgenden Optionen unterstutzt: [options] ; Falls es viele Scanner gibt und Sie nur an einigen davon interessiert ; sind, schalten Sie die automatische Erkennung aus und konfigurieren Sie ; die Scanner manuell. discovery = enable | disable ; Wahlen Sie aus, welche SANE-Apps in einer Gerateliste auftauchen: ; Scanner-Netzwerkname (die Vorgabe) oder den Hardware-Modellnamen. model = network | hardware ; Falls Gerate sowohl eSCL- als auch das WSD-Protokoll unterstutzen, kann ; Sane-airscan entweder das >>beste<< Protokoll automatisch auswahlen oder ; dem Benutzer alle Varianten offenlegen und ihm eine manuelle ; Protokollauswahl ermoglichen. ; Die Vorgabe ist >>auto<<. protocol = auto | manual ; Die Ermittlung von WSD-Geraten kann >>fast<< (schnell) oder >>full<< ; (vollstandig) erfolgen. Der Modus >>fast<< arbeitet so schnell wie die ; DNS-SD-Ermittlung, kann aber in einigen Fallen unzuverlassig sein. Der ; Modus >>full<< ist langsam und zuverlassig. Es ist auch moglich, die ; automatische Ermittlung von WSD-Geraten zu deaktivieren. ; Die Vorgabe ist >>fast<<. ws-discovery = fast | full | off ; Scanner, die das Schema unix:// in ihrer URL verwenden, konnen nur einen ; Socket-Namen (keinen vollstandigen Pfad) festlegen. In dem hier ; festgelegten Verzeichnis wird nach dem Namen gesucht. ; Die Vorgabe ist /var/run. socket_dir = /Pfad/zum/Verzeichnis GERATE-AUSSCHLUSSLISTE Diese Funktionalitat kann nutzlich sein, wenn Sie an einem sehr grossen Netzwerk hangen und es um Sie herum viele Gerate gibt, von denen Sie aber nur wenige interessieren. [blacklist] model = "Xerox*" ; Ausschluss uber Modellname name = "HP*" ; Ausschluss uber Netzwerkname ip = 192.168.0.1 ; Ausschluss uber Adresse ip = 192.168.0.0/24 ; Ausschluss des gesamten Subnetzes Netzwerknamen kommen von DNS-SD, WS-Discovery stellt diese Information nicht zur Verfugung. Damit das Filtern nach Netzwerknamen funktioniert, muss Avahi aktiviert sein und die Gerate mussen mittels DNS-SD erkennbar sein (nicht notwendigerweise als Scanner, es reicht, wenn WSD-Scanner als Drucker uber DNS-SD erkannt werden konnen). Ausschlusslisten betreffen nur die automatische Erkennung und betreffen nicht die manuell konfigurierten Gerate. DEBUGGING Sane-airscan stellt eine sehr gute Instrumentierung fur die Fehlersuche ohne physischen Zugriff auf das problematische Gerat bereit. Die Debugging-Einrichtungen konnen uber den Abschnitt [debug] der Konfigurationsdatei gesteuert werden. [debug] ; Protokollieren auf der Konsole aktivieren oder deaktivieren enable = false | true : Protokoll-Nachverfolgung aktivieren und Ausgabeverzeichnis fur ; Nachverfolgungsdateien konfigurieren. Um einen Pfad relativ zum Home- ; Verzeichnis festzulegen, starten Sie ihn wie in der Shell mit einer ; Tilde, gefolgt von einem Schragstrich, d.h. >>~/airscan/trace<<. Das ; Verzeichnis wird automatisch erstellt. trace = Pfad ; Samtlichen Verkehr zur Nachverfolgungsdatei hexadezimal rausschreiben ; (sehr ausfuhrlich!) hexdump = false | true DATEIEN /etc/sane.d/airscan.conf, /etc/sane.d/airscan.d/* Die Konfigurationsdatei des Backends. /usr/LIBDIR/sane/libsane-airscan.so Die dynamische Bibliothek, die dieses Backend implementiert. UMGEBUNGSVARIABLEN SANE_DEBUG_AIRSCAN Falls diese Variable auf true oder einen von Null verschiedenen numerischen Wert gesetzt wird, dann werden Debug-Meldungen aktiviert, die auf die Standardausgabe geschrieben werden. SANE_CONFIG_DIR Diese Variable andert den Suchpfad fur Konfigurationsdateien. Dies ist eine Doppelpunkt-getrennte Liste von Verzeichnissen. In diesen Verzeichnissen wird nach der Konfigurationsdatei airscan.conf und dem Unterverzeichnis airscan.d gesucht, bevor der Standardpfad (/etc/sane.d) durchsucht wird. FEHLER UND UNTERSTUTZUNG Falls Sie einen Fehler gefunden haben, reichen Sie auf der GitHub-Projektseite bitte eine Meldung (>>issue<<) auf Englisch ein: https://github.com/alexpevzner/sane-airscan. SIEHE AUCH sane(7), scanimage(1), xsane(1), airscan-discover(1) AUTOR Alexander Pevzner UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von 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 . Mai 2022 SANE-AIRSCAN(5)