'\" t
.\"     Title: nut-scanner
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "NUT\-SCANNER" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nut-scanner \- ابزاری برای پویش گذرگاه‌های ارتباطی جهت یافتن دستگاه‌های NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnut\-scanner\fR \-h
.sp
\fBnut\-scanner\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBnut\-scanner\fR گذرگاه‌های ارتباطی موجود را پویش می‌کند و هر دستگاه سازگار با NUT را که پیدا کند نمایش می‌دهد\&.
.sp
همچنین \fBnut\-scanner\fR می‌تواند دستگاه‌های شناسایی‌شده را در قالب‌های گوناگون از جمله ups\&.conf نمایش دهد و تضمین می‌کند که نام‌های ایجادشده برای دستگاه‌ها در میان گذرگاه‌های مختلف یکتا باشند\&.
.SH "نصب (INSTALLATION)"
.sp
ابزار \fBnut\-scanner\fR تنها زمانی ساخته می‌شود که libltdl (بخشی از مجموعه توسعه libtool) در دسترس باشد\&.
.sp
گزینه‌های پویش در دسترس (USB، SNMP، IPMI، UPower و \&...) بر اساس وابستگی‌های موجود در زمان کامپایل و زمان اجرا متغیر خواهند بود\&. برای نمونه، اگر Net\-SNMP نصب باشد و در نتیجه کتابخانه‌های libsnmp (فایل‌های *\&.so یا *\&.dll) و فایل‌های هدر را در حین کامپایل و دست‌کم فایل‌های کتابخانه را روی سیستم نظارتی فراهم کند، امکان کشف از طریق SNMP فعال خواهد بود\&. به همین ترتیب، کشف UPower نیازمند کتابخانه‌های GDBus/libgio است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h\fR
.RS 4
نمایش متن راهنما\&.
.RE
.SH "گزینه‌های نمایش (DISPLAY OPTIONS)"
.PP
\fB\-Q\fR | \fB\-\-disp_nut_conf_with_sanity_check\fR
.RS 4
نمایش نتیجه در قالب
ups\&.conf
همراه با هشدارهای بررسی صحت به صورت یادداشت (پیش‌فرض)\&.
.RE
.PP
\fB\-N\fR | \fB\-\-disp_nut_conf\fR
.RS 4
نمایش نتیجه در قالب
ups\&.conf\&.
.RE
.PP
\fB\-P\fR | \fB\-\-disp_parsable\fR
.RS 4
نمایش نتیجه در قالبی قابل پردازش و تجزیه\&.
.RE
.SH "گزینه‌های گذرگاه (BUS OPTIONS)"
.PP
\fB\-C\fR | \fB\-\-complete_scan\fR
.RS 4
پویش تمام گذرگاه‌های ارتباطی در دسترس (رفتار پیش‌فرض)\&.
.RE
.PP
\fB\-U\fR | \fB\-\-usb_scan\fR
.RS 4
فهرست کردن تمام دستگاه‌های USB سازگار با NUT که در حال حاضر متصل هستند\&.
.sp
این گزینه را می‌توان چندین بار مشخص کرد تا جزئیات خاص پیوند سخت‌افزاری بیشتری ارائه شود؛ این موضوع می‌تواند در صورت تغییر شمارش دستگاه‌های USB در طول زمان نتیجه معکوس داشته باشد:
.TS
allbox tab(:);
ltB ltB.
T{
تعداد گزینه
T}:T{
مفهوم کاربردی
T}
.T&
lt lt
lt lt
lt lt
lt lt.
T{
\-U
T}:T{
.if n \{\
.RS 4
.\}
.nf
عدم گزارش جزئیات `bus`/`device`/`busport`
.fi
.if n \{\
.RE
.\}
T}
T{
\-UU
T}:T{
.if n \{\
.RS 4
.\}
.nf
گزارش `bus` و `busport` در صورت وجود
.fi
.if n \{\
.RE
.\}
T}
T{
\-UUU
T}:T{
.if n \{\
.RS 4
.\}
.nf
گزارش جزئیات `bus`/`device`/`busport`
.fi
.if n \{\
.RE
.\}
T}
T{
\-UUUU
T}:T{
.if n \{\
.RS 4
.\}
.nf
گزارش جزئیات `bus`/`device`/`busport`
و `bcdDevice` (کاربرد و مزیت محدود)
.fi
.if n \{\
.RE
.\}
T}
.TE
.sp 1
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
برای اطمینان‌پذیری، ترجیح داده می‌شود که تطبیق صرفاً بر اساس شناسه‌های سازنده و محصول و در صورت موجود و یکتا بودن، شماره سریال انجام گیرد\&.
.sp .5v
.RE
.RE
.PP
\fB\-S\fR | \fB\-\-snmp_scan\fR
.RS 4
پویش دستگاه‌های SNMP\&. دست‌کم به یک
\fIstart IP\fR
و در صورت تمایل، یک
\fIend IP\fR
نیاز دارد\&. برای تنظیمات جامعه و امنیت، بخش گزینه‌های خاص SNMP را ببینید\&.
.RE
.PP
\fB\-M\fR | \fB\-\-xml_scan\fR
.RS 4
پویش دستگاه‌های XML/HTTP\&. می‌تواند پیامی را روی رابط(های) شبکه جاری همه‌پخشی (broadcast) کند تا دستگاه‌های دارای قابلیت XML/HTTP دریافت شوند\&. در این حالت به نشانی IP نیازی نیست\&. اگر محدوده‌های نشانی IP مشخص شوند، به جای همه‌پخشی، آن‌ها پویش خواهند شد\&.
.RE
.PP
\fB\-O\fR | \fB\-\-oldnut_scan\fR
.RS 4
پویش دستگاه‌های NUT (یعنی دیمن
upsd)
روی IPهای بازه
\fIstart IP\fR
تا
\fIend IP\fR\&.
.RE
.PP
\fB\-n\fR | \fB\-\-nut_simulation_scan\fR
.RS 4
پویش دستگاه‌های شبیه‌سازی‌شده NUT (فایل‌های dev\&. در مسیر پیش‌فرض "sysconfig")\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBهشدار\fR
.ps -1
.br
نادیده‌گیری از طریق متغیر محیطی
NUT_CONFPATH
در حال حاضر پشتیبانی نمی‌شود\&.
.sp .5v
.RE
.RE
.PP
\fB\-A\fR | \fB\-\-avahi_scan\fR
.RS 4
پویش سرورهای NUT با استفاده از درخواست Avahi روی رابط(های) شبکه جاری\&. هیچ گزینه نشانی IP نیاز نبوده و استفاده نمی‌شود\&.
.RE
.PP
\fB\-I\fR | \fB\-\-ipmi_scan\fR
.RS 4
پویش منابع تغذیه سازگار با NUT موجود از طریق IPMI روی میزبان جاری، یا از طریق شبکه در صورتی که محدوده‌های نشانی IP مشخص شده باشند\&.
.RE
.PP
\fB\-J\fR | \fB\-\-upower_scan\fR
.RS 4
پویش دستگاه‌های UPower\&. نیازمند در دسترس بودن کتابخانه‌های GDBus/libgio است\&.
.RE
.PP
\fB\-E\fR | \fB\-\-eaton_serial\fR \fIserial ports\fR
.RS 4
پویش دستگاه‌های Eaton (پروتکل‌های XCP و SHUT) موجود از طریق گذرگاه سریال روی میزبان جاری\&. این گزینه باید به صورت صریح درخواست شود، حتی برای یک پویش کامل\&.
\fIserial ports\fR
را می‌توان به شکل‌های مختلف بیان کرد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIauto\fR
برای پویش تمام درگاه‌های سریال\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک نویسه تکی نشان‌دهنده شماره درگاه (\fI0\fR
(صفر) برای
/dev/ttyS0
و
/dev/ttyUSB0
در لینوکس،
\fI1\fR
برای
COM1
در ویندوز،
\fIa\fR
برای
/dev/ttya
در سولاریس و \&...)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
محدوده‌ای از N نویسه، جداشده با خط تیره، که محدوده درگاه‌ها را با دستور زبان
X\-Y
توصیف می‌کند، که در آن
\fIX\fR
و
\fIY\fR
نویسه‌های اشاره‌کننده به شماره درگاه هستند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
نام یک درگاه تکی\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرستی از نام درگاه‌ها، جداشده با کاما، مانند
/dev/ttyS1,/dev/ttyS4\&.
.RE
.RE
.SH "گزینه‌های شبکه (NETWORK OPTIONS)"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
گذرگاه‌های شبکه‌ای (مانند SNMP، NetXML، IPMI و "Old NUT") امکان مشخص کردن چندین محدوده نشانی IP (شامل IPv4 یا IPv6)، تا نشانی‌های IP منفرد را می‌دهند\&.
.sp
معمولاً یک محدوده جدید با مجموعه‌ای از گزینه‌های \-s و \-e که به دنبال یکدیگر می‌آیند (به هر ترتیبی در خط فرمان) مشخص می‌شود\&.
.sp
گزینه‌های \-s یا \-e تنها یا متوالی در خط فرمان به پرس‌وجوهای تک‌IP ترجمه می‌شوند\&.
.sp
همچنین، قرار گرفتن یک گزینه \-m بین دو گزینه \-s و \-e به منزله یک محدوده جدید خواهد بود و آن دو را به پرس‌وجوهای تک‌IP تبدیل می‌کند\&. این ویژگی به خودی خود نشانی‌های «همسایه» را در یک محدوده ترکیب نمی‌کند و حتی مشخصات تکراری یا هم‌پوشان را بررسی نمی‌نماید\&.
.sp
یک محدوده تک‌نشانی می‌تواند نام میزبان باشد که توسط تحلیل‌گر سیستم به یک نشانی IP ترجمه می‌شود\&. یک CIDR با استفاده از نام میزبان و طول ماسک شبکه به یک نشانی IP ترجمه شده و ماسک روی آن اعمال می‌گردد تا میزبان‌های «نزدیک» به میزبان نام‌برده پرس‌وجو شوند\&.
.sp .5v
.RE
.sp
همچنین توجه داشته باشید که برخی گذرگاه‌ها برای پویش به نشانی(های) IP نیاز دارند، و برخی دیگر زمانی که دقیقاً هیچ نشانی مشخص نشده باشد رفتار متفاوتی دارند (در حال حاضر امکان ترکیب این دو رفتار در یک بار فراخوانی ابزار nut\-scanner وجود ندارد)\&.
.sp
در نهایت توجه داشته باشید که در حال حاضر حتی در صورت وجود پشتیبانی چندریسمانی، هر مشخصه محدوده یک توزیع جداگانه از پرس‌وجوهاست که با محدودیت زمانی مشخص می‌شود\&. درخواست‌های پویش نشانی‌های متعدد تک‌IP برای تکمیل به زمان زیادی نیاز دارند، بسیار طولانی‌تر از زمانی که در یک محدوده واحد باشند\&. امید است این مورد در نسخه‌های بعدی برطرف شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
نشانی‌های IPv6 جداشده با دونقطه باید در کروشه قرار گیرند\&.
.sp .5v
.RE
.PP
\fB\-t\fR | \fB\-\-timeout\fR \fItimeout\fR
.RS 4
تنظیم مهلت زمانی شبکه بر حسب ثانیه\&. مهلت زمانی پیش‌فرض ۵ ثانیه است\&.
.RE
.PP
\fB\-s\fR | \fB\-\-start_ip\fR \fIstart IP\fR
.RS 4
تنظیم نخستین IP (IPv4 یا IPv6) زمانی که محدوده‌ای از IP الزامی است (SNMP، old_nut) یا اختیاری است (XML/HTTP)\&.
.RE
.PP
\fB\-e\fR | \fB\-\-end_ip\fR \fIend IP\fR
.RS 4
تنظیم آخرین IP (IPv4 یا IPv6) زمانی که محدوده‌ای از IP الزامی است (SNMP، old_nut) یا اختیاری است (XML/HTTP)\&. اگر این پارامتر حذف شود، تنها
\fIstart IP\fR
پویش می‌شود\&. اگر
\fIend IP\fR
کوچک‌تر از
\fIstart IP\fR
باشد، هر دو پارامتر در داخل جابه‌جا می‌شوند\&.
.RE
.PP
\fB\-m\fR | \fB\-\-mask_cidr\fR \fIIP address/mask\fR
.RS 4
تنظیم محدوده‌ای از نشانی‌های IP با استفاده از نمادگذاری CIDR\&.
.sp
یک قالب ویژه
\-m auto
به
nut\-scanner
امکان می‌دهد نشانی(های) IP محلی را شناسایی کرده و زیرشبکه(های) متناظر را در پلتفرم‌های پشتیبانی‌شده پویش کند، و
\-m auto4
یا
\-m auto6
نشانی‌های انتخابی را به ترتیب به IPv4 و IPv6 محدود می‌کند\&. تنها نخستین درخواست "auto*" اعمال می‌شود و سایرین با یک هشدار نادیده گرفته خواهند شد\&.
.sp
پسوند
/ADDRLEN
را می‌توان به گزینه اضافه کرد تا زیرشبکه‌های کشف‌شده با بیت‌های بیش از حد در دسترس برای بخش نشانی میزبان را فیلتر کند (تا در موارد شدید از میلیون‌ها پویش جلوگیری شود)\&. برای نمونه، اگر محدوده شبکه IPv4 در LAN شما
10\&.2\&.3\&.0/24
باشد، بخش نشانی آن
(32\-24)=8
است\&. توجه داشته باشید در حالی که این مورد برای شبکه‌های IPv6 نیز اعمال می‌شود، زیرشبکه‌های معمول
/64
آن‌ها بعید است سرور NUT/SNMP/NetXML/\&... را در
\fBآن\fR
نزدیکی (از نظر آدرس‌دهی) داشته باشند که یک فیلتر دقیق بتواند آن‌ها را پیدا کند\&. مقدار پیش‌فرض
8
است\&.
.RE
.SH "گزینه دستگاه NUT (NUT DEVICE OPTION)"
.PP
\fB\-p\fR | \fB\-\-port\fR \fIport number\fR
.RS 4
تنظیم شماره درگاه دستگاه‌های NUT پویش‌شده (پیش‌فرض 3493)\&.
.RE
.SH "گزینه SNMP V1 (SNMP V1 OPTION)"
.PP
\fB\-c\fR | \fB\-\-community\fR \fIcommunity\fR
.RS 4
تنظیم نام جامعه SNMP v1 (پیش‌فرض = public)\&.
.RE
.SH "گزینه‌های SNMP V3 (SNMP V3 OPTIONS)"
.PP
\fB\-l\fR | \fB\-\-secLevel\fR \fIsecurity level\fR
.RS 4
تنظیم
\fIsecurity level\fR
مورد استفاده برای پیام‌های SNMPv3\&. مقادیر مجاز عبارتند از: noAuthNoPriv، authNoPriv و authPriv\&. در صورت استفاده از احراز هویت غیربدیهی، این پارامتر الزامی است\&.
.RE
.PP
\fB\-u\fR | \fB\-\-secName\fR \fIsecurity name\fR
.RS 4
تنظیم
\fIsecurity name\fR
مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3\&. در صورت تنظیم
\fIsecurity level\fR
این پارامتر الزامی است\&.
.RE
.PP
\fB\-w\fR | \fB\-\-authProtocol\fR \fIauthentication protocol\fR
.RS 4
تنظیم
\fIauthentication protocol\fR
مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3\&. مقادیر مجاز عبارتند از MD5، SHA، SHA256، SHA384 یا SHA512 (بسته به قابلیت‌های کتابخانه Net\-SNMP؛ راهنمای برنامه اجرایی
nut\-scanner
را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید)\&. مقدار پیش‌فرض MD5 است\&.
.RE
.PP
\fB\-W\fR | \fB\-\-authPassword\fR \fIauthentication pass phrase\fR
.RS 4
تنظیم
\fIauthentication pass phrase\fR
مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3\&. در صورت تنظیم
\fIsecurity level\fR
روی authNoPriv یا authPriv، این پارامتر الزامی است\&.
.RE
.PP
\fB\-x\fR | \fB\-\-privProtocol\fR \fIprivacy protocol\fR
.RS 4
تنظیم
\fIprivacy protocol\fR
مورد استفاده برای پیام‌های رمزنگاری‌شده SNMPv3\&. مقادیر مجاز عبارتند از DES، AES، AES192 یا AES256 (بسته به قابلیت‌های کتابخانه Net\-SNMP؛ راهنمای برنامه اجرایی
nut\-scanner
را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید)\&. مقدار پیش‌فرض DES است\&.
.RE
.PP
\fB\-X\fR | \fB\-\-privPassword\fR \fIprivacy pass phrase\fR
.RS 4
تنظیم
\fIprivacy pass phrase\fR
مورد استفاده برای پیام‌های رمزنگاری‌شده SNMPv3\&. در صورت تنظیم
\fIsecurity level\fR
روی authPriv، این پارامتر الزامی است\&.
.RE
.SH "گزینه‌های IPMI (IPMI OPTIONS)"
.PP
\fB\-b\fR | \fB\-\-username\fR \fIusername\fR
.RS 4
تنظیم نام کاربری مورد استفاده برای احراز هویت اتصالات IPMI بر بستر LAN (برای IPMI بر بستر LAN الزامی است\&. بدون پیش‌فرض)\&.
.RE
.PP
\fB\-B\fR | \fB\-\-password\fR \fIpassword\fR
.RS 4
مشخص کردن گذرواژه مورد استفاده هنگام احراز هویت با میزبان راه دور (برای IPMI بر بستر LAN الزامی است\&. بدون پیش‌فرض)\&.
.RE
.PP
\fB\-d\fR | \fB\-\-authType\fR \fIauthentication type\fR
.RS 4
مشخص کردن نوع احراز هویت IPMI 1\&.5 مورد استفاده (شامل NONE، STRAIGHT_PASSWORD_KEY، MD2 و MD5) با میزبان راه دور (پیش‌فرض=MD5)\&. این گزینه اتصال را از طریق رابط IPMI با عنوان
\fIlan\fR
اجباری می‌کند، و در نتیجه در حالت IPMI 1\&.5 عمل می‌نماید\&.
.RE
.PP
\fB\-L\fR | \fB\-\-cipher_suite_id\fR \fIcipher suite identifier\fR
.RS 4
مشخص کردن شناسه مجموعه رمزنگاری (cipher suite) در IPMI 2\&.0 برای استفاده\&. شناسه Cipher Suite مجموعه‌ای از الگوریتم‌های احراز هویت، یکپارچگی و محرمانگی را جهت ارتباطات IPMI 2\&.0 تعیین می‌کند\&.
.sp
الگوریتم احراز هویت الگوریتم مورد استفاده برای برپایی نشست را مشخص می‌کند، الگوریتم یکپارچگی الگوریتم مورد استفاده برای امضای بسته‌های نشست را تعیین می‌نماید، و الگوریتم محرمانگی الگوریتم مورد استفاده برای رمزنگاری داده‌های ارسالی (payload) را مشخص می‌کند (پیش‌فرض=3)\&.
.sp
شناسه‌های مجموعه رمزنگاری زیر در حال حاضر پشتیبانی می‌شوند (احراز هویت؛ یکپارچگی؛ محرمانگی):
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR: None; None; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR: HMAC\-SHA1; None; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR: HMAC\-SHA1; HMAC\-SHA1\-96; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB3\fR: HMAC\-SHA1; HMAC\-SHA1\-96; AES\-CBC\-128
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB6\fR: HMAC\-MD5; None; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB7\fR: HMAC\-MD5; HMAC\-MD5\-128; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB8\fR: HMAC\-MD5; HMAC\-MD5\-128; AES\-CBC\-128
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB11\fR: HMAC\-MD5; MD5\-128; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB12\fR: HMAC\-MD5; MD5\-128; AES\-CBC\-128
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB15\fR: HMAC\-SHA256; None; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB16\fR: HMAC\-SHA256; HMAC_SHA256_128; None
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB17\fR: HMAC\-SHA256; HMAC_SHA256_128; AES\-CBC\-128
.RE
.RE
.SH "گزینه‌های گوناگون (MISCELLANEOUS OPTIONS)"
.PP
\fB\-V\fR | \fB\-\-version\fR
.RS 4
نمایش نسخه NUT\&.
.RE
.PP
\fB\-a\fR | \fB\-\-available\fR
.RS 4
نمایش گذرگاه‌های موجود که بر اساس نحوه کامپایل برنامه اجرایی nut\-scanner قابل پویش هستند (مانند OLDNUT، USB، SNMP، XML، AVAHI، IPMI)\&.
.RE
.PP
\fB\-q\fR | \fB\-\-quiet\fR
.RS 4
تنها نمایش نتیجه پویش\&. هیچ اطلاعاتی درباره گذرگاه در حال پویش نمایش داده نمی‌شود\&.
.RE
.PP
\fB\-D\fR | \fB\-\-nut_debug_level\fR
.RS 4
افزایش سطح اشکال‌زدایی\&. این گزینه را می‌توان چندین بار برای مشاهده جزئیات بیشتر به کار برد\&.
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
سطح اشکال‌زدایی مورد نیاز هم به nut\-scanner و هم به مشکلی که سعی در بررسی آن دارید بستگی دارد\&. بنابراین پیش از ارسال خروجی اشکال‌زدایی برای توسعه‌دهنده یا نگه‌دارنده، ابتدا مشکلی را که با nut\-scanner دارید توضیح دهید\&. در اغلب اوقات اگر صرفاً یک سطح را انتخاب کنید، خروجی ممکن است بسیار محدود یا بیش از حد حجیم و بدون استفاده باشد\&.
.sp .5v
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
تنها برای پویش دستگاه‌های USB:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-U

