نام (NAME)

upsrw - ابزار مدیریت متغیرهای دستگاه/درایور Network UPS Tools

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

upsrw [-l] ups

upsrw -h

upsrw -s variable [-u username] [-p password] [-w] [-t <timeout>] ups

توضیحات (DESCRIPTION)

برنامه upsrw به شما امکان می‌دهد متغیرهای خواندنی/نوشتنی (read/write) درون یوپی‌اس (UPS) خود را مشاهده کرده و تغییر دهید. این ابزار از طریق سرور upsd(8) دستوراتی را به درایور شما ارسال می‌کند که سخت‌افزار را برای شما پیکربندی می‌نماید. شما باید از اعتبارنامه‌های تعریف‌شده در فایل upsd.users(5) در آن سرور داده با مجوزهای مناسب استفاده کنید.

فهرست متغیرهایی که اجازه تغییر مقادیرشان را به شما می‌دهند، بر اساس قابلیت‌های تجهیزات UPS شما است. همه مدل‌ها از این ویژگی پشتیبانی نمی‌کنند. معمولاً سخت‌افزارهای ارزان‌تر از هیچ‌یک از آن‌ها پشتیبانی نمی‌کنند. برای اینکه ببینید چه مواردی برای شما کار خواهند کرد، upsrw را با یک شناسه UPS اجرا کنید.

گزینه‌ها (OPTIONS)

-s variable

مشخص کردن متغیری که باید درون UPS تغییر داده شود. برای حالت خودکار (بدون نظارت) مانند اسکریپت‌های پوسته، از قالب VAR=VALUE برای تعیین هم‌زمان متغیر و مقدار استفاده کنید، برای مثال:

-s input.transfer.high=129

بدون این آرگومان، upsrw صرفاً فهرست متغیرها و مقادیر ممکن آن‌ها را نمایش می‌دهد.

برخی از متغیرها رشته‌ای (string) هستند و می‌توان آن‌ها را روی هر مقداری درون محدودیت طول تنظیم کرد. برخی دیگر از انواع شمارشی (enumerated) هستند و تنها می‌توان آن‌ها را روی یکی از آن مقادیر قرار داد. برخی دیگر نیز ممکن است در یک محدوده مجاز از مقادیر باشند. برای اطلاع از اینکه چه مواردی در سخت‌افزار شما موجود است، به فهرست مراجعه کنید.

-l

صرفاً فهرست متغیرها و مقادیر ممکن آن‌ها را نمایش می‌دهد.

مشابه عملکرد پیش‌فرض بدون آرگومان -s است که برای حفظ سازگاری و شباهت رابط خط فرمان (CLI) با سایر ابزارها ارائه شده است.

-u username

تنظیم نام کاربری NUT برای اتصال به سرور. این گزینه اختیاری است و اگر هنگام استفاده از گزینه -s آن را در خط فرمان با -u مشخص نکنید، از شما درخواست خواهد شد. نام‌های کاربری NUT در upsd.users(5) تعریف می‌شوند و به نام‌های کاربری سیستم مرتبط نیستند.

-p password

تنظیم گذرواژه برای احراز هویت در سرور. این مورد نیز مانند -u اختیاری است و در صورت نیاز از شما درخواست خواهد شد.

-w

صبر کردن تا اجرای تنظیمات توسط درایور تکمیل شود و نتیجه واقعی آن از دستگاه بازگردانده شود. توجه داشته باشید که این ویژگی نیازمند آن است که هم upsd(8) و هم درایور از قابلیت TRACKING پشتیبانی کنند (NUT نسخه 2.8.0 یا بالاتر)، در غیر این صورت با شکست مواجه می‌شود.

این دستور همچنین تا زمانی که نتیجه واقعی از درایور دریافت شود یا مهلت زمانی به پایان برسد مسدود (block) خواهد شد (به -t مراجعه کنید).

-t seconds

تنظیم مهلت زمانی (timeout) هنگام استفاده از -w. مقدار پیش‌فرض ۱۰ ثانیه است.

