intel Magsimula sa oneAPI DPC ++/C++ Compiler User Guide

Mga nilalaman magtago

1 intel Magsimula sa oneAPI DPC ++/C++ Compiler

2 PANIMULA

3 Magsimula sa Linux

3.1 Bago Ka Magsimula

4 Magsimula sa Windows

4.1 Bago Ka Magsimula

5 Mga Dokumento / Mga Mapagkukunan

5.1 Mga sanggunian

6 Mga Kaugnay na Post

intel Magsimula sa oneAPI DPC ++/C++ Compiler

PANIMULA

Ang Intel® oneAPI DPC++/C++ Compiler ay nagbibigay ng mga pag-optimize na tumutulong sa iyong mga application na tumakbo nang mas mabilis sa mga arkitektura ng Intel® 64 sa Windows* at Linux*, na may suporta para sa pinakabagong mga pamantayan sa wikang C, C++, at SYCL. Ang compiler na ito ay gumagawa ng na-optimize na code na maaaring tumakbo nang mas mabilis sa pamamagitan ng pagkuha ng advantage ng patuloy na tumataas na bilang ng core at lapad ng rehistro ng vector sa mga processor ng Intel® Xeon® at mga katugmang processor. Tutulungan ka ng Intel® Compiler na palakasin ang performance ng application sa pamamagitan ng superior optimizations at Single Instruction Multiple Data (SIMD) vectorization, integration sa Intel® Performance Libraries, at sa pamamagitan ng paggamit ng OpenMP* 5.0/5.1 parallel programming model.

Ang Intel® oneAPI DPC++/C++ Compiler ay nag-compile ng C++-based na SYCL* na source files para sa malawak na hanay ng mga compute accelerators.
Ang Intel® oneAPI DPC++/C++ Compiler ay bahagi ng Intel® oneAPI Toolkits.

Maghanap ng Higit Pa

Paglalarawan ng Nilalaman at Mga Link

Mga Tala sa Paglabas Bisitahin ang pahina ng Mga Tala sa Paglabas para sa mga kilalang isyu at ang pinaka-up-to-date na impormasyon.

Intel® oneAPI Programming Guide Nagbibigay ng mga detalye sa Intel® oneAPI DPC++/C++ Compiler

programming model, kabilang ang mga detalye tungkol sa SYCL* at OpenMP* offload, programming para sa iba't ibang target accelerators, at mga pagpapakilala sa Intel® oneAPI library.

Intel® oneAPI DPC++/C++ I-explore ang Intel® oneAPI DPC++/C++ Compiler feature at setup at Gabay sa Developer ng Compiler at makakuha ng mas detalyadong impormasyon tungkol sa mga opsyon sa compiler, mga katangian, at Sanggunian higit pa.

oneAPI Code Samples I-explore ang pinakabagong oneAPI code samples.

• Intel® oneAPI Data Parallel C+ Magtanong at maghanap ng mga sagot sa Intel® oneAPI Data Parallel C+

+ Forum + at mga forum ng Intel® C++ Compiler.

• Intel® C++ Compiler Forum

Intel® oneAPI DPC++/C++ Galugarin ang mga tutorial, materyales sa pagsasanay, at iba pang Intel® oneAPI Compiler Documentation Dokumentasyon ng DPC++/C++ Compiler.

SYCL Specification Bersyon 1.2.1 Ang detalye ng SYCL, ay nagpapaliwanag kung paano isinasama ng SYCL ang mga OpenCL device PDF na may modernong C++.

https://www.khronos.org/sycl/ Isang taposview ng SYCL.

Ang GNU* C++ Library – Paggamit Ang dokumentasyon ng GNU* C++ Library sa paggamit ng dalawahang ABI. Dual ABI

Mga Layer para sa Yocto* Project Magdagdag ng mga bahagi ng oneAPI sa isang Yocto project build gamit ang meta-intel

mga layer.

Mga Paunawa at Disclaimer
Ang mga teknolohiyang Intel ay maaaring mangailangan ng pag-activate ng hardware, software o serbisyo.

Walang produkto o bahagi ang maaaring maging ganap na ligtas.
Ang iyong mga gastos at resulta ay maaaring magkakaiba.

© Intel Corporation. Ang Intel, ang logo ng Intel, at iba pang mga marka ng Intel ay mga trademark ng Intel Corporation o mga subsidiary nito. Maaaring i-claim ang ibang mga pangalan at brand bilang pag-aari ng iba.

Walang lisensya (ipahayag o ipinahiwatig, sa pamamagitan ng estoppel o kung hindi man) sa anumang mga karapatan sa intelektwal na ari-arian ang ibinibigay ng dokumentong ito.
Ang mga produktong inilarawan ay maaaring naglalaman ng mga depekto sa disenyo o mga error na kilala bilang errata na maaaring maging sanhi ng paglihis ng produkto mula sa mga nai-publish na mga detalye. Available ang kasalukuyang characterized errata kapag hiniling.

