Intel DPC++ Compatibility Tool notendahandbók

Intel DPC++ samhæfingartól

Innihald fela sig

1 Byrjaðu með Intel® DPC+ + Compatibility Tool

1.1 Áður en þú byrjar

1.2 Sendar viðvaranir

1.3 Flytja einfalt prófunarverkefni

Byrjaðu með Intel® DPC+ + Compatibility Tool

Intel® DPC++ Compatibility Tool aðstoðar við flutning á forriti þróunaraðila sem er skrifað í CUDA* í forrit skrifað í Data Parallel C++ (DPC++), sem er byggt á nútíma C++ og inniheldur flytjanlega iðnaðarstaðla eins og SYCL*.

Skoðaðu Intel® DPC++ Compatibility Tool Developer Guide and Reference fyrir frekari upplýsingar um tólið.
Skoðaðu útgáfuskýringarnar fyrir þekkt vandamál og nýjustu upplýsingarnar.

ATH Notkun Intel® DPC++ Compatibility Tool mun leiða til verkefnis sem er ekki að öllu leyti flutt. Viðbótarvinna, eins og lýst er í framleiðslu Intel® DPC++ samhæfingartólsins, er nauðsynleg til að ljúka flutningnum.

Áður en þú byrjar

Intel® DPC++ samhæfingartólið er innifalið í Intel® oneAPI Base Toolkit. Ef þú hefur ekki sett upp Intel® oneAPI Base Toolkit skaltu fylgja leiðbeiningunum í uppsetningarhandbókinni.

Ákveðinn CUDA haus files (sérstakt fyrir verkefnið þitt) gæti þurft að vera aðgengilegt fyrir Intel® DPC++
Samhæfni tól. Intel® DPC++ samhæfingartólið leitar að þessum CUDA haus files á sjálfgefnum stöðum:

/usr/local/cuda/include
/usr/local/cuda-xy/include, þar sem xy er eitt af þessum gildum: 8.0, 9.x, 10.x og 11.0–11.6.

Þú getur vísað í sérsniðnar staðsetningar með því að benda á þær með –cuda-include-path= valmöguleika í Intel® DPC++ Compatibility Tool skipanalínunni.

ATH CUDA innihalda slóðin ætti ekki að vera sú sama og, eða undirslóð, möppunnar þar sem frumkóði sem þarf að flytja er staðsettur.

Eins og er, styður Intel® DPC++ samhæfingartólið flutning á forritum sem eru útfærð með CUDA útgáfum 8.0, 9.x, 10.x og 11.0–11.6. Listi yfir studd tungumál og útgáfur gæti verið framlengdur í framtíðinni.

Til að setja upp Intel® DPC++ Compatibility Tool umhverfið skaltu keyra eftirfarandi:

Á Linux (sudo): heimild /opt/intel/oneapi/setvars.sh
Á Linux (notandi): heimild ~/intel/oneapi/setvars.sh
Á Windows :Drive:\ Forrit Files (x86)\Intel\oneAPI\setvars.bat

Almenn ákallssetningafræði frá stýrikerfisskelinni er:

dpct [valkostir] [ … ]

ATH c2s er samnefni dpct skipunarinnar og má nota í staðinn.

Innbyggðar notkunarupplýsingar

Til að sjá lista yfir Intel® DPC++ Compatibility Tool-sérstaka valkosti, notaðu –help:

dpct -hjálp

Til að sjá listann yfir tungumálaþáttunarvalkostina (Clang*) skaltu nota -help sem Clang valmöguleikann:

dpct — -hjálp

Sendar viðvaranir

Intel® DPC++ samhæfingartólið auðkennir staðina í kóðanum sem gætu krafist athygli þinnar við flutning á files til að gera kóðann SYCL samhæfan eða réttan.
Athugasemdir eru settar inn í myndaða uppsprettu files og birtist sem viðvaranir í úttakinu. Til dæmisample:

/slóð/til/file.hpp:26:1: viðvörun: DPCT1003:0: Flutt API skilar ekki villukóða. (*,0) er sett inn. Þú gætir þurft að endurskrifa þennan kóða. // frumkóðalína sem viðvörun var búin til fyrir ^

Fyrir frekari upplýsingar um hvað tiltekin viðvörun þýðir, vísa til Tilvísun til greiningar.

Fyrir frekari upplýsingar um hvað tiltekin viðvörun þýðir, vísa til greiningartilvísunar.

