'\" t
.\"     Title: clone
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: راهنمای NUT
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "CLONE" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "راهنمای NUT"
.\" -----------------------------------------------------------------
.\" * 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 \- کلون کردن یک UPS و در نظر گرفتن خروجی برق آن به عنوان یک UPS مستقل (با پشتیبانی از دستورات فوری خاموش‌سازی INSTCMD)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBclone\fR \-h
.sp
\fBclone\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 را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، \fBnutupsdrv\fR(8) را ببینید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
این درایور که روی فایل سوکت محلی UNIX درایور دیگر (یا پایپ نام‌گذاری‌شده Windows) قرار می‌گیرد، به کاربران اجازه می‌دهد کلاینت‌ها را به یک خروجی برق (outlet) خاص از یک دستگاه گروه‌بندی کنند و با این خروجی طوری رفتار نمایند که گویی یک UPS عادی است\&.
.sp
برخلاف درایور \fBclone-outlet\fR(8)، این درایور یک دستگاه قابل‌مدیریت را نشان می‌دهد که هم برای نظارت و هم برای خاموش‌سازی کامپیوترهای کلاینت و خروجی UPS/ePDU قابل استفاده است (از ارسال دستورات فوری مرتبط در زمان اجرا پشتیبانی می‌کند)\&.
.sp
برخلاف \fBdummy-ups\fR(8)، این درایور نیازی به اجرای سرور داده upsd یا استفاده از پروتکل تحت شبکه NUT برای گفتگو با درایور «واقعی» ندارد (که در حالت تکرارکننده یا repeater درایور dummy\-ups ممکن است ریموت باشد)\&.
.sp
این درایور یک دستگاه مجازی کاملاً جدید ایجاد نمی‌کند، بلکه برخی از مقادیر خوانده‌شده اصلی که توسط درایور «واقعی» گزارش شده است را با استفاده از اطلاعات خروجی مشخص‌شده جایگزین یا گسترش می‌دهد و تمام مقادیر دیگر را همان‌طور که بودند بازپخش (relay) می‌کند\&.
.sp
کلاینت‌های راه دور مانند upsmon می‌توانند مدخل دستگاه ارائه‌شده توسط سرور داده را در حالی که این درایور (و درایور «واقعی») در حال اجرا و منتشرشده هستند، با دستور MONITOR پایش کنند\&.
.sp
یک استقرار بزرگ‌تر با یک یا چند دستگاه با اولویت پایین‌تر که روی یک خروجی قابل‌مدیریت از UPS یا ePDU تجمیع شده‌اند، احتمالاً چندین درایور راه‌اندازی‌شده روی سیستمی خواهد داشت که در واقع قادر به تعامل با UPS و اجرای سرور داده NUT یعنی \fBupsd\fR(8) است (و احتمالاً از یک خروجی دیگر تغذیه می‌شود):
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک درایور «واقعی» که با UPS ارتباط برقرار می‌کند؛
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک درایور
clone
که با درایور «واقعی» گفتگو می‌کند و بر اساس آستانه‌های نسبتاً بالای شارژ باتری باقی‌مانده و/یا زمان کارکرد UPS واقعی (یا دستورات فوری صریح)، دستور قطع برق خروجی (یا بازنشانی برق/power-cycle) را صادر می‌کند؛ چنین عملیاتی ابتدا تایمرهای مربوطه را برای خروجی روی درایور «واقعی» تنظیم کرده و پرچم "FSD" را در میان وضعیت‌های UPS مجازی قرار می‌دهد؛
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
احتمالاً یک درایور
clone\-outlet
که فقط‌خواندنی است و مقادیر تایمر خروجی را به عنوان محرک‌هایی برای پرچم‌های "FSD" یا "OFF" گزارش‌شده در میان وضعیت‌های UPS مجازی تفسیر می‌کند\&.
.RE
.sp
با این رویکرد، سیستم‌های با اولویت پایین‌تر متصل به چنین خروجی، کلاینت NUT یعنی \fBupsmon\fR(8) را اجرا می‌کنند تا UPS مجازی ارائه‌شده توسط درایور فقط‌خواندنی clone\-outlet را MONITOR کنند و به محض بالا رفتن پرچم "FSD" (نسبتاً زود، بر اساس آستانه‌های شارژ و/یا زمان کارکرد پیکربندی‌شده برای آن درایور) خاموش شوند، که به دستگاه‌های با اولویت بالاتر (احتمالاً شامل سرور NUT) اجازه می‌دهد از عمر باتری طولانی‌تری بهره‌مند شوند\&.
.sp
درایور clone که مسئول تغییرات وضعیت برق خروجی است معمولاً مستقیماً مانیتور نمی‌شود (به عنوان مثال برای جلوگیری از درخواست‌های ناخواسته خاموش‌سازی مستقیم از سوی آن کلاینت‌ها)، هرچند در شبکه‌هایی با اعتماد کافی می‌توان آن را (به جای clone\-outlet) مستقیماً پایش کرد\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات زیر پشتیبانی می‌کند:
.PP
\fBport\fR=\fIdrivername\-devicename\fR
.RS 4
الزامی\&. تنظیم استاندارد
port
در درایور NUT، در اینجا نام فایل سوکت محلی Unix (یا پایپ نام‌گذاری‌شده Windows) را برای اتصال به درایور دستگاه «واقعی» مشخص می‌کند\&.
.RE
.PP
\fBload\&.off\fR=\fIcommand\fR
.RS 4
توصیه‌شده\&. دستوری را روی درایور UPS «واقعی» تنظیم می‌کند که برای خاموش کردن خروجی استفاده می‌شود\&. برای قطع و وصل مجدد برق (power cycle) خروجی، به هر دو گزینه
\fBload\&.off\fR
و
\fBload\&.on\fR
نیاز دارید\&. در غیر این صورت، خاموش کردن کلاینت‌هایی که از یک خروجی تغذیه می‌شوند یک‌طرفه خواهد بود (بخش
IMPORTANT
را ببینید)\&.
.RE
.PP
\fBload\&.on\fR=\fIcommand\fR
.RS 4
توصیه‌شده\&. دستوری را روی درایور UPS «واقعی» تنظیم می‌کند که برای روشن کردن خروجی استفاده می‌شود\&. برای قطع و وصل مجدد برق (power cycle) خروجی، به هر دو گزینه
\fBload\&.off\fR
و
\fBload\&.on\fR
نیاز دارید\&. در غیر این صورت، خاموش کردن کلاینت‌هایی که از یک خروجی تغذیه می‌شوند یک‌طرفه خواهد بود (بخش
IMPORTANT
را ببینید)\&.
.RE
.PP
\fBload\&.status\fR=\fIvalue\fR
.RS 4
توصیه‌شده\&. متغیری را روی درایور UPS «واقعی» تعیین می‌کند که برای نشان دادن وضعیت خروجی (یعنی on/off) به کار می‌رود\&. اگر مشخص نشود، درایور clone تلاش خواهد کرد وضعیت خروجی را ردیابی کند، اما این روش قابلیت اطمینان کمتری دارد\&.
.RE
.PP
\fBoffdelay\fR=\fInum\fR
.RS 4
مدت‌زمان تایمر (به ثانیه) را قبل از خاموش شدن خروجی پس از برآورده شدن شرایط خاموشی (OB LB) برای این خروجی یا صدور دستور خاموش‌سازی، تنظیم می‌کند\&. پیش‌فرض ۱۲۰ ثانیه است\&.
.RE
.PP
\fBondelay\fR=\fInum\fR
.RS 4
مدت‌زمان تایمر (به ثانیه) را برای روشن شدن مجدد خروجی در صورتی که پس از خاموش شدن خروجی، برق بازگردد، تنظیم می‌کند\&. پیش‌فرض ۳۰ ثانیه است\&.
.RE
.PP
\fBmincharge\fR=\fIvalue\fR
.RS 4
میزان شارژ باقی‌مانده باتری (به درصد) را هنگامی که UPS کلون به وضعیت LB سوییچ می‌کند، تنظیم می‌کند\&.
.RE
.PP
\fBminruntime\fR=\fIvalue\fR
.RS 4
زمان کارکرد باقی‌مانده باتری (به ثانیه) را هنگامی که UPS کلون به وضعیت LB سوییچ می‌کند، تنظیم می‌کند\&.
.RE
.SH "پیاده‌سازی (IMPLEMENTATION)"
.sp
مشخصه port در \fBups.conf\fR(5) باید به سوکت محلی درایور (یا پایپ نام‌گذاری‌شده Windows) که درایور UPS «واقعی» استفاده می‌کند، ارجاع دهد\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
  [realups]
     driver = usbhid\-ups
     port = auto

  [clone\-outlet\-1]
     driver = clone
     port = usbhid\-ups\-realups
     load\&.on = outlet\&.1\&.load\&.on
     load\&.off = outlet\&.1\&.load\&.off
     load\&.status = outlet\&.1\&.status
     desc = "Outlet 1 of the Real UPS"
     [\&.\&.\&.]
