SANE-AIRSCAN(5)    controlorul SANE AirScan (eSCL) <?>i WSD    SANE-AIRSCAN(5)

NUME
       sane-airscan - controlorul SANE pentru scanerele <?>i dispozitivele
       multifunc<?>ionale AirScan (eSCL) <?>i WSD

DESCRIERE
       sane-airscan este motorul de control universal pentru scanarea ,,fara
       controlor" a documentelor. In prezent, acesta accepta doua protocoale:


           1. eSCL, de asemenea cunoscut ca scanare AirScan sau AirPrint
           2. WSD, de asemenea cunoscut ca WS-Scan




CONFIGURARE
       sane-airscan i<?>i incarca fi<?>ierele de configurare din urmatoarele
       locuri:


           1. /etc/sane.d/airscan.conf
           2. /etc/sane.d/airscan.d/*




       Sintaxa fi<?>ierului de configurare este foarte asemanatoare cu cea a
       fi<?>ierului .INI. Acesta este format din sec<?>iuni, fiecare
       sec<?>iune con<?>inand anumite variabile. Comentariile incep de la
       caracterele # sau ; <?>i continua pana la sfar<?>itul liniei.


           # Acesta este un comentariu
           [section 1]
           variabila 1 = valoare 1  ; <?>i un alt comentariu
           variabila 2 = valoare 2




       Spa<?>iile de inceput <?>i de sfar<?>it ale numelui <?>i valorii
       variabilei sunt eliminate. Daca dori<?>i sa le pastra<?>i, pune<?>i
       numele sau valoarea intre ghilimele ("precum aici").

CONFIGURAREA DISPOZITIVELOR
       In cazul in care scanerul <?>i calculatorul sunt conectate la acela<?>i
       segment LAN, se a<?>teapta ca totul sa func<?>ioneze imediat, fara a fi
       nevoie de o configurare manuala.

       Cu toate acestea, in unele cazuri, configurarea manuala poate fi utila.
       De exemplu:


           1. Daca calculatorul <?>i scanerul sunt conectate prin intermediul unui router IP
           2. Exista o mul<?>ime de dispozitive intr-o re<?>ea corporativa, dar
              doar cateva dintre ele sunt de interes
           3. Descoperirea automata nu func<?>ioneaza in mod fiabil




       Pentru a configura manual un dispozitiv, adauga<?>i urmatoarea
       sec<?>iune la fi<?>ierul de configurare:


           [devices]
           "Kyocera eSCL" = http://192.168.1.102:9095/eSCL, eSCL
           "Kyocera WSD" = http://192.168.1.102:5358/WSDScanner, WSD
           "Dispozitiv pe care nu vreau sa-l vad" = disable




       Sec<?>iunea [devices] con<?>ine toate dispozitivele configurate manual,
       cate o linie pentru fiecare dispozitiv, iar fiecare linie con<?>ine un
       nume de dispozitiv in partea stanga a ecua<?>iei <?>i adresa URL a
       dispozitivului in partea dreapta, urmata de protocol (eSCL sau WSD).
       Daca protocolul este omis, se presupune ca eSCL. De asemenea, pute<?>i
       dezactiva un anumit dispozitiv folosind cuvantul cheie disable in loc
       de adresa URL.

       In plus, pute<?>i configura manual un dispozitiv trecand direct adresa
       URL a acestuia in numele dispozitivului, fara a-l adauga la fi<?>ierul
       de configurare. Aceasta are formatul protocol:Nume
       dispozitiv:adresaURL. Exemplele de mai sus ar putea fi scrise ca
       escl:Kyocera eSCL:http://192.168.1.102:9095/eSCL <?>i wsd:Kyocera
       WSD:http://192.168.1.102:5358/WSDScanner.

       Pentru a afla adresele URL ale dispozitivelor disponibile, cea mai
       simpla metoda este de a rula un instrument furnizat airscan-discover(1)
       pe un calculator conectat cu scanerul la acela<?>i segment LAN. In caz
       de succes, acest program va afi<?>a la ie<?>irea standard o lista a
       dispozitivelor descoperite intr-un format adecvat pentru a fi inclus in
       fi<?>ierul de configurare.

       Daca nu este posibila rularea airscan-discover(1) pe acela<?>i segment
       LAN ca <?>i scanerul, va trebui sa urma<?>i o cale dificila.
       Administratorul dvs. trebuie sa <?>tie adresa IP a dispozitivului, sa
       consulte manualul dispozitivului pentru portul eSCL, iar componenta
       rutei URL cel mai probabil este ,,/eSCL", de<?>i la unele dispozitive
       poate fi diferita. Descoperirea adreselor URL WSD procedand in acest
       mod este mult mai dificila, deoarece este foarte greu de ghicit portul
       TCP <?>i ruta URL, decat in cazul unui eSCL.

       Pentru dispozitivele eSCL, adresa URL poate utiliza, de asemenea,
       schema unix://, cum ar fi unix://scanner.sock/eSCL. ,,gazda" din adresa
       URL este un nume de fi<?>ier care va fi cautat in directorul specificat
       de socket_dir (a se vedea mai jos). La conectarea la scaner, tot
       traficul va fi trimis catre soclul UNIX specificat, in loc de o
       conexiune TCP.

       In mod implicit, sane-airscan trateaza toate scanerele ca dispozitive
       la distan<?>a. Acest lucru poate fi nedorit, daca se configureaza un
       proxy care converte<?>te de la eSCL/WSD la protocolul SANE, deoarece
       saned(8) ignora orice dispozitiv care nu este ata<?>at local. Prin
       configurarea pretend-local = true, sane-airscan i<?>i poate face
       dispozitivele accesibile pentru demonul de re<?>ea SANE.

OP<?>IUNI DE CONFIGURARE
       Diversele op<?>iuni se regasesc toate in sec<?>iunea [options]. In
       prezent, sunt acceptate urmatoarele op<?>iuni:


           [options]
           ; Daca exista o mul<?>ime de scanere in jur <?>i sunte<?>i interesat
           ; doar de cateva dintre ele, dezactiva<?>i descoperirea automata
           ; <?>i configura<?>i scanerele manual.
           discovery = enable | disable

           ; Alege<?>i ce vor afi<?>a aplica<?>iile SANE intr-o lista de dispozitive:
           ; numele re<?>elei scanerului (implicit) sau numele modelului scanerului.
           model = network | hardware

           ; Daca dispozitivul accepta atat protocolul eSCL, cat <?>i WSD, sane-airscan
           ; poate alege automat ,,cel mai bun" protocol, sau expune toate variantele
           ; pentru utilizator, permi<?>and selectarea manuala a protocolului.
           ; Valoarea implicita este ,,auto".
           protocol = auto | manual

           ; Descoperirea dispozitivelor WSD poate fi ,,fast" (rapida) sau ,,full" (completa).
           ; Modul ,,rapid" func<?>ioneaza la fel de rapid ca <?>i descoperirea DNS-SD, dar in
           ; unele cazuri poate sa nu fie fiabil. Modul ,,complet" este lent <?>i fiabil.
           ; De asemenea, este posibil sa se dezactiveze descoperirea automata
           ; a dispozitivelor WSD. Valoarea implicita este ,,fast".
           ws-discovery = fast | full | off

           ; Scanerele care utilizeaza schema unix:// in adresa lor URL pot
           ; specifica doar un nume de soclu (nu o ruta completa). Numele va fi
           ; cautat in directorul specificat aici.
           ; Valoarea implicita este ,,/var/run".
           socket_dir = /ruta/la/director

           ; Configureaza daca dispozitivele eSCL <?>i WSD trebuie sa fie
           ; tratate ca <?>i cum ar fi ata<?>ate local. Comportamentul implicit le
           ; considera ca dispozitive la distan<?>a care sunt accesate prin re<?>ea.
           ; Aceasta op<?>iune trebuie sa fie modificata atunci cand exporta<?>i
           ; un scaner prin ,,saned". Valoareaimplicita este ,,false".
           pretend-local = false | true




DISPOZITIVE PENTRU LISTA NEAGRA
       Aceasta func<?>ie poate fi utila in cazul in care va afla<?>i intr-o
       re<?>ea foarte mare <?>i ave<?>i o mul<?>ime de dispozitive in jurul
       dumneavoastra, dar va intereseaza doar cateva dintre ele.


           [blacklist]
           model = "Xerox*"       ; lista neagra dupa numele modelului
           name  = "HP*"          ; lista neagra dupa numele re<?>elei
           ip    = 192.168.0.1    ; lista neagra dupa adresa
           ip    = 192.168.0.0/24 ; lista neagra pentru intreaga subre<?>ea




       Numele de re<?>ea provin din DNS-SD, WS-Discovery nu furnizeaza aceste
       informa<?>ii. Pentru ca filtrarea in func<?>ie de numele re<?>elei sa
       func<?>ioneze, Avahi trebuie sa fie activat, iar dispozitivul trebuie
       sa poata fi descoperit prin DNS-SD (nu neaparat ca scaner, este
       suficient ca scanerul WSD sa poata fi descoperit ca imprimanta prin
       DNS-SD).

       Lista neagra afecteaza doar descoperirea automata <?>i nu afecteaza
       dispozitivele configurate manual.

DEPANAREA
       sane-airscan ofera o instrumenta<?>ie foarte buna pentru depanarea fara
       acces fizic la dispozitivul problematic.

       Facilita<?>ile de depanare pot fi controlate cu ajutorul sec<?>iunii
       [debug] din fi<?>ierul de configurare:


           [debug]
           ; Activeaza sau dezactiveaza jurnalizarea in consola
           enable = false | true

           ; Activeaza urmarirea protocolului <?>i configureaza directorul de ie<?>ire
           ; pentru fi<?>ierele de urmarire. La fel ca in shell, pentru a specifica ruta
           ; relativa la directorul personal, incepe<?>i-o cu caracterul tilda, urmat de
           ; o bara oblica, de exemplu: ,,~/airscan/trace". Directorul va fi creat
           ; automat.
           trace = path

           ; Arhiveaza in format hexazecimal tot traficul in fi<?>ierul de
           ; urmarire, foarte detaliat!
           hexdump = false | true




FI<?>IERE
       /etc/sane.d/airscan.conf, /etc/sane.d/airscan.d/*
              Fi<?>ierele de configurare ale controlorului

       /usr/LIBDIR/sane/libsane-airscan.so
              Biblioteca partajata care implementeaza acest controlor

MEDIU
       SANE_DEBUG_AIRSCAN
              Aceasta variabila, daca este fixata la true sau la o valoare
              numerica diferita de zero, activeaza mesajele de depanare, care
              sunt afi<?>ate la ie<?>irea de eroare standard.

       SANE_CONFIG_DIR
              Aceasta variabila modifica ruta de cautare a fi<?>ierelor de
              configurare. Aceasta este o lista de directoare separate prin
              doua puncte. Aceste directoare sunt cautate pentru fi<?>ierul de
              configurare ,,airscan.conf" <?>i pentru subdirectorul
              ,,airscan.d", inainte de a fi cautata ruta standard
              (,,/etc/sane.d").

       SANE_AIRSCAN_DEVICE
              Aceasta variabila, daca este definita, prevaleaza asupra tuturor
              dispozitivelor, configurate manual in fi<?>ierele de configurare
              <?>i dezactiveaza descoperirea automata.

              Aceasta consta din trei parametri, delimita<?>i prin doua puncte
              (:):

              "PROTO:DEVICE NAME:URL"

              Unde:

              - PROTO este fie escl, fie wsd.
              - DEVICE NAME va aparea in lista de dispozitive.
              - URL este adresa URL a dispozitivului, utilizand schemele http:
              sau https:.

              Exemple:

              "escl:Kyocera eSCL:http://192.168.1.102:9095/eSCL" (eSCL)
              "wsd:Kyocera WSD:http://192.168.1.102:5358/WSDScanner" (WSD)

              Scopul principal al acestei variabile este testarea automata a
              controlorului sane-airscan.

ERORI <?>I ASISTEN<?>A
       Daca a<?>i gasit o eroare, va rugam sa depune<?>i o problema in GitHub
       pe pagina proiectului din GitHub:
       https://github.com/alexpevzner/sane-airscan

CONSULTA<?>I <?>I
       sane(7), saned (8), scanimage(1), xsane(1), airscan-discover(1)

AUTOR
       Alexander Pevzner <pzz@apevzner.com>

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

                                  iulie 2025                   SANE-AIRSCAN(5)