Rollup merge of #144188 - joshtriplett:available-parallelism, r=Mark-Simulacrum

Zalathar · web-flow · commit e65201ccb88c · 2025-08-04T11:24:36.000+10:00
`available_parallelism`: Add documentation for why we don't look at `ulimit`
diff --git a/library/std/src/thread/mod.rs b/library/std/src/thread/mod.rs
@@ -2018,6 +2018,9 @@ fn _assert_sync_and_send() {
 ///   which may take time on systems with large numbers of mountpoints.
 ///   (This does not apply to cgroup v2, or to processes not in a
 ///   cgroup.)
+/// - It does not attempt to take `ulimit` into account. If there is a limit set on the number of
+///   threads, `available_parallelism` cannot know how much of that limit a Rust program should
+///   take, or know in a reliable and race-free way how much of that limit is already taken.
 ///
 /// On all targets:
 /// - It may overcount the amount of parallelism available when running in a VM
