.TH BATSIGNAL 1 batsignal\-1.8.0
.SH "نام (NAME)"
batsignal \- دیمن پایشگر باتری
.SH "خلاصه دستور (SYNOPSIS)"
.B batsignal
.RB [ OPTIONS ]
.SH "توضیحات (DESCRIPTION)"
برنامه batsignal یک دیمن سبک پایش باتری نوشته‌شده به زبان C است که وضعیت باتری را به کاربر اعلان می‌کند.
این ابزار برای مدیر پنجره‌های مینیمال در نظر گرفته شده است، اما در هر محیطی که از اعلان‌های رومیزی از طریق libnotify پشتیبانی کند قابل استفاده است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h
نمایش راهنما
.TP
.B \-v
نمایش اطلاعات نسخه
.TP
.B \-b
اجرای batsignal به عنوان دیمن پس‌زمینه
.TP
.B \-o
بررسی باتری برای یک‌بار و خروج
.TP
.B \-i
نادیده گرفتن خطاهای عدم وجود باتری
.TP
.B \-e
منقضی شدن خودکار اعلان‌ها
.TP
.B \-N
غیرفعال کردن اعلان‌های رومیزی
.TP
.B \-w LEVEL
سطح هشدار باتری LEVEL (پیش‌فرض ۱۵). مقدار ۰ این سطح را غیرفعال می‌کند
.TP
.B \-c LEVEL
سطح بحرانی باتری LEVEL (پیش‌فرض ۵). مقدار ۰ این سطح را غیرفعال می‌کند
.TP
.B \-d LEVEL
سطح خطر باتری LEVEL (پیش‌فرض ۲). مقدار ۰ این سطح را غیرفعال می‌کند
.TP
.B \-f LEVEL
سطح پر بودن باتری LEVEL (پیش‌فرض ۰). مقدار ۰ این سطح را غیرفعال می‌کند
.TP
.B \-p
نمایش پیام هنگام شروع شارژ یا تخلیه باتری
.TP
.B \-W MESSAGE
نمایش MESSAGE هنگام رسیدن باتری به سطح هشدار
.TP
.B \-C MESSAGE
نمایش MESSAGE هنگام رسیدن باتری به سطح بحرانی
.TP
.B \-D COMMAND
اجرای دستور COMMAND هنگام رسیدن باتری به سطح خطر
.TP
.B \-F MESSAGE
نمایش MESSAGE هنگام رسیدن باتری به سطح پر
.TP
.B \-P MESSAGE
نمایش MESSAGE هنگام شارژ شدن باتری، در صورت تنظیم بودن گزینه -p
.TP
.B \-U MESSAGE
نمایش MESSAGE هنگام تخلیه باتری، در صورت تنظیم بودن گزینه -p
.TP
.B \-M COMMAND
ارسال هر پیام با استفاده از دستور COMMAND
.TP
.B \-n NAME
نام دستگاه باتری NAME - باتری‌های چندگانه را می‌توان با ویرگول جدا کرد (پیش‌فرض BAT0)
.TP
.B \-m SECONDS
حداقل تعداد ثانیه‌ها SECONDS (پیش‌فرض ۶۰) برای توقف بین بررسی‌های وضعیت باتری.
تنظیم SECONDS روی ۰ پایش دوره‌ای را غیرفعال کرده و منتظر سیگنال USR1 پیش از بررسی سطح باتری می‌ماند.
افزودن پیشوند + به SECONDS (مانند: ‎-m +10) بررسی را در فواصل مشخص SECONDS فارغ از سطح باتری اجباری می‌کند.
.TP
.B \-a APP_NAME
نام برنامه مورد استفاده در اعلان‌ها (پیش‌فرض: batsignal)
.TP
.B \-I ICON
نمایش نماد ICON مشخص‌شده در اعلان‌ها
.SH "پیکربندی (CONFIGURATION)"
گزینه‌ها را می‌توان به عنوان آرگومان‌های دستور به batsignal ارسال کرد یا در یک فایل پیکربندی قرار داد.
گزینه‌های فایل پیکربندی ابتدا اعمال می‌شوند و سپس ممکن است توسط آرگومان‌های خط فرمان بازنویسی گردند.
.P
فایل پیکربندی باید شامل آرگومان‌های گزینه‌ها همان‌طور که در بالا مستند شده، یک آرگومان در هر خط باشد.
خطوطی که با # شروع می‌شوند و خطوط خالی نادیده گرفته می‌شوند.
برای مثال، جهت تعیین سطح هشدار ۳۰ و اجرا به عنوان دیمن پس‌زمینه، فایل پیکربندی زیر می‌تواند استفاده شود:
.RS
.P
# Run in background
.br
-b
.br
# Use warning level of 30
.br
-w
.br
30
.RE
.P
مسیرهای زیر به ترتیب برای یافتن فایل پیکربندی بررسی می‌شوند:
.IP \[bu]
متغیر محیطی
.B BATSIGNAL_CONFIG
(در صورت وجود)
.IP \[bu]
مسیر $HOME/.config/batsignal (یا پایه پیکربندی مشخص‌شده در XDG_CONFIG_HOME)
.IP \[bu]
$HOME/.batsignal
.IP \[bu]
/usr/local/etc/batsignal
.IP \[bu]
/etc/batsignal
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B BATSIGNAL_CONFIG
مسیر فایل پیکربندی گزینه‌ها را تعیین می‌کند.
.TP
.B XDG_CONFIG_HOME
مسیر پایه برای شاخه پیکربندی XDG. در جستجوی فایل گزینه‌ها استفاده می‌شود.
.SH "سیگنال‌ها (SIGNALS)"
برنامه batsignal به سیگنال‌های زیر پاسخ می‌دهد:
.TP
.B SIGUSR1
ارسال SIGUSR1 به فرایند باعث انجام فوری بررسی باتری می‌شود.
.SH "نکات (NOTES)"
در بیشتر موارد، هنگامی که باتری در حال تخلیه است و سطح شارژ نزدیک به سطح هشدار نیست، batsignal بررسی‌های کمتری برای وضعیت باتری انجام می‌دهد.
این بسامد تحت تأثیر گزینه ضرب‌کننده (-m) است و هرگز کمتر از <multiplier> ثانیه نخواهد بود.
اگر سطح "پر" (-f) تعیین شده باشد یا پیام‌های شارژ/تخلیه فعال باشند (-p)، برنامه batsignal وضعیت باتری را در هر <multiplier> ثانیه صرف‌نظر از سطح شارژ بررسی خواهد کرد.
.P
اگر سطح "پر" (-f) تنظیم شده باشد، اعلان پر بودن باتری در سطح شارژ داده‌شده یا هنگام تغییر وضعیت باتری به "full"، هر کدام زودتر رخ دهد، فعال خواهد شد.
.P
دستور پیام COMMAND که با -M ارسال می‌شود یک رشته قالب‌بندی به سبک printf در C است.
می‌تواند از دو جایگزین رشته‌ای (%s) استفاده کند که با متن پیام و سطح فعلی باتری جایگزین می‌شوند.
حتماً دستور را آزمایش کنید - رشته‌های قالب نامعتبر ممکن است باعث کرش کردن batsignal شوند.
.br
مثال: ‎-M "wall 'Battery warning: %s - Level is %s'"
.SH "حق نشر (COPYRIGHT)"
حق نشر 2018-2024 Corey Hinshaw
.br
حق نشر 2016-2017 Aaron Marcher
.br
مجوز: مجوز ISC