56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
|
# NVRTCC
|
||
|
|
|
||
|
|
## How to use:
|
||
|
|
|
||
|
|
Configure libcudacxx to test with NVRTC and `cmake --build` the project before executing `lit`.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
cmake ... -DLIBCUDACXX_TEST_WITH_NVRTC=ON
|
||
|
|
cmake --build $BUILD_DIR
|
||
|
|
lit ... $TEST_DIR
|
||
|
|
```
|
||
|
|
|
||
|
|
## How it works
|
||
|
|
|
||
|
|
`nvrtcc` processes incoming arguments matching for flags that modify its behavior, and passes the rest to NVRTC.
|
||
|
|
It will hopefully filter any that don't apply (gcc warnings and such).
|
||
|
|
|
||
|
|
The input file is processed to be compatible with NVRTC similarly to the `nvrtc.sh` scripts during compilation.
|
||
|
|
The resulting file is then compiled with NVRTC and stored as a fatbin. This is, in effect, a compilation pass for NVRTC.
|
||
|
|
`.fail.cpp` tests will be analyzable by lit and should work properly.
|
||
|
|
|
||
|
|
For execution, the fatbin file is provided to nvrtcc again, but will instead launch the precompiled test unit on the GPU.
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
flowchart TD;
|
||
|
|
compile{nvrtcc};
|
||
|
|
runfat{nvrtcc};
|
||
|
|
|
||
|
|
start[Execute lit]
|
||
|
|
build(Execute nvrtcc)
|
||
|
|
pass(Pass: Continue)
|
||
|
|
fail(Fail: Compile time failure)
|
||
|
|
save[Save fatbin]
|
||
|
|
|
||
|
|
load[Load fatbin]
|
||
|
|
testpass[Pass: No failures]
|
||
|
|
testfail[Fail: Report driver error]
|
||
|
|
|
||
|
|
save --> load;
|
||
|
|
|
||
|
|
subgraph Build Pass
|
||
|
|
start -- lit -sv -Denable_nvrtc=true --> build;
|
||
|
|
build -- nvrtcc -x cu test.pass.cpp ... --> compile;
|
||
|
|
compile --> fail;
|
||
|
|
compile --> pass;
|
||
|
|
pass --> save;
|
||
|
|
end
|
||
|
|
|
||
|
|
|
||
|
|
subgraph Test Pass
|
||
|
|
load -- nvrtcc test.pass.cpp.fatbin --> runfat;
|
||
|
|
runfat --> testpass
|
||
|
|
runfat --> testfail
|
||
|
|
end
|
||
|
|
```
|