.fi
.if n \{\
.RE
.\}
.sp
این درایور از دستورات فوری (instant commands) برای آغاز یک خاموش‌سازی اجباری (forced shutdown) برای upsmon یا کلاینت‌های مشابه که این دستگاه UPS مجازی را MONITOR می‌کنند، پشتیبانی می‌کند؛ در صورتی که وضعیت خروجی در حال حاضر \fIon\fR باشد و هیچ خاموش‌سازی دیگری تاکنون آغاز نشده باشد (با تنظیم تایمر تاخیر خاموش‌سازی UPS مجازی روی offdelay و صدور FSD از طریق ups\&.status):
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
shutdown\&.return \(em روشن کردن مجدد برق خروجی پس از
ondelay؛
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
shutdown\&.stayoff \(em نگه داشتن خروجی در حالت
\fIoff\fR\&.
.RE
.sp
چنین دستوراتی با استفاده از پروتکل سوکت NUT (با استفاده از نام دستورات مشخص‌شده در گزینه‌های پیکربندی درایور load\&.off و load\&.on) به درایور «واقعی» ارسال می‌شوند، مشروط بر اینکه تایمرهای خاموش‌سازی یا راه‌اندازی در آن لحظه تنظیم شده باشند، یا دستگاه «واقعی» برخط (online) نبوده و شارژ باتری یا زمان کارکرد شناخته‌شده آن زیر آستانه‌های پیکربندی‌شده "low" باشد\&.
.sp
وضعیت خروجی با استفاده از نام مشخص‌شده توسط گزینه load\&.status درایور (در صورت تنظیم) تعیین می‌شود، یا صرفاً بر اساس آخرین عملیات خاموش‌سازی/راه‌اندازی تکمیل‌شده (با استفاده از شماره خروجی نامشخص) فرض می‌شود\&.
.sp
این درایور از عملیات خاموش‌سازی معمول دستگاه‌های NUT پشتیبانی نمی‌کند (اجرای clone \-k فقط یک خطا چاپ کرده و خارج می‌شود)\&.
.sp
این درایور همچنین از تنظیم برخی متغیرهای NUT در زمان اجرا پشتیبانی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
battery\&.charge\&.low \(em به گزینه
mincharge
در گزینه‌های درایور مراجعه کنید؛
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
battery\&.runtime\&.low \(em به گزینه
minruntime
در گزینه‌های درایور مراجعه کنید\&.
.RE
.sp
در مقایسه با مقادیر درایور «واقعی»، این درایور داده‌های زیر را نیز اضافه (یا بازنویسی) می‌کند: ups\&.delay\&.shutdown، ups\&.delay\&.start، ups\&.timer\&.shutdown و ups\&.timer\&.start\&. این درایور مقادیر درایور «واقعی» برای battery\&.charge و battery\&.runtime (خوانش‌های واقعی کنونی) را ردیابی می‌کند تا بعداً درباره خاموش‌سازی خودکار خروجی تصمیم‌گیری کند\&.
.SH "مهم (IMPORTANT)"
.sp
برخلاف یک UPS واقعی، شما \fBنباید\fR حالت اصلی (primary) در upsmon را برای این درایور پیکربندی کنید\&. هنگامی که یک نسخه اصلی \fBupsmon\fR(8) پرچم‌های OB LB را می‌بیند و به سرور داده \fBupsd\fR(8) اعلام می‌کند که آغاز توالی خاموش‌سازی بلامانع است، سرور وضعیت FSD را قفل (latch) می‌کند و راه‌اندازی مجدد سیستم‌های متصل بدون راه‌اندازی دوباره سرور upsd ممکن نخواهد بود\&.
.sp
اگر پس از اینکه UPS کلون توالی خاموش‌سازی را روی خروجی خود آغاز کرد اما پیش از اینکه UPS واقعی شروع به خاموش شدن کند، برق بازگردد، این مسئله مشکل‌ساز خواهد شد\&. راه‌حل در خود درایور clone نهفته است که در صورت نیاز، پرچم FSD را بدون کمک حالت اصلی upsmon درج خواهد کرد\&.
.SH "هشدارها (CAVEATS)"
.sp
دستگاه UPS کلون از وضعیت درایور UPS واقعی تبعیت خواهد کرد\&. شما فقط می‌توانید کاری کنید که UPS کلون زودتر از درایور UPS واقعی خاموش شود، نه دیرتر\&. اگر درایور UPS واقعی خاموش‌سازی را آغاز کند، درایور UPS کلون بلافاصله از آن تبعیت خواهد کرد\&.
.sp
توجه داشته باشید که دستورات خاموش‌سازی/راه‌اندازی مجدد یک خروجی در درایورهای UPS واقعی تحت تأثیر قرار نمی‌گیرند؛ بنابراین اگر به درایور UPS واقعی دستور دهید خروجی درایور UPS کلون را خاموش کند، کلاینت‌های شما بدون هشدار برق خود را از دست خواهند داد\&.
.sp
اگر از چارچوب‌های مدیریت سرویس مانند systemd یا SMF برای مدیریت وابستگی‌ها میان نمونه‌های درایور و سایر واحدها استفاده می‌کنید، ممکن است مجبور شوید وابستگی‌های خاصی را تنظیم کنید (مثلاً با فایل‌های قطعه‌کد "drop\-in" در systemd) تا درایورهای clone شما پس از درایورهای دستگاه «واقعی» در صف راه‌اندازی قرار گیرند\&.
.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-outlet\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 "منابع اینترنتی:"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5