نام (NAME)

ratbagctl - بررسی و تغییر تنظیمات ماوس‌های با قابلیت پیکربندی

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

ratbagctl [<options>] list
ratbagctl [<options>] <device> <command> ...

توضیحات (DESCRIPTION)

ابزار ratbagctl تنظیمات یک دستگاه را بررسی یا تغییر می‌دهد.

این ابزار معمولاً برای کار به اجرای ratbagd نیاز دارد.

گزینه‌ها (OPTIONS)

--version, -V

نمایش شماره نسخه برنامه و خروج.

--verbose, -v

چاپ خروجی اشکال‌زدایی. استفاده چندباره از گزینه -v میزان جزئیات خروجی را افزایش می‌دهد. برای نمونه، -vvv خروجی پروتکل را نشان خواهد داد.

--nocommit

تنظیمات را بلافاصله روی ماوس اعمال نکن. این گزینه اجازه می‌دهد چندین پارامتر درون یک اسکریپت تعیین شوند، و آخرین فراخوانی ratbagctl تمام آن‌ها را به یکباره اعمال خواهد کرد.

--help, -h

نمایش راهنما.

دستورات عمومی (GENERAL COMMANDS)

list

فهرست کردن دستگاه‌های پشتیبانی‌شده (آرگومان دستگاه نمی‌پذیرد)

دستورات دستگاه (DEVICE COMMANDS)

info

چاپ اطلاعات مربوط به یک دستگاه

name

چاپ نام دستگاه

دستورات نمایه (PROFILE COMMANDS)

profile active get

چاپ نمایه فعال کنونی

profile active set N

تنظیم نمایه N به‌عنوان نمایه فعال

profile N {COMMAND}

استفاده از نمایه N برای COMMAND

دستورات COMMAND دردسترس:

دستورات تفکیک‌پذیری (RESOLUTION COMMANDS)

دستورات تفکیک‌پذیری روی نمایه ارائه‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.

resolution active get

چاپ تفکیک‌پذیری فعال کنونی

resolution active set N

تنظیم تفکیک‌پذیری N به‌عنوان تفکیک‌پذیری فعال

resolution default get

چاپ تفکیک‌پذیری پیش‌فرض کنونی

resolution default set N

تنظیم تفکیک‌پذیری N به‌عنوان تفکیک‌پذیری پیش‌فرض

resolution N {COMMAND}

استفاده از تفکیک‌پذیری N برای COMMAND

دستورات COMMAND دردسترس:

دستورات DPI (DPI COMMANDS)

دستورات DPI روی نمایه و تفکیک‌پذیری مشخص‌شده، یا در صورت مشخص نشدن روی تفکیک‌پذیری فعال از نمایه فعال کار می‌کنند.

dpi get

چاپ مقدار dpi

dpi get-all

چاپ مقادیر dpi پشتیبانی‌شده

dpi set N

تنظیم مقدار dpi روی N

دستورات نرخ گزارش‌دهی (RATE COMMANDS)

دستورات نرخ گزارش‌دهی روی نمایه و تفکیک‌پذیری مشخص‌شده، یا در صورت مشخص نشدن روی تفکیک‌پذیری فعال از نمایه فعال کار می‌کنند.

rate get

چاپ نرخ گزارش‌دهی به میلی‌ثانیه (ms)

rate get-all

چاپ نرخ‌های گزارش‌دهی پشتیبانی‌شده به میلی‌ثانیه (ms)

rate set N

تنظیم نرخ گزارش‌دهی روی N میلی‌ثانیه

دستورات کلیدها (BUTTON COMMANDS)

دستورات کلید روی نمایه مشخص‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.

button count

چاپ تعداد کلیدها

button N get

چاپ اطلاعات کلید انتخاب‌شده

button N action get

چاپ عملکرد کلید

button N action set button B

تنظیم عملکرد کلید روی کلید B

button N action set special S

تنظیم عملکرد کلید روی عملکرد ویژه S

button N action set macro ...

تنظیم عملکرد کلید روی ماکروی مشخص‌شده

نحو ماکرو (Macro syntax):

یک ماکرو دنباله‌ای از رویدادهای کلید یا دوره‌های انتظار است. کلیدها باید با نام‌های کلید مشخص‌شده در linux/input-event-codes.h تعیین شوند.

دستورات ال‌ای‌دی (LED COMMANDS)

دستورات LED روی نمایه مشخص‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.

led get

چاپ مقادیر فعلی led

led N get

چاپ مقدار LED انتخاب‌شده

led N {COMMAND}

استفاده از led N برای COMMAND

دستورات COMMAND دردسترس:

مثال‌ها (EXAMPLES)

ratbagctl profile active get eventX

ratbagctl profile 0 resolution active set 4 eventX

ratbagctl profile 0 resolution 1 dpi get eventX

ratbagctl resolution 4 rate get eventX

ratbagctl dpi set 800 eventX

نکات (NOTES)

در حال حاضر هیچ تضمینی وجود ندارد که قالب خروجی ratbagctl در آینده تغییر نکند. دستورات ذکرشده در این صفحه راهنما باید تا حدی پایداری داشته باشند، اما انتظار نداشته باشید که همواره بدون تغییر باقی بمانند.

نویسندگان (AUTHORS)

ratbagctl توسط David Herrmann، Peter Hutterer و Benjamin Tissoires نوشته شده است.

این صفحه راهنما توسط Stephen Kitt <skitt@debian.org> برای سیستم دبیان گنو/لینوکس (Debian GNU/Linux) نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).