'\" t
.\"     Title: nut-driver-enumerator
.\"    Author: [see the "AUTHOR" section]
.\" 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\-DRIVER\-ENUMERA" "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-driver-enumerator \- ابزاری برای نگاشت مدخل‌های دستگاه NUT به نمونه‌های سرویس
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnut\-driver\-enumerator\&.sh\fR \-h
.sp
\fBnut\-driver\-enumerator\&.sh\fR (بدون آرگومان)
.sp
\fBnut\-driver\-enumerator\&.sh\fR [\-\-COMMAND]
.SH "توضیحات (DESCRIPTION)"
.sp
اسکریپت \fBnut\-driver\-enumerator\&.sh\fR (که با نام «NDE» نیز شناخته می‌شود) راه‌اندازی و پرس‌وجوی نگاشت میان بخش‌های پیکربندی درایور NUT برای هر دستگاه تحت‌نظر و نمونه‌های سرویس در چارچوب مدیریت سرویس سیستم‌عامل را پیاده‌سازی می‌کند (در پلتفرم‌هایی که NUT از قبل از این یکپارچه‌سازی پشتیبانی می‌کند \(em در حال حاضر این پلتفرم‌ها شامل توزیع‌های لینوکس با systemd و سیستم‌های مشتق‌شده از پایه‌کد Solaris 10، از جمله Sun/Oracle Solaris تجاری و توزیع‌های متعدد متن‌باز illumos با SMF است)، که چنین درایورهایی برای اجرا و مدیریت مستقل درون آن‌ها کپسوله‌سازی می‌شوند\&. این اسکریپت ممکن است در بسته‌بندی سایر سیستم‌عامل‌ها نصب نشده باشد\&.
.sp
با نمایش هر درایور NUT به‌صورت یک نمونه سرویس جداگانه، می‌توان وابستگی‌ها را تعریف کرد (برای نمونه، درایورهای شبکه باید پس از فعال شدن قابلیت شبکه در سیستم‌عامل شروع به کار کنند، اما درایورهای USB/Serial نباید منتظر آن بمانند)، و همچنین این درایورها می‌توانند به‌طور مستقل با خطا مواجه شده یا به وضعیت نگهداری برده شوند (برخلاف یک سرویس یکپارچه مبتنی بر \fBupsdrvctl\fR(8) که نیازمند اجرای تمام موارد پیکربندی‌شده است)\&. برای چند درایور خاص مانند \fBdummy-ups\fR(8)، \fBclone\fR(8)، \fBclone-outlet\fR(8) و \fBfailover\fR(8)، این موضوع حتی ممکن است شامل وابستگی متقابل میان نمونه‌های سرویس درایورهای گوناگون NUT به یکدیگر باشد\&.
.sp
این اسکریپت یک رابط یکپارچه برای ابزارهای بعدی NUT مانند \fBupsdrvsvcctl\fR(8) فراهم می‌کند تا منطق خود را تا حد ممکن و کاربردی، به‌صورت مستقل از پلتفرم پیاده‌سازی کنند\&. این اسکریپت در حال حاضر برای استفاده مستقیم کاربر نهایی در نظر گرفته نشده است (و به همین دلیل در پوشه \fIlibexec\fR قرار دارد)، و در عوض \fBupsdrvsvcctl\fR داده‌ها و عملکردهای پرکاربرد را با آرگومان‌های \fIlist\fR و \fIresync\fR خود ارائه می‌دهد\&.
.sp
بخشی از پیچیدگی پلتفرم که \fBnut\-driver\-enumerator\&.sh\fR آن را پنهان می‌سازد، تفاوت در قوانین نام‌های معتبر نمونه‌های سرویس در چارچوب‌های مختلف، و نیز ابزارهای سیستمی و الگوهای نام‌گذاری مرتبط است\&.
.sp
بسته به پلتفرم، این اسکریپت ممکن است درون انواع مختلفی از واحدهای سرویس قرار گیرد تا به‌صورت خودکار اجرا شود (برای نمونه، هنگام راه‌اندازی سیستم، یا به‌صورت دوره‌ای برای دریافت سریع تغییرات \fBups.conf\fR(5) پس از ویرایش، یا یکپارچه‌سازی با سامانه پایش فایل‌سیستم تا هنگام تغییر پیکربندی فراخوانی شود)\&. برخی از این حالت‌ها برای مواردی منطقی هستند که دستگاه‌های برق به‌ندرت (یا هرگز) تغییر نمی‌کنند، مانند یک UPS خانگی یا اداری کوچک که سال‌ها به یک روش پایش می‌شود؛ حالت‌های دیگر می‌توانند به خودکارسازی سیستم پایش در مراکز داده کمک کنند که استقرار (یا شناسایی) دستگاه‌ها می‌تواند بسیار پویاتر باشد\&.
.SH "دستورها (COMMANDS)"
.PP
\fBnut\-driver\-enumerator\&.sh (بدون آرگومان)\fR
.RS 4
به‌روزرسانی کپسوله‌سازی دستگاه‌ها درون سرویس‌ها\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-daemon(=freq)\fR
.RS 4
به‌روزرسانی کپسوله‌سازی دستگاه‌ها درون سرویس‌ها در یک حلقه بی‌پایان؛ بسامد پیش‌فرض ۶۰ ثانیه است\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-daemon\-after(=freq)\fR
.RS 4
به‌روزرسانی کپسوله‌سازی دستگاه‌ها درون سرویس‌ها در یک حلقه بی‌پایان؛ ابتدا یک بار حلقه را اجرا کرده و سپس به‌صورت دیمن درمی‌آید (بدین ترتیب، واحد سرویس تنها زمانی شروع‌شده تلقی می‌شود که پیکربندی NUT و نمونه‌های درایور همگام باشند)\&. بسامد پیش‌فرض ۶۰ ثانیه است\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-reconfigure\fR
.RS 4
توقف و لغو ثبت تمامی نمونه‌های سرویس و ایجاد مجدد آن‌ها (برای نمونه، اگر الگوی وابستگی جدیدی در نسخه جدید اسکریپت یا بسته تعریف شده باشد)\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-get\-service\-framework\fR
.RS 4
چاپ چارچوب مدیریت سرویس شناسایی‌شده در این سیستم‌عامل\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-list\-devices\fR
.RS 4
چاپ فهرست دستگاه‌ها در پیکربندی NUT\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-list\-services\fR
.RS 4
چاپ فهرست نمونه‌های سرویسی که دستگاه‌های ثبت‌شده NUT را کپسوله‌سازی می‌کنند (نام کامل واحد سرویس)\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-list\-instances\fR
.RS 4
چاپ فهرست نمونه‌های سرویسی که دستگاه‌های ثبت‌شده NUT را کپسوله‌سازی می‌کنند (تنها پسوند نمونه)\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-get\-service\-for\-device DEV\fR
.RS 4
چاپ نام کامل واحد سرویسی که دستگاه NUT با نام
DEV
را کپسوله‌سازی می‌کند\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-get\-device\-for\-service SVC\fR
.RS 4
چاپ نام دستگاه NUT متناظر با نام کامل یا پسوند نمونه واحد سرویس
SVC
که آن را کپسوله‌سازی کرده است\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-list\-services\-for\-devices\fR
.RS 4
چاپ فهرستی جداشده با تب (TAB) از واحدهای سرویس و نام دستگاه‌های متناظر NUT که توسط هر واحد کپسوله‌سازی شده‌اند\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-show\-all\-configs\fR
.RS 4
نمایش فهرست کامل و استانداردشده بلوک‌های پیکربندی دستگاه (مشابه آنچه بعداً توسط تجزیه‌کننده اسکریپت برای تصمیم‌گیری استفاده می‌شود)\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-show\-device\-config DEV\fR
.RS 4
نمایش بلوک پیکربندی دستگاه NUT تعیین‌شده\&.
.RE
.PP
\fBnut\-driver\-enumerator\&.sh \-\-show\-device\-config\-value DEV KEY\fR
.RS 4
نمایش مقدار یک کلید پیکربندی مشخص از دستگاه NUT تعیین‌شده\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
به‌طور پیش‌فرض، اجرای \fBnut\-driver\-enumerator\&.sh\fR بدون آرگومان، به‌طور خودکار هر نمونه سرویس تازه‌ثبت‌شده‌ای را که دستگاه‌های NUT را در بر می‌گیرد راه‌اندازی می‌کند و در صورت تغییر پیکربندی، سرویس nut\-server را نیز راه‌اندازی مجدد می‌نماید\&. متغیر محیطی AUTO_START=no این بخش از رفتار پیش‌فرض را غیرفعال می‌کند\&.
.sp
همچنین برای متغیر محیطی REPORT_RESTART_42=no به بخش زیر مراجعه کنید\&.
.SH "عیب‌یابی (DIAGNOSTICS)"
.sp
در صورتی که اسکریپت \fBnut\-driver\-enumerator\&.sh\fR کاری برای انجام نداشته باشد (تمامی درایورهای تعریف‌شده فعلی دقیقاً و یک‌به‌یک با نمونه‌های سرویس تعریف‌شده مطابقت داشته باشند) و در عملیات آن خطایی رخ نداده باشد، کد خروج صفر را برمی‌گرداند\&.
.sp
کدهای دیگر ممکن است در نتیجه همگام‌سازی مجدد نگاشت‌ها بازگردانده شوند:
.PP
\fB42\fR
.RS 4
بخش‌های دستگاه NUT و نمونه‌های سرویس سیستم قبلاً متفاوت بودند، اما اکنون مطابقت دارند \(em بنابراین اکنون فراخواننده احتمالاً باید برخی از سرویس‌ها را راه‌اندازی مجدد کند\&. توجه داشته باشید که نمونه‌های سرویس درایورها ممکن است بر حسب نیاز (توسط
AUTO_START=yes)
راه‌اندازی یا متوقف شده باشند \(em اما شاید سرویس‌های upsmon یا upssched باید راه‌اندازی مجدد شوند\&. اگر متغیر محیطی
REPORT_RESTART_42=no
را مشخص کنید، این مسیر کد مقدار ۰ را (به‌عنوان کد خروج بدون خطا) بازمی‌گرداند\&. در حالت پیش‌فرض، چنین پیکربندی مجدد غیرتهی باعث راه‌اندازی مجدد سرویس nut\-driver\-enumerator می‌شود و این امر به سایر سرویس‌های NUT وابسته به آن نیز سرایت خواهد کرد\&.
.RE
.PP
\fB13\fR
.RS 4
بخش‌ها و سرویس‌ها تفاوت داشتند و هنوز هم مطابقت ندارند\&.
.RE
.PP
\fB1\fR
.RS 4
ورودی‌های نادرست، برای نمونه عدم شناسایی چارچوب مدیریت سرویس\&.
.RE
.PP
\fB2\fR
.RS 4
فایل
ups\&.conf
یافت نشد یا غیرقابل خواندن است\&.
.RE
.SH "نویسنده (AUTHOR)"
.sp
Jim Klimov <jimklimov+nut@gmail\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsdrvsvcctl\fR(8), \fBups.conf\fR(5)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5