نام (NAME)

intel_gpu_top - نمایشی مشابه top از میزان مصرف پردازنده گرافیکی اینتل

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

intel_gpu_top [گزینه‌ها]

توضیحات (DESCRIPTION)

intel_gpu_top ابزاری برای نمایش اطلاعات میزان مصرف پردازنده‌های گرافیکی اینتل (Intel GPU) است.

این ابزار داده‌های جمع‌آوری‌شده از شمارنده‌های عملکرد (PMU) را ارائه می‌دهد که توسط i915 و دیگر درایورهای پلتفرم مانند RAPL (توان مصرفی) و Uncore IMC (پهنای باند حافظه) در دسترس قرار می‌گیرند.

گزینه‌ها (OPTIONS)

-h: نمایش متن راهنما.
-c: خروجی داده‌ها با قالب‌بندی CSV.
-J: خروجی داده‌ها با قالب‌بندی JSON.
-l: فهرست کردن داده‌ها به‌صورت متن ساده.

-o <file> یا -o -: ارسال خروجی به فایل مشخص‌شده به جای خروجی استاندارد. همچنین می‌توان از '-' برای انتخاب صریح خروجی استاندارد استفاده کرد.

-s <ms>: دورهٔ نوسازی برحسب میلی‌ثانیه.
-L: فهرست کردن پردازنده‌های گرافیکی موجود روی سیستم.
-d: انتخاب یک پردازنده گرافیکی خاص با استفاده از یکی از فیلترهای پشتیبانی‌شده.
-p: پیش‌فرض برای نمایش موتورهای فیزیکی به جای رده‌های تجمیع‌شده.
-m: پیش‌فرض برای نمایش جداگانهٔ تمام نواحی حافظه.
-n <number>: مدت‌زمان اجرای برنامه را به‌صورت <refresh period> * <number - 1> مشخص می‌کند. دادن مقدار 0 (پیش‌فرض) یا یک عدد منفی باعث اجرای آن در یک حلقهٔ بی‌پایان می‌شود تا زمانی که کاربر با کلید q یا Ctrl-C آن را متوقف کند یا سیگنالی ارسال شود. همراه با گزینه‌های -c، -J یا -l، اطلاعات را به تعداد <number> بار چاپ می‌کند.

کنترل در زمان اجرا (RUNTIME CONTROL)

کلیدهای پشتیبانی‌شده:

'q'    خروج از ابزار.
'h'    نمایش راهنمای تعاملی.
'1'    تغییر وضعیت بین حالت رده‌های موتور تجمیع‌شده و حالت موتور فیزیکی.
'n'    تغییر وضعیت نمایش لایه عددی مشغولیت کلاینت‌ها.
's'    تغییر وضعیت بین حالت‌های مرتب‌سازی (runtime، total runtime، pid، client id).
'i'    تغییر وضعیت نمایش کلاینت‌هایی که از هیچ زمان GPU استفاده نکرده‌اند.
'H'    تغییر وضعیت بین تجمیع بر اساس PID و کلاینت‌های مجزا.
'm'    تغییر وضعیت بین نواحی حافظه تجمیع‌شده و تفکیک کامل.

انتخاب دستگاه (DEVICE SELECTION)

در سیستم‌هایی که چندین پردازنده گرافیکی (GPU) وجود دارد، امکان انتخاب یک پردازنده گرافیکی مشخص برای نظارت وجود دارد. یک پردازنده گرافیکی می‌تواند از طریق مسیر sysfs، گره دستگاه drm یا با استفاده از فیلترهای فرعی گوناگون PCI انتخاب شود.

فیلتر	نحو	معیار انتخاب GPU
sys	sys:/sys/devices/pci0000:00/0000:00:02.0	انتخاب با استفاده از مسیر sysfs.

drm

drm:/dev/dri/<node>

انتخاب با استفاده از گره دستگاه /dev/dri/*.

pci

pci:[vendor=%04x/name][,device=%04x][,card=%d]

انتخاب با استفاده از نشانی PCI. سازنده (Vendor) یک عدد هگزادسیمال یا نام سازنده است.

خروجی JSON (JSON OUTPUT)

خروجی JSON هنگامی که ابزار به‌درستی خارج شود به صورت صحیح خاتمه می‌یابد؛ در غیر این صورت، پیش از تجزیه باید یک براکت بسته اضافه شود.

محدودیت‌ها (LIMITATIONS)

دستگاه‌های مبتنی بر درایور Xe پشتیبانی نمی‌شوند؛ لطفاً در عوض از ابزار gputop استفاده کنید.
همهٔ معیارها در تمام پلتفرم‌ها پشتیبانی نمی‌شوند. در صورتی که معیاری پشتیبانی نشود، مقدار آن با یک خط‌چین جایگزین خواهد شد.
دسترسی غیرریشه (non-root) به شمارنده‌های perf توسط sysctl با متغیر perf_event_paranoid کنترل می‌شود.

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

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

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

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

کپی‌رایت و تکثیر (COPYRIGHT)

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