add modern cuda

Author: archibate

.gitignore

@@ -4,5 +4,6 @@ __pycache__/
 node_modules/
 package.json
 package-lock.json
+.cache/
 *.pdf
 *.o

cuda/moderncuda/.oldexample/example.cu renamed to cudaguide/1_moderncuda/.oldexample/example.cu

@@ -4,6 +4,7 @@
 
 - https://docs.nvidia.com/cuda/cuda-c-programming-guide/index.html
 - https://www.cs.sfu.ca/~ashriram/Courses/CS431/assets/lectures/Part8/GPU1.pdf
+- https://developer.nvidia.com/gpugems/gpugems/contributors
 
 ## 配置 CUDA 开发环境
 
@@ -19,6 +20,8 @@ WSL 用户要注意，WSL 环境和真正的 Linux 相差甚远。很多 Linux 
 
 Ubuntu 用户可能考虑卸载 Ubuntu，因为 Ubuntu 源中的版本永不更新。想要安装新出的软件都非常困难，基本只能安装到五六年前的古董软件，要么只能从网上下 deb 包，和 Wendous 一个软耸样。所有官方 apt 源中包的版本从 Ubuntu 发布那一天就定死了，永远不会更新了。这是为了起夜级服务器安全稳定的需要，对于个人电脑而言却只是白白阻碍我们学习，Arch Linux 这样的滚动更新的发行版才更适合个人桌面用户。
 
+> {{ icon.tip }} 我使用的 CUDA / C++ 开发环境为 [小彭老师 vimrc 整合包](https://github.com/archibate/vimrc)，你也可以用其他支持 CUDA 的 IDE。
+
 ### 安装 NVIDIA 驱动
 
 首先确保你安装了 NVIDIA 最新驱动：

cuda/moderncuda/.oldexample/kernel.cu renamed to cudaguide/1_moderncuda/.oldexample/kernel.cu

@@ -1,6 +1,6 @@
 #include <cuda_runtime.h>
 #include <nvfunctional>
-#include "cudapp.cuh"
+#include "cudapp.cuh" // 小彭老师现代 CUDA 框架，更符合现代 C++ 风格，减少官方 C 风格接口的繁琐
 
 using namespace cudapp;
 
@@ -10,12 +10,16 @@ __global__ void kernel(int x) {
 }
 
 int main() {
+    // 启动内核的3种方式
+    // 1. 三箭头语法糖（常用）
     int x = 42;
     kernel<<<3, 4, 0, 0>>>(x);
 
+    // 2. cudaLaunchKernel
     void *args[] = {&x};
-    CHECK_CUDA(cudaLaunchKernel((const void *)kernel, dim3(3), dim3(4), args, 0, 0));
+    CHECK_CUDA(cudaLaunchKernel(kernel, dim3(3), dim3(4), args, 0, 0));
 
+    // 3. cudaLaunchKernelEx
     cudaLaunchConfig_t cfg{};
     cfg.blockDim = dim3(3);
     cfg.gridDim = dim3(4);
@@ -26,9 +30,17 @@ int main() {
     CHECK_CUDA(cudaLaunchKernelEx(&cfg, kernel, x));
 
     const char *name;
-    CHECK_CUDA(cudaFuncGetName(&name, (const void *)kernel));
+    CHECK_CUDA(cudaFuncGetName(&name, kernel));
     printf("内核名字：%s\n", name);
 
+    // 1. 强制同步：等待此前启动过的所有内核执行完成
+    CHECK_CUDA(cudaDeviceSynchronize());
+
+    // 2. 仅同步 0 号流（null-stream）
+    CHECK_CUDA(cudaStreamSynchronize(0));
+
+    // 3. 仅同步 0 号流，但使用小彭老师现代 CUDA 框架
     CudaStream::nullStream().join();
+
     return 0;
 }