From 51e8c807277580f3575df4bbd01ebf2bfde941ff Mon Sep 17 00:00:00 2001 From: Trevor Gross Date: Tue, 10 Oct 2023 02:40:26 -0400 Subject: [PATCH] Add unstable book page for the no-jump-tables codegen option --- .../src/compiler-flags/no-jump-tables.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 src/doc/unstable-book/src/compiler-flags/no-jump-tables.md diff --git a/src/doc/unstable-book/src/compiler-flags/no-jump-tables.md b/src/doc/unstable-book/src/compiler-flags/no-jump-tables.md new file mode 100644 index 00000000000..f096c20f4bd --- /dev/null +++ b/src/doc/unstable-book/src/compiler-flags/no-jump-tables.md @@ -0,0 +1,19 @@ +# `no-jump-tables` + +The tracking issue for this feature is [#116592](https://github.com/rust-lang/rust/issues/116592) + +--- + +This option enables the `-fno-jump-tables` flag for LLVM, which makes the +codegen backend avoid generating jump tables when lowering switches. + +This option adds the LLVM `no-jump-tables=true` attribute to every function. + +The option can be used to help provide protection against +jump-oriented-programming (JOP) attacks, such as with the linux kernel's [IBT]. + +```sh +RUSTFLAGS="-Zno-jump-tables" cargo +nightly build -Z build-std +``` + +[IBT]: https://www.phoronix.com/news/Linux-IBT-By-Default-Tip