library/std/src/sys/windows/thread.rs

   1 use crate::ffi::CStr;
   2 use crate::io;
   3 use crate::ptr;
   4 use crate::sys::c;
   5 use crate::sys::handle::Handle;
   6 use crate::sys::stack_overflow;
   7 use crate::time::Duration;
   8
   9 use libc::c_void;
  10
  11 use super::to_u16s;
  12
  13 pub const DEFAULT_MIN_STACK_SIZE: usize = 2 * 1024 * 1024;
  14
  15 pub struct Thread {
  16     handle: Handle,
  17 }
  18
  19 impl Thread {
  20     // unsafe: see thread::Builder::spawn_unchecked for safety requirements
  21     pub unsafe fn new(stack: usize, p: Box<dyn FnOnce()>) -> io::Result<Thread> {
  22         let p = Box::into_raw(box p);
  23
  24         // FIXME On UNIX, we guard against stack sizes that are too small but
  25         // that's because pthreads enforces that stacks are at least
  26         // PTHREAD_STACK_MIN bytes big.  Windows has no such lower limit, it's
  27         // just that below a certain threshold you can't do anything useful.
  28         // That threshold is application and architecture-specific, however.
  29         // Round up to the next 64 kB because that's what the NT kernel does,
  30         // might as well make it explicit.
  31         let stack_size = (stack + 0xfffe) & (!0xfffe);
  32         let ret = c::CreateThread(
  33             ptr::null_mut(),
  34             stack_size,
  35             thread_start,
  36             p as *mut _,
  37             c::STACK_SIZE_PARAM_IS_A_RESERVATION,
  38             ptr::null_mut(),
  39         );
  40
  41         return if ret as usize == 0 {
  42             // The thread failed to start and as a result p was not consumed. Therefore, it is
  43             // safe to reconstruct the box so that it gets deallocated.
  44             drop(Box::from_raw(p));
  45             Err(io::Error::last_os_error())
  46         } else {
  47             Ok(Thread { handle: Handle::new(ret) })
  48         };
  49
  50         extern "system" fn thread_start(main: *mut c_void) -> c::DWORD {
  51             unsafe {
  52                 // Next, set up our stack overflow handler which may get triggered if we run
  53                 // out of stack.
  54                 let _handler = stack_overflow::Handler::new();
  55                 // Finally, let's run some code.
  56                 Box::from_raw(main as *mut Box<dyn FnOnce()>)();
  57             }
  58             0
  59         }
  60     }
  61
  62     pub fn set_name(name: &CStr) {
  63         if let Ok(utf8) = name.to_str() {
  64             if let Ok(utf16) = to_u16s(utf8) {
  65                 unsafe {
  66                     c::SetThreadDescription(c::GetCurrentThread(), utf16.as_ptr());
  67                 };
  68             };
  69         };
  70     }
  71
  72     pub fn join(self) {
  73         let rc = unsafe { c::WaitForSingleObject(self.handle.raw(), c::INFINITE) };
  74         if rc == c::WAIT_FAILED {
  75             panic!("failed to join on thread: {}", io::Error::last_os_error());
  76         }
  77     }
  78
  79     pub fn yield_now() {
  80         // This function will return 0 if there are no other threads to execute,
  81         // but this also means that the yield was useless so this isn't really a
  82         // case that needs to be worried about.
  83         unsafe {
  84             c::SwitchToThread();
  85         }
  86     }
  87
  88     pub fn sleep(dur: Duration) {
  89         unsafe { c::Sleep(super::dur2timeout(dur)) }
  90     }
  91
  92     pub fn handle(&self) -> &Handle {
  93         &self.handle
  94     }
  95
  96     pub fn into_handle(self) -> Handle {
  97         self.handle
  98     }
  99 }
 100
 101 #[cfg_attr(test, allow(dead_code))]
 102 pub mod guard {
 103     pub type Guard = !;
 104     pub unsafe fn current() -> Option<Guard> {
 105         None
 106     }
 107     pub unsafe fn init() -> Option<Guard> {
 108         None
 109     }
 110 }