'\" t
.\"     Title: nut-upower
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: English
.\"
.TH "NUT\-UPOWER" "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)"
nut-upower \- درایور پایش دستگاه‌های UPower از طریق D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnut\-upower\fR \-h
.sp
\fBnut\-upower\fR \-a \fIUPS_NAME\fR [\fIگزینه‌ها\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
این صفحه راهنما فقط ویژگی‌های خاص درایور \fBnut\-upower\fR را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، \fBnutupsdrv\fR(8) را ببینید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
این درایور امکان پایش دستگاه‌های تأمین برق (یوپی‌اس، باتری‌ها) را که توسط دیمن UPower از طریق گذرگاه سیستم D\-Bus مدیریت می‌شوند، فراهم می‌آورد\&.
.sp
این درایور ویژگی‌های UPower (وضعیت، درصد، ولتاژ و غیره) را به متغیرهای استاندارد NUT نگاشت می‌کند و به کلاینت‌های NUT اجازه می‌دهد دستگاه‌هایی را پایش کنند که به طور بومی توسط محیط میزکار سیستم‌عامل پشتیبانی می‌شوند اما مستقیماً توسط سایر درایورهای NUT پشتیبانی نمی‌گردند\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر در \fBups.conf\fR(5) پشتیبانی می‌کند:
.PP
\fBport\fR
.RS 4
مسیر شیء (Object Path) در UPower برای دستگاه مورد پایش\&.
.RE
.sp
اگر روی auto (پیش‌فرض) تنظیم شود، درایور نخستین دستگاه UPower را که مسیر شیء آن شامل رشته "ups_" باشد جستجو و انتخاب خواهد کرد\&.
.sp
اگر روی یک مسیر مشخص تنظیم شود (مانند /org/freedesktop/UPower/devices/ups_hiddev0)، درایور تلاش می‌کند همان دستگاه خاص را پایش کند\&.
.PP
\fBlowbatt\fR
.RS 4
آستانه درصد باتری که کمتر از آن، پرچم وضعیت
LB
(باتری ضعیف) تنظیم می‌شود\&. مقدار پیش‌فرض 20\&.0 است\&.
.RE
.SH "نصب و راه‌اندازی (INSTALLATION)"
.sp
برای استفاده از این درایور، یک بخش به فایل \fBups\&.conf\fR خود بیفزایید:
.sp
.if n \{\
.RS 4
.\}
.nf
[myups]
    driver = nut\-upower
    port = auto
    lowbatt = 20
    desc = "Laptop Battery or generic UPS via UPower"
.fi
.if n \{\
.RE
.\}
.SH "پیش‌نیازها (REQUIREMENTS)"
.sp
این درایور نیازمند این است که دیمن upower در حال اجرا و از طریق گذرگاه سیستمی D\-Bus در دسترس باشد\&. همچنین به کتابخانه‌های GLib 2\&.0 و GIO نیاز دارد\&.
.SH "نویسنده (AUTHOR)"
.sp
Tim Niemueller <tim@niemueller\&.de>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBups.conf\fR(5), \fBnutupsdrv\fR(8), \fBupsc\fR(8)
.SS "منابع اینترنتی:"
.sp
صفحه اصلی NUT (ابزارهای یوپی‌اس شبکه): <https://www.networkupstools.org/historic/v2.8.5>