Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add NVCC inability to compile .hip files notice and workaround #3650

Open
wants to merge 10 commits into
base: docs/develop
Choose a base branch
from
Open

Add NVCC inability to compile .hip files notice and workaround #3650

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
bc75f73
Add NVCC inability to compile .hip files notice and workaround
Oct 28, 2024
d29cbd4
Update deprecated API list
neon60 Oct 23, 2024
14b9b5a
Correct Porting Guide Macros
harkgill-amd Oct 9, 2024
510df8e
Add what is HIP
neon60 Oct 24, 2024
4ecb218
Update FAQ
MKKnorr Oct 30, 2024
68b03fe
Docs: Fix broken refs
MKKnorr Oct 30, 2024
2c18280
Add HIP environment variables
neon60 Nov 5, 2024
5a23e77
Amend docs note to be included as a callout instead of an extra topic…
Nov 8, 2024
af3127f
remove how-to/faq.md page
Nov 8, 2024
15b71da
Use double `` backticks for unformatted text blocks in .rst file instead
Nov 8, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ APU
APUs
AQL
AXPY
asm
Asynchrony
backtrace
Bitcode
Expand All @@ -15,6 +16,7 @@ builtins
Builtins
CAS
clr
compilable
coroutines
Ctx
cuBLASLt
Expand Down Expand Up @@ -48,6 +50,7 @@ FNUZ
fp
gedit
GPGPU
GROMACS
GWS
hardcoded
HC
Expand All @@ -58,13 +61,15 @@ hipcc
hipCtx
hipexamine
hipified
HIPify
hipModule
hipModuleLaunchKernel
hipother
HIPRTC
icc
IILE
iGPU
inlined
inplace
Interoperation
interoperate
Expand All @@ -75,6 +80,7 @@ intrinsics
IPC
IPs
isa
iteratively
Lapack
latencies
libc
Expand All @@ -87,6 +93,7 @@ ltrace
makefile
Malloc
malloc
MALU
memset
multicore
multigrid
Expand All @@ -101,6 +108,7 @@ NOP
Numa
Nsight
ocp
omnitrace
overindex
overindexing
oversubscription
Expand All @@ -111,13 +119,15 @@ preconditioners
predefining
prefetched
preprocessor
profilers
PTX
PyHIP
queryable
prefetching
quad
representable
RMW
rocgdb
ROCm's
rocTX
roundtrip
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ HIP releases are typically naming convention for each ROCM release to help diffe
## More Info

* [Installation](docs/install/install.rst)
* [HIP FAQ](docs/how-to/faq.md)
* [HIP FAQ](docs/faq.rst)
* [HIP C++ Language Extensions](docs/reference/cpp_language_extensions.rst)
* [HIP Porting Guide](docs/how-to/hip_porting_guide.md)
* [HIP Porting Driver Guide](docs/how-to/hip_porting_driver_api.md)
Expand Down
3 changes: 2 additions & 1 deletion docs/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,5 +50,6 @@

