'\" t
.\"     Title: upsc
.\"    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
.\"    Source: Network UPS Tools 2\&.8\&.5
.\"  Language: Persian
.\"
.TH "UPSC" "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)"
upsc \- کلاینت سبک و فقط‌خواندنی برای NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBupsc\fR [\-j] \-l | \-L [\fIhost\fR]
.sp
\fBupsc\fR [\-j] \fIups\fR [\fIvariable\fR]
.sp
\fBupsc\fR [\-j] \-c \fIups\fR
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBupsc\fR به عنوان روشی سریع برای دریافت وضعیت یک سرور یوپی‌اس (UPS) ارائه شده است\&. این ابزار را می‌توان درون اسکریپت‌های پوسته و سایر برنامه‌هایی که به داده‌های UPS نیاز دارند اما نمی‌خواهند رابط کاربری کامل را پیاده‌سازی کنند، استفاده کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-j\fR
.RS 4
خروجی نتایج در قالب JSON\&. این گزینه خروجی متنی استاندارد را دور می‌زند و یک شیء JSON در
stdout
چاپ می‌کند\&. ساختار JSON به حالت اجرا بستگی دارد:
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
`upsc \-j \-l`: آرایه‌ای JSON از نام‌های UPS را برمی‌گرداند\&.
`upsc \-j \-L`: شیء JSON شامل نگاشت نام‌های UPS به توضیحات آن‌ها را برمی‌گرداند\&.
`upsc \-j <ups>`: شیء JSON شامل تمام متغیرها و مقادیر آن‌ها را برمی‌گرداند\&.
`upsc \-j <ups> <variable>`: یک رشته JSON منفرد (مقدار) را برمی‌گرداند\&.
`upsc \-j \-c <ups>`: آرایه‌ای JSON از آدرس‌های کلاینت‌ها را برمی‌گرداند\&.
.fi
.if n \{\
.RE
.\}
.PP
\fB\-l\fR \fIhost\fR
.RS 4
فهرست کردن تمام نام‌های UPS پیکربندی‌شده در
\fIhost\fR، یک نام در هر خط\&. نام میزبان به طور پیش‌فرض "localhost" است\&. می‌توانید به صورت اختیاری دو نقطه و یک شماره پورت را اضافه کنید\&.
.RE
.PP
\fB\-L\fR \fIhost\fR
.RS 4
همانند بالا، فهرست کردن تمام نام‌های UPS پیکربندی‌شده در
\fIhost\fR، شامل توضیحات ارائه‌شده توسط
\fBupsd\fR(8)
دوردست از فایل
\fBups.conf\fR(5)
آن\&. نام میزبان به طور پیش‌فرض "localhost" است\&. می‌توانید به صورت اختیاری دو نقطه و یک شماره پورت برای بازنویسی پورت پیش‌فرض اضافه کنید\&.
.RE
.PP
\fB\-c\fR \fIups\fR
.RS 4
فهرست کردن هر کلاینت متصل به
\fIups\fR، یک نام در هر خط\&.
.RE
.PP
\fIups\fR
.RS 4
نمایش وضعیت آن UPS\&. قالب این گزینه به صورت
\fIupsname[@hostname[:port]]\fR
است\&. نام میزبان پیش‌فرض "localhost" است\&.
.RE
.PP
\fIvariable\fR
.RS 4
فقط مقدار این متغیر را نمایش می‌دهد\&. به طور پیش‌فرض،
upsc
فهرست متغیرها را از سرور دریافت کرده و سپس مقدار هر یک را نمایش می‌دهد\&. این گزینه ممکن است در اسکریپت‌های پوسته برای صرفه‌جویی در لوله‌کشی (pipe) اضافی به
grep
مفید باشد\&.
.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
تنظیم مهلت زمانی (timeout) برای اتصالات اولیه شبکه (به طور پیش‌فرض به صورت نامحدود غیرمسدودکننده هستند، یا تا زمانی که سیستم تلاش را متوقف کند)\&. متغیر محیطی اختیاری
NUT_DEFAULT_CONNECT_TIMEOUT
را بازنویسی می‌کند\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای فهرست کردن تمام متغیرهای یک UPS به نام "myups" روی میزبان "mybox"، با اجرای \fBupsd\fR(8) روی پورت \fI1234\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
:; upsc myups@mybox:1234
battery\&.charge: 100\&.0
battery\&.voltage: 13\&.9
battery\&.voltage\&.nominal: 13\&.6
\&. \&. \&.
.fi
.if n \{\
.RE
.\}
.sp
برای دریافت تمام متغیرهای "myups" به صورت یک شیء JSON:
.sp
.if n \{\
.RS 4
.\}
.nf
:; upsc \-j myups@mybox:1234
{
  "battery\&.charge": "100\&.0",
  "battery\&.voltage": "13\&.9",
  "battery\&.voltage\&.nominal": "13\&.6",
  \&.\&.\&.
}
.fi
.if n \{\
.RE
.\}
.sp
برای فهرست کردن UPSهای پیکربندی‌شده روی این سیستم به همراه توضیحات آن‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
:; upsc \-L
apc: Back\-UPS 500
ppro2: Patriot Pro II
.fi
.if n \{\
.RE
.\}
.sp
برای دریافت وضعیت تمام UPSهای متصل به mybox با استفاده از ساختار دستور Bourne\-shell:
.sp
.if n \{\
.RS 4
.\}
.nf
:; for UPS in `upsc \-l mybox:1234`; do
    upsc $UPS ups\&.status
done
.fi
.if n \{\
.RE
.\}
.sp
برای فهرست کردن کلاینت‌های متصل به "myups":
.sp
.if n \{\
.RS 4
.\}
.nf
:; upsc \-c myups
127\&.0\&.0\&.1
::1
192\&.168\&.1\&.2
.fi
.if n \{\
.RE
.\}
.SH "حالت اسکریپتی (SCRIPTED MODE)"
.sp
اگر این برنامه را درون یک اسکریپت پوسته یا موارد مشابه برای دریافت فهرست دستگاه‌ها و متغیرها اجرا می‌کنید، باید تنها از خروجی stdout استفاده کنید، نه stderr\&.
.SH "عیب‌یابی (DIAGNOSTICS)"
.sp
برنامه upsc یا فهرستی از نام‌های UPS، فهرستی از تمام متغیرهای پشتیبانی‌شده و مقادیر آن‌ها در UPS، یا یک پیام خطا چاپ خواهد کرد\&. اگر خطایی دریافت کردید، اطمینان حاصل کنید که یک UPS معتبر را در خط فرمان مشخص کرده‌اید، \fBupsd\fR(8) واقعاً روی میزبان دیگر در حال اجرا است، و هیچ فایروالی مانع شما نمی‌شود\&.
.SH "تاریخچه (HISTORY)"
.sp
نسخه‌های پیشین این برنامه از کتابخانه \fIupsfetch\fR و سوکت‌های UDP برای گفتگو با upsd استفاده می‌کردند\&. این نسخه از upsc از کتابخانه جدید \fIupsclient\fR استفاده می‌کند که تنها از طریق TCP گفتگو می‌کند\&. به همین دلیل \fIupsct\fR دیگر وجود ندارد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupslog\fR(8), \fBups.conf\fR(5), \fBupsd\fR(8)
.SS "منابع اینترنتی:"
.sp
صفحه خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5