.TH sane\-dll 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-dll
.SH "نام (NAME)"
sane\-dll \- بارگذار پویای بک‌اند SANE
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-dll
یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به هر تعداد دلخواه از دیگر بک‌اندهای SANE را فراهم می‌سازد. این بک‌اندها می‌توانند در زمان ساخت کتابخانه
.B sane\-dll
پیش‌بارگذاری شوند یا در سیستم‌هایی که از بارگذاری پویای کتابخانه‌های اشتراکی پشتیبانی می‌کنند، در زمان اجرا بارگذاری گردند. در حالت دوم، افزودن پشتیبانی از یک بک‌اند جدید صرفاً شامل نصب کتابخانه مربوطه در مسیر
.I /usr/lib/sane
و افزودن یک مدخل به فایل پیکربندی
.I dll.conf
است. به عبارت دیگر، برای افزودن پشتیبانی از دستگاه‌های جدید نیازی به تغییر یا کامپایل مجدد هیچ برنامه‌ای نیست.
.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند انتظار نام‌هایی با قالب زیر برای دستگاه‌ها دارد:
.PP
.RS
.IR backend : device
.RE
.PP
که در آن
.I backend
نام بک‌اند و
.I device
نام دستگاهی در این بک‌اند است که باید مخاطب قرار گیرد. اگر نام دستگاه فاقد دو‌نقطه (:) باشد، کل رشته به عنوان رشته
.I device
برای بک‌اند پیش‌فرض در نظر گرفته می‌شود. بک‌اند پیش‌فرض، آخرین بک‌اند فهرست‌شده در فایل پیکربندی (توضیحات پایین را ببینید) یا اولین بک‌اند پیش‌بارگذاری‌شده (در صورت وجود) است.
.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I dll.conf
فهرستی از نام‌های بک‌اند است که می‌توانند بر حسب تقاضا به صورت پویا بارگذاری شوند. خطوط خالی و همچنین تمام موارد بعد از علامت هش (#) نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:
.PP
.RS
net
.br
# this is a comment
.br
pnm
.br
mustek
.RE
.PP
همچنین می‌توان فایلی در مسیر
.I /etc/sane.d/dll.d
افزود که شامل فهرست بک‌اندهای اضافه‌شونده باشد. بک‌اندهای ذکر شده در فایلی که در این پوشه قرار گیرد، قبل از هر بک‌اند فهرست شده در
.I dll.conf
اضافه خواهند شد. فایل‌های موجود در
.I /etc/sane.d/dll.d
می‌توانند نام دلخواه داشته باشند. آن‌ها باید از همان قراردادهای قالب مربوط به
.I dll.conf
پیروی کنند.

.PP
توجه داشته باشید که بک‌اندهای پیش‌بارگذاری‌شده هنگام ساخت این کتابخانه نیازی به فهرست شدن در این فایل پیکربندی ندارند. یعنی اگر بک‌اندی پیش‌بارگذاری شده باشد، صرف‌نظر از این که در فایل پیکربندی آمده باشد یا خیر، همواره حاضر خواهد بود.
.PP
فهرست بک‌اندهای پیش‌بارگذاری‌شده توسط ماکروی
.B PRELOADABLE_BACKENDS
در فایل backend/Makefile.in در توزیع کد منبع SANE تعیین می‌شود. پس از تغییر مقدار این ماکرو، برای اعمال تغییرات لازم است SANE را مجدداً پیکربندی، کامپایل و نصب کنید.

نام‌های مستعار (Alias) در فایل پیکربندی
.IR dll.aliases
تعریف می‌شوند. این فایل می‌تواند شامل مدخل‌هایی به شکل زیر باشد:
.PP
.RS
.br
alias SomeName SaneDeviceName
.br
alias "Some Name" SaneDeviceName
.br
hide SaneDeviceName
.RE
.PP
برای نمونه:

.PP
.RS
.br
alias Epson net:somehost:epson:/dev/sgX
.br
alias "Siemens ST400" st400:/dev/sgY
.br
hide net:somehost:pnm:0
.br
hide net:somehost:pnm:1
.br
alias "Read from file" pnm:0
.br
hide pnm:1
.RE
.PP

نام‌های دستگاه دارای نام مستعار، به طور خودکار پنهان می‌شوند.

هدف این است که کاربران مجبور به سر و کار داشتن با نام‌های پیچیده دستگاه‌ها (به‌ویژه برای دستگاه‌های تحت شبکه) نباشند و دستگاه‌های دیگر صادرشده که ممکن است باعث سردرگمی آن‌ها شود، پنهان گردند. توجه داشته باشید که یک دستگاه پنهان‌شده در صورت دانستن نام آن همچنان قابل دسترسی است و تنها در فهرست ظاهر نمی‌شود.

.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/dll.aliases
فهرست بک‌اندهای دارای نام مستعار یا پنهان‌شده.
.TP
.I /etc/sane.d/dll.conf
فایل پیکربندی بک‌اند (توضیحات
.B SANE_CONFIG_DIR
در زیر را نیز ببینید).
.TP
.I /usr/lib/sane/libsane\-dll.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-dll.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).
.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است شامل فایل پیکربندی باشند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها با دو‌نقطه (:) و در OS/2 با نقطه-ویرگول (;) جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو مسیر پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری («.») و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های به صراحت مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم
.B SANE_CONFIG_DIR
روی «/tmp/config:» سبب می‌شود دایرکتوری‌های
.IR tmp/config ،
.IR .
و
.I "/etc/sane.d"
به همین ترتیب جستجو شوند.
.TP
.B SANE_DEBUG_DLL
اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال مقدار ۱۲۸ درخواست چاپ تمام خروجی‌های اشکال‌زدایی را می‌دهد. مقادیر کوچک‌تر میزان جزئیات را کاهش می‌دهند.

.ft CR
.nf
Value  Description
0      تنها خطاهای بحرانی چاپ می‌شوند
1      خطاهای عادی و پیام‌های مهم چاپ می‌شوند
2      پیام‌های عادی چاپ می‌شوند
3      پیام‌های اشکال‌زدایی چاپ می‌شوند
4      همه پیام‌ها چاپ می‌شوند
.fi
.ft R

مثال:
.PP
export SANE_DEBUG_DLL=3

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR scanimage (1),
.BR sane\-"backendname" (5)

.SH "نویسنده (AUTHOR)"
David Mosberger