about summary refs log tree commit diff
path: root/src/doc/rustc
diff options
context:
space:
mode:
authorSimonas Kazlauskas <git@kazlauskas.me>2022-04-10 23:13:12 +0300
committerSimonas Kazlauskas <git@kazlauskas.me>2022-04-11 00:52:22 +0300
commitab4675583f58572478fa6abf42557c8aab9a358b (patch)
tree27c81f67d03143442f41ca467b81737e765ac6c9 /src/doc/rustc
parent18f32b73bdb3833c18c73fe3062bde8e1721ccca (diff)
downloadrust-ab4675583f58572478fa6abf42557c8aab9a358b.tar.gz
rust-ab4675583f58572478fa6abf42557c8aab9a358b.zip
Note the contacts for the nvptx64 target(s)
Diffstat (limited to 'src/doc/rustc')
-rw-r--r--src/doc/rustc/src/platform-support/nvptx64-nvidia-cuda.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/src/doc/rustc/src/platform-support/nvptx64-nvidia-cuda.md b/src/doc/rustc/src/platform-support/nvptx64-nvidia-cuda.md
new file mode 100644
index 00000000000..1af1410d4bb
--- /dev/null
+++ b/src/doc/rustc/src/platform-support/nvptx64-nvidia-cuda.md
@@ -0,0 +1,58 @@
+# `nvptx64-nvidia-cuda`
+
+**Tier: 2**
+
+This is the target meant for deploying code for Nvidia® accelerators based on their CUDA
+platform.
+
+## Target maintainers
+
+- Riccardo D'Ambrosio, https://github.com/RDambrosio016
+- Kjetil Kjeka, https://github.com/kjetilkjeka
+
+<!-- FIXME: fill this out
+
+## Requirements
+
+Does the target support host tools, or only cross-compilation? Does the target
+support std, or alloc (either with a default allocator, or if the user supplies
+an allocator)?
+
+Document the expectations of binaries built for the target. Do they assume
+specific minimum features beyond the baseline of the CPU/environment/etc? What
+version of the OS or environment do they expect?
+
+Are there notable `#[target_feature(...)]` or `-C target-feature=` values that
+programs may wish to use?
+
+What calling convention does `extern "C"` use on the target?
+
+What format do binaries use by default? ELF, PE, something else?
+
+## Building the target
+
+If Rust doesn't build the target by default, how can users build it? Can users
+just add it to the `target` list in `config.toml`?
+
+## Building Rust programs
+
+Rust does not yet ship pre-compiled artifacts for this target. To compile for
+this target, you will either need to build Rust with the target enabled (see
+"Building the target" above), or build your own copy of `core` by using
+`build-std` or similar.
+
+## Testing
+
+Does the target support running binaries, or do binaries have varying
+expectations that prevent having a standard way to run them? If users can run
+binaries, can they do so in some common emulator, or do they need native
+hardware? Does the target support running the Rust testsuite?
+
+## Cross-compilation toolchains and C code
+
+Does the target support C code? If so, what toolchain target should users use
+to build compatible C code? (This may match the target triple, or it may be a
+toolchain for a different target triple, potentially with specific options or
+caveats.)
+
+-->