mikros/rust
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Rollup merge of #79119 - jamesmunns:patch-1, r=Mark-Simulacrum

Browse Source 
Clarify availability of atomic operations

This was noticed while we were updating the embedded rust book: https://github.com/rust-embedded/book/pull/273/files

These targets do natively have atomic load/stores, but do not support CAS operations.
This commit is contained in:
Dylan DPC 2020-11-19 23:58:33 +01:00 committed by GitHub
commit 138e96d222
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
library/core/src/sync/atomic.rs
View File

@ -47,9 +47,16 @@
//! //!
//! * PowerPC and MIPS platforms with 32-bit pointers do not have `AtomicU64` or //! * PowerPC and MIPS platforms with 32-bit pointers do not have `AtomicU64` or
//! `AtomicI64` types. //! `AtomicI64` types.
//! * ARM platforms like `armv5te` that aren't for Linux do not have any atomics //! * ARM platforms like `armv5te` that aren't for Linux only provide `load`
//! at all. //! and `store` operations, and do not support Compare and Swap (CAS)
//! * ARM targets with `thumbv6m` do not have atomic operations at all. //! operations, such as `swap`, `fetch_add`, etc. Additionally on Linux,
//! these CAS operations are implemented via [operating system support], which
//! may come with a performance penalty.
//! * ARM targets with `thumbv6m` only provide `load` and `store` operations,
//! and do not support Compare and Swap (CAS) operations, such as `swap`,
//! `fetch_add`, etc.
//!
//! [operating system support]: https://www.kernel.org/doc/Documentation/arm/kernel_user_helpers.txt
//! //!
//! Note that future platforms may be added that also do not have support for //! Note that future platforms may be added that also do not have support for
//! some atomic operations. Maximally portable code will want to be careful //! some atomic operations. Maximally portable code will want to be careful