about summary refs log tree commit diff
diff options
context:
space:
mode:
authorMatthias Krüger <matthias.krueger@famsik.de>2022-05-12 16:41:01 +0200
committerGitHub <noreply@github.com>2022-05-12 16:41:01 +0200
commit43dabbf485b2aa2bd644580fefcae8a689d2836d (patch)
tree552eb11902dcf6d16263f82a64889385e10044a9
parent18bd2dd5cda08b09ace6e37c1a0312e9b2bb4beb (diff)
parentab4675583f58572478fa6abf42557c8aab9a358b (diff)
downloadrust-43dabbf485b2aa2bd644580fefcae8a689d2836d.tar.gz
rust-43dabbf485b2aa2bd644580fefcae8a689d2836d.zip
Rollup merge of #95896 - nagisa:nvptx-contacts, r=Mark-Simulacrum
Note the contacts for the nvptx64 target(s)

cc `@RDambrosio016` `@kjetilkjeka`
-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.)
+
+-->