'\" t
.\"     Title: upsset.cgi
.\"    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 "UPSSET\&.CGI" "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)"
upsset.cgi \- برنامه تحت وب CGI برای تغییر متغیرهای یوپی‌اس در NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBupsset\&.cgi\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
به عنوان یک برنامه CGI، این برنامه باید از طریق وب‌سرور شما فراخوانی شود\&. اگر آن را از خط فرمان اجرا کنید، همان‌جا معطل می‌ماند تا زمانی که ورودی شبیه به یک درخواست POST به آن بدهید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
\fBupsset\&.cgi\fR یک کلاینت خواندنی/نوشتنی NUT است که به شما امکان می‌دهد از مرورگر وب خود به بسیاری از عملکردهای مدیریتی درون نرم‌افزار یوپی‌اس دسترسی داشته باشید\&. در صورت در دسترس بودن، می‌توانید تنظیمات را تغییر دهید و دستورات آنی را فراخوانی کنید\&.
.sp
برای جزئیات بیشتر درباره پیکربندی برخی از وب‌سرورهای پرکاربرد جهت اجرای برنامه‌های CGI در NUT، لطفاً صفحه \fBupsset.conf\fR(5) را ببینید\&.
.SH "تغییر تنظیمات (CHANGING SETTINGS)"
.sp
برخی از سخت‌افزارهای یوپی‌اس به شما اجازه می‌دهند متغیرهای خاصی را به مقادیر دیگری تغییر دهید\&. برای مشاهده موارد در دسترس، یک یوپی‌اس را از بخش انتخاب برگزیده و گزینه "settings" را انتخاب کنید، سپس "View" را برای به‌روزرسانی صفحه بزنید\&.
.sp
باید فهرستی از موارد را مشاهده کنید که توضیحات در سمت چپ و گزینه‌ها یا فیلدهای ورودی ممکن در سمت راست قرار دارند\&. پس از ایجاد هر تغییر، حتماً "Save changes" را بزنید تا مقادیر در یوپی‌اس شما به‌روزرسانی شوند\&.
.sp
اگر یوپی‌اس شما از هیچ متغیر خواندنی/نوشتنی پشتیبانی نکند، در این صفحه کاری برای انجام دادن وجود نخواهد داشت\&.
.sp
تنظیم مقادیر در متغیرهای خواندنی/نوشتنی را می‌توان از خط فرمان با \fBupsrw\fR(8) نیز انجام داد\&.
.SH "دستورات آنی (INSTANT COMMANDS)"
.sp
برخی از سخت‌افزارهای یوپی‌اس همچنین تمهیداتی برای انجام اقدامات خاص طبق دستور کاربر دارند\&. این موارد شامل آزمایش باتری، کالیبراسیون باتری، آزمایش‌های پنل جلو (بوق!) و موارد دیگر است\&. برای دسترسی به این بخش، مانند بالا عمل کنید، اما "Commands" را به عنوان عملکرد انتخاب نمایید\&.
.sp
اگر یوپی‌اس شما از دستورات آنی پشتیبانی کند، آن‌ها در یک ویجت انتخاب‌گر فهرست خواهند شد\&. موردی را که می‌خواهید انتخاب کرده و برای اجرا، گزینه "Issue command" را بزنید\&.
.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
برخی دستورات خطرناک مانند "Turn off load" ممکن است بلافاصله اجرا نشوند\&. این یک قابلیت است، نه یک باگ\&.
.sp .5v
.RE
.sp
درایور \fBapcsmart\fR(8) و برخی درایورهای دیگر نیازمند آن هستند که برای اجرای این دستور، آن را دو بار در یک بازه زمانی کوتاه ارسال کنید\&. این کار برای جلوگیری از خاموش کردن تصادفی سیستم‌های شما بر اثر انتخاب اشتباه است\&.
.sp
برای خاموش کردن واقعی بار (load)، باید دستور را یک بار ارسال کنید، سپس پس از گذشت ۳ ثانیه اما قبل از گذشت ۱۵ ثانیه دوباره آن را بفرستید\&. اگر خیلی سریع یا خیلی کند این کار را انجام دهید، باید مجدداً دست‌کم ۳ ثانیه اما نه بیشتر از ۱۵ ثانیه صبر کنید\&.
.sp
همچنین می‌توانید دستورات آنی را از طریق خط فرمان با \fBupscmd\fR(8) فراخوانی کنید\&.
.SH "کنترل دسترسی (ACCESS CONTROL)"
.sp
این برنامه دستورات و تنظیمات را از طریق سرور \fBupsd\fR(8) به درایور شما ارسال می‌کند که سخت‌افزار را برای شما مدیریت می‌نماید\&. شما باید از اعتبارنامه‌های تعریف‌شده در فایل \fBupsd.users\fR(5) در آن سرور داده با مجوزهای مناسب استفاده کنید\&.
.sp
برنامه upsset فقط با سرورهای \fBupsd\fR(8) ارتباط برقرار خواهد کرد که در فایل \fBhosts.conf\fR(5) شما تعریف شده باشند\&. اگر با خطای "Access to that host is not authorized" مواجه شدید، ابتدا فایل hosts\&.conf خود را بررسی کنید\&.
.SH "امنیت (SECURITY)"
.sp
برنامه upsset تا زمانی که مطمئن نشود دایرکتوری CGI شما ایمن‌سازی شده است اجرا نخواهد شد\&. این امر به دلیل احتمال سوءاستفاده از upsset برای آزمایش ترکیب‌های مختلف رمز عبور علیه سرور \fBupsd\fR(8) شما است\&.
.sp
برای اطلاعات بیشتر درباره نحوه انجام این کار، نمونه فایل upsset\&.conf را ببینید\&. توضیح کوتاه این است\(emاگر نمی‌توانید آن را ایمن و محدود کنید، برای اجرای آن تلاش نکنید\&.
.SH "فایل‌ها (FILES)"
.sp
\fBhosts.conf\fR(5), \fBupsset.conf\fR(5)
.SH "همچنین ببینید (SEE ALSO)"
.SS "منابع اینترنتی:"
.sp
صفحه خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5