Uživatelská příručka nástroje intel DPC++ Compatibility Tool

Nástroj pro kompatibilitu intel DPC++

Obsah skrýt

1 Začněte s nástrojem Intel® DPC+ + Compatibility Tool

1.1 Než začnete

1.2 Vydaná varování

1.3 Migrujte jednoduchý testovací projekt

2 Najít další

3 Dokumenty / zdroje

3.1 Reference

4 Související příspěvky

Začněte s nástrojem Intel® DPC+ + Compatibility Tool

Nástroj Intel® DPC++ Compatibility Tool pomáhá při migraci vývojářského programu napsaného v CUDA* na program napsaný v Data Parallel C++ (DPC++), který je založen na moderním C++ a zahrnuje přenosné průmyslové standardy, jako je SYCL*.

Další informace o nástroji naleznete v příručce Intel® DPC++ Compatibility Tool Developer Guide and Reference.
Známé problémy a nejaktuálnější informace najdete v poznámkách k verzi.

POZNÁMKA Použití nástroje Intel® DPC++ Compatibility Tool povede k projektu, který nebude zcela migrován. K dokončení migrace je zapotřebí další práce, jak je uvedeno ve výstupu nástroje Intel® DPC++ Compatibility Tool.

Než začnete

Nástroj Intel® DPC++ Compatibility Tool je součástí základní sady nástrojů Intel® oneAPI. Pokud jste nenainstalovali Intel® oneAPI Base Toolkit, postupujte podle pokynů v Instalační příručce.

Určité záhlaví CUDA files (specifické pro váš projekt) může být nutné zpřístupnit Intel® DPC++
Nástroj pro kompatibilitu. Nástroj Intel® DPC++ Compatibility Tool hledá tyto hlavičky CUDA files ve výchozích umístěních:

/usr/local/cuda/include
/usr/local/cuda-xy/include, kde xy je jedna z těchto hodnot: 8.0, 9.x, 10.x a 11.0–11.6.

Na vlastní umístění můžete odkazovat tak, že na ně ukážete pomocí –cuda-include-path= možnost v příkazovém řádku nástroje Intel® DPC++ Compatibility Tool.

POZNÁMKA Zahrnutá cesta CUDA by neměla být stejná nebo podřízená cesta adresáře, kde se nachází zdrojový kód, který je třeba migrovat.

V současné době nástroj Intel® DPC++ Compatibility Tool podporuje migraci programů implementovaných pomocí CUDA verze 8.0, 9.x, 10.xa 11.0–11.6. Seznam podporovaných jazyků a verzí může být v budoucnu rozšířen.

Chcete-li nastavit prostředí nástroje Intel® DPC++ Compatibility Tool, spusťte následující:

V systému Linux (sudo): zdroj /opt/intel/oneapi/setvars.sh
V systému Linux (uživatel): zdroj ~/intel/oneapi/setvars.sh
V systému Windows :Jednotka:\ Program Files (x86)\Intel\oneAPI\setvars.bat

Obecná syntaxe vyvolání z prostředí operačního systému je:

dpct [možnosti] [ … ]

POZNÁMKA c2s je alias příkazu dpct a lze jej použít místo něj.

Vestavěné informace o použití

Chcete-li zobrazit seznam specifických možností nástroje Intel® DPC++ Compatibility Tool, použijte –help:

dpct – pomoc

Chcete-li zobrazit seznam voleb jazykového analyzátoru (Clang*), předejte -help jako volbu Clang:

dpct — -pomoc

Vydaná varování

Nástroj Intel® DPC++ Compatibility Tool identifikuje místa v kódu, která mohou vyžadovat vaši pozornost během migrace files, aby byl kód SYCL kompatibilní nebo správný.
Komentáře se vkládají do vygenerovaného zdroje filesa zobrazí jako varování ve výstupu. Napřampten:

/cesta/k/file.hpp:26:1: varování: DPCT1003:0: Migrované rozhraní API nevrací kód chyby. (*,0) se vkládá. Možná budete muset tento kód přepsat. // řádek zdrojového kódu, pro který bylo vygenerováno varování ^

Další podrobnosti o tom, co konkrétní varování znamená, viz Diagnostická reference.

