.TH sane\-net 5 "14 Jul 2008" "" "دسترسی آسان به اسکنر SANE"
.IX sane\-net
.SH "نام (NAME)"
sane\-net \- بک‌اند شبکه SANE برای دسترسی به اسکنرها
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-net
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به دستگاه‌های تصویربرداری و اسکن را از طریق اتصال شبکه فراهم می‌آورد. این قابلیت، کنترل دستگاه‌های متصل به یک میزبان راه دور را امکان‌پذیر ساخته و همچنین روشی برای اعطای دسترسی کاربران به منابع حفاظت‌شده فراهم می‌کند.

.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند نام‌های دستگاه را به قالب زیر انتظار دارد:
.PP
.RS
.IR host : device
.RE
.PP
که در آن
.I host
نام (یا آدرس IP) میزبان (راه دور) و
.I device
نام دستگاهی روی آن میزبان است که باید مورد خطاب قرار گیرد.
اگر نام دستگاه حاوی دو‌نقطه (:) نباشد، کل رشته به عنوان رشته
.I device
برای میزبان پیش‌فرض در نظر گرفته می‌شود. میزبان پیش‌فرض همان میزبانی است که در آخرین سطر فایل پیکربندی آمده است (به زیر مراجعه کنید).
.PP
آدرس IPv6 می‌تواند داخل براکت مشخص شود:
.PP
.RS
.IR [::1] : device
.RE
.SH "پیکربندی (CONFIGURATION)"
فایل
.IR net.conf
شامل گزینه‌های بک‌اند و همچنین فهرستی از نام‌های میزبان (یا آدرس‌های IP) است که باید برای درخواست‌های اسکن با آن‌ها تماس گرفته شود. هر عبارتی که جزو گزینه‌های فهرست‌شده زیر نباشد، به عنوان نام میزبان در نظر گرفته خواهد شد.
.PP
.TP
.B connect_timeout = nsecs
مهلت زمانی (به ثانیه) برای اتصال اولیه به سرور
.BR saned (8).
این گزینه مانع از قفل شدن یا مسدود ماندن بک‌اند به مدت چند دقیقه در تلاش برای اتصال به میزبان غیرپاسخگوی
.BR saned (8)
(به علت قطعی شبکه، خاموش بودن میزبان و...) می‌شود. از متغیر محیطی
.B SANE_NET_TIMEOUT
نیز می‌توان برای مشخص کردن مهلت زمانی در زمان اجرا استفاده کرد.
.PP
خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته خواهند شد. توجه داشته باشید که آدرس‌های IPv6 در این فایل نیازی به قرار گرفتن داخل براکت ندارند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:
.PP
.RS
scan\-server.somedomain.firm
.br
192.168.0.1
.br
# این یک یادداشت توضیحی است
.br
localhost
.br
::1
.RE
.PP
فهرست میزبان‌های بالا را می‌توان در زمان اجرا با استفاده از متغیر محیطی
.BR SANE_NET_HOSTS
گسترش داد. این متغیر محیطی فهرستی جداشده با دونقطه از نام‌های میزبان یا آدرس‌های IP است که باید علاوه بر میزبان‌های ذکرشده در فایل پیکربندی با آن‌ها تماس گرفته شود. به عنوان مثال، یک کاربر می‌تواند متغیر محیطی را روی رشته زیر تنظیم کند:
.PP
.RS
new.scanner.com:[::1]:192.168.0.2:scanner.univ.edu
.RE
.PP
تا درخواست تماس علاوه بر میزبان‌های ذکرشده در بالا، با میزبان‌های
.I new.scanner.com
،
.I [::1]
،
.I 192.168.0.2
و
.I scanner.univ.edu
نیز ارسال گردد.
.PP
برای عملکرد صحیح این بک‌اند، لازم است سرویس
.B sane\-port
نیز در فایل
.I /etc/services
با استفاده از خطی به شکل زیر تعریف شده باشد:
.PP
.RS
sane\-port 6566/tcp # دیمن اسکنر تحت شبکه SANE
.RE
.PP
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/net.conf
فایل پیکربندی بک‌اند (توضیحات مربوط به
.B SANE_CONFIG_DIR
در زیر را نیز مشاهده کنید).
.TP
.I /usr/lib/sane/libsane\-net.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-net.so
کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).
.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرست دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های یونیکسی، دایرکتوری‌ها با دونقطه (':') و در سیستم OS/2 با نقطه\-ویرگول (';') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری (".") و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم
.B SANE_CONFIG_DIR
به "/tmp/config:" منجر به جستجوی دایرکتوری‌های
.IR "tmp/config"
،
.IR "."
و
.I "/etc/sane.d"
(به همین ترتیب) خواهد شد.
.TP
.B SANE_NET_HOSTS
فهرستی جداشده با دونقطه از نام‌های میزبان یا آدرس‌های IP که این بک‌اند باید با آن‌ها ارتباط برقرار کند.
.TP
.B SANE_NET_TIMEOUT
تعداد ثانیه‌های انتظار برای دریافت پاسخ از سرور
.BR saned (8)
جهت درخواست اتصال اولیه.
.TP
.B SANE_DEBUG_NET
چنانچه کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸ سبب چاپ تمامی خروجی‌های دیباگ می‌شود. مقادیر کوچک‌تر جزئیات خروجی را کاهش می‌دهند.
.SH "اشکالات (BUGS)"
اگر مهلت زمانی ارتباط با
.BR saned (8)
به پایان برسد، بک‌اند شبکه ممکن است در یک حلقه تکرار درخواست‌های احراز هویت بیفتد.

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR saned (8),
.BR sane\-dll (5),
.BR scanimage (1)
.PP
.I http://www.penguin-breeder.org/?page=sane\-net
.SH "نویسنده (AUTHOR)"
David Mosberger و Andreas Beck