ups

مشاهده یا تغییر تنظیمات این UPS. قالب این گزینه به صورت upsname[@hostname[:port]] است. نام میزبان پیش‌فرض "localhost" است.

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

-h

نمایش پیام راهنمای خط فرمان.

-D

افزایش سطح اشکال‌زدایی (debugging). برای دریافت جزئیات بیشتر، از این گزینه چندین بار استفاده کنید. متغیر محیطی اختیاری NUT_DEBUG_LEVEL را بازنویسی می‌کند.

-V

نمایش بنر نسخه NUT. جزئیات بیشتر ممکن است با اجرای دستور export NUT_DEBUG_LEVEL=1 یا سطوح پرگویی بیشتر در دسترس باشد.

-W secs

تنظیم مهلت زمانی (timeout) برای اتصالات اولیه شبکه (به طور پیش‌فرض به صورت نامحدود غیرمسدودکننده هستند، یا تا زمانی که سیستم تلاش را متوقف کند). متغیر محیطی اختیاری NUT_DEFAULT_CONNECT_TIMEOUT را بازنویسی می‌کند.

حالت بدون نظارت (UNATTENDED MODE)

اگر این برنامه را درون یک اسکریپت پوسته یا موارد مشابه برای تنظیم متغیرها اجرا می‌کنید، باید تمام اطلاعات را در خط فرمان مشخص کنید. این به معنای استفاده از -s VAR=VALUE، -u و -p است. در غیر این صورت برنامه درخواستی (prompt) برای ورودی نمایش می‌دهد و برنامه شما متوقف خواهد شد.

این امر هنگام نمایش فهرست نیازی نیست، زیرا برای حالت فقط‌خواندنی به نام کاربری و گذرواژه احتیاجی وجود ندارد.

علاوه بر این، اگر این برنامه را درون یک اسکریپت پوسته یا موارد مشابه اجرا می‌کنید، تنها باید استفاده از خروجی استاندارد (stdout) را در نظر بگیرید، نه خروجی خطا (stderr).

عیب‌یابی (DIAGNOSTICS)

دستور upsrw نمی‌تواند متغیرها را روی UPS شما تنظیم کند مگر اینکه یک نام کاربری و گذرواژه معتبر ارائه دهید. اگر خطای "access denied" دریافت کردید، مطمئن شوید که فایل upsd.users(5) شما دارای مدخلی برای شما است و نام کاربری که استفاده می‌کنید دارای مجوزهای SET برای متغیرها می‌باشد.

اجرای upsrw بدون گزینه -w تا حدودی به طور گمراه‌کننده‌ای عبارت "OK" را نمایش می‌دهد که صرفاً به این معناست که اتصال به سرور داده برقرار شده و سرور بلافاصله درخواست را به دلیل مواردی مانند نام متغیر ناشناخته درایور رد نکرده است. اگر می‌خواهید نتایج واقعی را بدانید، حتماً از گزینه(های) -w (-t NUM) برای منتظر ماندن جهت دریافت آن‌ها استفاده کنید.

قالب مقدار (VALUE FORMAT)

هنگام استفاده از upsrw برای تغییر یک مقدار عددی ممیز شناور (float)، آن مقادیر باید با استفاده از نمایش اعشاری (مبنای ۱۰) مبتنی بر انگلیسی، یعنی با استفاده از نقطه، و در نماد غیرعلمی ارائه شوند. بنابراین استفاده از مقادیر هگزادسیمال، نمایی و کاما به عنوان جداکننده هزارگان ممنوع است.

برای مثال: "1200.20" معتبر است، در حالی که "1,200.20" و "1200,20" نامعتبر هستند.

تاریخچه (HISTORY)

این برنامه در گذشته upsct2 نامیده می‌شد، نامی که مبهم و گیج‌کننده بود.

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

upsd(8), upscmd(8)

منابع اینترنتی:

صفحه اصلی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5/