Tinatanggihan ng Intel ang lahat ng ipinahayag at ipinahiwatig na mga warranty, kabilang ang walang limitasyon, ang mga ipinahiwatig na warranty ng kakayahang maikalakal, pagiging angkop para sa isang partikular na layunin, at hindi paglabag, pati na rin ang anumang warranty na nagmumula sa kurso ng pagganap, kurso ng pakikitungo, o paggamit sa kalakalan.

Magsimula sa Linux

Bago Ka Magsimula

Itakda ang Mga Variable ng Environment
Bago mo magamit ang compiler, dapat mo munang itakda ang mga variable ng kapaligiran sa pamamagitan ng pagkuha ng script ng kapaligiran gamit ang utility sa pagsisimula. Sinisimulan nito ang lahat ng mga tool sa isang hakbang.

Tukuyin ang iyong direktoryo ng pag-install, :
- a. Kung ang iyong compiler ay na-install sa default na lokasyon ng isang root user o sudo user, ang compiler ay mai-install sa ilalim ng/opt/intel/oneapi. Sa kasong ito, ay /opt/intel/oneapi.
- b. Para sa mga di-root na user, ginagamit ang iyong home directory sa ilalim ng intel/oneapi. Sa kasong ito,
  ay magiging $HOME/intel/oneapi.
- c. Para sa mga gumagamit ng cluster o enterprise, maaaring na-install ng iyong admin team ang mga compiler sa isang nakabahaging network file sistema. Tingnan sa iyong lokal na kawani ng admin para sa lokasyon ng pag-install
  ( ).

Source ang environment-setting script para sa iyong shell:
- a. bash: source /setvars.sh intel64
- b. csh/tcsh: pinagmulan /setvars.csh intel64

I-install ang mga GPU Driver o Plug-in (Opsyonal)
Maaari kang bumuo ng mga oneAPI application gamit ang C++ at SYCL* na tatakbo sa Intel, AMD*, o NVIDIA* GPUs. Upang bumuo at magpatakbo ng mga application para sa mga partikular na GPU kailangan mo munang i-install ang mga kaukulang driver o plug-in:

Upang gumamit ng Intel GPU, i-install ang pinakabagong mga driver ng Intel GPU.
Para gumamit ng AMD GPU, i-install ang oneAPI para sa AMD GPUs plugin.

Para gumamit ng NVIDIA GPU, i-install ang oneAPI para sa NVIDIA GPUs plugin.

Opsyon 1: Gamitin ang Command Line
Ang Intel® oneAPI DPC++/C++ Compiler ay nagbibigay ng maraming driver:

I-invoke ang compiler gamit ang sumusunod na syntax:
{compiler driver} [opsyon] file1 [file2…]

Para kay example:
icpx hello-world.cpp

Para sa SYCL compilation, gamitin ang -fsycl na opsyon sa C++ driver:
icpx -fsycl hello-world.cpp

TANDAAN: Kapag gumagamit ng -fsycl, -fsycl-targets=spir64 ay ipinapalagay maliban kung ang -fsycl-targets ay tahasang itinakda sa command.
Kung nagta-target ka ng NVIDIA o AMD GPU, sumangguni sa kaukulang GPU plugin na gabay sa pagsisimula para sa mga detalyadong tagubilin sa pag-compile:

oneAPI para sa NVIDIA GPUs Gabay sa Pagsisimula

oneAPI para sa mga AMD GPU Gabay sa Pagsisimula

Opsyon 2: Gamitin ang Eclipse* CDT
Sundin ang mga hakbang na ito para ma-invoke ang compiler mula sa loob ng Eclipse* CDT.

I-install ang plugin ng Intel® Compiler Eclipse CDT.

Simulan ang Eclipse
Piliin ang Tulong > I-install ang Bagong Software
Piliin ang Idagdag upang buksan ang dialog na Magdagdag ng Site
Piliin ang Archive, mag-browse sa direktoryo /compiler/ /linux/ide_support, piliin ang .zip file na nagsisimula sa com.intel.dpcpp.compiler, pagkatapos ay piliin ang OK
Piliin ang mga opsyon na nagsisimula sa Intel, piliin ang Susunod, pagkatapos ay sundin ang mga tagubilin sa pag-install
Kapag tinanong kung gusto mong i-restart ang Eclipse*, piliin ang Oo

Bumuo ng bagong proyekto o magbukas ng kasalukuyang proyekto.

Buksan ang Umiiral na Proyekto o Gumawa ng Bagong Proyekto sa Eclipse
Mag-right click sa Project > Properties > C/C++ Build > Tool chain Editor
Piliin ang Intel DPC++/C++ Compiler mula sa kanang panel

