SANE-AIRSCAN(5)

الاسم
sane-airscan - خلفية SANE لماسحات AirScan (eSCL) و WSD وأجهزة الطباعة متعددة الوظائف

الوصف
sane-airscan هي الخلفية الشاملة لمسح المستندات "بدون برنامج تشغيل". تدعم حالياً بروتوكولين:

    1. eSCL، وتُعرف أيضًا بـ AirScan أو مسح AirPrint الضوئي.
    2. WSD، وتُعرف أيضًا بـ WS-Scan.

الضبط
يقوم sane-airscan بتحميل ملفات تهيئته من الأماكن التالية:

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

بناء جملة ملف التهيئة مشابه جداً لبناء جملة ملف .INI. يتكون من أقسام، كل قسم يحتوي على بعض المتغيرات. تبدأ التعليقات من الحرف # أو ; وتستمر حتى نهاية السطر

    # This is a comment
    [section 1]
    variable 1 = value 1  ; and another comment
    variable 2 = value 2

تُزال المسافات البادئة واللاحقة لاسم المتغير وقيمته. إذا أردت الاحتفاظ بها، ضع الاسم أو القيمة بين علامتي اقتباس ("مثل هذا").

تهيئة الأجهزة
إذا كان الماسح والكمبيوتر متصلين بنفس قطعة الشبكة المحلية، فمن المتوقع أن يعمل كل شيء "فوراً" دون الحاجة إلى أي تهيئة يدوية.

ومع ذلك، في بعض الحالات قد تكون التهيئة اليدوية مفيدة. على سبيل المثال:

    1. إذا كان الحاسوب والماسحة الضوئية متصلين عبر موجّه (IP router).
    2. وجود عدد كبير من الأجهزة على الشبكة المؤسسية، ولكن
       عددًا قليلاً منها فقط هو المهم.
    3. الاكتشاف التلقائي (Automatic discovery) يعمل بشكل غير موثوق.

لتهيئة جهاز يدوياً، أضف القسم التالي إلى ملف التهيئة:

    [devices]
    "Kyocera eSCL" = http://192.168.1.102:9095/eSCL, eSCL
    "Kyocera WSD" = http://192.168.1.102:5358/WSDScanner, WSD
    "Device I do not want to see" = disable

يحتوي القسم [devices] على جميع الأجهزة المكونة يدوياً، سطر واحد لكل جهاز، ويحتوي كل سطر على اسم جهاز على الجانب الأيسر من المعادلة وعنوان URL للجهاز على الجانب الأيمن، متبوعاً بالبروتوكول (eSCL أو WSD). إذا تم حذف البروتوكول، يُفترض eSCL. يمكنك أيضًا تعطيل جهاز معين باستخدام الكلمة الأساسية disable بدلاً من عنوان URL.

بالإضافة إلى ذلك، يمكنك تهيئة جهاز يدوياً عن طريق تمرير عنوان URL الخاص به مباشرة في اسم الجهاز دون إضافته إلى ملف التهيئة. يأخذ هذا التنسيق protocol:اسم الجهاز:URL. يمكن كتابة الأمثلة أعلاه كـ escl:Kyocera eSCL:http://192.168.1.102:9095/eSCL و wsd:Kyocera WSD:http://192.168.1.102:5358/WSDScanner.

لمعرفة عناوين URL للأجهزة المتاحة، أسهل طريقة هي تشغيل الأداة المرفقة airscan-discover(1) على كمبيوتر متصل بالماسح بنفس قطعة الشبكة المحلية. عند النجاح، سيقوم هذا البرنامج بإخراج قائمة بالأجهزة المكتشفة إلى مخرجاته القياسية بتنسيق مناسب للإدراج في ملف التهيئة.

إذا لم يكن تشغيل airscan-discover(1) على نفس قطعة الشبكة المحلية للماسح ممكناً، فسيتعين عليك اتباع طريقة صعبة. يجب على المسؤول معرفة عنوان IP للجهاز، والرجوع إلى دليل الجهاز لمعرفة منفذ eSCL، ومن المرجح أن يكون مكون مسار URL هو "/eSCL"، على الرغم من أنه قد يختلف في بعض الأجهزة. اكتشاف عناوين URL لـ WSD بهذه الطريقة أصعب بكثير، لأنه من الصعب جداً تخمين منفذ TCP ومسار URL، كما هو الحال في eSCL.

بالنسبة لأجهزة eSCL، يمكن لعنوان URL أيضًا استخدام مخطط unix://، مثل unix://scanner.sock/eSCL. "المضيف" من عنوان URL هو اسم ملف سيتم البحث عنه في الدليل المحدد بواسطة socket_dir (انظر أدناه). عند الاتصال بالماسح، سيتم إرسال كل حركة المرور إلى مقبس UNIX المحدد بدلاً من اتصال TCP.

مبدئيًا، يعامل sane-airscan جميع الماسحات الضوئية كأجهزة بعيدة. قد يكون هذا غير مرغوب فيه عند تكوين وكيل يترجم من eSCL/WSD إلى بروتوكول SANE، حيث يتجاهل saned(8) أي جهاز غير موصل محليًا. بتعيين pretend-local = true، يمكن لـ sane-airscan جعل أجهزته قابلة للوصول لبرنامج خفي لشبكة SANE.

خيارات الضبط
جميع الخيارات المتنوعة تذهب إلى قسم [options]. حاليًا، الخيارات التالية مدعومة:

    [options]
    ; If there are a lot of scanners around and you are only
    ; interested in few of them, disable auto discovery and
    ; configure scanners manually.
    discovery = enable | disable
    ; اختر ما ستعرضه تطبيقات SANE في قائمة الأجهزة:
    ; اسم الماسحة الضوئية على الشبكة (الخيار المبدئي) أو اسم طراز الأجهزة.
    model = network | hardware
    ; إذا كانت الماسحة الضوئية تدعم كلاً من بروتوكولي eSCL و WSD، فقد يقوم
    ; برنامج sane-airscan إما باختيار "أفضل" بروتوكول تلقائيًا، أو
    ; عرض جميع الخيارات للمستخدم، مما يسمح باختيار البروتوكول يدويًا.
    ; القيمة المبدئية هي "auto" (تلقائي).
    protocol = auto | manual
    ; يمكن أن يكون اكتشاف أجهزة WSD "سريعًا"(fast) أو "كاملاً" (full).
    ; يعمل الوضع "السريع" بسرعة اكتشاف DNS-SD، ولكنه قد يكون غير موثوق
    ; في بعض الحالات. أما الوضع "الكامل" فهو بطيء ولكنه موثوق.
    ; من الممكن أيضًا تعطيل الاكتشاف التلقائي
    ; لأجهزة WSD. القيمة المبدئية هي "fast".
    ws-discovery = fast | full | off
    ; الماسحات الضوئية التي تستخدم المخطط unix:// في عنوان URL الخاص بها
    ; يمكنها فقط تحديد اسم مقبس (socket name) (وليس مسارًا كاملاً). سيتم
    ; البحث عن الاسم في الدليل المحدد هنا.
    ; المسار المبدئي هو /var/run.
    socket_dir = /path/to/directory
    ; قم بتهيئة ما إذا كان ينبغي التعامل مع أجهزة eSCL و WSD وكأنها
    ; متصلة محليًا. السلوك المبدئي يعتبرها أجهزة بعيدة يتم الوصول إليها
    ; عبر الشبكة. يجب تغيير هذا الخيار عند تصدير ماسحة ضوئية عبر
    ; saned. القيمة المبدئية هي "false".
    pretend-local = false | true