Další podrobnosti o tom, co konkrétní varování znamená, naleznete v Referenční příručce diagnostiky.

Migrujte jednoduchý testovací projekt

Nástroj Intel® DPC++ Compatibility Tool je dodáván s několika sample projects, abyste mohli nástroj prozkoumat a seznámit se s tím, jak funguje:

Sample Project	Popis
Vektor Přidat DPCT vector_add.cu	Vektor Přidat DPCT sample ukazuje, jak migrovat jednoduchý program z CUDA do SYCL. Vector Add poskytuje snadný způsob, jak ověřit, zda je vaše vývojové prostředí správně nastaveno pro použití nástroje Intel® DPC++ Compatibility Tool.
Možnosti složky DPCT hlavní.cu bar/util.cu bar/util.h	Možnosti složky DPCT sample ukazuje, jak migrovat složitější projekty a jak používat možnosti.
Rodinia NW DPCT jehla.cu jehla.h jehla_kernel.cu	Společnost Rodinia NW DPCT sample ukazuje, jak migrovat projekt Make/CMake z CUDA do SYCL pomocí nástroje Intel® DPC++ Compatibility Tool.

Review soubor README file součástí každého sample pro podrobnější informace o účelu a použití sample projekt.

Pro přístup k samples

pomocí nástroje oneapi-cli vyberte jakoample z kategorie Intel® DPC++ Compatibility Tool, popř
stáhnout samples od GitHub*.

Pro podrobnější informace o tom, jak stáhnout a získat přístup k sampnavštivte Příručky Začínáme s Intel® oneAPI Base Toolkit:

Zkuste Sample Project

Při migraci vektoru Add DPCT s postupujte podle následujících krokůampProjektujte pomocí nástroje Intel® DPC++ Compatibility Tool:

Stáhněte si soubor vector_add.cu sample.
Spusťte nástroj Intel® DPC++ Compatibility Tool ze sampkořenový adresář:

dpct –in-root=. src/vector_add.cu

Vector_add.dp.cpp file by se měl objevit v adresáři dpct_output. The file je nyní zdrojem SYCL file.
Přejděte na nový zdroj SYCL file:

cd dpct_output

Ověřte vygenerovaný zdrojový kód a opravte jakýkoli kód, který nástroj Intel® DPC++ Compatibility Tool nedokázal migrovat. (Kód použitý v tomto příkladuample je jednoduchý, takže ruční změny nemusí být nutné). Nejpřesnější a nejpodrobnější pokyny k řešení varování vydávaných nástrojem Intel® DPC++ Compatibility Tool naleznete v části Adresování varování v migrovaném kódu README files.

POZNÁMKA Chcete-li zkompilovat migrované sample, přidejte -I/include do vašeho kompilačního příkazu.

Pro složitější sampnávod viz Migrujte projekt části Intel® DPC++ Compatibility Tool Developer Guide and Reference.

Najít další

Obsah	Popis
Kompatibilita Intel® DPC++ Průvodce vývojářem nástrojů a Odkaz	Detailní konecview funkcí, pracovního postupu a použití nástroje Intel® DPC++ Compatibility Tool.
On-Demand Webinar: Migrace vaší stávající CUDA Kód do kódu DPC++	Jak migrovat kód CUDA do Data Parallel C++ (DPC++) pomocí nástroje Intel® DPC++ Compatibility Tool, jednorázového migračního nástroje, který portuje jak jádra, tak volání API.
Instalační příručky pro Intel® sady nástrojů oneAPI	Podrobné pokyny, jak získat a nainstalovat balíčky Intel® oneAPI pomocí různých režimů instalace a správců balíčků.
Verze specifikace SYCL 1.2.1 PDF	Specifikace SYCL ve formátu PDF. Vysvětluje, jak SYCL integruje zařízení OpenCL s moderním C++.
Specifikace SYCL 2020	Specifikace SYCL 2020 PDF.
Khronos* SYCL skončilview	Konecview SYCL poskytované společností Khronos Group.
Kompilace CUDA s clang	Popis podpory CUDA v clang.
Rozšíření Intel LLVM SYCL	Navrhovaná rozšíření specifikace SYCL.
Vrstvy pro projekt Yocto*	Přidejte jednu komponentu API do sestavení projektu Yocto pomocí vrstev meta-intel.