نام (NAME)

batsignal - دیمن پایشگر باتری

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

batsignal [OPTIONS]

توضیحات (DESCRIPTION)

برنامه batsignal یک دیمن سبک پایش باتری نوشته‌شده به زبان C است که وضعیت باتری را به کاربر اعلان می‌کند. این ابزار برای مدیر پنجره‌های مینیمال در نظر گرفته شده است، اما در هر محیطی که از اعلان‌های رومیزی از طریق libnotify پشتیبانی کند قابل استفاده است.

گزینه‌ها (OPTIONS)

-h: نمایش راهنما
-v: نمایش اطلاعات نسخه
-b: اجرای batsignal به عنوان دیمن پس‌زمینه
-o: بررسی باتری برای یک‌بار و خروج
-i: نادیده گرفتن خطاهای عدم وجود باتری
-e: منقضی شدن خودکار اعلان‌ها
-N: غیرفعال کردن اعلان‌های رومیزی
-w LEVEL: سطح هشدار باتری LEVEL (پیش‌فرض ۱۵). مقدار ۰ این سطح را غیرفعال می‌کند
-c LEVEL: سطح بحرانی باتری LEVEL (پیش‌فرض ۵). مقدار ۰ این سطح را غیرفعال می‌کند
-d LEVEL: سطح خطر باتری LEVEL (پیش‌فرض ۲). مقدار ۰ این سطح را غیرفعال می‌کند
-f LEVEL: سطح پر بودن باتری LEVEL (پیش‌فرض ۰). مقدار ۰ این سطح را غیرفعال می‌کند
-p: نمایش پیام هنگام شروع شارژ یا تخلیه باتری
-W MESSAGE: نمایش MESSAGE هنگام رسیدن باتری به سطح هشدار
-C MESSAGE: نمایش MESSAGE هنگام رسیدن باتری به سطح بحرانی
-D COMMAND: اجرای دستور COMMAND هنگام رسیدن باتری به سطح خطر
-F MESSAGE: نمایش MESSAGE هنگام رسیدن باتری به سطح پر
-P MESSAGE: نمایش MESSAGE هنگام شارژ شدن باتری، در صورت تنظیم بودن گزینه -p
-U MESSAGE: نمایش MESSAGE هنگام تخلیه باتری، در صورت تنظیم بودن گزینه -p
-M COMMAND: ارسال هر پیام با استفاده از دستور COMMAND
-n NAME: نام دستگاه باتری NAME - باتری‌های چندگانه را می‌توان با ویرگول جدا کرد (پیش‌فرض BAT0)
-m SECONDS: حداقل تعداد ثانیه‌ها SECONDS (پیش‌فرض ۶۰) برای توقف بین بررسی‌های وضعیت باتری. تنظیم SECONDS روی ۰ پایش دوره‌ای را غیرفعال کرده و منتظر سیگنال USR1 پیش از بررسی سطح باتری می‌ماند. افزودن پیشوند + به SECONDS (مانند: ‎-m +10) بررسی را در فواصل مشخص SECONDS فارغ از سطح باتری اجباری می‌کند.
-a APP_NAME: نام برنامه مورد استفاده در اعلان‌ها (پیش‌فرض: batsignal)
-I ICON: نمایش نماد ICON مشخص‌شده در اعلان‌ها

پیکربندی (CONFIGURATION)

گزینه‌ها را می‌توان به عنوان آرگومان‌های دستور به batsignal ارسال کرد یا در یک فایل پیکربندی قرار داد. گزینه‌های فایل پیکربندی ابتدا اعمال می‌شوند و سپس ممکن است توسط آرگومان‌های خط فرمان بازنویسی گردند.

فایل پیکربندی باید شامل آرگومان‌های گزینه‌ها همان‌طور که در بالا مستند شده، یک آرگومان در هر خط باشد. خطوطی که با # شروع می‌شوند و خطوط خالی نادیده گرفته می‌شوند. برای مثال، جهت تعیین سطح هشدار ۳۰ و اجرا به عنوان دیمن پس‌زمینه، فایل پیکربندی زیر می‌تواند استفاده شود:

# Run in background
-b
# Use warning level of 30
-w
30

مسیرهای زیر به ترتیب برای یافتن فایل پیکربندی بررسی می‌شوند:

•: متغیر محیطی BATSIGNAL_CONFIG (در صورت وجود)
•: مسیر $HOME/.config/batsignal (یا پایه پیکربندی مشخص‌شده در XDG_CONFIG_HOME)
•: $HOME/.batsignal
•: /usr/local/etc/batsignal
•: /etc/batsignal

متغیرهای محیطی (ENVIRONMENT)

BATSIGNAL_CONFIG: مسیر فایل پیکربندی گزینه‌ها را تعیین می‌کند.
XDG_CONFIG_HOME: مسیر پایه برای شاخه پیکربندی XDG. در جستجوی فایل گزینه‌ها استفاده می‌شود.

سیگنال‌ها (SIGNALS)

برنامه batsignal به سیگنال‌های زیر پاسخ می‌دهد:

SIGUSR1: ارسال SIGUSR1 به فرایند باعث انجام فوری بررسی باتری می‌شود.

نکات (NOTES)

در بیشتر موارد، هنگامی که باتری در حال تخلیه است و سطح شارژ نزدیک به سطح هشدار نیست، batsignal بررسی‌های کمتری برای وضعیت باتری انجام می‌دهد. این بسامد تحت تأثیر گزینه ضرب‌کننده (-m) است و هرگز کمتر از <multiplier> ثانیه نخواهد بود. اگر سطح "پر" (-f) تعیین شده باشد یا پیام‌های شارژ/تخلیه فعال باشند (-p)، برنامه batsignal وضعیت باتری را در هر <multiplier> ثانیه صرف‌نظر از سطح شارژ بررسی خواهد کرد.

اگر سطح "پر" (-f) تنظیم شده باشد، اعلان پر بودن باتری در سطح شارژ داده‌شده یا هنگام تغییر وضعیت باتری به "full"، هر کدام زودتر رخ دهد، فعال خواهد شد.

دستور پیام COMMAND که با -M ارسال می‌شود یک رشته قالب‌بندی به سبک printf در C است. می‌تواند از دو جایگزین رشته‌ای (%s) استفاده کند که با متن پیام و سطح فعلی باتری جایگزین می‌شوند. حتماً دستور را آزمایش کنید - رشته‌های قالب نامعتبر ممکن است باعث کرش کردن batsignal شوند.
مثال: ‎-M "wall 'Battery warning: %s - Level is %s'"

حق نشر (COPYRIGHT)

حق نشر 2018-2024 Corey Hinshaw
حق نشر 2016-2017 Aaron Marcher
مجوز: مجوز ISC