نام (NAME)

lsgpu - فهرست‌بندی و بازبینی پردازنده‌های گرافیکی با اسکن گذرگاه PCI، زیرسیستم DRM و sysfs

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

lsgpu [OPTIONS]

توضیحات (DESCRIPTION)

lsgpu بخشی از مجموعه igt-gpu-tools است و برای کمک به شناسایی و اشکال‌زدایی پردازنده‌های گرافیکی (GPU) طراحی شده است. lsgpu یک ابزار خط فرمانی برای فهرست کردن و بازبینی پردازنده‌های گرافیکی موجود روی سیستم است. این ابزار گذرگاه PCI، زیرسیستم DRM و sysfs را اسکن می‌کند تا اطلاعات مربوط به دستگاه‌های گرافیکی شناسایی‌شده و ویژگی‌های آن‌ها را جمع‌آوری نماید.

به‌طور پیش‌فرض، lsgpu فهرستی از پردازنده‌های گرافیکی را همراه با جزئیات اولیه نمایش می‌دهد. این ابزار از گزینه‌های تکمیلی برای چاپ ویژگی‌های تفصیلی و مشخصه‌های sysfs، اعمال فیلترها جهت انتخاب دستگاه‌های خاص و بررسی مجوزهای دسترسی به گره‌های گرافیکی پشتیبانی می‌کند.

فیلتر کردن می‌تواند با استفاده از گزینه -d یا --device انجام شود و به کاربران اجازه می‌دهد پردازنده‌های گرافیکی را بر اساس سازنده، ویژگی‌های PCI یا سایر معیارها مطابقت دهند. هنگامی که فیلتری اعمال می‌شود، فقط نخستین دستگاه منطبق نمایش داده می‌شود.

علاوه بر این، lsgpu تلاش می‌کند گره‌های دستگاه DRM متناظر (/dev/dri/cardX، /dev/dri/renderDX) را باز کند تا مجوزهای دسترسی را بررسی نماید. این ابزار ترتیب جستجوی متغیرهای IGT زیر را برای انتخاب دستگاه هدف دنبال می‌کند:

1.: گزینه --device، در صورت ارائه
2.: متغیر محیطی IGT_DEVICE، در صورت تنظیم بودن
3.: فایل پیکربندی .igtrc (تنظیم Common::Device)، در صورتی که هیچ‌یک از موارد بالا مشخص نشده باشد

گزینه‌ها (OPTIONS)

-h, --help: نمایش متن راهنما.
-n, --numeric: چاپ سازنده/دستگاه در قالب هگزادسیمال (hex).
-c, --codename: چاپ نام کد (Codename) به جای نام خوانای دستگاه.
-s, --print-simple: چاپ جزئیات ساده (سنتی) دستگاه.
-p, --print-details: چاپ دستگاه‌ها همراه با جزئیات کامل.
-P, --pci-scan: چاپ دستگاه‌های گرافیکی PCI.
-v, --list-vendors: فهرست کردن سازندگان شناخته‌شده.
-l, --list-filter-types: فهرست کردن انواع فیلترهای ثبت‌شده برای دستگاه‌ها.
-d,--device <filter>: اعمال یک فیلتر دستگاه (مانند 'pci:vendor=Intel,device=discrete,card=0'). می‌تواند چندین بار استفاده شود.
-V, --version: چاپ اطلاعات نسخه و خروج.

گزینه‌های حالت چاپ پیش‌فرض (Default print mode options)

این گزینه‌ها تنها هنگام استفاده از حالت خروجی پیش‌فرض معتبر هستند:

--drm: پیش‌فرض: چاپ فیلترهای DRM برای هر دستگاه.
--sysfs: چاپ فیلترهای sysfs برای هر دستگاه.
--pci: چاپ فیلترهای PCI برای هر دستگاه.

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

اشکالات را در گیت‌لب fd.o گزارش دهید: https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/issues

نویسنده (AUTHOR)

توسعه‌دهندگان IGT <igt-dev@lists.freedesktop.org>

حق نشر (COPYRIGHT)

2009,2011,2012,2016,2018,2019,2020,2023,2024,2025 Intel Corporation