This is a quick notice for developers of R packages using Rust. I posted the same thing on the R-devel-package mailing list, so if you already read it, you don’t need to read this post.

Rust 1.70 was released on June 1st, 2023 ¹. If you use Rust in your R package, you’ll probably start to see an error and a warning on the final linking step of Windows builds.

Error

The first thing you’ll notice is that linking fails with errors like this one:

...snip...\std\src\sys\windows/handle.rs:290: undefined reference to `NtWriteFile'

This is because Rust 1.70 started to use several Windows APIs defined in NTDLL.DLL ². So, this can be easily fixed by adding -lntdll to PKG_LIBS.

PKG_LIBS = ...snip... -lntdll

Warning

This one is a bit tricky, After modifying PKG_LIBS, your build should succeed, but you might or might not see a lot of warnings like this one:

Warning: corrupt .drectve at end of def file

This is because Rust 1.70 upgraded LLVM to version 16, and LLVM generates a binary containing directives that only the very latest version (2.40) of GNU linker can understand ³. What’s fortunate is that the latest Rtools43 uses Binutils 2.40, so this warning won’t happen if you target only R >= 4.3. However, the following cases might be a problem:

On R < 4.3
On R >= 4.3 with outdated Rtools43 (this rarely happens except when you installed Rtools43 before the release of R 4.3)

Unfortunately, it seems there’s no option to suppress this warning, so there’s no way to save R CMD check from failing if you run it with --as-cran and treat warnings as failure. In other words, if you are a maintainer of some R package on CRAN, you might need to consider giving up your package on oldrel when the CRAN Windows server upgrades Rust (I heard the current installed version is 1.69, but I’m not sure).

For non-CRAN packages, I think you can ignore the warnings. The directive is added in order to reduce the number of exported symbols so that it won’t overflow ⁴. So, it should be fine if it doesn’t overflow in actual. But, I’m not an expert here, so please decide at your own risk.

For example, you can tweak the GitHub Actions settings like the following to allow warnings on R 4.2 or before.

- name: Check R version
  id: error-on
  run: |
    output <- Sys.getenv("GITHUB_OUTPUT")
    if (.Platform$OS.type == "windows" && getRversion() < "4.3.0") {
      cat('level=error', file = output, append = TRUE)
    } else {
      cat('level=warning', file = output, append = TRUE)
    }
  shell: Rscript {0}

- uses: r-lib/actions/check-r-package@v2
  with:
    error-on: '"${{ steps.error-on.outputs.level }}"'

Hope this helps.

Rust 1.70 And Build Failures On Windows

Error

Warning

Footnotes