'\" t
.\"     Title: apcupsd-ups
.\"    Author: [see the "AUTHOR" section]
.\" 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 "APCUPSD\-UPS" "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)"
apcupsd-ups \- درایور برای دسترسی به کلاینت apcupsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBapcupsd\-ups\fR \-h
.sp
\fBapcupsd\-ups\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\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
این صفحه راهنما تنها ویژگی‌های اختصاصی درایور \fBapcupsd\-ups\fR را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
این درایور یک کلاینت برای \fBapcupsd\fR (پروژه دیگری برای نظارت بر یوپی‌اس) است\&.
.sp
\fBapcupsd\-ups\fR به عنوان کلاینت \fBapcupsd\fR عمل می‌کند و صرفاً داده‌ها را بازارسال (فوروارد) می‌نماید\&. این درایور می‌تواند در مواردی که هر دو پروتکل در یک شبکه مورد نیاز هستند، یا زمانی که پایگاه کد apcupsd دارای حالت دسترسی خاصی به یوپی‌اس است که در NUT وجود ندارد، مفید باشد\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر در \fBnut.conf\fR(5) پشتیبانی می‌کند:
.PP
\fBport\fR=<hostname>[:<port>]
.RS 4
این گزینه نام یک میزبان دوردست است که apcupsd را اجرا می‌کند (به همراه یک پورت اختیاری)\&.
.RE
.sp
برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
[apcupsd]
        driver = apcupsd\-ups
        port = localhost
        desc = "apcupsd client"
.fi
.if n \{\
.RE
.\}
.sp
برای آدرس‌های IPv6، برای بخش نام میزبان (hostname) از قلاب استفاده کنید (تا دونقطه‌های موجود در آن به عنوان پورت اشتباه گرفته نشوند، به ویژه در صورت استفاده از پورت پیش‌فرض):
.sp
.if n \{\
.RS 4
.\}
.nf
[apcupsd]
        driver = apcupsd\-ups
        port = "[::1]:3551"
        desc = "apcupsd client"
.fi
.if n \{\
.RE
.\}
.SH "پیش‌زمینه (BACKGROUND)"
.sp
این درایور در ابتدا در طول یک عصر برای امکان‌پذیر ساختن تعامل‌پذیری با \fBapcupsd\fR نوشته شد\&.
.SH "متغیرهای پشتیبانی‌شده (SUPPORTED VARIABLES)"
.sp
متغیرهای زیر از \fBapcupsd\fR به NUT ترجمه می‌شوند\&. تمام زمان‌ها باید به ثانیه تبدیل شوند (در صورت مشاهده عدم تطابق در واحدها، لطفاً یک گزارش اشکال ثبت کنید)\&.
.TS
allbox tab(:);
ltB ltB.
T{
متغیر apcupsd
T}:T{
متغیر(های) NUT
T}
.T&
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
.sp
BCHARGE
T}:T{
.sp
battery\&.charge
T}
T{
.sp
MBATTCHG
T}:T{
.sp
battery\&.charge\&.low
T}
T{
.sp
RETPCT
T}:T{
.sp
battery\&.charge\&.restart
T}
T{
.sp
BATTDATE
T}:T{
.sp
battery\&.date
T}
T{
.sp
TIMELEFT
T}:T{
.sp
battery\&.runtime
T}
T{
.sp
MINTIMEL
T}:T{
.sp
battery\&.runtime\&.low
T}
T{
.sp
BATTV
T}:T{
.sp
battery\&.voltage
T}
T{
.sp
NOMBATTV
T}:T{
.sp
battery\&.voltage\&.nominal
T}
T{
.sp
LINEFREQ
T}:T{
.sp
input\&.frequency
T}
T{
.sp
SENSE
T}:T{
.sp
input\&.sensitivity
T}
T{
.sp
HITRANS
T}:T{
.sp
input\&.transfer\&.high
T}
T{
.sp
LOTRANS
T}:T{
.sp
input\&.transfer\&.low
T}
T{
.sp
LASTXFER
T}:T{
.sp
input\&.transfer\&.reason
T}
T{
.sp
LINEV
T}:T{
.sp
input\&.voltage
T}
T{
.sp
MAXLINEV
T}:T{
.sp
input\&.voltage\&.maximum
T}
T{
.sp
MINLINEV
T}:T{
.sp
input\&.voltage\&.minimum
T}
T{
.sp
NOMINV
T}:T{
.sp
input\&.voltage\&.nominal
T}
T{
.sp
LINEFREQ
T}:T{
.sp
output\&.frequency
T}
T{
.sp
OUTPUTV
T}:T{
.sp
output\&.voltage
T}
T{
.sp
NOMOUTV
T}:T{
.sp
output\&.voltage\&.nominal
T}
T{
.sp
DATE
T}:T{
.sp
ups\&.date, ups\&.time
T}
T{
.sp
DSHUTD
T}:T{
.sp
ups\&.delay\&.shutdown
T}
T{
.sp
DWAKE
T}:T{
.sp
ups\&.delay\&.start
T}
T{
.sp
FIRMWARE
T}:T{
.sp
ups\&.firmware, ups\&.firmware\&.aux
T}
T{
.sp
UPSNAME
T}:T{
.sp
ups\&.id
T}
T{
.sp
LOADPCT
T}:T{
.sp
ups\&.load
T}
T{
.sp
MANDATE
T}:T{
.sp
ups\&.mfr\&.date
T}
T{
.sp
NOMPOWER
T}:T{
.sp
ups\&.realpower\&.nominal
T}
T{
.sp
SERIALNO
T}:T{
.sp
ups\&.serial
T}
T{
.sp
STATUS
T}:T{
.sp
ups\&.status
T}
T{
.sp
ITEMP
T}:T{
.sp
ups\&.temperature
T}
T{
.sp
STESTI
T}:T{
.sp
ups\&.test\&.interval
T}
T{
.sp
SELFTEST
T}:T{
.sp
ups\&.test\&.result
T}
.TE
.sp 1
.SH "محدودیت‌ها (LIMITATIONS)"
.sp
دسترسی به \fBapcupsd\fR اکیداً فقط‌خواندنی است: هیچ دستوری را نمی‌توان صادر کرد\&. این محدودیت از طراحی \fBapcupsd\fR ناشی می‌شود که در آن تنظیمات در \fBapctest\fR تغییر می‌یابند\&. برای اجرای \fBapctest\fR، سرویس \fBapcupsd\fR باید متوقف شود (و این در واقع \fBapcupsd\fR است که یوپی‌اس را در شبکه و برای این درایور NUT به عنوان کلاینت آن در دسترس قرار می‌دهد)\&.
.SH "نویسنده (AUTHOR)"
.sp
Andreas Steinmetz
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBups.conf\fR(5), \fBnutupsdrv\fR(8)
.SS "منابع اینترنتی (Internet Resources):"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی NUT (Network UPS Tools):
https://www\&.networkupstools\&.org/historic/v2\&.8\&.5/
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی apcupsd:
http://www\&.apcupsd\&.org/
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
به نظر می‌رسد توسعه خود پروژه
\fBapcupsd\fR
در سال‌های ۲۰۱۶/۲۰۱۷ متوقف شده است و انتشار نسخه 3\&.14\&.14 آخرین برچسب رسمی آن است\&. با این وجود، گفتگوهای انجمن آن همچنان کاملاً فعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جهت اطمینان، یک کپی از سورس‌های آن در آدرس زیر نگهداری می‌شود:
https://github\&.com/networkupstools/apcupsd
.RE
.RE