Itakda ang mga configuration ng build.

Buksan ang Umiiral na Proyekto sa Eclipse
Mag-right click sa Project > Properties > C/C++ Build > Settings
Gumawa o pamahalaan ang mga configuration ng build sa kanang panel

Bumuo ng Programa Mula sa Command Line
Gamitin ang mga sumusunod na hakbang upang subukan ang iyong pag-install ng compiler at bumuo ng isang program.

Gumamit ng text editor upang lumikha ng a file tinatawag na hello-world.cpp na may mga sumusunod na nilalaman:

I-compile ang hello-world.cpp:
icpx hello-world.cpp -o hello-world
Ang -o na opsyon ay tumutukoy sa file pangalan para sa nabuong output.
Ngayon ay mayroon ka nang executable na tinatawag na hello-world na maaaring patakbuhin at magbibigay ng agarang feedback:

Aling mga output
Maaari mong idirekta at kontrolin ang compiler gamit ang mga opsyon sa compiler. Para kay example, maaari kang lumikha ng bagay file at i-output ang panghuling binary sa dalawang hakbang:

I-compile ang hello-world.cpp:Pinipigilan ng -c na opsyon ang pag-link sa hakbang na ito.
Gamitin ang icpx compiler upang i-link ang resultang application object code at mag-output ng isang executable:
Tinutukoy ng opsyong -o ang nabuong executable file pangalan. Sumangguni sa Compiler Options para sa mga detalye tungkol sa mga available na opsyon.

Magsimula sa Windows

Bago Ka Magsimula

Itakda ang Mga Variable ng Environment
Sumasama ang compiler sa mga sumusunod na bersyon ng Microsoft Visual Studio*:

Visual Studio 2022
Visual Studio 2019
Visual Studio 2017

TANDAAN Ang suporta para sa Microsoft Visual Studio 2017 ay hindi na ginagamit simula sa paglabas ng Intel® oneAPI 2022.1 at aalisin sa isang release sa hinaharap.

Para sa buong functionality sa loob ng Visual Studio, kabilang ang pag-debug at pag-develop, kinakailangan ang Visual Studio Community Edition o mas mataas. Binibigyang-daan lamang ng Visual Studio Express Edition ang mga command-line build. Para sa lahat ng bersyon, dapat piliin ang suporta ng Microsoft C++ bilang bahagi ng pag-install ng Visual Studio. Para sa Visual Studio 2017 at mas bago, dapat kang gumamit ng custom na pag-install upang piliin ang opsyong ito.
Karaniwang hindi mo kailangang itakda ang mga variable ng kapaligiran sa Windows, dahil awtomatikong itinatakda ng compiler command-line window ang mga variable na ito para sa iyo. Kung kailangan mong itakda ang mga variable ng kapaligiran, patakbuhin ang script ng kapaligiran tulad ng inilarawan sa dokumentasyong Magsimula na partikular sa suite.
Ang default na direktoryo ng pag-install ( ) ay C:\Program Files (x86)\Intel\oneAPI.

I-install ang mga GPU Driver (Opsyonal)
Upang bumuo at magpatakbo ng mga application para sa mga Intel GPU kailangan mo munang i-install ang pinakabagong mga driver ng Intel GPU.

Opsyon 1: Gamitin ang Command Line sa Microsoft Visual Studio

Ang Intel® oneAPI DPC++/C++ Compiler ay nagbibigay ng maraming driver:

I-invoke ang compiler gamit ang sumusunod na syntax:

Upang i-invoke ang compiler gamit ang command line mula sa loob ng Microsoft Visual Studio, magbukas ng command prompt at ilagay ang iyong compilation command. Para kay example:

Para sa SYCL compilation, gamitin ang -fsycl na opsyon sa C++ driver:

TANDAAN: Kapag gumagamit ng -fsycl, -fsycl-targets=spir64 ay ipinapalagay maliban kung ang -fsycl-targets ay tahasang itinakda sa command.

Opsyon 2: Gamitin ang Microsoft Visual Studio
Project Support para sa Intel® DPC++/C++ Compiler sa Microsoft Visual Studio
Ang mga bagong proyekto ng Microsoft Visual Studio para sa DPC++ ay awtomatikong na-configure upang gamitin ang Intel® oneAPI DPC++/C++ Compiler.
Ang mga bagong proyekto ng Microsoft Visual C++* (MSVC) ay dapat na manu-manong i-configure upang magamit ang Intel® oneAPI DPC++/C++ Compiler.

TANDAAN: Ang mga uri ng proyekto ng CLR C++ na nakabase sa NET ay hindi sinusuportahan ng Intel® oneAPI DPC++/C++ Compiler. Ang mga partikular na uri ng proyekto ay mag-iiba depende sa iyong bersyon ng Visual Studio, halimbawaample: CLR Class Library, CLR Console App, o CLR Empty Project.