قائمة الأجهزة المحظورة
قد تكون هذه الميزة مفيدة إذا كنت على شبكة كبيرة جدًا ولديك العديد من الأجهزة حولك، بينما تهتم فقط بعدد قليل منها.

    [blacklist]
    model = "Xerox*"        ; حظر حسب اسم الطراز
    name  = "HP*"         ; حظر حسب اسم الشبكة
    ip    = 192.168.0.1    ; حظر حسب العنوان
    ip    = 192.168.0.0/24 ; حظر الشبكة الفرعية بالكامل

تأتي أسماء الشبكات من DNS-SD، ولا يوفر WS-Discovery هذه المعلومات. لكي يعمل التصفية حسب اسم الشبكة، يجب تمكين Avahi ويجب أن يكون الجهاز قابلًا للاكتشاف عبر DNS-SD (ليس بالضرورة كماسح ضوئي، يكفي إذا كان ماسح WSD قابلًا للاكتشاف كطابعة عبر DNS-SD).

يؤثر الحظر فقط على الاكتشاف الآلي، ولا يؤثر على الأجهزة المكونة يدويًا.

تنقيح
يوفر sane-airscan أدوات جيدة جدًا لاستكشاف الأخطاء وإصلاحها دون وصول مادي إلى الجهاز الذي يعاني من المشكلة.

يمكن التحكم في مرافق التصحيح باستخدام قسم [debug] من ملف التكوين:

    [debug]
    ; تمكين أو تعطيل سجلات وحدة التحكم (console logging)
    enable = false | true
    ; تمكين تتبع البروتوكول (protocol trace) وتحديد دليل الإخراج
    ; لملفات التتبع. كما هو الحال في الصدفة (shell)، لتحديد مسار
    ; نسبي لدليل المنزل، ابدأه بحرف التيلدا (tilda)، متبوعًا
    ; بشرطة مائلة، أي:"~/airscan/trace". سيُنشى الدليل
    ; تلقائيًا.
    trace = path
    ; إلقاء (dump) كامل لحركة مرور البيانات بصيغة ست عشرية (Hex) في ملف التتبع (مفصل للغاية!)
    hexdump = false | true

الملفات

/etc/sane.d/airscan.conf، /etc/sane.d/airscan.d/*
    ملفات تكوين الواجهة الخلفية

/usr/LIBDIR/sane/libsane-airscan.so
    المكتبة المشتركة التي تنفذ هذا الخلفية

البيئة

SANE_DEBUG_AIRSCAN
    هذا المتغير إذا تم تعيينه إلى true أو قيمة رقمية غير صفرية، يُفعّل رسائل التصحيح التي تُطبع إلى stderr

SANE_CONFIG_DIR
    هذا المتغير يُعدّل مسار البحث عن ملفات التهيئة. هذه قائمة من الأدلة مفصولة بنقطتين. تُبحث هذه الأدلة عن ملف التهيئة airscan.conf وعن الدليل الفرعي airscan.d، قبل البحث في المسار المبدئي (/etc/sane.d).

SANE_AIRSCAN_DEVICE
    هذا المتغير، إذا تم تعيينه، يُلغي جميع الأجهزة المُهيأة يدويًا في ملفات التهيئة ويُعطّل الاكتشاف الآلي.

    يتكون من ثلاث معاملات، مفصولة بنقطتين (:):

    "PROTO:DEVICE NAME:URL"

    حيث:

    - PROTO إما escl أو wsd.
    - DEVICE NAME سيظهر في قائمة الأجهزة.
    - URL هو رابط الجهاز، باستخدام مخططات http: أو https:.

    أمثلة:

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

    الغرض الرئيسي من هذا المتغير هو الاختبار الآلي لخلفية sane-airscan.

العلل والدعم
إذا وجدت خطأ، يُرجى تقديم مشكلة في GitHub على صفحة مشروع GitHub: https://github.com/alexpevzner/sane-airscan

انظر أيضًا
sane(7), saned (8), scanimage(1), xsane(1), airscan-discover(1)

المؤلف
ألكسندر بيفزنر <pzz@apevzner.com>

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.