Flytja einfalt prófunarverkefni

Intel® DPC++ samhæfingartólið kemur með nokkrum sampLe verkefni svo þú getir kannað tólið og kynnt þér hvernig það virkar:

SampLe Project	Lýsing
Vektor Bæta við DPCT vektor_add.cu	The Vector Add DPCT sampLe sýnir hvernig á að flytja einfalt forrit frá CUDA til SYCL. Vector Add veitir auðvelda leið til að sannreyna að þróunarumhverfið þitt sé rétt uppsett til að nota Intel® DPC++ samhæfingartólið.
Möppuvalkostir DPCT main.cu bar/util.cu bar/util.h	Möppuvalkostirnir DPCT sampLe sýnir hvernig á að flytja flóknari verkefni og nota valkosti.
Rodinia NW DPCT nál.cu nál.h needle_kernel.cu	Rodinia NW DPCT sampLe sýnir hvernig á að flytja Make/ CMake verkefni frá CUDA til SYCL með því að nota Intel® DPC++ samhæfingartólið.

Review README file fylgir hverri sample fyrir ítarlegri upplýsingar um tilgang og notkun sample verkefnið.

Til að fá aðgang að samples

notaðu oneapi-cli tólið til að velja semample úr Intel® DPC++ Compatibility Tool flokki, eða

hlaða niður samples frá GitHub*.

Fyrir frekari upplýsingar um hvernig á að hlaða niður og fá aðgang að samples, heimsækja Intel® oneAPI Base Toolkit Byrjaðu leiðbeiningar:

Byrjaðu handbók með Intel® oneAPI Base Toolkit fyrir Windows*

Prófaðu SampLe Project

Fylgdu þessum skrefum til að flytja Vector Add DPCT sampverkefnið með því að nota Intel® DPC++ samhæfingartólið:

Sæktu vektor_add.cu sample.
Keyrðu Intel® DPC++ Compatibility Tool frá samprótarskrá:

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

Vector_add.dp.cpp file ætti að birtast í dpct_output möppunni. The file er nú SYCL source file.
Farðu í nýja SYCL upprunann file:

cd dpct_output

Staðfestu frumkóðann sem myndast og lagfærðu hvaða kóða sem Intel® DPC++ Samhæfingartólið gat ekki flutt. (Kóðinn sem notaður er í þessu tdample er einfalt, svo ekki er víst að þörf sé á handvirkum breytingum). Fyrir nákvæmustu og ítarlegustu leiðbeiningarnar um að bregðast við viðvörunum sem sendar eru frá Intel® DPC++ samhæfingartólinu, sjá kaflann Addressing Warnings in Migrated Code í README files.

ATH Til að setja saman flutta sample, bættu -I/include við compile skipuninni þinni.

Fyrir flóknari sample leiðbeiningar, sjá Flytja verkefni hluta Intel® DPC++ Compatibility Tool Developer Guide and Reference.

Finndu meira

Efni	Lýsing
Intel® DPC++ samhæfni Verkfærahönnuðahandbók og Tilvísun	Ítarleg yfirview af Intel® DPC++ Compatibility Tool eiginleikum, verkflæði og notkun.
Á-eftirspurn Webinar: Flytja núverandi CUDA Kóði í DPC++ kóða	Hvernig á að flytja CUDA kóða yfir í Data Parallel C++ (DPC++) með því að nota Intel® DPC++ Compatibility Tool, einskiptis flutningsvél sem flytur bæði kjarna og API símtöl.
Uppsetningarleiðbeiningar fyrir Intel® oneAPI verkfærasett	Ítarlegar leiðbeiningar um hvernig á að fá og setja upp Intel® oneAPI pakka með því að nota mismunandi uppsetningarstillingar og pakkastjóra.
SYCL forskrift útgáfa 1.2.1 PDF	SYCL forskrift PDF. Útskýrir hvernig SYCL samþættir OpenCL tæki við nútíma C++.
SYCL 2020 forskrift	SYCL 2020 forskriftin PDF.
Khronos* SYCL lokiðview	Yfirview af SYCL frá Khronos Group.
Að setja saman CUDA með clang	Lýsing á CUDA stuðningi í clang.
Intel LLVM SYCL viðbætur	Fyrirhugaðar framlengingar á SYCL forskriftinni.
Lög fyrir Yocto* verkefnið	Bættu einum API íhlutum við Yocto verkefnisbyggingu með því að nota meta-intel lögin.