'\" t
.\"     Title: upscmd
.\"    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 "UPSCMD" "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)"
upscmd \- ابزار مدیریت دستورات فوری دستگاه/درایور در ابزارهای یوپی‌اس شبکه (NUT)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBupscmd\fR \-h
.sp
\fBupscmd\fR \-l \fIups\fR
.sp
\fBupscmd\fR [\-u \fIusername\fR] [\-p \fIpassword\fR] [\-w] [\-t <timeout>] \fIups\fR \fIcommand\fR
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBupscmd\fR به شما امکان می‌دهد «دستورات فوری» (instant commands) را در سخت‌افزار یوپی‌اس (UPS) خود فراخوانی و اجرا کنید\&. این ابزار دستورات را از طریق سرور \fBupsd\fR(8) به درایور مربوطه ارسال می‌کند، که سخت‌افزار را برای شما مدیریت می‌نماید\&. شما باید از اعتبارنامه‌های تعریف‌شده در فایل \fBupsd.users\fR(5) بر روی آن سرور داده با مجوزهای مناسب استفاده کنید\&.
.sp
همه سخت‌افزارها از این قابلیت پشتیبانی نمی‌کنند، بنابراین لیست را با گزینه \-l بررسی کنید تا ببینید آیا دستوری روی تجهیزات شما کار می‌کند یا خیر\&.
.sp
روی سخت‌افزارهایی که پشتیبانی می‌کنند، می‌توانید از این برنامه برای شروع و توقف آزمایش‌های باتری، فراخوانی تست پنل جلویی (بوق!)، روشن یا خاموش کردن بار الکتریکی (load) و موارد دیگر استفاده کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-l\fR \fIups\fR
.RS 4
نمایش فهرست دستورات فوری پشتیبانی‌شده در آن یوپی‌اس\&. برخی سخت‌افزارها ممکن است از هیچ‌یک از آن‌ها پشتیبانی نکنند\&.
.RE
.PP
\fB\-u\fR \fIusername\fR
.RS 4
تنظیم نام کاربری برای اتصال به سرور\&. این گزینه اختیاری است و اگر از \-u استفاده نشود، هنگام فراخوانی دستور از شما درخواست خواهد شد\&.
.RE
.PP
\fB\-p\fR \fIpassword\fR
.RS 4
تنظیم گذرواژه جهت احراز هویت در سرور\&. این مورد نیز مانند \-u اختیاری است و در صورت نیاز از شما پرسیده خواهد شد\&.
.RE
.PP
\fB\-w\fR
.RS 4
صبر کردن برای تکمیل اجرای دستور توسط درایور و بازگرداندن نتیجه واقعی از دستگاه\&. توجه داشته باشید که این ویژگی نیازمند آن است که هم
\fBupsd\fR(8)
و هم درایور از قابلیت TRACKING پشتیبانی کنند (NUT نسخه 2\&.8\&.0 یا بالاتر)، در غیر این صورت با شکست مواجه می‌شود\&.
.sp
همچنین تا زمانی که نتیجه واقعی از درایور ارائه شود، یا زمان مهلت به پایان برسد (گزینه
\fB\-t\fR
را ببینید)، این دستور متوقف و مسدود (block) خواهد ماند\&.
.RE
.PP
\fB\-t\fR \fIseconds\fR
.RS 4
تنظیم زمان مهلت (timeout) بر حسب ثانیه هنگام استفاده از
\fB\-w\fR\&. مقدار پیش‌فرض 10 ثانیه است\&.
.RE
.PP
\fIups\fR
.RS 4
اتصال به این یوپی‌اس\&. قالب به صورت
upsname[@hostname[:port]]
است\&. نام میزبان پیش‌فرض "localhost" می‌باشد\&.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
\fB\-h\fR
.RS 4
نمایش پیام راهنمای خط فرمان\&.
.RE
.PP
\fB\-D\fR
.RS 4
افزایش سطح اشکال‌زدایی (debugging)\&. برای جزئیات بیشتر این گزینه را چندین بار به کار ببرید\&. این گزینه بر متغیر محیطی اختیاری
NUT_DEBUG_LEVEL
اولویت دارد\&.
.RE
.PP
\fB\-V\fR
.RS 4
نمایش مشخصات و نسخه NUT\&. اگر متغیر محیطی
export NUT_DEBUG_LEVEL=1
یا سطوح بالاتر پرحرفی را نیز تنظیم کنید، جزئیات بیشتری نمایش داده می‌شود\&.
.RE
.PP
\fB\-W\fR \fIsecs\fR
.RS 4
تنظیم زمان مهلت برای اتصالات اولیه شبکه (به طور پیش‌فرض بدون انسداد نامحدود هستند، یا تا زمانی که سیستم تلاش را قطع کند)\&. بر متغیر محیطی اختیاری
NUT_DEFAULT_CONNECT_TIMEOUT
اولویت دارد\&.
.RE
.SH "حالت بدون نظارت (UNATTENDED MODE)"
.sp
اگر این برنامه را در داخل یک اسکریپت شل یا برنامه‌ای مشابه برای اجرای دستور اجرا می‌کنید، باید تمام اطلاعات را در خط فرمان مشخص کنید\&. این به معنای استفاده از \-u و \-p است\&. در غیر این صورت، اعلان ورود ظاهر شده و برنامه شما معلق خواهد ماند\&.
.sp
هنگام نمایش فهرست (گزینه \-l) نیازی به این کار نیست، زیرا نام کاربری و گذرواژه برای حالت فقط‌خواندنی الزامی نیستند\&.
.sp
علاوه بر این، اگر این برنامه را درون اسکریپت شل یا موارد مشابه اجرا می‌کنید، باید خروجی stdout را در نظر بگیرید، نه stderr را\&.
.SH "دستورات خطرناک (DANGEROUS COMMANDS)"
.sp
برخی درایورها مانند \fBapcsmart\fR(8) دارای حساسیت و وسواس درونی برای دستورات خطرناک مانند load\&.off هستند\&. برای وادار کردن آن‌ها به قطع واقعی بار الکتریکی، باید دستور را دوبار در یک بازه زمانی کوتاه ارسال کنید\&. یعنی یک بار آن را بفرستید، سپس پس از گذشت ۳ ثانیه و قبل از سپری شدن ۱۵ ثانیه، دوباره آن را ارسال کنید\&.
.sp
این رفتار احتیاطی کاملاً در داخل درایور تعریف شده است\&. ابزارهای upsd و upscmd کنترلی روی زمان‌بندی آن ندارند\&.
.SH "عیب‌یابی (DIAGNOSTICS)"
.sp
برنامه \fBupscmd\fR کار نخواهد کرد مگر اینکه نام کاربری و گذرواژه معتبری ارائه دهید\&. اگر خطای «دسترسی رد شد» (access denied) دریافت کردید، مطمئن شوید که فایل \fBupsd.users\fR(5) شامل رکوردی برای شما است، و نام کاربری که استفاده می‌کنید مجوز تنظیم متغیرها (SET) را دارد\&.
.sp
دستور \fBupscmd\fR بدون گزینه \fI\-w\fR ممکن است با کمی ابهام عبارت "OK" را نمایش دهد، که صرفاً به این معناست که اتصال با سرور داده برقرار شده و سرور بلافاصله درخواست را (به دلیل مواردی چون نام نامعتبر دستور) رد نکرده است\&. اگر مایلید از نتایج واقعی آگاه شوید، از گزینه(های) \-w (\-t NUM) برای انتظار نتایج استفاده کنید\&.
.SH "اشکالات (BUGS)"
.sp
در حال حاضر راهی وجود ندارد که به کاربر اعلام شود چه زمانی درایور برای فراخوانی دستوری مانند load\&.off به تاییدیه نیاز دارد\&.
.sp
این موضوع در لیست مواردی است که باید در آینده برطرف شوند، پس نگران نباشید؛ این کار شامل کوکی‌های جادویی (magic cookies) خواهد بود\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsd\fR(8), \fBupsrw\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه اصلی NUT (ابزارهای یوپی‌اس شبکه): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5