'\" t .\" Title: ups.conf .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/21/2026 .\" Manual: NUT Manual .\" Source: Network UPS Tools 2.8.5 .\" Language: English .\" .TH "UPS\&.CONF" "5" "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)" ups.conf \- تعاریف یوپی‌اس برای مجموعه ابزارهای Network UPS Tools .SH "توضیحات (DESCRIPTION)" .sp این فایل توسط کنترل‌کننده درایور \fBupsdrvctl\fR(8)، درایورهای یوپی‌اس که از هسته مشترک استفاده می‌کنند (به \fBnutupsdrv\fR(8) مراجعه کنید)، \fBnut-driver-enumerator\fR(8) و سرور داده NUT یعنی \fBupsd\fR(8) خوانده می‌شود\&. فایل با دستورالعمل‌های سراسری (global) آغاز می‌شود و سپس هر یوپی‌اس دارای بخشی است که شامل تعدادی دستورالعمل برای تنظیم پارامترهای آن یوپی‌اس می‌باشد\&. .sp بخش مربوط به هر یوپی‌اس با نام آن یوپی‌اس درون براکت آغاز می‌شود و تا نام یوپی‌اس بعدی درون براکت یا پایان فایل ادامه می‌یابد\&. نام "default" به صورت داخلی در \fBupsd\fR(8) استفاده می‌شود، بنابراین نمی‌توانید از آن در این فایل استفاده کنید\&. .sp شما باید عناصر \fIdriver\fR و \fIport\fR را برای هر مدخل تعریف کنید\&. هر مورد دیگری پس از آن در یک بخش اختیاری است\&. یک مثال ساده ممکن است به این شکل باشد: .sp .if n \{\ .RS 4 .\} .nf [myups] driver = blazer_ser port = /dev/ttyS0 desc = "Web server UPS" .fi .if n \{\ .RE .\} .sp یک نسخه کمی پیچیده‌تر شامل مواردی اضافی برای بخش وابسته به سخت‌افزار درایور است: .sp .if n \{\ .RS 4 .\} .nf [bigups] driver = apcsmart port = /dev/cua00 cable = 940\-0095B sdtype = 2 desc = "Database server UPS" .fi .if n \{\ .RE .\} .sp در این حالت، درایور \fBapcsmart\fR(8) متغیرهایی به نام "cable" و "sdtype" را دریافت می‌کند که معانی خاصی دارند\&. برای اطلاع از اینکه چه متغیرهایی پشتیبانی می‌شوند و چه کاری انجام می‌دهند، به صفحات راهنمای درایور(های) خود مراجعه کنید\&. .sp در اینجا مثال دیگری هنگام اتصال یک یوپی‌اس سریال در ویندوز آورده شده است: .sp .if n \{\ .RS 4 .\} .nf [windows\-ups] driver = mge\-shut port = "\e\e\e\e\&.\e\eCOM10" desc = "UPS on a Windows machine" .fi .if n \{\ .RE .\} .SH "نکات مهم (IMPORTANT NOTES)" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} محتویات این فایل باید فقط از نویسه‌های اسکی (ASCII) خالص باشد (کدهای نویسه‌ای خارج از این محدوده با پیام هشدار نادیده گرفته می‌شوند)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مجوزهای دسترسی کاربر زمان اجرا را طوری متعادل کنید که فقط upsd و درایورها بتوانند فایل (و احتمالاً دایرکتوری حاوی آن) را بخوانند؛ دسترسی نوشتن لازم نیست\&. معمولاً از دستورات chown root:nut و chmod 640 برای تنظیم مجوزهای قابل قبول فایل استفاده می‌شود\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} بسته‌ها (و دستورالعمل‌های ساخت) معمولاً یک مجموعه از حساب‌های کاربری و گروهی را برای NUT آماده می‌کنند\&. ساخت‌های سفارشی با حداقل پیکربندی ممکن است حتی از nobody:nogroup یا موارد مشابه استفاده کنند که ذاتاً ناامن است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} در سیستم‌هایی با ملاحظات امنیتی بیشتر، درایورهای NUT و سرور داده باید با حساب‌های کاربری جداگانه‌ای اجرا شوند که برای دسترسی اشتراکی به فایل‌های سوکت یونیکس محلی و دایرکتوری مربوطه و همچنین برای خواندن ups\&.conf عضو یک گروه مشترک باشند، اما برای دسترسی به سایر فایل‌های پیکربندی در گروه‌های متفاوتی قرار گیرند\&. این امر مستلزم آن است که برخی دیمن‌ها از تنظیمات سفارشی user، group، RUN_AS_USER و/یا RUN_AS_GROUP برای بازنویسی مقدار پیش‌فرض داخلی استفاده کنند\&. .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 .\} امنیت هرگونه نسخه پشتیبان از این فایل را نیز در نظر داشته باشید، مانند فایل‌های آرشیوی که ممکن است در آنها ذخیره شود\&. .RE .RE .SH "دستورالعمل‌های سراسری (GLOBAL DIRECTIVES)" .PP \fBchroot\fR .RS 4 اختیاری\&. درایور در حین مقداردهی اولیه به این دایرکتوری \fBchroot\fR(2) می‌کند\&. این قابلیت می‌تواند هنگام ایمن‌سازی سیستم‌ها مفید باشد\&. .RE .PP \fBdriverpath\fR .RS 4 اختیاری\&. مسیر دایرکتوری که فایل‌های اجرایی درایور یوپی‌اس در آن قرار دارند\&. در صورت عدم تعیین، برنامه‌ها در یک دایرکتوری پیش‌فرض داخلی جستجو می‌کنند که اغلب /usr/local/ups/bin است\&. .RE .PP \fBstatepath\fR .RS 4 اختیاری\&. مسیر دایرکتوری که درایورهای یوپی‌اس باید سوکت‌های وضعیت خود را برای ارتباط محلی با سرور داده upsd در آن قرار دهند، به جای مکان پیش‌فرضی که در برنامه کامپایل شده است (که اغلب /var/state/ups است)\&. .sp توجه داشته باشید که درایورها باید از همان مسیر مورد استفاده upsd استفاده کنند، بنابراین سرور داده در صورت وجود، این تنظیم از بخش سراسری ups\&.conf را بر تنظیم موجود در upsd\&.conf ترجیح می‌دهد\&. .sp متغیر محیطی NUT_STATEPATH تنظیم‌شده توسط فراخوان می‌تواند این تنظیم را بازنویسی کند\&. .RE .PP \fBmaxstartdelay\fR .RS 4 اختیاری\&. مشابه فیلد یوپی‌اس با همین نام است، اما این مقدار پیش‌فرضی برای یوپی‌اس‌هایی است که این فیلد را ندارند\&. .RE .PP \fBmaxretry\fR .RS 4 اختیاری\&. مشخص کردن تعداد دفعات تلاش برای راه‌اندازی درایور(ها) در صورت شکست، پیش از انصراف\&. یک تأخیر به میزان \fIretrydelay\fR بین هر تلاش گنجانده می‌شود\&. در استفاده از این گزینه احتیاط کنید زیرا می‌تواند بر زمان شروع سیستم تأثیر بگذارد\&. .sp مقدار پیش‌فرض ۱ بار تلاش است\&. .RE .PP \fBnowait\fR .RS 4 اختیاری\&. به upsdrvctl می‌گوید اصلاً منتظر نماند تا درایور(ها) دستور درخواست‌شده را اجرا کنند\&. .sp حالت پیش‌فرض (عدم درج) صبر کردن است\&. .sp این گزینه را می‌توان با متغیر محیطی NUT_IGNORE_NOWAIT بازنویسی کرد (برای نمونه، جهت رفع برخی مشکلات مربوط به systemd)\&. .RE .PP \fBretrydelay\fR .RS 4 اختیاری\&. مشخص کردن تأخیر بین هر تلاش راه‌اندازی مجدد درایور(ها)، طبق مشخصات \fImaxretry\fR\&. در استفاده از این گزینه احتیاط کنید زیرا می‌تواند بر زمان شروع به کار سیستم تأثیر بگذارد\&. .sp مقدار پیش‌فرض ۵ ثانیه است\&. .RE .PP \fBpollinterval\fR .RS 4 اختیاری\&. وضعیت یوپی‌اس پس از یک حداکثر تأخیر که توسط این تنظیم کنترل می‌شود، تازه‌سازی خواهد شد\&. این مقدار معمولاً ۲ ثانیه است\&. اگر درایور بار زیادی روی سیستم پایش یا شبکه شما ایجاد می‌کند، این تنظیم می‌تواند مفید باشد\&. .sp توجه داشته باشید که برخی درایورها (مانند \fBusbhid-ups\fR(8)، \fBsnmp-ups\fR(8) و \fBnutdrv_qx\fR(8)) همچنین دارای گزینه‌ای به نام \fBpollfreq\fR هستند که دفعات پایش برخی از پارامترهای با اهمیت کمتر را کنترل می‌کند\&. جزئیات در صفحات راهنمای هر درایور ارائه شده است\&. .RE .PP \fBsynchronous\fR .RS 4 اختیاری\&. درایورها به طور پیش‌فرض در ابتدا در حالت ناهمگام (asynchronous) کار می‌کنند اما در صورت شکست در نوشتن روی سوکت سرور، می‌توانند به حالت همگام برگردند (یعنی \fBsynchronous=auto\fR)\&. این بدان معناست که تمام داده‌ها توسط درایور روی سوکت ارتباطی با upsd (سوکت یونیکس در یونیکس، Named pipe در ویندوز) بدون انتظار برای مصرف واقعی این داده‌ها ارسال می‌شوند\&. در برخی سخت‌افزارها، مانند ePDUها که می‌توانند داده‌های زیادی تولید کنند، حالت ناهمگام ممکن است باعث تراکم شود، منجر به پر شدن سوکت گردد و به نظر برسد که درایور متصل نیست\&. در این حالت، درایور پیام اشکال‌زدایی زیر را ارائه می‌دهد: .sp .if n \{\ .RS 4 .\} .nf write XX bytes to socket Y failed .fi .if n \{\ .RE .\} .sp با فعال کردن فلگ \fIsynchronous\fR (مقدار = \fIyes\fR)، درایور قبل از انتشار داده‌های بیشتر، منتظر می‌ماند تا داده‌ها توسط upsd مصرف شوند\&. این ویژگی را می‌توان به صورت سراسری یا برای هر درایور فعال کرد\&. .sp حالت پیش‌فرض \fIauto\fR برای سازگاری با گذشته در رفتار درایور مانند \fIno\fR (یعنی حالت ناهمگام) عمل می‌کند، تا زمانی که ارتباطات با وضعیت "Resource temporarily unavailable" دچار شکست شود؛ این حالت زمانی رخ می‌دهد که درایور داده‌های زیادی برای ارسال به صورت انفجاری دارد و سرور نمی‌تواند با سرعت کافی آن را پردازش کند، در نتیجه بافر پر می‌شود\&. .RE .PP \fBuser\fR .RS 4 اختیاری\&. نام کاربری غیرممتاز پیش‌فرض کامپایل‌شده را برای همه درایورهای دستگاه NUT بازنویسی می‌کند\&. برای جزئیات به بررسی گزینه \-u در \fBnutupsdrv\fR(8) مراجعه کنید\&. .RE .PP \fBgroup\fR .RS 4 اختیاری\&. نام گروه غیرممتاز پیش‌فرض کامپایل‌شده (و/یا بخش سراسری) را برای همه درایورهای دستگاه NUT که برای دسترسی به فایل سوکت استفاده می‌شود بازنویسی می‌کند\&. برای جزئیات به بررسی گزینه \-g در \fBnutupsdrv\fR(8) مراجعه کنید\&. این مورد می‌تواند به‌ویژه برای اطمینان از دسترسی به گره‌های پویای سیستم‌فایل دستگاه، مانند پشتیبانی از اتصال داغ (hot-plug) یواس‌بی (یا سریال روی یواس‌بی)، یا در سیستم‌فایل‌های دستگاه که با هر بار راه‌اندازی مجدد توسط سیستم‌عامل بازتولید می‌شوند، مفید باشد\&. .RE .PP \fBdebug_min\fR \fIINTEGER\fR .RS 4 اختیاری\&. تعیین حداقل سطح اشکال‌زدایی برای تمامی دیمن‌های درایور و ابزار \fBupsdrvctl\fR(8)، برای نمونه جهت عیب‌یابی بدون تغییر اسکریپت‌های آغازین و بدون تأثیر مستقیم بر حالت اجرای پیش‌زمینه یا پس‌زمینه\&. گزینه خط فرمان \-D تنها می‌تواند این سطح پرحرفی را افزایش دهد\&. .RE .PP \fBLIBUSB_DEBUG\fR \fIINTEGER\fR .RS 4 اختیاری\&. برای عیب‌یابی در زمان اجرای درایورهای NUT با قابلیت USB، می‌توانید پرحرفی اشکال‌زدایی ویژه LibUSB را به عنوان یک مقدار عددی مانند 4 ("All messages are emitted") مشخص کنید\&. نباید تأثیر عملی روی سایر درایورهای NUT داشته باشد\&. .sp برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده جاری برای نسخه کتابخانه شما، ببینید: .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 .\} .RE .RE .SH "فیلدهای یوپی‌اس (UPS FIELDS)" .PP \fBdriver\fR .RS 4 الزامی\&. مشخص می‌کند کدام برنامه قرار است این یوپی‌اس را پایش کند\&. باید برنامه‌ای را مشخص کنید که با سخت‌افزار شما سازگار باشد\&. برای اطلاعات بیشتر در مورد درایورها به طور کلی و ارجاع به صفحات راهنمای درایورهای خاص، به \fBnutupsdrv\fR(8) مراجعه کنید\&. .RE .PP \fBport\fR .RS 4 الزامی\&. پورت سریالی است که یوپی‌اس به آن متصل شده است\&. در یک سیستم لینوکس، اولین پورت سریال معمولاً \fI/dev/ttyS0\fR است\&. در FreeBSD و سیستم‌های مشابه، احتمالاً \fI/dev/cuaa0\fR خواهد بود\&. در ویندوز، اولین پورت سریال "\e\e\e\e\&.\e\eCOM1" خواهد بود (به اسلش‌های اسکیپ‌شده توجه کنید)\&. .RE .PP \fBuser\fR .RS 4 اختیاری\&. نام کاربری غیرممتاز پیش‌فرض کامپایل‌شده (و/یا بخش سراسری) را برای یک درایور دستگاه NUT خاص بازنویسی می‌کند\&. برای جزئیات به بررسی گزینه \-u در \fBnutupsdrv\fR(8) مراجعه کنید\&. این مورد می‌تواند به‌ویژه برای اطمینان از دسترسی به گره‌های پویای سیستم‌فایل دستگاه، مانند پشتیبانی از اتصال داغ (hot-plug) یواس‌بی (یا سریال روی یواس‌بی)، یا در سیستم‌فایل‌های دستگاه که با هر بار راه‌اندازی مجدد توسط سیستم‌عامل بازتولید می‌شوند، مفید باشد\&. .RE .PP \fBgroup\fR .RS 4 اختیاری\&. نام گروه غیرممتاز پیش‌فرض کامپایل‌شده (و/یا بخش سراسری) را برای یک درایور دستگاه NUT خاص که برای دسترسی به فایل سوکت استفاده می‌شود بازنویسی می‌کند\&. برای جزئیات به بررسی گزینه \-g در \fBnutupsdrv\fR(8) مراجعه کنید\&. این مورد می‌تواند به‌ویژه برای اطمینان از دسترسی به گره‌های پویای سیستم‌فایل دستگاه، مانند پشتیبانی از اتصال داغ (hot-plug) یواس‌بی (یا سریال روی یواس‌بی)، یا در سیستم‌فایل‌های دستگاه که با هر بار راه‌اندازی مجدد توسط سیستم‌عامل بازتولید می‌شوند، مفید باشد\&. .RE .PP \fBsdorder\fR .RS 4 اختیاری\&. هنگامی که چندین یوپی‌اس روی سیستم خود دارید، معمولاً باید آن‌ها را به ترتیب خاصی خاموش کنید\&. upsdrvctl ابتدا همه یوپی‌اس‌های سطح 0، سپس 1، 2 و غیره را خاموش می‌کند\&. برای حذف یک یوپی‌اس از توالی خاموش‌سازی، این مقدار را روی 1- قرار دهید\&. .sp مقدار پیش‌فرض برای این پارامتر 0 است\&. .RE .PP \fBsdcommands\fR .RS 4 اختیاری\&. فهرستی جداشده با کاما از نام دستور(های) فوری برای ارسال به یوپی‌اس در زمان درخواست خاموش‌سازی آن\&. .sp منطق پیش‌فرض در هر درایور (در صورت پشتیبانی) تعبیه شده است و می‌توان در اینجا به عنوان مقدار shutdown\&.default به آن ارجاع داد\&. .sp کاربرد اصلی برای دستگاه‌هایی است که درایورهای آنها به صورت بومی تلاش برای چند دستور را پشتیبانی می‌کنند، اما ترتیب پیش‌فرض تعبیه‌شده دستوری را فراخوانی می‌کند که توسط مدل دستگاه خاص به درستی مدیریت نمی‌شود (بنابراین گزارش موفقیت داده می‌شود و حلقه متوقف می‌شود، اما در عمل هیچ اتفاقی در مورد قطع برق بار رخ نمی‌دهد)\&. .sp کاربرد دیگر تمایز سناریوهای خاموش کردن خودکار برق است که در آنها یوپی‌اس و بار متصل باید در حالت "OFF" باقی بمانند (مانند قطع برق اضطراری ساختمان) در مقایسه با سناریوهایی که بار باید پس از ایمن شدن وضعیت به طور خودکار به کار بازگردد\&. توجه: در حال حاضر برای چنین مواردی نیاز به ویرایش ups\&.conf پیش از مشاهده فایل توسط nutshutdown است؛ اما در نسخه‌های آینده NUT می‌تواند به شکل بهتری خودکار شود\&. .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 دستورات ارائه‌شده توسط کاربر ممکن است چیزی غیر از خاموش‌سازی واقعی باشند، برای نمونه یک بیپر (beeper) برای آزمایش اینکه INSTCMD همان‌طور و در زمانی که انتظار می‌رفت رخ داده و با دستگاه ارتباط برقرار شده است، بدون تأثیر بر بار تغذیه‌شده توسط یوپی‌اس\&. .sp .5v .RE .RE .PP \fBallow_killpower\fR .RS 4 اختیاری\&. به شما امکان می‌دهد دستور فوری driver\&.killpower را درخواست کنید تا بلافاصله پیاده‌سازی پیش‌فرض متد upsdrv_shutdown() مربوط به درایور فراخوانی شود، با همان اثری که گویی درایور NUT با فلگ خط فرمان \-k راه‌اندازی شده است\&. این گزینه را می‌توان با \fBupsrw\fR(8) به عنوان driver\&.flag\&.allow_killpower در زمان اجرا تغییر وضعیت داد\&. .RE .PP \fBdesc\fR .RS 4 اختیاری\&. امکان تنظیم توضیح کوتاهی را فراهم می‌کند که upsd به کلاینت‌هایی که فهرست تجهیزات متصل را درخواست می‌کنند ارائه می‌دهد\&. .RE .PP \fBnolock\fR .RS 4 اختیاری\&. هنگام تعیین این گزینه، درایور در هر بار راه‌اندازی، روتین‌های قفل کردن پورت را نادیده می‌گیرد\&. این کار ممکن است در صورت راه‌اندازی تصادفی بیش از یک فرایند، به سایر فرایندها اجازه دهد پورت را تصاحب کنند\&. .sp تنها در صورتی باید از این گزینه استفاده کنید که سیستم شما بدون آن کار نکند\&. .sp این گزینه ممکن است در سیستم‌های Mac OS X مورد نیاز باشد\&. .RE .PP \fBignorelb\fR .RS 4 اختیاری\&. هنگامی که این گزینه را تعیین می‌کنید، درایور پرچم وضعیت باتری ضعیف که توسط یوپی‌اس گزارش می‌شود را نادیده می‌گیرد (برخی دستگاه‌ها تقریباً بلافاصله پس از تنظیم این پرچم خاموش می‌شوند، یا به محض قطع برق شهری این را گزارش می‌کنند)\&. در عوض از هر یک از شرایط زیر برای تعیین زمان ضعیف بودن باتری استفاده می‌کند: .sp .if n \{\ .RS 4 .\} .nf battery\&.charge < battery\&.charge\&.low battery\&.runtime < battery\&.runtime\&.low .fi .if n \{\ .RE .\} .sp ایده این است که سطوح battery\&.charge\&.low و/یا battery\&.runtime\&.low در \fBups\&.conf\fR روی مقداری تنظیم شوند که زمان کافی برای خاموش‌سازی تمیز سیستم فراهم کند: .sp .if n \{\ .RS 4 .\} .nf override\&.battery\&.charge\&.low = 30 override\&.battery\&.runtime\&.low = 180 .fi .if n \{\ .RE .\} .sp برای کارکرد این قابلیت، یوپی‌اس شما باید بتواند میزان شارژ و/یا زمان کارکرد باقی‌مانده روی باتری را (به طور قابل اعتماد) گزارش کند\&. با احتیاط استفاده کنید! .RE .PP \fBmaxstartdelay\fR .RS 4 اختیاری\&. این مورد را می‌توان به عنوان یک متغیر سراسری بالای اولین تعریف یوپی‌اس و همچنین در بخش مربوط به هر یوپی‌اس تنظیم کرد\&. این مقدار مدت زمانی را که upsdrvctl منتظر می‌ماند تا راه‌اندازی درایور به پایان برسد کنترل می‌کند\&. این ویژگی مانع از گیر کردن سیستم به دلیل درایور یا یوپی‌اس معیوب می‌شود\&. .sp توجه داشته باشید که پس از سپری شدن این مدت، upsdrvctl به کار خود ادامه می‌دهد (چه تلاش مجدد برای همان درایور در صورت maxretry>1، یا تلاش برای درایوری دیگر در صورت راه‌اندازی همه آنها، یا در نهایت خروج)؛ با این حال، هر یک از این فرایندهای درایور "گیرکرده" که به تازگی راه‌اندازی شده‌اند ممکن است در پس‌زمینه به مقداردهی اولیه ادامه دهند و حتی در نهایت با موفقیت روبرو شوند\&. .sp آن‌ها پس از پایان این مهلت زمانی توسط upsdrvctl به صورت فعال متوقف (kill) نمی‌شوند\&. .sp مقدار پیش‌فرض ۷۵ ثانیه است\&. .RE .PP \fBmaxretry\fR .RS 4 اختیاری\&. این مورد را می‌توان به عنوان یک متغیر سراسری بالای اولین تعریف یوپی‌اس و همچنین در بخش مربوط به هر یوپی‌اس تنظیم کرد\&. به توضیحات بالا در بخش سراسری مراجعه کنید\&. .RE .PP \fBretrydelay\fR .RS 4 اختیاری\&. این مورد را می‌توان به عنوان یک متغیر سراسری بالای اولین تعریف یوپی‌اس و همچنین در بخش مربوط به هر یوپی‌اس تنظیم کرد\&. به توضیحات بالا در بخش سراسری مراجعه کنید\&. .RE .PP \fBsynchronous\fR .RS 4 اختیاری\&. مشابه دستورالعمل سراسری با همین نام است، اما برای یک دستگاه خاص اعمال می‌شود\&. .RE .PP \fBusb_set_altinterface\fR[=\fIaltinterface\fR] .RS 4 اختیاری\&. کد USB را وادار می‌کند تا usb_set_altinterface(0) را فراخوانی کند، مشابه آنچه در NUT 2\&.7\&.2 و نسخه‌های پیشین انجام می‌شد\&. این کار نباید ضروری باشد، زیرا مقدار پیش‌فرض bAlternateSetting (همان‌طور که در lsusb نشان داده می‌شود) در تمامی دستگاه‌های USB مشاهده‌شده تا به امروز صفر است\&. با این حال، این فراخوانی اضافی برای usb_set_altinterface() مانع از کارکرد برخی یوپی‌اس‌ها در Mac OS X می‌شود\&. اگر یوپی‌اس شما نیازمند تنظیم صریح رابط جایگزین است، این فلگ را اضافه کرده و مشخصات یوپی‌اس و سیستم‌عامل خود را به فهرست پستی nut\-upsdev ایمیل کنید\&. .RE .PP \fBusb_config_index\fR, \fBusb_hid_rep_index\fR, \fBusb_hid_desc_index\fR, \fBusb_hid_ep_in\fR, \fBusb_hid_ep_out\fR .RS 4 اختیاری\&. اجبار به استفاده از شماره‌های خاص رابط، اندپوینت، اندیس توصیف‌کننده و غیره، به جای مقدار پیش‌فرض 0 (به ندرت مقادیر دیگر در برخی درایورها برای دستگاه‌هایی که شناخته شده از مقادیر غیرصفر استفاده می‌کنند)\&. به عنوان یک عدد هگزادسیمال مشخص می‌شود\&. .sp به عنوان یک قاعده کلی برای کشف usb_hid_desc_index، می‌توانید مقادیر بزرگتر wDescriptorLength (تقریباً بیش از ۶۰۰ بایت) را در گزارش‌های lsusb یا ابزارهای مشابه مشاهده کنید\&. .RE .PP \fBdefault\&.\fR .RS 4 اختیاری\&. تنظیم مقدار پیش‌فرض برای که در صورت عدم ارائه مقدار توسط یوپی‌اس استفاده می‌شود، اما در صورت وجود مقدار از طرف یوپی‌اس بازنویسی خواهد شد: .sp .if n \{\ .RS 4 .\} .nf default\&.input\&.voltage\&.nominal = 230 .fi .if n \{\ .RE .\} .sp دستور بالا ولتاژ اسمی ورودی را ۲۳۰ گزارش می‌کند، مگر اینکه یوپی‌اس مقدار دیگری اعلام کند\&. .RE .PP \fBoverride\&.\fR .RS 4 اختیاری\&. تنظیم مقداری برای که هر مقداری را که ممکن است از یوپی‌اس خوانده شود بازنویسی می‌کند\&. برای بازنویسی مقادیر دریافتی از یوپی‌اس که به وضوح نادرست هستند استفاده می‌شود (برای نمونه برخی دستگاه‌ها مقادیر نادرستی برای ولتاژ باتری گزارش می‌کنند): .sp .if n \{\ .RS 4 .\} .nf override\&.battery\&.voltage\&.nominal = 12 .fi .if n \{\ .RE .\} .sp با احتیاط استفاده کنید! این کار تنها ظاهر متغیر را برای دنیای بیرون تغییر می‌دهد؛ درون یوپی‌اس همچنان از مقدار اصلی استفاده می‌شود\&. .RE .sp تمام فیلدهای دیگر به بخش وابسته به سخت‌افزار درایور منتقل می‌شوند\&. برای فهرست موارد مجاز به آن راهنماها مراجعه کنید\&. .PP \fBdebug_min\fR \fIINTEGER\fR .RS 4 اختیاری\&. تعیین حداقل سطح اشکال‌زدایی برای این دیمن درایور، برای نمونه جهت عیب‌یابی بدون تأثیر مستقیم بر حالت اجرای پیش‌زمینه یا پس‌زمینه\&. اگر debug_min سراسری نیز تنظیم شده باشد، این تنظیم سطح درایور آن را بازنویسی می‌کند\&. گزینه خط فرمان \-D تنها می‌تواند این سطح پرحرفی را افزایش دهد\&. .RE .PP \fBLIBUSB_DEBUG\fR \fIINTEGER\fR .RS 4 اختیاری\&. برای عیب‌یابی در زمان اجرای درایورهای NUT با قابلیت USB، می‌توانید پرحرفی اشکال‌زدایی ویژه LibUSB را به صورت یک مقدار عددی مانند 4 ("All messages are emitted") مشخص کنید\&. .sp برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده جاری برای نسخه کتابخانه شما، ببینید: .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 .\} .RE .RE .SH "یکپارچه‌سازی (INTEGRATION)" .sp \fBupsdrvctl\fR(8) از این فایل برای راه‌اندازی و متوقف کردن درایورها استفاده می‌کند\&. .sp خود درایورها نیز داده‌های پیکربندی را از این فایل دریافت می‌کنند\&. هر درایور بخش مربوط به خود را جستجو کرده و از آن برای پیکربندی خود استفاده می‌نماید\&. .sp \fBupsd\fR(8) با خواندن این فایل متوجه می‌شود چه یوپی‌اس‌هایی روی این سیستم نصب شده‌اند\&. اگر این سیستم "doghouse" نامیده شود و شما یوپی‌اسی را در \fBups\&.conf\fR خود به نام "snoopy" تعریف کرده باشید، می‌توانید آن را از طریق \fBupsc\fR(8) یا برنامه‌های مشابه به صورت "snoopy@doghouse" پایش کنید\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBupsd\fR(8), \fBnutupsdrv\fR(8), \fBupsdrvctl\fR(8), \fBupsdrvsvcctl\fR(8) .SS "منابع اینترنتی (Internet resources)" .sp صفحه اصلی NUT (Network UPS Tools):