lpt 1.0.0

Low priority thread
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

#![doc = include_str!("../README.md")]
#![cfg_attr(docsrs, feature(doc_auto_cfg))]

#[inline]
#[cfg(target_os = "windows")]
/// Set the calling thread to the lowest possible priority
///
/// This function will never fail.
/// ```
pub fn lpt() {
	use windows::Win32::System::Threading::*;

	// SAFETY: calling C.
	//
	// We are _lowering_ our priority, not increasing, so this function should never fail.
	unsafe { SetThreadPriority(GetCurrentThread(), THREAD_PRIORITY_IDLE) };
}

#[inline]
#[cfg(target_family = "unix")]
/// Set the calling thread to the lowest possible priority
///
/// This function will never fail.
/// ```
pub fn lpt() {
	const NICE_MAX: libc::c_int = if cfg!(target_os = "linux") { 19 } else { 20 };

	// SAFETY: calling C.
	//
	// We are _lowering_ our priority, not increasing, so this function should never fail.
	unsafe { libc::nice(NICE_MAX) };
}