sane-net(5) دسترسی آسان به اسکنر SANE sane-net(5)

sane-net - بک‌اند شبکه SANE برای دسترسی به اسکنرها

کتابخانه sane-net یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به دستگاه‌های تصویربرداری و اسکن را از طریق اتصال شبکه فراهم می‌آورد. این قابلیت، کنترل دستگاه‌های متصل به یک میزبان راه دور را امکان‌پذیر ساخته و همچنین روشی برای اعطای دسترسی کاربران به منابع حفاظت‌شده فراهم می‌کند.

این بک‌اند نام‌های دستگاه را به قالب زیر انتظار دارد:

host:device

که در آن host نام (یا آدرس IP) میزبان (راه دور) و device نام دستگاهی روی آن میزبان است که باید مورد خطاب قرار گیرد. اگر نام دستگاه حاوی دو‌نقطه (:) نباشد، کل رشته به عنوان رشته device برای میزبان پیش‌فرض در نظر گرفته می‌شود. میزبان پیش‌فرض همان میزبانی است که در آخرین سطر فایل پیکربندی آمده است (به زیر مراجعه کنید).

آدرس IPv6 می‌تواند داخل براکت مشخص شود:

[::1]:device

فایل net.conf شامل گزینه‌های بک‌اند و همچنین فهرستی از نام‌های میزبان (یا آدرس‌های IP) است که باید برای درخواست‌های اسکن با آن‌ها تماس گرفته شود. هر عبارتی که جزو گزینه‌های فهرست‌شده زیر نباشد، به عنوان نام میزبان در نظر گرفته خواهد شد.

مهلت زمانی (به ثانیه) برای اتصال اولیه به سرور saned(8). این گزینه مانع از قفل شدن یا مسدود ماندن بک‌اند به مدت چند دقیقه در تلاش برای اتصال به میزبان غیرپاسخگوی saned(8) (به علت قطعی شبکه، خاموش بودن میزبان و...) می‌شود. از متغیر محیطی SANE_NET_TIMEOUT نیز می‌توان برای مشخص کردن مهلت زمانی در زمان اجرا استفاده کرد.

خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته خواهند شد. توجه داشته باشید که آدرس‌های IPv6 در این فایل نیازی به قرار گرفتن داخل براکت ندارند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:

scan-server.somedomain.firm
192.168.0.1
# این یک یادداشت توضیحی است
localhost
::1

فهرست میزبان‌های بالا را می‌توان در زمان اجرا با استفاده از متغیر محیطی SANE_NET_HOSTS گسترش داد. این متغیر محیطی فهرستی جداشده با دونقطه از نام‌های میزبان یا آدرس‌های IP است که باید علاوه بر میزبان‌های ذکرشده در فایل پیکربندی با آن‌ها تماس گرفته شود. به عنوان مثال، یک کاربر می‌تواند متغیر محیطی را روی رشته زیر تنظیم کند:

new.scanner.com:[::1]:192.168.0.2:scanner.univ.edu

تا درخواست تماس علاوه بر میزبان‌های ذکرشده در بالا، با میزبان‌های new.scanner.com ، [::1] ، 192.168.0.2 و scanner.univ.edu نیز ارسال گردد.

برای عملکرد صحیح این بک‌اند، لازم است سرویس sane-port نیز در فایل /etc/services با استفاده از خطی به شکل زیر تعریف شده باشد:

sane-port 6566/tcp # دیمن اسکنر تحت شبکه SANE

/etc/sane.d/net.conf
فایل پیکربندی بک‌اند (توضیحات مربوط به SANE_CONFIG_DIR در زیر را نیز مشاهده کنید).
/usr/lib/sane/libsane-net.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-net.so
کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

این متغیر محیطی فهرست دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های یونیکسی، دایرکتوری‌ها با دونقطه (':') و در سیستم OS/2 با نقطه-ویرگول (';') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری (".") و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم SANE_CONFIG_DIR به "/tmp/config:" منجر به جستجوی دایرکتوری‌های tmp/config ، . و /etc/sane.d (به همین ترتیب) خواهد شد.
فهرستی جداشده با دونقطه از نام‌های میزبان یا آدرس‌های IP که این بک‌اند باید با آن‌ها ارتباط برقرار کند.
تعداد ثانیه‌های انتظار برای دریافت پاسخ از سرور saned(8) جهت درخواست اتصال اولیه.
چنانچه کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸ سبب چاپ تمامی خروجی‌های دیباگ می‌شود. مقادیر کوچک‌تر جزئیات خروجی را کاهش می‌دهند.

اگر مهلت زمانی ارتباط با saned(8) به پایان برسد، بک‌اند شبکه ممکن است در یک حلقه تکرار درخواست‌های احراز هویت بیفتد.

sane(7), saned(8), sane-dll(5), scanimage(1)

http://www.penguin-breeder.org/?page=sane-net

David Mosberger و Andreas Beck

14 Jul 2008