[nutdev\-usb1]
        driver = "snmp\-ups"
        port = "192\&.168\&.0\&.42"
.fi
.if n \{\
.RE
.\}
.sp
برای پویش دستگاه SNMP v1 با جامعه \fIpublic\fR (پیش‌فرض) در محدوده نشانی \fI192\&.168\&.0\&.0 تا 192\&.168\&.0\&.255\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-S \-s 192\&.168\&.0\&.0 \-e 192\&.168\&.0\&.255

[nutdev\-snmp1]
        driver = "snmp\-ups"
        port = "192\&.168\&.0\&.42"
.fi
.if n \{\
.RE
.\}
.sp
همان با استفاده از نمادگذاری CIDR:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-S \-m 192\&.168\&.0\&.0/24

[nutdev\-snmp1]
        driver = "snmp\-ups"
        port = "192\&.168\&.0\&.42"
.fi
.if n \{\
.RE
.\}
.sp
برای پویش سرورهای NUT با مهلت زمانی \fI10\fR ثانیه در محدوده IP \fI192\&.168\&.0\&.0 تا 192\&.168\&.0\&.127\fR با استفاده از نمادگذاری CIDR:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-O \-t 10 \-m 192\&.168\&.0\&.0/25

[nutdev\-nut1]
        driver = "dummy\-ups"
        port = "dummy\-test@192\&.168\&.1\&.28"
