Miwiti Intel® Distribution for GDB* ing Linux* OS Host
Miwiti nggunakake Intel® Distribution for GDB* kanggo aplikasi debugging. Tindakake pandhuan ing ngisor iki kanggo nyiyapake debugger kanggo debug aplikasi kanthi kernel sing diundhuh menyang piranti CPU lan GPU.
Intel® Distribution for GDB* kasedhiya minangka bagéan saka Intel® oneAPI Base Toolkit. Kanggo informasi luwih lengkap babagan toolkit oneAPI, bukak kaca produk.
Dolan maring Cathetan Rilis kaca kanggo informasi babagan kapabilitas tombol, fitur anyar, lan masalah sing dikenal.
Sampeyan bisa nggunakake SYCL * sampkode, Array Transform, kanggo miwiti karo Distribusi Intel® kanggo GDB *. Ing sample ora ngasilake kesalahan lan mung nggambarake fitur debugger. Kode ngolah unsur array input gumantung saka genap utawa ganjil lan ngasilake array output. Sampeyan bisa nggunakake sample kanggo debug ing CPU utawa GPU, nemtokake piranti sing dipilih liwat argumen baris printah. Elinga yen debugging GPU mbutuhake rong sistem lan konfigurasi tambahan kanggo debugging remot.
Prasyarat
Yen sampeyan pengin debug ing GPU, instal driver GPU paling anyar lan atur sistem supaya bisa digunakake. Rujuk menyang Pandhuan Instalasi Toolkits Intel® oneAPI kanggo Linux* OS. Tindakake pandhuane Instal Intel GPU Drivers kanggo nginstal driver GPU sing cocog karo sistem sampeyan.
Kajaba iku, sampeyan bisa nginstal ekstensi kanggo Visual Studio Code* kanggo debugging GPU nganggo Intel® Distribution for GDB*. Rujuk menyang Nggunakake Visual Studio Code karo Intel® oneAPI Toolkits Guide.
Nggawe GPU Debugger
Kanggo nyiyapake debugger GPU, sampeyan kudu duwe akses root.
CATETAN Sajrone debugging kernel, GPU mandheg lan output video ora kasedhiya ing mesin target sampeyan. Amarga iki, sampeyan ora bisa debug GPU saka sistem target yen kertu GPU saka sistem uga digunakake kanggo output grafis. Ing kasus iki, sambungake menyang mesin liwat ssh.
1. Yen sampeyan pengin debug ing GPU, Kernel Linux sing ndhukung debugging GPU dibutuhake.
a. Tindakake pandhuan ing Piranti lunak Intel® kanggo kemampuan umum GPU kanggo ndownload lan nginstal driver sing dibutuhake.
b. Aktifake dhukungan debug i915 ing Kernel:
a. Bukak terminal.
b. Bukak grumbul file ing /etc/default.
c. Ing grub file, golek baris GRUB_CMDLINE_LINUX_DEFAULT="".
d. Ketik teks ing ngisor iki ing antarane kuotasi (“”):
i915.debug_eu=1
CATETAN Kanthi gawan, driver GPU ora ngidini beban kerja ing GPU luwih suwe tinimbang wektu tartamtu. Pembalap mateni beban kerja sing dawa banget kanthi ngreset GPU kanggo nyegah macet. Mekanisme hangcheck driver dipatèni yen aplikasi mlaku ing debugger. Yen sampeyan rencana kanggo mbukak beban kerja komputasi sing dawa uga tanpa debugger sing dipasang, coba lamar GPU: Pateni Hangcheck kanthi nambah
i915.enable_hangcheck=0
kanggo padha GRUB_CMDLINE_LINUX_DEFAULT baris.
c. Nganyari GRUB supaya owah-owahan iki ditrapake:
sudo nganyari-grub
d. Urip maneh.
2. Setel lingkungan CLI kanthi sumber skrip setvars sing ana ing root instalasi toolkit sampeyan.
Linux (sudo):
sumber /opt/intel/oneapi/setvars.sh
Linux (user):
sumber ~/intel/oneapi/setvars.sh
3. Lingkungan setelan
Gunakake variabel lingkungan ing ngisor iki kanggo ngaktifake dhukungan debugger kanggo Intel® oneAPI Level Zero:
ngekspor ZET_ENABLE_PROGRAM_DEBUGGING=1
ekspor IGC_EnableGTLocationDebugging=1
4. Priksa sistem
Yen kabeh wis siyap, bukak printah ing ngisor iki kanggo konfirmasi manawa konfigurasi sistem bisa dipercaya:
python3 /path/to/intel/oneapi/diagnostics/latest/diagnostics.py –filter debugger_sys_check -force
Output sing bisa ditindakake saka sistem sing dikonfigurasi kanthi apik yaiku:
…
asil mriksa:
================================================== ===============================
Priksa jeneng: debugger_sys_check
Description: Priksa iki verifikasi yen lingkungan wis siyap kanggo nggunakake gdb (Intel(R) Distribusi kanggo GDB*).
Status hasil: PASS
Debugger ditemokake.
libipt ketemu.
libiga ketemu.
i915 debug diaktifake.
Variabel lingkungan bener. ================================================== ===================================
1 Mriksa: 1 LULUS, 0 GAGAL, 0 PÈNGET, 0 KESALAHAN
Output konsol file: /path/to/logs/diagnostics_filter_debugger_sys_check_force.txt output JSON file: /path/to/diagnostics/logs/diagnostics_filter_debugger_sys_check_force.json …
Kompilasi Program kanthi Informasi Debug
Sampeyan bisa nggunakake sample project, Array Transform, kanggo cepet miwiti karo debugger aplikasi.
1. Kanggo entuk sample, pilih salah siji saka cara ing ngisor iki:
- Gunakake oneAPI CLI Samplan Browser kanggo milih Transform Array saka kategori Miwiti.
- Ngundhuh saka GitHub*.
2. Navigasi menyang src saka sampproyek iki:
cd array-transform/src
3. Kompilasi aplikasi kanthi ngaktifake info debug (-g flag) lan mateni optimasi (-O0 flag).
Mateni optimalisasi dianjurake kanggo lingkungan debug sing stabil lan akurat. Iki mbantu supaya ora kebingungan amarga owah-owahan kode sawise optimasi kompiler.
CATETAN Sampeyan isih bisa ngumpulake program karo Optimization aktif (-O2 flag), kang bisa mbiyantu yen sampeyan ngarahake ing GPU Déwan debugging.
Sampeyan bisa ngumpulake program ing sawetara cara. Pilihan 1 lan 2 nggunakake kompilasi just-in-time (JIT), sing dianjurake kanggo debug s.ample. Opsi 3 nggunakake kompilasi ahead-of-time (AOT).
- Pilihan 1. Sampeyan bisa nggunakake CMake file kanggo ngatur lan mbangun aplikasi. Rujuk menyang BACA saka sample kanggo instruksi.
CATETAN CMake file diwenehake karo sample wis ngliwati flag -g -O0.
- Pilihan 2. Kanggo ngumpulake array-transform.cpp sample aplikasi tanpa CMake file, ngetokake perintah ing ngisor iki:
icpx -fsycl -g -O0 array-transform.cpp -o array-transform
Yen kompilasi lan panyambungan ditindakake kanthi kapisah, tetep tandha -g -O0 ing langkah link. Langkah link yaiku nalika icpx nerjemahake panji kasebut kanggo dikirim menyang kompiler piranti nalika runtime. Example:
icpx -fsycl -g -O0 -c array-transform.cpp
icpx -fsycl -g -O0 array-transform.o -o array-transform
- Opsi 3. Sampeyan bisa nggunakake kompilasi AOT kanggo ngindhari wektu kompilasi JIT sing luwih dawa nalika runtime. Kompilasi JIT bisa luwih suwe kanggo kernel gedhe ing debugger. Kanggo nggunakake mode kompilasi Ahead-of-Time:
• Kanggo debugging ing GPU:
Nemtokake piranti sing bakal digunakake kanggo eksekusi program. Kanggo example, -piranti dg2-g10 kanggo Intel® Data Center GPU Flex 140 Graphics. Kanggo dhaptar opsi sing didhukung lan informasi luwih lengkap babagan kompilasi AOT, waca ing Intel® oneAPI DPC++ Pandhuan Pangembang Compiler lan Referensi.
Kanggo example:
icpx -fsycl -g -O0 -fsycl-targets=spir64_gen -Xs "-device dg2-g10" array-transform.cpp -o arraytransform
Kompilasi ahead-of-Time mbutuhake OpenCLTM Offline Compiler (OC Compiler LOC). Kanggo informasi luwih lengkap, deleng bagean "Instal OpenCLTM Offline Compiler (OCLOC)" saka Guide Instalasi.
• Kanggo debugging ing CPU:
icpx -fsycl -g -O0 -fsycl-targets=spir64_x86_64 array-transform.cpp -o array-transform
Miwiti Sesi Debug
Miwiti sesi debug:
1. Miwiti Distribusi Intel® kanggo GDB* kaya ing ngisor iki:
gdb-oneapi array-transform
Sampeyan kudu ndeleng pituduh (gdb).
2. Kanggo mesthekake yen kernel wis diundhuh menyang piranti sing bener, tindakake langkah ing ngisor iki. Nalika sampeyan nglakokake printah run saka pituduh (gdb), pass cpu, gpu or akselerator argumentasi:
- Kanggo debugging ing CPU:
mbukak cpu
Exampoutput sing:
[SYCL] Nggunakake piranti: [Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz] saka [Intel(R) OpenCL]- Kanggo debugging ing GPU:
mlaku gpu
Exampoutput sing:
[SYCL] Nggunakake piranti: [Intel(R) Data Center GPU Flex Series 140 [0x56c1]] saka [Intel(R) LevelZero]- Kanggo debugging ing FPGA-emulator:
mbukak akselerator
Exampoutput sing:
[SYCL] Nggunakake piranti: [Intel(R) FPGA Emulation Device] saka [Intel(R) FPGA Emulation Platform kanggo piranti lunak OpenCL(TM)]CATETAN Parameter cpu, gpu, lan akselerator khusus kanggo aplikasi Array Transform.
3. Kanggo metu saka Intel® Distribution for GDB*:
mandhek
Kanggo penak, prentah Intel® Distribution for GDB* kasedhiya ing Lembar Referensi.
Kanggo debug Array Transform sample lan sinau liyane babagan Intel® Distribution kanggo GDB *, lumaku liwat skenario debugging dhasar nggunakake Tutorial.
Sinau luwih lengkap
| Dokumen | Katrangan |
| Tutorial: Debugging nganggo Intel® Distribution kanggo GDB* | Dokumen iki nggambarake skenario dhasar sing kudu ditindakake nalika debugging SYCL* lan OpenCL nganggo Intel® Distribution kanggo GDB*. |
| Intel® Distribution for GDB* Pandhuan pangguna | Dokumen iki njlèntrèhaké kabeh tugas umum sing bisa rampung karo Intel® Distribution kanggo GDB* lan menehi rincian teknis sing perlu. |
| Intel® Distribution for GDB* Cathetan Rilis | Cathetan ngemot informasi babagan kapabilitas utama, fitur anyar, lan masalah sing dikenal babagan Intel® Distribution for GDB*. |
| OneAPI Product Page | Kaca iki ngemot introduksi ringkes babagan toolkit oneAPI lan pranala menyang sumber daya sing migunani. |
| Distribusi Intel® kanggo Lembar Referensi GDB* | Dokumen siji-kaca iki kanthi ringkes njlentrehake Intel® Distribution for GDB* prasyarat lan prentah sing migunani. |
| Jacobi Sample | Aplikasi SYCL * cilik iki duwe rong versi: bug lan tetep. Gunakake sample kanggo ngleksanani debugging aplikasi karo Intel® Distribusi kanggo GDB *. |
Kabar lan Penafian
Teknologi Intel bisa uga mbutuhake hardware, software, utawa aktifitas layanan.
Ora ana produk utawa komponen sing bisa pancen aman.
Biaya lan asil sampeyan bisa beda-beda.
© Intel Corporation. Intel, logo Intel, lan merek Intel liyane minangka merek dagang saka Intel Corporation utawa anak perusahaan. Jeneng lan merek liyane bisa uga diklaim minangka properti wong liya.
Ora ana lisensi (nyata utawa diwenehake, kanthi estoppel utawa liya-liyane) kanggo hak properti intelektual sing diwenehake dening dokumen iki.
Produk sing diterangake bisa ngemot cacat desain utawa kesalahan sing dikenal minangka errata sing bisa nyebabake produk kasebut nyimpang saka spesifikasi sing diterbitake. errata ditondoi saiki kasedhiya ing request.
Intel mbantah kabeh jaminan sing nyata lan tersirat, kalebu tanpa watesan, jaminan sing bisa didol, kesesuaian kanggo tujuan tartamtu, lan ora nglanggar, uga jaminan apa wae sing kedadeyan saka kinerja, transaksi, utawa panggunaan ing perdagangan.
OpenCL lan logo OpenCL minangka merek dagang Apple Inc. digunakake kanthi ijin dening Khronos.
Dokumen / Sumber Daya
 |
Distribusi intel kanggo GDB ing Linux OS Host [pdf] Pandhuan pangguna Distribusi kanggo GDB ing Linux OS Host, GDB ing Linux OS Host, Linux OS Host, OS Host, Host |
