'\" t
.\"     Title: clone-outlet
.\"    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 "CLONE\-OUTLET" "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)"
clone\-outlet \- شبیه‌سازی یک یوپی‌اس و مدیریت پریز آن به‌صورت یک یوپی‌اس مستقل (فقط پایش)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBclone\-outlet\fR \-h
.sp
\fBclone\-outlet\fR \-a \fIUPS_NAME\fR [\fIگزینه‌ها\fR]
.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
این صفحه راهنما فقط ویژگی‌های اختصاصی درایور clone\-outlet را مستند می‌کند\&. برای کسب اطلاعات درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
این درایور که روی فایل سوکت محلی یونیکس (یا پایپ نام‌گذاری‌شده ویندوز) درایور دیگری قرار می‌گیرد، به کاربران اجازه می‌دهد کلاینت‌ها را به یک پریز خاص از دستگاه متصل کرده و با این خروجی به‌گونه‌ای رفتار کنند که گویی یک یوپی‌اس عادی است\&.
.sp
برخلاف درایور \fBclone\fR(8) یا درایور \fBdummy-ups\fR(8) که در حالت تکرارکننده (repeater) اجرا می‌شوند، این درایور نمایانگر یک دستگاه فقط‌خواندنی برای پایش و خاموش‌سازی است (این درایور تنظیم هیچ مقداری یا ارسال دستورات آنی را در حین اجرا نمی‌پذیرد)\&.
.sp
برخلاف \fBdummy-ups\fR(8) به‌طور کلی، این درایور نیازی به اجرای سرور داده upsd ندارد و از پروتکل شبکه‌ای NUT برای ارتباط با درایور «واقعی» (که در حالت تکرارکننده dummy\-ups ممکن است از راه دور باشد) استفاده نمی‌کند\&.
.sp
این درایور یک دستگاه مجازی کاملاً جدید ایجاد نمی‌کند، بلکه برخی از مقادیر اصلی گزارش‌شده توسط درایور «واقعی» را با استفاده از اطلاعات پریز مشخص‌شده جایگزین کرده یا گسترش می‌دهد و سایر مقادیر را همان‌طور که بودند بازپخش می‌کند\&.
.sp
کلاینت‌های راه دور مانند upsmon می‌توانند مدخل دستگاه ارائه‌شده توسط سرور داده را در حالی که این درایور (و درایور «واقعی») در حال اجرا و منتشرشده هستند، با MONITOR پایش کنند\&.
.sp
یک پیاده‌سازی بزرگ‌تر با یک یا چند دستگاه با اولویت پایین‌تر متصل به یک پریز قابل مدیریت از یوپی‌اس یا ePDU احتمالاً شامل راه‌اندازی چندین درایور بر روی سیستمی خواهد بود که عملاً قادر به تعامل با یوپی‌اس و اجرای سرور داده NUT یعنی \fBupsd\fR(8) است (و احتمالاً از پریز دیگری تغذیه می‌شود):
.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
.\}
یک درایور
clone
در حال ارتباط با درایور «واقعی» که بر اساس آستانه‌های نسبتاً بالا برای شارژ باقی‌مانده باتری یا مدت‌زمان کارکرد یوپی‌اس واقعی (یا دستورات آنی صریح)، فرمان قطع برق پریز (یا چرخه برق) را صادر می‌کند؛ به‌طوری‌که این عملیات ابتدا تایمرهای مربوط به پریز را در درایور «واقعی» تنظیم کرده و پرچم "FSD" را در میان وضعیت‌های یوپی‌اس مجازی قرار می‌دهد؛
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
احتمالاً یک درایور
clone\-outlet
که فقط‌خواندنی است و مقادیر تایمر پریز را به‌عنوان محرک‌هایی برای پرچم‌های "FSD" یا "OFF" گزارش‌شده در میان وضعیت‌های یوپی‌اس مجازی تفسیر می‌کند\&.
.RE
.sp
با این رویکرد، سیستم‌های با اولویت پایین‌تر متصل به چنین پریزی، کلاینت NUT یعنی \fBupsmon\fR(8) را اجرا می‌کنند تا یوپی‌اس مجازی ارائه‌شده توسط درایور فقط‌خواندنی clone\-outlet را پایش (MONITOR) کرده و به محض بالا رفتن پرچم "FSD" (که بر اساس آستانه‌های شارژ و/یا زمان کارکرد پیکربندی‌شده برای آن درایور، نسبتاً زود رخ می‌دهد) خاموش شوند؛ این کار به دستگاه‌های با اولویت بالاتر (که احتمالاً شامل خود سرور NUT نیز می‌شود) امکان می‌دهد مدت‌زمان بیشتری از باتری استفاده کنند\&.
.sp
درایور clone که مسئول تغییرات وضعیت برق پریز است، معمولاً به‌طور مستقیم پایش نمی‌شود (برای مثال جهت جلوگیری از درخواست‌های خاموش‌سازی ناخواسته و مستقیم از سوی آن کلاینت‌ها)، هرچند در شبکه‌هایی با ضریب اطمینان کافی، می‌توان آن را (به‌جای clone\-outlet) مستقیماً پایش کرد\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات زیر پشتیبانی می‌کند:
.PP
\fBport\fR=\fIdrivername\-devicename\fR
.RS 4
اجباری\&. تنظیم استاندارد
port
در درایورهای NUT؛ در اینجا نام سوکت یونیکس محلی (یا پایپ نام‌گذاری‌شده ویندوز) را برای اتصال به درایور «واقعی» مشخص می‌کند\&.
.RE
.PP
\fBprefix\fR=\fIoutlet\&.N\fR
.RS 4
اجباری\&. پیشوند پریز را همان‌طور که در درایور اصلی شناخته می‌شود مشخص کنید\&. زیرمجموعه‌ای از داده‌های گزارش‌شده توسط درایور یوپی‌اس «واقعی» برای دستگاه اصلی با این پیشوند، به‌عنوان داده‌های یوپی‌اس مجازیِ مدیریت‌شده توسط این درایور گزارش خواهند شد\&.
.RE
.SH "پیاده‌سازی (IMPLEMENTATION)"
.sp
مشخصه پورت در \fBups.conf\fR(5) باید به سوکت درایور محلی (یا پایپ نام‌گذاری‌شده ویندوز) که درایور یوپی‌اس «واقعی» از آن استفاده می‌کند ارجاع دهد\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
  [realups]
     driver = usbhid\-ups
     port = auto

  [clone\-outlet\-1]
     driver = clone\-outlet
     port = usbhid\-ups\-realups
     prefix = outlet\&.1
     desc = "Outlet 1 of the Real UPS"
     [\&.\&.\&.]
