نام (NAME)

sane-dll - بارگذار پویای بک‌اند SANE

توضیحات (DESCRIPTION)

کتابخانه sane-dll یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به هر تعداد دلخواه از دیگر بک‌اندهای SANE را فراهم می‌سازد. این بک‌اندها می‌توانند در زمان ساخت کتابخانه sane-dll پیش‌بارگذاری شوند یا در سیستم‌هایی که از بارگذاری پویای کتابخانه‌های اشتراکی پشتیبانی می‌کنند، در زمان اجرا بارگذاری گردند. در حالت دوم، افزودن پشتیبانی از یک بک‌اند جدید صرفاً شامل نصب کتابخانه مربوطه در مسیر /usr/lib/sane و افزودن یک مدخل به فایل پیکربندی dll.conf است. به عبارت دیگر، برای افزودن پشتیبانی از دستگاه‌های جدید نیازی به تغییر یا کامپایل مجدد هیچ برنامه‌ای نیست.

نام‌های دستگاه (DEVICE NAMES)

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

backend:device

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

پیکربندی (CONFIGURATION)

محتوای فایل dll.conf فهرستی از نام‌های بک‌اند است که می‌توانند بر حسب تقاضا به صورت پویا بارگذاری شوند. خطوط خالی و همچنین تمام موارد بعد از علامت هش (#) نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:

net
# this is a comment
pnm
mustek

همچنین می‌توان فایلی در مسیر /etc/sane.d/dll.d افزود که شامل فهرست بک‌اندهای اضافه‌شونده باشد. بک‌اندهای ذکر شده در فایلی که در این پوشه قرار گیرد، قبل از هر بک‌اند فهرست شده در dll.conf اضافه خواهند شد. فایل‌های موجود در /etc/sane.d/dll.d می‌توانند نام دلخواه داشته باشند. آن‌ها باید از همان قراردادهای قالب مربوط به dll.conf پیروی کنند.

توجه داشته باشید که بک‌اندهای پیش‌بارگذاری‌شده هنگام ساخت این کتابخانه نیازی به فهرست شدن در این فایل پیکربندی ندارند. یعنی اگر بک‌اندی پیش‌بارگذاری شده باشد، صرف‌نظر از این که در فایل پیکربندی آمده باشد یا خیر، همواره حاضر خواهد بود.

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

نام‌های مستعار (Alias) در فایل پیکربندی dll.aliases تعریف می‌شوند. این فایل می‌تواند شامل مدخل‌هایی به شکل زیر باشد:

alias SomeName SaneDeviceName
alias "Some Name" SaneDeviceName
hide SaneDeviceName

برای نمونه:

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

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

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

فایل‌ها (FILES)

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

محیط (ENVIRONMENT)

SANE_CONFIG_DIR

این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است شامل فایل پیکربندی باشند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها با دو‌نقطه (:) و در OS/2 با نقطه-ویرگول (;) جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو مسیر پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری («.») و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های به صراحت مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم SANE_CONFIG_DIR روی «/tmp/config:» سبب می‌شود دایرکتوری‌های tmp/config، . و /etc/sane.d به همین ترتیب جستجو شوند.

SANE_DEBUG_DLL

اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال مقدار ۱۲۸ درخواست چاپ تمام خروجی‌های اشکال‌زدایی را می‌دهد. مقادیر کوچک‌تر میزان جزئیات را کاهش می‌دهند.

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

مثال:

export SANE_DEBUG_DLL=3

همچنین ببینید (SEE ALSO)

sane(7), scanimage(1), sane-"backendname"(5)

نویسنده (AUTHOR)

David Mosberger