نام (NAME)

upsc - کلاینت سبک و فقط‌خواندنی برای NUT

خلاصه دستور (SYNOPSIS)

upsc [-j] -l | -L [host]

upsc [-j] ups [variable]

upsc [-j] -c ups

توضیحات (DESCRIPTION)

برنامه upsc به عنوان روشی سریع برای دریافت وضعیت یک سرور یوپی‌اس (UPS) ارائه شده است. این ابزار را می‌توان درون اسکریپت‌های پوسته و سایر برنامه‌هایی که به داده‌های UPS نیاز دارند اما نمی‌خواهند رابط کاربری کامل را پیاده‌سازی کنند، استفاده کرد.

گزینه‌ها (OPTIONS)

-j

`upsc -j -l`: آرایه‌ای JSON از نام‌های UPS را برمی‌گرداند.
`upsc -j -L`: شیء JSON شامل نگاشت نام‌های UPS به توضیحات آن‌ها را برمی‌گرداند.
`upsc -j <ups>`: شیء JSON شامل تمام متغیرها و مقادیر آن‌ها را برمی‌گرداند.
`upsc -j <ups> <variable>`: یک رشته JSON منفرد (مقدار) را برمی‌گرداند.
`upsc -j -c <ups>`: آرایه‌ای JSON از آدرس‌های کلاینت‌ها را برمی‌گرداند.

-l host

-L host

-c ups

ups

variable

گزینه‌های عمومی (COMMON OPTIONS)

-h

-D

-V

-W secs

مثال‌ها (EXAMPLES)

برای فهرست کردن تمام متغیرهای یک UPS به نام "myups" روی میزبان "mybox"، با اجرای upsd(8) روی پورت 1234:

:; upsc myups@mybox:1234
battery.charge: 100.0
battery.voltage: 13.9
battery.voltage.nominal: 13.6
. . .

برای دریافت تمام متغیرهای "myups" به صورت یک شیء JSON:

:; upsc -j myups@mybox:1234
{
  "battery.charge": "100.0",
  "battery.voltage": "13.9",
  "battery.voltage.nominal": "13.6",
  ...
}

برای فهرست کردن UPSهای پیکربندی‌شده روی این سیستم به همراه توضیحات آن‌ها:

:; upsc -L
apc: Back-UPS 500
ppro2: Patriot Pro II

برای دریافت وضعیت تمام UPSهای متصل به mybox با استفاده از ساختار دستور Bourne-shell:

:; for UPS in `upsc -l mybox:1234`; do
    upsc $UPS ups.status
done

برای فهرست کردن کلاینت‌های متصل به "myups":

:; upsc -c myups
127.0.0.1
::1
192.168.1.2

حالت اسکریپتی (SCRIPTED MODE)

اگر این برنامه را درون یک اسکریپت پوسته یا موارد مشابه برای دریافت فهرست دستگاه‌ها و متغیرها اجرا می‌کنید، باید تنها از خروجی stdout استفاده کنید، نه stderr.

عیب‌یابی (DIAGNOSTICS)

برنامه upsc یا فهرستی از نام‌های UPS، فهرستی از تمام متغیرهای پشتیبانی‌شده و مقادیر آن‌ها در UPS، یا یک پیام خطا چاپ خواهد کرد. اگر خطایی دریافت کردید، اطمینان حاصل کنید که یک UPS معتبر را در خط فرمان مشخص کرده‌اید، upsd(8) واقعاً روی میزبان دیگر در حال اجرا است، و هیچ فایروالی مانع شما نمی‌شود.

تاریخچه (HISTORY)

نسخه‌های پیشین این برنامه از کتابخانه upsfetch و سوکت‌های UDP برای گفتگو با upsd استفاده می‌کردند. این نسخه از upsc از کتابخانه جدید upsclient استفاده می‌کند که تنها از طریق TCP گفتگو می‌کند. به همین دلیل upsct دیگر وجود ندارد.

همچنین ببینید (SEE ALSO)

upslog(8), ups.conf(5), upsd(8)