| saned(8) | SANE Scanner Access Now Easy | saned(8) |
نام (NAME)
saned - دیمن شبکه SANE
خلاصه دستور (SYNOPSIS)
saned [ -a [ username ] ] [ -u username ] [ -b address ] [ -p port ] [ -l ] [ -D ] [ -o ] [ -d n ] [ -e ] [ -h ] [ -B buffer-size ]
توضیحات (DESCRIPTION)
برنامه saned دیمن SANE (دسترسی آسان به اسکنر) است که به کلاینتهای راه دور امکان میدهد به دستگاههای دریافت تصویر موجود در میزبان محلی دسترسی داشته باشند.
گزینهها (OPTIONS)
برنامه saned گزینههای زیر را تشخیص میدهد:
- -a [username], --alone[=username]
- معادل ترکیب گزینههای -l -D -u username است. با این حال، تعیین username اختیاری است و کاربر اجراکننده تنها در صورت مشخص شدن تنظیم خواهد شد.
- -u username, --user=username
- درخواست میکند که saned پس از اتصال به درگاه (binding)، امتیازات دسترسی ریشه (root) را رها کرده و با هویت کاربر (و گروه) مرتبط با username اجرا شود.
- -b address, --bind=address
- به saned دستور میدهد به address دادهشده متصل شود.
- -p port, --port=port
- به saned دستور میدهد روی port دادهشده به درخواستها گوش فرا دهد. مقدار 0 به saned میگوید که یک درگاه استفادهنشده را انتخاب کند. مقدار پیشفرض sane-port (6566) است.
- -l, --listen
- درخواست میکند که saned در حالت دیمن مستقل (standalone) اجرا شود. در این حالت، saned به اتصالات ورودی کلاینتها گوش فرا خواهد داد؛ برای عملیات saned در این حالت نیازی به inetd(8) نیست.
- -D, --daemonize
- از saned درخواست میکند که از کنسول جدا شده و در پسزمینه اجرا شود.
- -n, --allow-network
- به saned اجازه میدهد از اسکنرهای تحت شبکه استفاده کند. بهطور پیشفرض این قابلیت برای جلوگیری از تماس saned با خودش غیرفعال است. در صورت فعالسازی، در پیکربندی بکاند sane-net(5) نباید به نشانیای که saned روی آن گوش میدهد اشاره شود.
- -o, --once
- درخواست میکند که saned پس از قطع ارتباط نخستین کلاینت خارج شود. این گزینه برای اشکالزدایی مفید است.
- -d n, --debug=n
- سطح خروجی اشکالزدایی saned را روی n تنظیم میکند. هنگامی که برنامه با پشتیبانی از اشکالزدایی کامپایل شده باشد، میتوان پس از این گزینه یک عدد قرار داد تا اطلاعات اشکالزدایی بیشتر یا کمتری درخواست شود. هر چه این عدد بزرگتر باشد، خروجی اشکالزدایی با جزئیات بیشتری خواهد بود. به عنوان مثال، -d128 خروجی تمام اطلاعات اشکالزدایی را درخواست میکند. سطح 0 هیچ خروجیای تولید نمیکند. مقدار پیشفرض 2 است.
- -e, --stderr
- خروجی اشکالزدایی saned را به جای حالت پیشفرض syslog، به stderr هدایت میکند.
- -B, --buffer-size=buffer-size
- اندازه بافر خواندن استفادهشده برای برقراری ارتباط با بکاند را بر حسب کیلوبایت مشخص میکند. مقدار پیشفرض 1MB است.
- -h, --help
- یک پیام راهنمای کوتاه را نمایش میدهد.
پیکربندی (CONFIGURATION)
فایل پیکربندی saned.conf شامل گزینههای مربوط به دیمن و همچنین فهرست کنترل دسترسی است.
- data_portrange = min_port - max_port
- محدوده درگاهی را که برای اتصال داده استفاده میشود مشخص میکند. یک محدوده درگاه بین 1024 و 65535 انتخاب کنید؛ از انتخاب یک محدوده درگاه بسیار بزرگ خودداری نمایید، زیرا ممکن است باعث ایجاد مشکلات کارایی شود. اگر سرور saned شما پشت دیوار آتش (firewall) قرار دارد از این گزینه استفاده کنید. اگر آن دیوار آتش یک ماشین لینوکسی است، اکیداً توصیه میکنیم به جای آن از ماژول Netfilter nf_conntrack_sane استفاده کنید.
- data_connect_timeout = timeout
- مدت زمانی را بر حسب میلیثانیه مشخص میکند که saned برای برقراری اتصال داده منتظر خواهد ماند. بدون این گزینه، اگر اتصال داده پیش از رسیدن اسکنر به پایان مرحله اسکن برقرار نشود، ممکن است بسته به نوع بکاند، اسکنر فراتر از نقطه پایان به حرکت خود ادامه دهد و به دستگاه آسیب برسد. برای بازگشت به رفتار قدیمی مقدار صفر را تعیین کنید. مقدار پیشفرض 4000ms است.
فهرست دسترسی شامل فهرستی از نامهای میزبان، نشانیهای IP یا زیرشبکههای IP (با نمادگذاری CIDR) است که مجاز به استفاده از دستگاههای محلی SANE هستند. نشانیهای IPv6 باید داخل قلاب (کروشه) قرار گیرند و همواره باید به صورت فشرده مشخص شوند. اتصالات از localhost همیشه مجاز هستند. خطوط خالی و خطوطی که با علامت هش (#) آغاز میشوند نادیده گرفته میشوند. خطی که تنها حاوی نویسه «+» باشد به عنوان تطابق با هر نام میزبانی تفسیر میشود. این کار به هر ماشین راه دوری اجازه میدهد از اسکنر شما استفاده کند و ممکن است یک خطر امنیتی به همراه داشته باشد، بنابراین نباید از آن استفاده شود مگر اینکه دقیقاً بدانید چه کاری انجام میدهید.
یک نمونه فایل پیکربندی در زیر نشان داده شده است:
data_portrange = 10000 - 10100
# Access list
scan-client.somedomain.firm
# this is a comment
192.168.0.1
192.168.2.12/29
[::1]
[2001:db8:185e::42:12]/64
بزرگی و کوچکی حروف در نامهای میزبان اهمیتی ندارد، بنابراین AHost.COM با ahost.com یکسان در نظر گرفته میشود.
فایلها (FILES)
- /etc/hosts.equiv
- میزبانهای فهرستشده در این فایل مجاز به دسترسی به تمام دستگاههای محلی SANE هستند. هشدار: این فایل خطرات امنیتی جدی ایجاد میکند و استفاده از آن توصیه نمیشود.
- /etc/sane.d/saned.conf
- شامل فهرستی از میزبانهای مجاز برای دسترسی به دستگاههای محلی SANE است (همچنین توضیحات مربوط به SANE_CONFIG_DIR را در ادامه ببینید).
- /etc/sane.d/saned.users
- اگر این
فایل حاوی
خطوطی به
شکل زیر
باشد:
user:password:backend
دسترسی به بکاندهای فهرستشده محدود میشود. یک بکاند ممکن است چندین بار برای ترکیبهای مختلف کاربر/گذرواژه فهرست شود. در صورتی که کلاینت پشتیبانی کند، سرور از هش MD5 استفاده میکند.
محیط (ENVIRONMENT)
- SANE_CONFIG_DIR
- این متغیر محیطی فهرستی از دایرکتوریهایی را مشخص میکند که ممکن است حاوی فایل پیکربندی باشند. در سیستمهای شبهیونیکس (*NIX)، دایرکتوریها با دونقطه (':') و در OS/2 با نقطه-ویرگول (';') از هم جدا میشوند. اگر این متغیر مقداردهی نشده باشد، فایل پیکربندی در دو دایرکتوری پیشفرض جستجو میشود: ابتدا در دایرکتوری کاری جاری (".") و سپس در /etc/sane.d. اگر مقدار این متغیر محیطی به نویسه جداکننده دایرکتوری ختم شود، دایرکتوریهای پیشفرض پس از دایرکتوریهای صریحاً مشخصشده جستجو میشوند. برای مثال، تنظیم SANE_CONFIG_DIR روی "/tmp/config:" باعث میشود که دایرکتوریهای tmp/config، .، و /etc/sane.d (به همین ترتیب) جستجو شوند.
نکات (NOTES)
برنامه saned هنگام برقراری ارتباط با کلاینتها محرمانگی (confidentiality) را فراهم نمیکند. اگر saned مستقیماً در معرض شبکه قرار گیرد، سایر کاربران ممکن است بتوانند با تلاشی اندک، تصاویر اسکنشده را رهگیری کرده یا از گذرواژههای اتصال به saned مطلع شوند. در عوض، سیستمهای کلاینت باید از طریق یک تونل امن به سرور saned متصل شوند.
برنامه saned یک برنامه مورد اعتماد (trusted) نیست و نباید با امتیازات ریشه (root) اجرا شود.
برای جزئیات بیشتر در مورد پیکربندی saned به عنوان یک سرویس، به فایل /usr/share/doc/sane/saned/saned.install.md مراجعه کنید.
همچنین ببینید (SEE ALSO)
sane(7), scanimage(1), xscanimage(1),
xcam(1), sane-dll(5), sane-net(5),
sane-"backendname"(5), inetd(8), xinetd(8),
systemd(1)
http://www.penguin-breeder.org/?page=sane-net
نویسنده (AUTHOR)
David Mosberger
| 29 Sep 2017 |