.\" generated with Ronn-NG/v0.10.1 .\" http://github.com/apjanke/ronn-ng/tree/0.10.1 .TH "SANE\-AIRSCAN" "5" "April 2026" "" "AirScan (eSCL) and WSD SANE backend" .SH "نام (NAME)" \fBsane\-airscan\fR \- بک‌اند SANE برای اسکنرها و دستگاه‌های چندمنظوره (MFP) مبتنی بر AirScan (eSCL) و WSD .SH "شرح (DESCRIPTION)" بک‌اند \fBsane\-airscan\fR یک بک‌اند سراسری برای اسکن اسناد به‌صورت «بدون درایور» (driverless) است\. در حال حاضر این بک‌اند از دو پروتکل پشتیبانی می‌کند: .IP "" 4 .nf 1\. eSCL, also known as AirScan or AirPrint scan 2\. WSD, also known as WS\-Scan .fi .IP "" 0 .SH "پیکربندی (CONFIGURATION)" ابزار sane\-airscan فایل‌های پیکربندی خود را از مکان‌های زیر بارگذاری می‌کند: .IP "" 4 .nf 1\. /etc/sane\.d/airscan\.conf 2\. /etc/sane\.d/airscan\.d/* .fi .IP "" 0 .P نحو (syntax) فایل پیکربندی بسیار شبیه به فایل‌های \.INI است\. این فایل از بخش‌ها تشکیل شده و هر بخش شامل چند متغیر است\. کامنت‌ها با نویسه‌های # یا ; آغاز می‌شوند و تا انتهای خط ادامه دارند .IP "" 4 .nf # This is a comment [section 1] variable 1 = value 1 ; and another comment variable 2 = value 2 .fi .IP "" 0 .P فاصله‌های خالی ابتدا و انتهای نام متغیر و مقدار آن حذف می‌شوند\. اگر می‌خواهید آن‌ها را حفظ کنید، نام یا مقدار را داخل گیومه قرار دهید ("مانند این")\. .SH "پیکربندی دستگاه‌ها (CONFIGURATION OF DEVICES)" اگر اسکنر و رایانه به یک بخش یکسان از شبکه محلی (LAN segment) متصل باشند، انتظار می‌رود همه‌چیز بدون نیاز به هیچ پیکربندی دستی، به‌صورت خودکار کار کند\. .P با این حال، در برخی موارد پیکربندی دستی می‌تواند مفید باشد\. برای مثال: .IP "" 4 .nf 1\. If computer and scanner are connected via IP router 2\. There are a lot of devices on a corporate network, but only few of them are interesting 3\. Automatic discovery works unreliable .fi .IP "" 0 .P برای پیکربندی دستی یک دستگاه، بخش زیر را به فایل پیکربندی اضافه کنید: .IP "" 4 .nf [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 .fi .IP "" 0 .P بخش \fB[devices]\fR شامل تمام دستگاه‌های پیکربندی‌شده به‌صورت دستی است، یک خط برای هر دستگاه؛ هر خط شامل نام دستگاه در سمت چپ تساوی و آدرس URL دستگاه در سمت راست است، که پس از آن پروتکل (eSCL یا WSD) می‌آید\. اگر پروتکل ذکر نشود، eSCL فرض می‌شود\. همچنین می‌توانید با استفاده از کلمه کلیدی \fBdisable\fR به‌جای آدرس URL، دستگاه خاصی را غیرفعال کنید\. .P علاوه بر این، می‌توانید بدون افزودن دستگاه به فایل پیکربندی، با ارسال مستقیم آدرس URL آن در قالب نام دستگاه، آن را به‌صورت دستی پیکربندی کنید\. این روش قالب \fBprotocol:Device Name:URL\fR را می‌گیرد\. مثال‌های بالا را می‌توان به‌صورت \fBescl:Kyocera eSCL:http://192\.168\.1\.102:9095/eSCL\fR و \fBwsd:Kyocera WSD:http://192\.168\.1\.102:5358/WSDScanner\fR نوشت\. .P برای یافتن آدرس‌های URL دستگاه‌های موجود، ساده‌ترین راه اجرای ابزار \fBairscan\-discover(1)\fR روی رایانه‌ای است که به همان بخش شبکه محلی اسکنر متصل است\. در صورت موفقیت، این برنامه فهرستی از دستگاه‌های کشف‌شده را در قالبی مناسب برای درج در فایل پیکربندی در خروجی استاندارد خود چاپ می‌کند\. .P اگر اجرای \fBairscan\-discover(1)\fR در همان بخش شبکه محلی اسکنر ممکن نباشد، باید روش دشوارتر را پیش بگیرید\. مدیر شبکه شما باید نشانی IP دستگاه را بداند، راهنمای دستگاه را برای پورت eSCL بررسی کند، و مسیر URL به احتمال زیاد "/eSCL" است، گرچه ممکن است در برخی دستگاه‌ها متفاوت باشد\. کشف آدرس‌های URL مربوط به WSD با این روش بسیار سخت‌تر است، زیرا حدس زدن پورت TCP و مسیر URL در مقایسه با eSCL بسیار دشوار است\. .P برای دستگاه‌های eSCL، نشانی URL می‌تواند از طرحواره unix:// نیز استفاده کند، مانند unix://scanner\.sock/eSCL\. بخش «host» از آدرس URL، نام فایلی است که در دایرکتوری مشخص‌شده توسط socket_dir (به زیر نگاه کنید) جستجو خواهد شد\. هنگام اتصال به اسکنر، تمام ترافیک به‌جای اتصال TCP به سوکت یونیکس مشخص‌شده ارسال می‌شود\. .P به‌طور پیش‌فرض، sane\-airscan با تمام اسکنرها به عنوان دستگاه‌های راه دور (remote) رفتار می‌کند\. این رفتار هنگام پیکربندی یک پروکسی که پروتکل eSCL/WSD را به پروتکل SANE ترجمه می‌کند می‌تواند نامطلوب باشد، زیرا \fBsaned(8)\fR هر دستگاهی را که به‌صورت محلی متصل نشده باشد نادیده می‌گیرد\. با تنظیم \fBpretend\-local = true\fR، بک‌اند sane\-airscan می‌تواند دستگاه‌های خود را در دسترس دیمن شبکه SANE قرار دهد\. .SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)" گزینه‌های متفرقه همگی در بخش \fB[options]\fR قرار می‌گیرند\. در حال حاضر گزینه‌های زیر پشتیبانی می‌شوند: .IP "" 4 .nf [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 ; Choose what SANE apps will show in a list of devices: ; scanner network name (the default) or hardware model name\. model = network | hardware ; If device supports both eSCL and WSD protocol, sane\-airscan ; may either choose the "best" protocol automatically, or ; expose all variants for user, allowing manual protocol selection\. ; The default is "auto"\. protocol = auto | manual ; Discovery of WSD devices may be "fast" or "full"\. The "fast" ; mode works as fast as DNS\-SD discovery, but in some cases ; may be unreliable\. The "full" mode is slow and reliable\. ; It is also possible to disable automatic discovery ; of WSD devices\. The default is "fast"\. ws\-discovery = fast | full | off ; Scanners that use the unix:// schema in their URL can only ; specify a socket name (not a full path)\. The name will be ; searched for in the directory specified here\. ; The default is /var/run\. socket_dir = /path/to/directory ; Configure whether eSCL and WSD devices should be treated as ; if they were attached locally\. The default behavior considers ; them as remote devices that are accessed over the network\. ; This option has to be changed when exporting a scanner through ; saned\. The default is "false" pretend\-local = false | true .fi .IP "" 0 .SH "لیست سیاه دستگاه‌ها (BLACKLISTING DEVICES)" اگر در شبکه بسیار بزرگی هستید و دستگاه‌های زیادی در اطراف شما وجود دارند، در حالی که فقط به تعداد کمی از آن‌ها نیاز دارید، این قابلیت می‌تواند مفید باشد\. .IP "" 4 .nf [blacklist] model = "Xerox*" ; blacklist by model name name = "HP*" ; blacklist by network name ip = 192\.168\.0\.1 ; blacklist by address ip = 192\.168\.0\.0/24 ; blacklist the whole subnet .fi .IP "" 0 .P نام‌های شبکه از DNS\-SD به دست می‌آیند و WS\-Discovery این اطلاعات را ارائه نمی‌دهد\. برای اینکه فیلتر کردن بر اساس نام شبکه کار کند، Avahi باید فعال باشد و دستگاه از طریق DNS\-SD قابل کشف باشد (نه لزوماً به عنوان اسکنر، حتی اگر اسکنر WSD به عنوان چاپگر از طریق DNS\-SD قابل کشف باشد کافی است)\. .P لیست سیاه تنها بر کشف خودکار اثر می‌گذارد و تأثیری بر دستگاه‌های پیکربندی‌شده به‌صورت دستی ندارد\. .SH "اشکال‌زدایی (DEBUGGING)" بک‌اند sane\-airscan ابزارهای بسیار خوبی برای عیب‌یابی بدون دسترسی فیزیکی به دستگاه مشکل‌دار فراهم می‌کند\. .P امکانات اشکال‌زدایی را می‌توان با استفاده از بخش \fB[debug]\fR در فایل پیکربندی کنترل کرد: .IP "" 4 .nf [debug] ; Enable or disable console logging enable = false | true ; Enable protocol trace and configure output directory ; for trace files\. Like in shell, to specify path relative to ; the home directory, start it with tilda character, followed ; by slash, i\.e\., "~/airscan/trace"\. The directory will ; be created automatically\. trace = path ; Hex dump all traffic to the trace file (very verbose!) hexdump = false | true .fi .IP "" 0 .SH "فایل‌ها (FILES)" .TP \fB/etc/sane\.d/airscan\.conf\fR, \fB/etc/sane\.d/airscan\.d/*\fR فایل‌های پیکربندی بک‌اند .TP \fB/usr/LIBDIR/sane/libsane\-airscan\.so\fR کتابخانه اشتراکی پیاده‌سازی‌کننده این بک‌اند .SH "متغیرهای محیطی (ENVIRONMENT)" .TP \fBSANE_DEBUG_AIRSCAN\fR اگر این متغیر روی \fBtrue\fR یا یک مقدار عددی غیرصفر تنظیم شود، پیام‌های اشکال‌زدایی را فعال می‌کند که در stderr چاپ می‌شوند .TP \fBSANE_CONFIG_DIR\fR این متغیر مسیر جستجو برای فایل‌های پیکربندی را تغییر می‌دهد\. این مقدار فهرستی از دایرکتوری‌ها است که با دونقطه (:) از هم جدا شده‌اند\. این دایرکتوری‌ها برای فایل پیکربندی airscan\.conf و زیرپوشه airscan\.d، پیش از جستجوی مسیر استاندارد (/etc/sane\.d) بررسی می‌شوند\. .TP \fBSANE_AIRSCAN_DEVICE\fR این متغیر در صورت تنظیم، تمام دستگاه‌های پیکربندی‌شده به‌صورت دستی در فایل‌های پیکربندی را نادیده می‌گیرد و کشف خودکار را غیرفعال می‌کند\. .IP این متغیر از سه پارامتر تشکیل شده که با دونقطه (\fB:\fR) از یکدیگر جدا می‌شوند: .IP \fB"PROTO:DEVICE NAME:URL"\fR .IP به‌طوری که: .IP \- \fBPROTO\fR یا \fBescl\fR است یا \fBwsd\fR\. .br \- \fBDEVICE NAME\fR در فهرست دستگاه‌ها نمایش داده خواهد شد\. .br \- \fBURL\fR آدرس اینترنتی دستگاه است که از طرحواره‌های \fBhttp:\fR یا \fBhttps:\fR استفاده می‌کند\. .br .IP مثال‌ها: .IP \fB"escl:Kyocera eSCL:http://192\.168\.1\.102:9095/eSCL"\fR (eSCL) .br \fB"wsd:Kyocera WSD:http://192\.168\.1\.102:5358/WSDScanner"\fR (WSD) .br .IP هدف اصلی این متغیر، آزمون خودکار بک‌اند \fBsane\-airscan\fR است\. .SH "گزارش باگ‌ها و پشتیبانی (BUGS AND SUPPORT)" اگر اشکالی پیدا کردید، لطفاً یک Issue در صفحه پروژه در گیت‌هاب ثبت کنید: \fBhttps://github.com/alexpevzner/sane\-airscan\fR .SH "همچنین ببینید (SEE ALSO)" \fBsane(7), saned (8), scanimage(1), xsane(1), airscan\-discover(1)\fR .SH "نویسنده (AUTHOR)" Alexander Pevzner