Ghidul utilizatorului instrumentului de compatibilitate intel DPC++

Instrument de compatibilitate intel DPC++ 

Începeți cu instrumentul de compatibilitate Intel® DPC+ +

Instrumentul de compatibilitate Intel® DPC++ ajută la migrarea programului unui dezvoltator care este scris în CUDA* la un program scris în Data Parallel C++ (DPC++), care se bazează pe C++ modern și încorporează standarde portabile ale industriei, cum ar fi SYCL*.

• Vizitați Ghidul și Referința pentru dezvoltatori a instrumentului de compatibilitate Intel® DPC++ pentru informații suplimentare despre instrument.
• Vizitați Notele de lansare pentru problemele cunoscute și cele mai actualizate informații.

NOTA Utilizarea instrumentului de compatibilitate Intel® DPC++ va avea ca rezultat un proiect care nu este migrat în întregime. Pentru a finaliza migrarea, este necesară muncă suplimentară, așa cum este subliniată de rezultatul Instrumentului de compatibilitate Intel® DPC++.

Înainte de a începe

Instrumentul de compatibilitate Intel® DPC++ este inclus în setul de instrumente de bază Intel® oneAPI. Dacă nu ați instalat Intel® oneAPI Base Toolkit, urmați instrucțiunile din Ghidul de instalare.

Anumit antet CUDA files (specifice pentru proiectul dvs.) poate trebui să fie accesibile pentru Intel® DPC++
Instrument de compatibilitate. Instrumentul de compatibilitate Intel® DPC++ caută aceste antete CUDA files în locațiile implicite:

• /usr/local/cuda/include
• /usr/local/cuda-xy/include, unde xy este una dintre aceste valori: 8.0, 9.x, 10.x și 11.0–11.6.

Puteți face referire la locații personalizate arătând spre ele cu –cuda-include-path= opțiunea din linia de comandă Intel® DPC++ Compatibility Tool.

NOTA Calea de includere CUDA nu trebuie să fie aceeași cu sau o cale secundară a directorului în care se află codul sursă care trebuie migrat.

În prezent, Instrumentul de compatibilitate Intel® DPC++ acceptă migrarea programelor implementate cu versiunile CUDA 8.0, 9.x, 10.x și 11.0–11.6. Lista de limbi și versiuni acceptate poate fi extinsă în viitor.

Pentru a configura mediul Intel® DPC++ Compatibility Tool, rulați următoarele:

• Pe Linux (sudo): sursa /opt/intel/oneapi/setvars.sh
• Pe Linux (utilizator): sursa ~/intel/oneapi/setvars.sh
• Pe Windows :Drive:\ Program Files (x86)\Intel\oneAPI\setvars.bat

Sintaxa generală de invocare din shell-ul sistemului de operare este:

NOTA c2s este un alias al comenzii dpct și poate fi folosit în locul lui.

Informații de utilizare încorporate 

Pentru a vedea lista de opțiuni specifice Instrumentului de compatibilitate Intel® DPC++, utilizați –help:

Pentru a vedea lista de opțiuni pentru analizatorul de limbă (Clang*), treceți -help ca opțiune Clang:

Avertismente emise

Instrumentul de compatibilitate Intel® DPC++ identifică locurile din cod care ar putea necesita atenția dvs. în timpul migrării files pentru a face codul SYCL compatibil sau corect.
Comentariile sunt inserate în sursa generată files și afișate ca avertismente în ieșire. De examppe:

Pentru mai multe detalii despre ce înseamnă un anumit avertisment, consultați Referință de diagnostic.

Pentru mai multe detalii despre ce înseamnă un anumit avertisment, consultați Referința de diagnosticare.

Migrați un proiect de testare simplu

Instrumentul de compatibilitate Intel® DPC++ vine cu mai multe dispozitiveample proiecte astfel încât să puteți explora instrumentul și să vă familiarizați cu modul în care funcționează:

Review README file prevazut cu fiecare sample pentru informații mai detaliate despre scopul și utilizarea sample proiect.

Pentru a accesa samples

• utilizați utilitarul oneapi-cli pentru a selecta caampfișier din categoria Instrument de compatibilitate Intel® DPC++ sau
• descărcați samples din GitHub*.

Pentru informații mai detaliate despre cum să descărcați și să accesați fișierul sampaccesați Ghidurile de început pentru Intel® oneAPI Base Toolkit:

• Ghid de început cu setul de instrumente de bază Intel® oneAPI pentru Windows*
• Începeți cu setul de instrumente de bază Intel® oneAPI pentru Linux*
• Începeți cu Intel® oneAPI Base Toolkit pentru macOS*

Încearcă un Sample Project 

Urmați acești pași pentru a migra Vector Add DPCTampproiectul folosind instrumentul de compatibilitate Intel® DPC++:

1. Descărcați vector_add.cu sample.
2. Rulați Instrumentul de compatibilitate Intel® DPC++ din sampdirectorul rădăcină al fișierului:
   

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

    

   Vector_add.dp.cpp file ar trebui să apară în directorul dpct_output. The file este acum o sursă SYCL file.

3. Navigați la noua sursă SYCL file:

Verificați codul sursă generat și reparați orice cod pe care Instrumentul de compatibilitate Intel® DPC++ nu l-a putut migra. (Codul folosit în acest exampfișierul este simplu, așa că este posibil să nu fie necesare modificări manuale). Pentru instrucțiunile cele mai precise și detaliate despre adresarea avertismentelor emise de Instrumentul de compatibilitate Intel® DPC++, consultați secțiunea Avertismente privind adresarea în codul migrat din CITEȘTE-MĂ files.

NOTA Pentru a compila s. migratample, adaugă -I/include la comanda ta de compilare.

Pentru s mai complexample instrucțiuni, vezi Migrați un proiect secțiunea Intel® DPC++ Compatibility Tool Developer Guide and Reference.

Găsiți mai multe