exclude_patterns = [
"doxygen/mainpage.md",
"understand/glossary.md"
"understand/glossary.md",
'how-to/debugging_env.rst'
]
157 changes: 157 additions & 0 deletions docs/data/what_is_hip/hip.drawio
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,157 @@
<mxfile host="65bd71144e">
<diagram id="zBbb_w2fufU70cdOGtND" name="1 oldal">
<mxGraphModel dx="1547" dy="1302" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="660" pageHeight="610" background="none" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="6033" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#5E5B61;fontColor=#FFFFFF;strokeColor=none;spacing=0;" parent="1" vertex="1">
<mxGeometry x="110" y="-320" width="480" height="490" as="geometry"/>
</mxCell>
<mxCell id="5981" value="" style="group" parent="1" vertex="1" connectable="0">
<mxGeometry x="130" y="60" width="210" height="90" as="geometry"/>
</mxCell>
<mxCell id="5982" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#333333;fontColor=#FFFFFF;strokeColor=none;" parent="5981" vertex="1">
<mxGeometry width="210" height="90" as="geometry"/>
</mxCell>
<mxCell id="5983" value="" style="group" parent="5981" vertex="1" connectable="0">
<mxGeometry x="7.7419872652362365" y="8" width="192.50000000000003" height="45" as="geometry"/>
</mxCell>
<mxCell id="5984" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#60a917;fontColor=#ffffff;strokeColor=#2D7600;" parent="5983" vertex="1">
<mxGeometry y="2" width="192.50000000000003" height="45" as="geometry"/>
</mxCell>
<mxCell id="5985" value="&lt;div&gt;NVIDIA runtime&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="5983" vertex="1">
<mxGeometry x="11.998194444444442" y="13.01" width="168.50166666666664" height="18.99" as="geometry"/>
</mxCell>
<mxCell id="5986" value="&lt;font style=&quot;&quot;&gt;NVIDIA Platform&lt;/font&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="5981" vertex="1">
<mxGeometry x="40" y="63" width="130" height="20" as="geometry"/>
</mxCell>
<mxCell id="5987" value="" style="endArrow=classic;startArrow=none;html=1;rounded=0;strokeWidth=2;startFill=0;strokeColor=#FFFFFF;" parent="1" edge="1">
<mxGeometry width="50" height="50" relative="1" as="geometry">
<mxPoint x="315" y="45" as="sourcePoint"/>
<mxPoint x="315" y="70" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="5988" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#9C2A44;fontColor=#FFFFFF;strokeColor=#4c1523;strokeWidth=5;" parent="1" vertex="1">
<mxGeometry x="300" y="-17" width="260" height="60" as="geometry"/>
</mxCell>
<mxCell id="5989" value="&lt;font style=&quot;font-size: 14px;&quot; face=&quot;Helvetica&quot;&gt;HIP&lt;/font&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;strokeWidth=2;" parent="1" vertex="1">
<mxGeometry x="300" y="-17" width="260" height="20" as="geometry"/>
</mxCell>
<mxCell id="5990" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#333333;fontColor=#FFFFFF;strokeColor=none;" parent="1" vertex="1">
<mxGeometry x="350" y="60" width="210" height="90" as="geometry"/>
</mxCell>
<mxCell id="5991" value="" style="group;fillColor=#A50040;fontColor=#ffffff;strokeColor=none;" parent="1" vertex="1" connectable="0">
<mxGeometry x="360" y="70" width="192" height="45" as="geometry"/>
</mxCell>
<mxCell id="5992" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#962744;fontColor=#FFFFFF;strokeColor=none;" parent="5991" vertex="1">
<mxGeometry width="192.00000000000003" height="45" as="geometry"/>
</mxCell>
<mxCell id="5993" value="&lt;div&gt;AMD runtime&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#ffffff;" parent="5991" vertex="1">
<mxGeometry x="8.638736842105262" y="7.497" width="174.72" height="29.996999999999993" as="geometry"/>
</mxCell>
<mxCell id="5994" value="" style="endArrow=classic;startArrow=none;html=1;rounded=0;strokeWidth=2;startFill=0;strokeColor=#FFFFFF;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" target="5992" edge="1">
<mxGeometry width="50" height="50" relative="1" as="geometry">
<mxPoint x="456" y="44" as="sourcePoint"/>
<mxPoint x="470" y="70" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="5995" value="&lt;font face=&quot;Helvetica&quot;&gt;AMD Platform&lt;br&gt;&lt;/font&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="1" vertex="1">
<mxGeometry x="365" y="123" width="180" height="20" as="geometry"/>
</mxCell>
<mxCell id="6003" value="" style="endArrow=classic;startArrow=none;html=1;rounded=0;strokeWidth=2;startFill=0;strokeColor=#FFFFFF;exitX=0.25;exitY=1;exitDx=0;exitDy=0;entryX=0.855;entryY=-0.018;entryDx=0;entryDy=0;entryPerimeter=0;" parent="1" target="6000" edge="1">
<mxGeometry width="50" height="50" relative="1" as="geometry">
<mxPoint x="309.5" y="-104" as="sourcePoint"/>
<mxPoint x="309.55999999999995" y="-60.975106382978765" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6004" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#9C2A44;fontColor=#FFFFFF;strokeColor=none;" parent="1" vertex="1">
<mxGeometry x="274.5" y="-150" width="140" height="45" as="geometry"/>
</mxCell>
<mxCell id="6005" value="&lt;font face=&quot;Helvetica&quot;&gt;hipLibrary&lt;/font&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#ffffff;dashed=1;strokeWidth=2;" parent="1" vertex="1">
<mxGeometry x="274.5" y="-150" width="140" height="45" as="geometry"/>
</mxCell>
<mxCell id="6007" value="" style="group;dashed=1;strokeWidth=2;strokeColor=none;" parent="1" vertex="1" connectable="0">
<mxGeometry x="360" y="-80" width="140" height="45" as="geometry"/>
</mxCell>
<mxCell id="6008" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#962744;fontColor=#FFFFFF;strokeColor=none;dashed=1;strokeWidth=2;" parent="6007" vertex="1">
<mxGeometry width="140.00000000000003" height="45" as="geometry"/>
</mxCell>
<mxCell id="6009" value="&lt;div&gt;rocLibrary&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="6007" vertex="1">
<mxGeometry x="6.299078947368418" y="7.497" width="127.39999999999998" height="29.996999999999993" as="geometry"/>
</mxCell>
<mxCell id="6010" value="" style="endArrow=classic;startArrow=none;html=1;rounded=0;strokeWidth=2;startFill=0;strokeColor=#FFFFFF;" parent="1" edge="1">
<mxGeometry width="50" height="50" relative="1" as="geometry">
<mxPoint x="386" y="-105" as="sourcePoint"/>
<mxPoint x="386" y="-80" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="5999" value="" style="group" parent="1" vertex="1" connectable="0">
<mxGeometry x="190" y="-80" width="140" height="45" as="geometry"/>
</mxCell>
<mxCell id="6000" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#60a917;fontColor=#ffffff;strokeColor=#2D7600;" parent="5999" vertex="1">
<mxGeometry y="-0.005106382978723234" width="140" height="45" as="geometry"/>
</mxCell>
<mxCell id="6001" value="&lt;div&gt;cuLibrary&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="5999" vertex="1">
<mxGeometry x="10.019288676236041" y="13.404255319148938" width="119.9667368421052" height="18.18191489361702" as="geometry"/>
</mxCell>
<mxCell id="6013" style="edgeStyle=none;html=1;strokeWidth=2;strokeColor=#FFFFFF;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" target="5984" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="234" y="-35" as="sourcePoint"/>
<mxPoint x="220" y="60" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6014" style="edgeStyle=none;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;strokeWidth=2;strokeColor=#FFFFFF;" parent="1" source="6008" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="430" y="-19" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6025" value="" style="group;strokeColor=none;dashed=1;strokeWidth=2;" parent="1" vertex="1" connectable="0">
<mxGeometry x="129.5" y="-290" width="430" height="100" as="geometry"/>
</mxCell>
<mxCell id="6023" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#333333;fontColor=#FFFFFF;strokeColor=none;spacing=0;" parent="6025" vertex="1">
<mxGeometry width="430" height="100" as="geometry"/>
</mxCell>
<mxCell id="6024" value="&lt;div&gt;Application Implementation&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="6025" vertex="1">
<mxGeometry x="97.50999999999999" y="43.93999999999998" width="234.99" height="12.120000000000001" as="geometry"/>
</mxCell>
<mxCell id="6026" style="edgeStyle=none;html=1;entryX=0.148;entryY=0.008;entryDx=0;entryDy=0;strokeWidth=2;entryPerimeter=0;strokeColor=#FFFFFF;" parent="1" target="5984" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="166" y="-190" as="sourcePoint"/>
<mxPoint x="159.99598908448831" y="-94.12" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6027" style="edgeStyle=none;html=1;strokeWidth=2;entryX=0.5;entryY=0;entryDx=0;entryDy=0;strokeColor=#FFFFFF;" parent="1" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="260" y="-190" as="sourcePoint"/>
<mxPoint x="260" y="-80.00510638297874" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6029" style="edgeStyle=none;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;strokeWidth=2;exitX=0.5;exitY=1;exitDx=0;exitDy=0;strokeColor=#FFFFFF;" parent="1" source="6023" target="6005" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="320" y="-190" as="sourcePoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6030" style="edgeStyle=none;html=1;strokeWidth=2;strokeColor=#FFFFFF;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" target="6008" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="452" y="-80" as="targetPoint"/>
<mxPoint x="430" y="-190" as="sourcePoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6031" style="edgeStyle=none;html=1;exitX=0.912;exitY=1.013;exitDx=0;exitDy=0;strokeWidth=2;exitPerimeter=0;strokeColor=#FFFFFF;" parent="1" source="6023" edge="1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="520" y="-19" as="targetPoint"/>
</mxGeometry>
</mxCell>
<mxCell id="6034" value="&lt;div&gt;Application&lt;/div&gt;" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=17;fontColor=#FFFFFF;" parent="1" vertex="1">
<mxGeometry x="232.5" y="-310" width="234.99" height="12.120000000000001" as="geometry"/>
</mxCell>
<mxCell id="6035" value="runtime API" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#4F1623;fontColor=#FFFFFF;strokeColor=none;" parent="1" vertex="1">
<mxGeometry x="310" y="3" width="115" height="30" as="geometry"/>
</mxCell>
<mxCell id="6036" value="kernel language" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#4F1623;fontColor=#FFFFFF;strokeColor=none;" parent="1" vertex="1">
<mxGeometry x="437" y="3" width="115" height="30" as="geometry"/>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
Loading
Loading