68bde0a073
This commit stabilizes the `std::sync::atomics` module, renaming it to `std::sync::atomic` to match library precedent elsewhere, and tightening up behavior around incorrect memory ordering annotations. The vast majority of the module is now `stable`. However, the `AtomicOption` type has been deprecated, since it is essentially unused and is not truly a primitive atomic type. It will eventually be replaced by a higher-level abstraction like MVars. Due to deprecations, this is a: [breaking-change]
61 lines
1.8 KiB
Rust
61 lines
1.8 KiB
Rust
// Copyright 2013-2014 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
//! Task bookkeeping
|
|
//!
|
|
//! This module keeps track of the number of running tasks so that entry points
|
|
//! with libnative know when it's possible to exit the program (once all tasks
|
|
//! have exited).
|
|
//!
|
|
//! The green counterpart for this is bookkeeping on sched pools, and it's up to
|
|
//! each respective runtime to make sure that they call increment() and
|
|
//! decrement() manually.
|
|
|
|
use core::atomic;
|
|
use core::ops::Drop;
|
|
|
|
use mutex::{StaticNativeMutex, NATIVE_MUTEX_INIT};
|
|
|
|
static mut TASK_COUNT: atomic::AtomicUint = atomic::INIT_ATOMIC_UINT;
|
|
static mut TASK_LOCK: StaticNativeMutex = NATIVE_MUTEX_INIT;
|
|
|
|
pub struct Token { _private: () }
|
|
|
|
impl Drop for Token {
|
|
fn drop(&mut self) { decrement() }
|
|
}
|
|
|
|
/// Increment the number of live tasks, returning a token which will decrement
|
|
/// the count when dropped.
|
|
pub fn increment() -> Token {
|
|
let _ = unsafe { TASK_COUNT.fetch_add(1, atomic::SeqCst) };
|
|
Token { _private: () }
|
|
}
|
|
|
|
pub fn decrement() {
|
|
unsafe {
|
|
if TASK_COUNT.fetch_sub(1, atomic::SeqCst) == 1 {
|
|
let guard = TASK_LOCK.lock();
|
|
guard.signal();
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Waits for all other native tasks in the system to exit. This is only used by
|
|
/// the entry points of native programs
|
|
pub fn wait_for_other_tasks() {
|
|
unsafe {
|
|
let guard = TASK_LOCK.lock();
|
|
while TASK_COUNT.load(atomic::SeqCst) > 0 {
|
|
guard.wait();
|
|
}
|
|
}
|
|
}
|