{"id":15994697,"url":"https://github.com/taiki-e/atomic-maybe-uninit","last_synced_at":"2026-01-28T13:04:24.248Z","repository":{"id":37635101,"uuid":"468981700","full_name":"taiki-e/atomic-maybe-uninit","owner":"taiki-e","description":"Atomic operations on potentially uninitialized integers.","archived":false,"fork":false,"pushed_at":"2026-01-25T11:58:33.000Z","size":1870,"stargazers_count":27,"open_issues_count":4,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-25T22:53:54.906Z","etag":null,"topics":["atomic","no-std","rust"],"latest_commit_sha":null,"homepage":"https://docs.rs/atomic-maybe-uninit","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taiki-e.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"taiki-e"}},"created_at":"2022-03-12T04:48:02.000Z","updated_at":"2026-01-25T11:58:36.000Z","dependencies_parsed_at":"2024-01-27T04:20:30.955Z","dependency_job_id":"32f4712b-0104-468b-a720-691cae5115b7","html_url":"https://github.com/taiki-e/atomic-maybe-uninit","commit_stats":{"total_commits":257,"total_committers":1,"mean_commits":257.0,"dds":0.0,"last_synced_commit":"b0b09f632828a2c25b85d3261d26b4cb2e1daadf"},"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/taiki-e/atomic-maybe-uninit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taiki-e%2Fatomic-maybe-uninit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taiki-e%2Fatomic-maybe-uninit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taiki-e%2Fatomic-maybe-uninit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taiki-e%2Fatomic-maybe-uninit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taiki-e","download_url":"https://codeload.github.com/taiki-e/atomic-maybe-uninit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taiki-e%2Fatomic-maybe-uninit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28845787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T13:02:32.985Z","status":"ssl_error","status_checked_at":"2026-01-28T13:02:04.945Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atomic","no-std","rust"],"created_at":"2024-10-08T07:09:51.589Z","updated_at":"2026-01-28T13:04:24.242Z","avatar_url":"https://github.com/taiki-e.png","language":"Rust","funding_links":["https://github.com/sponsors/taiki-e"],"categories":[],"sub_categories":[],"readme":"# atomic-maybe-uninit\n\n[![crates.io](https://img.shields.io/crates/v/atomic-maybe-uninit?style=flat-square\u0026logo=rust)](https://crates.io/crates/atomic-maybe-uninit)\n[![docs.rs](https://img.shields.io/badge/docs.rs-atomic--maybe--uninit-blue?style=flat-square\u0026logo=docs.rs)](https://docs.rs/atomic-maybe-uninit)\n[![license](https://img.shields.io/badge/license-Apache--2.0_OR_MIT-blue?style=flat-square)](#license)\n[![msrv](https://img.shields.io/badge/msrv-1.74-blue?style=flat-square\u0026logo=rust)](https://www.rust-lang.org)\n[![github actions](https://img.shields.io/github/actions/workflow/status/taiki-e/atomic-maybe-uninit/ci.yml?branch=main\u0026style=flat-square\u0026logo=github)](https://github.com/taiki-e/atomic-maybe-uninit/actions)\n\n\u003c!-- tidy:sync-markdown-to-rustdoc:start:src/lib.rs --\u003e\n\nAtomic operations on potentially uninitialized integers.\n\n## Motivation\n\nCopying types containing uninitialized bytes (e.g., padding), via the standard library's atomic types\nis [undefined behavior because the copy goes through integers][undefined-behavior].\n\nThis crate provides a way to soundly perform such operations.\n\n## Platform Support\n\nCurrently, all CPU architectures supported by Rust (x86, x86_64, Arm, AArch64, RISC-V, LoongArch, Arm64EC, s390x, MIPS, PowerPC, MSP430, AVR, SPARC, Hexagon, M68k, C-SKY, and Xtensa) are supported.\n(You can use `cfg_{has,no}_*` macros to write code based on whether or not which size of primitives is available.)\n\n| target_arch                                 | primitives                                          | load/store | swap/CAS |\n| ------------------------------------------- | --------------------------------------------------- |:----------:|:--------:|\n| x86                                         | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| x86_64                                      | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| x86_64 (+cmpxchg16b) \\[2]                   | i128,u128                                           | ✓          | ✓        |\n| arm (v6+ or Linux/Android)                  | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓\\[1]    |\n| arm (except for M-profile) \\[3]             | i64,u64                                             | ✓          | ✓        |\n| aarch64                                     | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64,i128,u128 | ✓          | ✓        |\n| riscv32                                     | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓\\[1]    |\n| riscv32 (+zacas) \\[4]                       | i64,u64                                             | ✓          | ✓        |\n| riscv64                                     | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓\\[1]    |\n| riscv64 (+zacas) \\[4]                       | i128,u128                                           | ✓          | ✓        |\n| loongarch64                                 | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| loongarch32 \\[9]                            | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓        |\n| arm64ec \\[8]                                | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64,i128,u128 | ✓          | ✓        |\n| s390x \\[8]                                  | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64,i128,u128 | ✓          | ✓        |\n| powerpc \\[10]                               | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓        |\n| powerpc64 \\[10]                             | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| powerpc64 (+quadword-atomics) \\[5] \\[10]    | i128,u128                                           | ✓          | ✓        |\n| mips / mips32r6 \\[11]                       | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓        |\n| mips64 / mips64r6 \\[11]                     | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| msp430 \\[11] (experimental)                 | isize,usize,i8,u8,i16,u16                           | ✓          | ✓        |\n| avr \\[11] (experimental)                    | isize,usize,i8,u8,i16,u16                           | ✓          | ✓        |\n| sparc \\[6] \\[11] (experimental)             | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓        |\n| sparc64 \\[11] (experimental)                | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| hexagon \\[11] (experimental)                | isize,usize,i8,u8,i16,u16,i32,u32,i64,u64           | ✓          | ✓        |\n| m68k \\[11] (experimental)                   | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓\\[1]    |\n| m68k (+isa-68020) \\[7] \\[11] (experimental) | i64,u64                                             | ✓          | ✓        |\n| csky \\[11] (experimental)                   | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓\\[1]    |\n| xtensa \\[11] (experimental)                 | isize,usize,i8,u8,i16,u16,i32,u32                   | ✓          | ✓\\[1]    |\n\n\\[1] Arm's atomic RMW operations are not available on Armv6-M (thumbv6m). RISC-V's atomic RMW operations are not available on targets without the A (or G which means IMAFD) or Zalrsc or Zacas extension, such as riscv32i, riscv32imc, etc. M68k's atomic RMW operations requires target-cpu M68020+ (enabled by default on Linux). C-SKY's atomic RMW operations requires target-cpu ck860\\* or c860\\* (enabled by default on the hard-float target). Xtensa's atomic RMW operations are not available on esp32s2.\u003cbr\u003e\n\\[2] Requires `cmpxchg16b` target feature (enabled by default on Apple, Windows (except Windows 7), and Fuchsia targets).\u003cbr\u003e\n\\[3] Armv6+ or Linux/Android, except for M-profile architecture such as thumbv6m, thumbv7m, etc.\u003cbr\u003e\n\\[4] Requires `zacas` target feature.\u003cbr\u003e\n\\[5] Requires `quadword-atomics` target feature (enabled by default on powerpc64le).\u003cbr\u003e\n\\[6] Requires `v9` or `leoncasa` target feature (enabled by default on Linux).\u003cbr\u003e\n\\[7] Requires target-cpu M68020+ (enabled by default on Linux).\u003cbr\u003e\n\\[8] Requires Rust 1.84+.\u003cbr\u003e\n\\[9] Requires Rust 1.91+.\u003cbr\u003e\n\\[10] Requires Rust 1.95+.\u003cbr\u003e\n\\[11] Requires nightly due to `#![feature(asm_experimental_arch)]`.\u003cbr\u003e\n\nSee also [Atomic operation overview by architecture](https://github.com/taiki-e/atomic-maybe-uninit/blob/HEAD/src/arch/README.md)\nfor more information about atomic operations in these architectures.\n\nFeel free to submit an issue if your target is not supported yet.\n\n## Limitations\n\nThis crate uses inline assembly to implement atomic operations (this is currently the only sound way to perform atomic operations on uninitialized values), so it is not compatible with Miri and Sanitizers.\n\n## Related Projects\n\n- [portable-atomic]: Portable atomic types including support for 128-bit atomics, atomic float, etc.\n- [atomic-memcpy]: Byte-wise atomic memcpy.\n- [asmtest]: A library for tracking generated assemblies.\n\n[asmtest]: https://github.com/taiki-e/asmtest\n[atomic-memcpy]: https://github.com/taiki-e/atomic-memcpy\n[portable-atomic]: https://github.com/taiki-e/portable-atomic\n[undefined-behavior]: https://doc.rust-lang.org/reference/behavior-considered-undefined.html\n\n\u003c!-- tidy:sync-markdown-to-rustdoc:end --\u003e\n\n## License\n\nLicensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or\n[MIT license](LICENSE-MIT) at your option.\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the work by you, as defined in the Apache-2.0 license, shall\nbe dual licensed as above, without any additional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaiki-e%2Fatomic-maybe-uninit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaiki-e%2Fatomic-maybe-uninit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaiki-e%2Fatomic-maybe-uninit/lists"}