.fi
.if n \{\
.RE
.\}
.sp
برای پویش منابع تغذیه از طریق IPMI (حالت 1\&.5) بر بستر شبکه در محدوده نشانی \fI192\&.168\&.0\&.0 تا 192\&.168\&.0\&.255\fR با استفاده از نمادگذاری CIDR:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-I \-m 192\&.168\&.0\&.0/24 \-b username \-B password
.fi
.if n \{\
.RE
.\}
.sp
برای پویش دستگاه‌های سریال Eaton روی درگاه‌های \fI0\fR و \fI1\fR (/dev/ttyS0، /dev/ttyUSB0، /dev/ttyS1 و /dev/ttyUSB1 در لینوکس):
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-\-eaton_serial 0\-1
.fi
.if n \{\
.RE
.\}
.sp
برای پویش دستگاه‌های سریال Eaton روی درگاه‌های \fI1\fR و \fI2\fR (COM1 و COM2 در ویندوز):
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-\-eaton_serial 1\-2
.fi
.if n \{\
.RE
.\}
.sp
برای پویش دستگاه‌های UPower:
.sp
.if n \{\
.RS 4
.\}
.nf
:; nut\-scanner \-J

[nutdev\-upower1]
        driver = "upower"
        port = "/org/freedesktop/UPower/devices/ups_hiddev0"
        vendor = "APC"
        product = "Back\-UPS ES 700G"
        serial = "5B1234567890"
        bus = "upower"
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBups.conf\fR(5)
.SS "منابع اینترنتی:"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5