Gamitin ang Intel® DPC++/C++ Compiler sa Microsoft Visual Studio
Ang mga eksaktong hakbang ay maaaring mag-iba depende sa bersyon ng Microsoft Visual Studio na ginagamit.

Gumawa ng proyekto ng Microsoft Visual C++ (MSVC) o magbukas ng kasalukuyang proyekto.
Sa Solution Explorer, piliin ang (mga) proyektong gagawin gamit ang Intel® oneAPI DPC++/C++ Compiler.
Buksan ang Project > Properties .

Sa kaliwang pane, palawakin ang kategorya ng Configuration Properties at piliin ang page ng General property.
Sa kanang pane baguhin ang Platform Toolset sa compiler na gusto mong gamitin:
- Para sa C++ na may SYCL, piliin ang Intel® oneAPI DPC++ Compiler.
- Para sa C/C++, mayroong dalawang toolset.
  Piliin ang Intel C++ Compiler (halample 2021) para i-invoke ang icx.
  Piliin ang Intel C++ Compiler (halample 19.2) para i-invoke ang icl.
  Bilang kahalili, maaari mong tukuyin ang bersyon ng compiler bilang toolset para sa lahat ng sinusuportahang platform at configuration ng (mga) napiling proyekto sa pamamagitan ng pagpili sa Project > Intel Compiler > Use Intel oneAPI DPC++/C++ Compiler.
I-rebuild, gamit ang alinman sa Build > Project only > Rebuild para sa isang proyekto o Build > Rebuild Solution para sa isang solusyon.

Piliin ang Bersyon ng Compiler
Kung marami kang bersyon ng Intel® oneAPI DPC++/C++ Compiler na naka-install, maaari mong piliin kung aling bersyon ang gusto mo mula sa dialog box ng Compiler Selection:

Pumili ng proyekto, pagkatapos ay pumunta sa Tools > Options > Intel Compiler and Libraries > > Compiler, kung saan ang mga halaga ay C++ o DPC++.
Gamitin ang drop-down na menu ng Selected Compiler upang piliin ang naaangkop na bersyon ng compiler.
Piliin ang OK.

Lumipat Bumalik sa Microsoft Visual Studio C++ Compiler
Kung ang iyong proyekto ay gumagamit ng Intel® oneAPI DPC++/C++ Compiler, maaari mong piliing lumipat pabalik sa Microsoft Visual C++ compiler:

Piliin ang iyong proyekto sa Microsoft Visual Studio.
I-right-click at piliin ang Intel Compiler > Gamitin ang Visual C++ mula sa menu ng konteksto.

Ina-update ng pagkilos na ito ang solusyon file upang gamitin ang Microsoft Visual Studio C++ compiler. Lahat ng configuration ng mga apektadong proyekto ay awtomatikong nililinis maliban kung pipiliin mo ang Huwag linisin ang (mga) proyekto. Kung pipiliin mong hindi linisin ang mga proyekto, kakailanganin mong buuin muli ang mga na-update na proyekto upang matiyak ang lahat ng pinagmulan files ay pinagsama-sama sa bagong compiler.

Bumuo ng Programa Mula sa Command Line
Gamitin ang mga sumusunod na hakbang upang subukan ang iyong pag-install ng compiler at bumuo ng isang program.

Gumamit ng text editor upang lumikha ng a file tinatawag na hello-world.cpp na may mga sumusunod na nilalaman:
#isama int main() std::cout << “Kumusta, mundo!\n”; bumalik 0;

I-compile ang hello-world.cpp:
icx hello-world.cpp
Ngayon ay mayroon kang executable na tinatawag na hello-world.exe na maaaring patakbuhin at magbibigay ng agarang feedback:
hello-world.exe

Aling mga output:
Hello, mundo!

Maaari mong idirekta at kontrolin ang compiler gamit ang mga opsyon sa compiler. Para kay example, maaari kang lumikha ng bagay file at i-output ang panghuling binary sa dalawang hakbang:

I-compile ang hello-world.cpp:
icx hello-world.cpp /c /Fohello-world.obj
Pinipigilan ng pagpipiliang /c ang pag-link sa hakbang na ito at tinukoy ng /Fo ang pangalan para sa bagay file.
Gamitin ang icx compiler upang i-link ang resultang application object code at mag-output ng isang executable:
icx hello-world.obj /Fehello-world.exe

Tinutukoy ng opsyong /Fe ang nabuong executable file pangalan. Sumangguni sa Compiler Options para sa mga detalye tungkol sa mga available na opsyon.

I-compile at Isagawa ang Sampang Code

Maramihang code sampAng mga ito ay ibinibigay para sa Intel® oneAPI DPC++/C++ Compiler para ma-explore mo ang mga feature ng compiler at maging pamilyar ka sa kung paano ito gumagana. Para kay example: