1 unstable release

Uses old Rust 2015

0.8.1 Mar 11, 2024

#232 in Operating systems

Download history 173/week @ 2024-05-18 173/week @ 2024-05-25 226/week @ 2024-06-01 62/week @ 2024-06-08 51/week @ 2024-06-15 78/week @ 2024-06-22 62/week @ 2024-06-29 91/week @ 2024-07-06 160/week @ 2024-07-13 225/week @ 2024-07-20 198/week @ 2024-07-27 171/week @ 2024-08-03 210/week @ 2024-08-10 107/week @ 2024-08-17 126/week @ 2024-08-24 150/week @ 2024-08-31

644 downloads per month
Used in 6 crates (via cpu-utils)

MIT/Apache

24KB
531 lines

core_affinity_rs is a Rust crate for managing CPU affinities. It currently supports Linux, Mac OSX, and Windows.

Documentation

Linux Status Build status

Example

This example shows how create a thread for each available processor and pin each thread to its corresponding processor.

extern crate core_affinity;

use std::thread;

// Retrieve the IDs of all cores on which the current
// thread is allowed to run.
// NOTE: If you want ALL the possible cores, you should
// use num_cpus.
let core_ids = core_affinity::get_core_ids().unwrap();

// Create a thread for each active CPU core.
let handles = core_ids.into_iter().map(|id| {
    thread::spawn(move || {
        // Pin this thread to a single CPU core.
        let res = core_affinity::set_for_current(id);
        if (res) {
          // Do more work after this.
        }
    })
}).collect::<Vec<_>>();

for handle in handles.into_iter() {
    handle.join().unwrap();
}

Platforms

core_affinity_rs should work on Linux, Windows, Mac OSX, FreeBSD, and Android.

core_affinity_rs is continuously tested on:

  • x86_64-unknown-linux-gnu (Linux)
  • i686-unknown-linux-gnu
  • x86_64-unknown-linux-musl (Linux w/ MUSL)
  • i686-unknown-linux-musl
  • x86_64-apple-darwin (Mac OSX)
  • i686-apple-darwin
  • x86_64-pc-windows-msvc (Windows)
  • i686-pc-windows-msvc
  • x86_64-pc-windows-gnu
  • i686-pc-windows-gnu

core_affinity_rs is continuously cross-compiled for:

  • arm-unknown-linux-gnueabihf
  • aarch64-unknown-linux-gnu
  • mips-unknown-linux-gnu
  • aarch64-unknown-linux-musl
  • i686-linux-android
  • x86_64-linux-android
  • arm-linux-androideabi
  • aarch64-linux-android

Dependencies

~28–250KB