use crate::utility::list::List; use crate::kernel::thread::Thread; use crate::simulator::interrupt::InterruptStatus::InterruptOff; use crate::simulator::machine::Machine; use std::cell::RefCell; use std::rc::Rc; use super::scheduler::Scheduler; use super::thread_manager::ThreadManager; /// Structure of a Semaphore used for synchronisation pub struct Semaphore { /// Counter of simultanous Semaphore counter:i32, /// QUeue of Semaphore waiting to be exucated waiting_queue:List>>, /// Thread manager which managing threads thread_manager: Rc> } impl Semaphore { /// Initializes a semaphore, so that it can be used for synchronization. /// /// ### Parameters /// - *counter* initial value of counter /// - *thread_manager* Thread manager which managing threads pub fn new(counter: i32, thread_manager: Rc>) -> Semaphore{ Semaphore { counter, waiting_queue: List::new(), thread_manager} } /// Decrement the value, and wait if it becomes < 0. Checking the /// value and decrementing must be done atomically, so we /// need to disable interrupts before checking the value. /// /// Note that thread_manager::thread_sleep assumes that interrupts are disabled /// when it is called. /// /// ### Parameters /// - *current_thread* the current thread /// - *machine* the machine where the threads are executed pub fn p(&mut self, current_thread: Rc>, machine: &mut Machine){ let old_status = machine.interrupt.set_status(InterruptOff); self.counter -= 1; if self.counter < 0 { self.waiting_queue.push(Rc::clone(¤t_thread)); self.thread_manager.borrow_mut().thread_sleep(current_thread); } machine.interrupt.set_status(old_status); } /// Increment semaphore value, waking up a waiting thread if any. /// As with P(), this operation must be atomic, so we need to disable /// interrupts. /// /// scheduler::ready_to_run() assumes that interrupts /// are disabled when it is called. /// /// ### Parameters /// - **machine** the machine where the threads are executed /// - **scheduler** the scheduler which determine which thread to execute pub fn v(&mut self, machine: &mut Machine, scheduler: &mut Scheduler){ let old_status = machine.interrupt.set_status(InterruptOff); self.counter -= 1; if self.waiting_queue.peek() != None { scheduler.ready_to_run(self.waiting_queue.pop().unwrap()); } machine.interrupt.set_status(old_status); } } /// Lock used for synchronisation, can be interpreted has a Semaphore with a /// counter of 1 /// It's used for critical parts pub struct Lock{ /// Thread owning the lock owner: Option>>, /// The queue of threads waiting for execution waiting_queue:List>>, /// Thread manager which managing threads thread_manager: Rc>, /// A boolean definig if the lock is free or not free: bool } impl Lock { /// Initialize a Lock, so that it can be used for synchronization. /// The lock is initialy free /// /// ### Parameters /// - **thread_manager** Thread manager which managing threads pub fn new(thread_manager: Rc>) -> Lock { Lock { owner: None, waiting_queue: List::new(), thread_manager, free: true } } /// Wait until the lock become free. Checking the /// state of the lock (free or busy) and modify it must be done /// atomically, so we need to disable interrupts before checking /// the value of free. /// /// Note that thread_manager::thread_seep assumes that interrupts are disabled /// when it is called. /// /// ### Parameters /// - **current_thread** the current thread /// - **machine** the machine where the threads are executed pub fn acquire(&mut self, current_thread: Option>>, machine: &mut Machine) { let old_status = machine.interrupt.set_status(InterruptOff); if self.free { self.free = false; self.owner = current_thread; } else { match current_thread { Some(x) => { self.waiting_queue.push(Rc::clone(&x)); self.thread_manager.borrow_mut().thread_sleep(x) }, None => () } } machine.interrupt.set_status(old_status); } /// Wake up a waiter if necessary, or release it if no thread is waiting. /// We check that the lock is held by the g_current_thread. /// As with Acquire, this operation must be atomic, so we need to disable /// interrupts. scheduler::ready_to_run() assumes that threads /// are disabled when it is called. /// /// ### Parameters /// - **machine** the machine where the code is executed /// - **scheduler** the scheduler which determine which thread to execute pub fn release(&mut self, machine: &mut Machine, scheduler: &mut Scheduler, current_thread: Rc>) { let old_status = machine.interrupt.set_status(InterruptOff); if self.held_by_current_thread(current_thread) { if self.waiting_queue.peek() != None { self.owner = Some(self.waiting_queue.pop().unwrap()); match &self.owner { Some(x) => scheduler.ready_to_run(Rc::clone(&x)), None => () } } else { self.free = true; } } machine.interrupt.set_status(old_status); } pub fn held_by_current_thread(&mut self, current_thread: Rc>) -> bool { match &self.owner { Some(x) => Rc::ptr_eq(&x, ¤t_thread), None => false } } } /// Structure of a condition used for synchronisation pub struct Condition{ /// The queue of threads waiting for execution waiting_queue:List>>, /// Thread manager which managing threads thread_manager: Rc>, } impl Condition { /// Initializes a Condition, so that it can be used for synchronization. /// /// ### Parameters /// - *thread_manager* Thread manager which managing threads pub fn new(thread_manager: Rc>) -> Condition { Condition{ waiting_queue: List::new(), thread_manager } } /// Block the calling thread (put it in the wait queue). /// This operation must be atomic, so we need to disable interrupts. /// /// ### Parameters /// - **current_thread** the current thread /// - **machine** the machine where threads are executed pub fn wait(&mut self, current_thread: Rc>, machine: &mut Machine) { let old_status = machine.interrupt.set_status(InterruptOff); self.waiting_queue.push(Rc::clone(¤t_thread)); self.thread_manager.borrow_mut().thread_sleep(current_thread); machine.interrupt.set_status(old_status); } /// Wake up the first thread of the wait queue (if any). /// This operation must be atomic, so we need to disable interrupts. /// /// ### Parameters /// - **machine** the machine where the code is executed /// - **scheduler** the scheduler which determine which thread to execute pub fn signal(&mut self, machine: &mut Machine, scheduler: &mut Scheduler) { let old_status = machine.interrupt.set_status(InterruptOff); if self.waiting_queue.peek() != None { scheduler.ready_to_run(self.waiting_queue.pop().unwrap()); } machine.interrupt.set_status(old_status); } /// Wake up all threads waiting in the waitqueue of the condition /// This operation must be atomic, so we need to disable interrupts. /// /// ### Parameters /// - **machine** the machine where the code is executed /// - **scheduler** the scheduler which determine which thread to execute pub fn broadcast(&mut self, machine: &mut Machine, scheduler: &mut Scheduler) { let old_status = machine.interrupt.set_status(InterruptOff); while self.waiting_queue.peek() != None { scheduler.ready_to_run(self.waiting_queue.pop().unwrap()); } machine.interrupt.set_status(old_status); } }