نام (NAME)

libinput-test-suite - اجرای مجموعه آزمون libinput

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

libinput test-suite [OPTIONS]

توضیحات (DESCRIPTION)

دستور libinput test-suite مجموعه آزمون libinput را اجرا می‌کند. هدف اصلی آن، اعتبارسنجی ساخت‌های توزیع پس از به‌روزرسانی بسته‌ها است. شکست در آزمون‌ها معمولاً نشان‌دهنده وصله‌های مفقود و/یا ناسازگاری لایه‌های پایینی سیستم است.

این مجموعه آزمون نباید توسط کاربران عادی اجرا شود. احتمال از دست رفتن داده‌ها وجود دارد.

مجموعه آزمون باید با دسترسی ریشه (root) اجرا شود. این مجموعه چندین فایل را در سیستم میزبان نصب می‌کند (بخش فایل‌ها (FILES) را ببینید)، دستورات سیستمی را اجرا کرده و از طریق uinput دستگاه‌های کرنل مجازی می‌سازد. این دستگاه‌ها با هر نشست فعالی تداخل خواهند داشت و ممکن است موجب از دست رفتن داده‌ها شوند.

توصیه می‌شود که مجموعه آزمون در یک ماشین مجازی و/یا روی سیستمی که در حال استفاده نیست اجرا شود. برای اجرای مجموعه آزمون به محیط گرافیکی نیازی نیست.

گزینه‌ها (OPTIONS)

توجه داشته باشید که گزینه‌ها ممکن است در انتشار‌های آینده libinput تغییر کنند. نام آزمون‌ها، نام دستگاه‌های آزمون و نام گروه‌های آزمون ممکن است در هر زمانی تغییر یابند.

--filter-test "testname"

یک الگوی تطبیق (glob) که آزمون‌های قابل اجرا را محدود می‌کند. مشخص کردن فیلتر، مقدار پیش‌فرض --jobs را روی ۱ تنظیم می‌کند.

--filter-device "devicename"

یک الگوی تطبیق (glob) که دستگاه‌های مورد آزمایش را محدود می‌کند. مشخص کردن فیلتر، مقدار پیش‌فرض --jobs را روی ۱ تنظیم می‌کند.

--filter-group "groupname"

یک الگوی تطبیق (glob) که آزمون‌ها را به گروه‌ها (با نام دلخواه) محدود می‌کند. مشخص کردن فیلتر، مقدار پیش‌فرض --jobs را روی ۱ تنظیم می‌کند.

--filter-deviceless

تنها برای استفاده داخلی

-h, --help

نمایش راهنما

-j, --jobs 8

تعداد فرآیندهای موازی برای اجرا. پیش‌فرض: 8.

--list

فهرست کردن تمام موارد آزمون و دستگاه‌هایی که آزمون‌ها برای آن‌ها اجرا می‌شوند. نام آزمون‌ها، نام دستگاه‌های آزمون و نام گروه‌های آزمون ممکن است در هر زمانی تغییر کنند.

--verbose

فعال کردن خروجی پرگو، شامل پیام‌های اشکال‌زدایی libinput.

فایل‌ها (FILES)

دایرکتوری‌های زیر دستخوش تغییر می‌شوند:

/usr/share/libinput

ویژگی‌های رفتاری خاص دستگاه‌های آزمون (quirks) با یک پیشوند سفارشی در این دایرکتوری نصب می‌شوند. فایل‌های موجود در این دایرکتوری دست‌نخورده باقی می‌مانند اما فایل‌های جدید نصب شده و هنگام خروج حذف می‌شوند. فایل‌های موجود (مثلاً از اجرای ناتمام قبلی) با همین نام، بدون اعلان بازنویسی و حذف خواهند شد.

/run/udev/rules.d

قوانین udev مختص آزمون در این دایرکتوری نصب شده و هنگام خروج حذف می‌شوند.

پیکربندی سیستم (SYSTEM SETUP)

قطعه‌کد xorg.conf.d(5) زیر اطمینان می‌دهد که کارساز X دستگاه‌های آزمایشی ایجاد شده توسط این مجموعه آزمون را نادیده می‌گیرد:

Section "InputClass"
        Identifier "Ignore libinput test suite devices"
        MatchProduct "litest"
        Option "Ignore" "on"
EndSection

برای کامپوزیتورهای Wayland نیازی به پیکربندی نیست. حالت پیش‌فرض libinput دستگاه‌های آزمایشی این مجموعه آزمون را نادیده خواهد گرفت.

گزارش باگ‌ها (BUGS)

برخی آزمون‌ها به زمان‌بندی حساس هستند. در شرایطی که سیستم زیر بار سنگین باشد، ممکن است یک آزمون شکست بخورد. اجرای مجدد آزمون با --filter-test می‌تواند به بررسی این موضوع که آیا شکست آزمون یک خطای واقعی بوده است یا خیر کمک کند.

LIBINPUT

بخشی از مجموعه libinput(1)