.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "intel_reg" "1" "2016-03-01" "igt-gpu-tools 2.5" "General Commands Manual"
.SH "نام (NAME)"
intel_reg \- ابزار چندمنظوره برای ثبات‌های گرافیک Intel
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBintel_reg\fP [\fIOPTIONS\fP] \fICOMMAND\fP
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار چندمنظوره برای ثبات‌های پردازنده گرافیکی Intel. خواندن، نوشتن، استخراج (dump) و رمزگشایی ثبات‌های MMIO و sideband گرافیک Intel و موارد دیگر.
.SH "گزینه‌ها (OPTIONS)"
.sp
برخی از گزینه‌ها عمومی هستند و برخی دیگر به دستورهای خاصی اختصاص دارند.
.INDENT 0.0
.TP
.B  \-\-verbose
افزایش جزئیات خروجی.
.TP
.B  \-\-quiet
کاهش جزئیات خروجی.
.TP
.BI \-\-count\fB= N
خواندن N ثبات.
.TP
.B  \-\-binary
چاپ خروجی مقادیر در قالب باینری (دودویی).
.TP
.B  \-\-decode
رمزگشایی ثبات‌ها. به‌طور پیش‌فرض تنها از آفست‌های خام استفاده می‌شود، مگر اینکه دستوری بدون آن کار نکند یا گزینه دیگری فعال‌سازی آن را اجباری کرده باشد. برای جزئیات بیشتر بخش دستورها (COMMANDS) را در ادامه ببینید.
.TP
.B  \-\-all
رمزگشایی ثبات‌ها برای همه پلتفرم‌های شناخته‌شده. این گزینه مستلزم \-\-decode است.
.TP
.BI \-\-mmio\fB= FILE
استفاده از MMIO bar از FILE.
.TP
.BI \-\-devid\fB= DEVID
تظاهر به عنوان شناسه سخت‌افزاری DEVID مربوط به PCI ID. برای تصویرهای لحظه‌ای (snapshots) مربوط به MMIO bar از سیستم‌های دیگر کاربرد دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pci\-slot <domain>:<bus>:<device>[.<func>]
یافتن GPU شرکت Intel بر اساس اسلات PCI. در سخت‌افزارهای مجهز به چند پردازنده گرافیکی مفید است.
.UNINDENT
.INDENT 0.0
.TP
.BI \-\-spec\fB= PATH
خواندن مشخصات ثبات (register spec) از دایرکتوری یا فایل مشخص‌شده توسط PATH؛ برای جزئیات به بخش تعاریف مشخصات ثبات (REGISTER SPEC DEFINITIONS) در ادامه مراجعه کنید. این گزینه مستلزم \-\-decode است.
.TP
.B  \-\-help
نمایش راهنمای مختصر.
.UNINDENT
.SH "دستورها (COMMANDS)"
.sp
برای چگونگی توصیف ثبات‌ها برای دستورها، به بخش مراجع ثبات (REGISTER REFERENCES) در ادامه مراجعه کنید.
.SS read [\-\-count=N] REGISTER [...]
.sp
استخراج هر REGISTER مشخص‌شده، یا N ثبات با شروع از هر REGISTER.
.SS write REGISTER VALUE [REGISTER VALUE ...]
.sp
نوشتن هر VALUE در REGISTER متناظر.
.SS dump [\-\-mmio=FILE \-\-devid=DEVID]
.sp
استخراج تمامی ثبات‌های مشخص‌شده در مشخصات ثبات. گزینه \-\-decode به‌طور ضمنی فعال می‌شود.
.SS decode REGISTER VALUE
.sp
رمزگشایی REGISTER VALUE. گزینه \-\-decode به‌طور ضمنی فعال می‌شود.
.SS list
.sp
فهرست کردن ثبات‌های شناخته‌شده. گزینه \-\-decode به‌طور ضمنی فعال می‌شود.
.SS help
.sp
نمایش راهنمای مختصر.
.SH "مراجع ثبات (REGISTER REFERENCES)"
.sp
ثبات‌ها به صورت [(PORTNAME|PORTNUM|ENGINE|MMIO\-OFFSET):](REGNAME|REGADDR) تعریف می‌شوند.
.INDENT 0.0
.TP
.B PORTNAME
روش دسترسی به ثبات، که اغلب MMIO و حالت پیش‌فرض است. روش‌های پشتیبانی‌شده در همه پلتفرم‌ها عبارتند از \(dqmmio\(dq، \(dqportio\-vga\(dq و \(dqmmio\-vga\(dq.
.sp
در BYT و CHV، درگاه‌های جانبی (sideband) شامل \(dqbunit\(dq، \(dqpunit\(dq، \(dqnc\(dq، \(dqdpio\(dq، \(dqgpio\-nc\(dq، \(dqcck\(dq، \(dqccu\(dq، \(dqdpio2\(dq و \(dqflisdsi\(dq نیز پشتیبانی می‌شوند.
.TP
.B PORTNUM
شماره درگاه برای درگاه‌های جانبی پشتیبانی‌شده در BYT و CHV. تنها اعدادی مجاز هستند که به درگاه‌های پشتیبانی‌شده نگاشت شده باشند؛ اعداد دلخواه پذیرفته نمی‌شوند.
.sp
اعداد بزرگ‌تر از 0xff به‌طور خودکار به عنوان آفست‌های MMIO تفسیر می‌شوند، نه شماره درگاه.
.TP
.B ENGINE
به جای MMIO مبتنی بر CPU، می‌توان از موتور (engine) مشخص‌شده برای روش دسترسی استفاده کرد. یک Batchbuffer برای خواندن/نوشتن به سمت آن موتور هدایت خواهد شد. فهرست موتورهای موجود وابسته به معماری است و با دستور \(dqintel_reg help\(dq قابل مشاهده می‌باشد. افزودن پیشوند \(aq\-\(aq به نام موتور، از یک batchbuffer غیرممتاز برای دسترسی استفاده می‌کند.
.TP
.B MMIO\-OFFSET
استفاده از MMIO، و افزودن این آفست به آدرس ثبات.
.sp
اعداد مساوی یا کمتر از 0xff به‌طور خودکار به عنوان شماره درگاه تفسیر می‌شوند، نه آفست MMIO.
.TP
.B REGNAME
نام ثبات همان‌طور که در مشخصات ثبات تعریف شده است.
.sp
اگر آفست MMIO مشخص نشده باشد، از مشخصات ثبات برداشته می‌شود. با این حال، درگاه‌ها این‌گونه نیستند؛ درگاه به عنوان یک فضای نام برای نام‌های ثبات عمل می‌کند.
.TP
.B REGADDR
آدرس ثبات. نیازی نیست نام ثبات متناظر در مشخصات ثبات تعریف شده باشد.
.UNINDENT
.SH "محیط (ENVIRONMENT)"
.INDENT 0.0
.TP
.B INTEL_REG_SPEC
مسیر دایرکتوری یا فایلی که حاوی تعاریف مشخصات ثبات است.
.UNINDENT
.SH "تعاریف مشخصات ثبات (REGISTER SPEC DEFINITIONS)"
.sp
مشخصات ثبات (register spec)، نام‌های ثبات را به آدرس‌ها مرتبط می‌کند. جستجو برای مشخصات به این ترتیب انجام می‌شود:
.INDENT 0.0
.IP 1. 3
دایرکتوری یا فایل مشخص‌شده توسط گزینه \-\-spec.
.IP 2. 3
دایرکتوری یا فایل مشخص‌شده توسط متغیر محیطی INTEL_REG_SPEC.
.IP 3. 3
مشخصات ثبات توکار (Builtin). همچنین در صورتی که موارد بالا استفاده شوند اما با خطا مواجه گردند، به عنوان راه‌حل پشتیبان همراه با یک هشدار استفاده خواهد شد.
.UNINDENT
.sp
اگر دایرکتوری با استفاده از گزینه \-\-spec یا متغیر محیطی INTEL_REG_SPEC مشخص شده باشد، دایرکتوری برای یافتن فایل مشخصات به این ترتیب پویش می‌شود:
.INDENT 0.0
.IP 1. 3
فایلی که بر اساس شناسه دستگاه PCI (device id) نام‌گذاری شده است. برای مثال، \(dq0412\(dq.
.IP 2. 3
فایلی که بر اساس نام رمزی (code name) با حروف کوچک و بدون نشانه‌گذاری نام‌گذاری شده است. برای مثال، \(dqvalleyview\(dq.
.IP 3. 3
فایلی که بر اساس نسل (generation) نام‌گذاری شده است. برای مثال، \(dqgen7\(dq (توجه داشته باشید که این مورد با valleyview، ivybridge و haswell مطابقت دارد!).
.UNINDENT
.SS "قالب فایل مشخصات ثبات (Register Spec File Format)"
.sp
قالب مشخصات ثبات به طور خلاصه در زیر توضیح داده شده است:
.INDENT 0.0
.IP \(bu 2
خطوط خالی و خطوطی که با \(dq#\(dq، \(dq;\(dq یا \(dq//\(dq شروع می‌شوند نادیده گرفته می‌شوند.
.IP \(bu 2
خطوطی که با \(dq(\(dq شروع \fIنمی‌شوند\fP به عنوان نام فایل‌ها (مطلق یا نسبی) برای گنجانده شدن (include) در نظر گرفته می‌شوند.
.IP \(bu 2
خطوطی که با \(dq(\(dq شروع می‌شوند به عنوان تعاریف ثبات تفسیر می‌گردند.
.UNINDENT
.sp
ثبات‌ها به صورت چندتایی‌های (\(aqREGNAME\(aq, \(aqREGADDR\(aq, \(aqPORTNAME|PORTNUM|MMIO\-OFFSET\(aq)، مشابه ارجاعات ثبات (REGISTER REFERENCES) در بالا، تعریف می‌شوند. توضیحات پورت همچنین می‌تواند یک رشته خالی برای نشان دادن MMIO باشد.
.sp
مثال‌ها:
.INDENT 0.0
.IP \(bu 2
# this is a comment, below is an include
.IP \(bu 2
vlv_pipe_a.txt
.IP \(bu 2
(\(aqGEN6_PMINTRMSK\(aq, \(aq0x0000a168\(aq, \(aq\(aq)
.IP \(bu 2
(\(aqMIPIA_PORT_CTRL\(aq, \(aq0x61190\(aq, \(aq0x180000\(aq)
.IP \(bu 2
(\(aqPLL1_DW0\(aq, \(aq0x8000\(aq, \(aqDPIO\(aq)
.UNINDENT
.SH "اشکالات (BUGS)"
.sp
خواندن برخی از ثبات‌ها ممکن است موجب توقف کامل (hang) پردازنده گرافیکی یا کل سیستم شود.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
گزارش باگ‌ها در گیت‌لب fd.o: \%<https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/issues>
.SH "نویسندگان (AUTHORS)"
Jani Nikula <jani.nikula@intel.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2015-2025 Intel Corporation
.\" End of generated man page.