.fi
.if n \{\
.RE
.\}
.sp
این درایور در لایه داخلی خود، اطلاعات درایور «واقعی» درباره تاخیر خاموش‌سازی و تایمر خاموش‌سازی، وضعیت کل یوپی‌اس و وضعیت این پریز را تفسیر کرده و سایر نقاط داده را همان‌طور که بودند بازپخش می‌کند\&.
.sp
اگر پریز از قطع با تاخیر برق پشتیبانی و آن را گزارش کند، یوپی‌اس مجازی از طریق ups\&.status یک وضعیت FSD (خاموش‌سازی اجباری) صادر می‌کند تا کلاینت‌های آن با ایمنی خاموش شوند\&.
.sp
با جزئیات بیشتر:
.sp
با در نظر گرفتن مقدار پیشوند (اجباری) مانند outlet\&.1، درایور به‌طور مشخص نقاط داده <prefix>\&.status، <prefix>\&.delay\&.shutdown و <prefix>\&.timer\&.shutdown گزارش‌شده توسط درایور «واقعی» را دنبال می‌کند\&. مقادیر عددی خوانش‌های *\&.shutdown توسط این درایور ثبت شده و وضعیت بولی پریز ("off" یا غیر آن) به خاطر سپرده می‌شود\&. این مقادیر همچنین توسط این درایور «به همان صورت» مجدداً منتشر خواهند شد\&.
.sp
مقدار ups\&.status از درایور «واقعی» به خاطر سپرده می‌شود، اما بلافاصله توسط این درایور بازنشر نمی‌شود\&. در عوض، در طول چرخه‌های منظم حلقه «به‌روزرسانی اطلاعات» به یکی از اشکال زیر منتشر می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
همراه با اضافه شدن وضعیت "OFF" (اگر
<prefix>\&.status
نشان دهد که پریز "off" یا خاموش است)،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یا با اضافه شدن وضعیت "FSD" در ابتدا (اگر
<prefix>\&.timer\&.shutdown
غیرمنفی باشد و از مقدار
<prefix>\&.delay\&.shutdown
فراتر نرود)،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یا «به همان صورت» اگر وضعیت برق پریز در حالت «بحرانی نیست» باشد\&.
.RE
.SH "مهم (IMPORTANT)"
.sp
برخلاف یک یوپی‌اس واقعی، شما \fBنباید\fR حالت اصلی (primary) در upsmon را برای این درایور پیکربندی کنید\&. هنگامی که یک نسخه اصلی \fBupsmon\fR(8) پرچم‌های OB LB را می‌بیند و به سرور \fBupsd\fR(8) اعلام می‌کند که آغاز توالی خاموش‌سازی مجاز است، سرور وضعیت FSD را قفل (latch) می‌کند و بدون راه‌اندازی مجدد سرور upsd، امکان راه‌اندازی مجدد سیستم‌های متصل وجود نخواهد داشت\&.
.sp
این موضوع زمانی مشکل‌ساز خواهد شد که برق پس از آغاز توالی خاموش‌سازی توسط یوپی‌اس کلون روی پریز آن برگردد، اما قبل از اینکه یوپی‌اس واقعی خاموش شدن را آغاز کند بازگردد\&. راه‌حل در درایور clone نهفته است که در صورت نیاز، بدون کمک نسخه اصلی upsmon، پرچم FSD را درج می‌کند\&.
.SH "هشدارها (CAVEATS)"
.sp
یوپی‌اس کلون از وضعیت درایور یوپی‌اس واقعی پیروی خواهد کرد\&. شما فقط می‌توانید کاری کنید که یوپی‌اس کلون زودتر از درایور یوپی‌اس واقعی خاموش شود، نه دیرتر\&. اگر درایور یوپی‌اس واقعی فرآیند خاموش‌سازی را آغاز کند، درایور یوپی‌اس clone\-outlet بلافاصله از آن تبعیت خواهد کرد\&.
.sp
توجه داشته باشید که دستورات خاموش‌سازی/راه‌اندازی مجدد یک پریز در درایورهای یوپی‌اس واقعی تحت تأثیر قرار نمی‌گیرند؛ بنابراین اگر به درایور یوپی‌اس واقعی دستور دهید پریز مربوط به درایور یوپی‌اس کلون را فوراً خاموش کند، کلاینت‌های شما بدون هشدار برق خود را از دست خواهند داد\&. قطع برق با تاخیر برای پریز باید به‌صورت FSD منتشر شود و این تاخیر باید به اندازه کافی طولانی باشد تا فرصت خاموش شدن کلاینت‌ها را فراهم کند\&.
.sp
اگر از چارچوب‌های مدیریت سرویس مانند systemd یا SMF برای مدیریت وابستگی‌ها بین نمونه‌های درایور و سایر واحدها استفاده می‌کنید، ممکن است مجبور شوید وابستگی‌های ویژه‌ای (مثلاً با فایل‌های قطعه‌کد "drop\-in" در systemd) تنظیم کنید تا درایورهای کلون شما پس از درایورهای دستگاه‌های «واقعی» در صف راه‌اندازی قرار گیرند\&.
.SH "نویسنده (AUTHOR)"
.sp
Arjen de Korte <adkorte\-guest@alioth\&.debian\&.org>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupscmd\fR(8), \fBupsrw\fR(8), \fBups.conf\fR(5), \fBclone\fR(8), \fBnutupsdrv\fR(8)
.SS "درایور ساختگی (Dummy driver)"
.sp
حالت «تکرارکننده» (repeater) در درایور \fIdummy\-ups\fR از جهاتی شبیه به درایورهای \fIclone\fR و \fIclone\-outlet\fR است، چرا که اطلاعات را از یک درایور دستگاه «واقعی» (و سرور داده NUT) در حال اجرا به‌صورت محلی یا از راه دور بازپخش می‌کند\&.
.sp
\fBdummy-ups\fR(8)
.SS "منابع اینترنتی (Internet Resources)"
.sp
صفحه اصلی پروژه ابزارهای یوپی‌اس تحت شبکه (NUT): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5