diff options
| author | Paul Menage <menage@gmail.com> | 2023-10-09 02:22:14 -0700 |
|---|---|---|
| committer | Paul Menage <menage@gmail.com> | 2023-11-11 19:48:47 -0800 |
| commit | 2e6b57541dc28cdd954b1ce2300b88ccc5c29d5c (patch) | |
| tree | 8055acc6e3dfb970acd642a19c9b7dea5c583c7a /src/doc | |
| parent | 2c1b65ee1431f8d3fe2142e821eb13c623bbf8a0 (diff) | |
| download | rust-2e6b57541dc28cdd954b1ce2300b88ccc5c29d5c.tar.gz rust-2e6b57541dc28cdd954b1ce2300b88ccc5c29d5c.zip | |
Add -Z llvm_module_flag
Allow adding values to the `!llvm.module.flags` metadata for a generated module. The syntax is `-Z llvm_module_flag=<name>:<type>:<value>:<behavior>` Currently only u32 values are supported but the type is required to be specified for forward compatibility. The `behavior` element must match one of the named LLVM metadata behaviors.viors. This flag is expected to be perma-unstable.
Diffstat (limited to 'src/doc')
| -rw-r--r-- | src/doc/unstable-book/src/compiler-flags/llvm-module-flag.md | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/src/doc/unstable-book/src/compiler-flags/llvm-module-flag.md b/src/doc/unstable-book/src/compiler-flags/llvm-module-flag.md new file mode 100644 index 00000000000..454ad0a9a6d --- /dev/null +++ b/src/doc/unstable-book/src/compiler-flags/llvm-module-flag.md @@ -0,0 +1,12 @@ +# `llvm-module-flag` + +--------------------- + +This flag allows adding a key/value to the `!llvm.module.flags` metadata in the +LLVM-IR for a compiled Rust module. The syntax is + +`-Z llvm_module_flag=<name>:<type>:<value>:<behavior>` + +Currently only u32 values are supported but the type is required to be specified +for forward compatibility. The `behavior` element must match one of the named +LLVM [metadata behaviors](https://llvm.org/docs/LangRef.html#module-flags-metadata) |