1#[cfg(not(target_os = "espidf"))]
2use crate::process::{Pid, Uid};
3use crate::{backend, io};
4
5/// `nice(inc)`—Adjust the scheduling priority of the current process.
6///
7/// # References
8/// - [POSIX]
9/// - [Linux]
10///
11/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/nice.html
12/// [Linux]: https://man7.org/linux/man-pages/man2/nice.2.html
13#[inline]
14pub fn nice(inc: i32) -> io::Result<i32> {
15 backend::process::syscalls::nice(inc)
16}
17
18/// `getpriority(PRIO_USER, uid)`—Get the scheduling priority of the given
19/// user.
20///
21/// # References
22/// - [POSIX]
23/// - [Linux]
24/// - [Apple]
25///
26/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/getpriority.html
27/// [Linux]: https://man7.org/linux/man-pages/man2/getpriority.2.html
28/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
29#[cfg(not(target_os = "espidf"))]
30#[inline]
31#[doc(alias = "getpriority")]
32pub fn getpriority_user(uid: Uid) -> io::Result<i32> {
33 backend::process::syscalls::getpriority_user(uid)
34}
35
36/// `getpriority(PRIO_PGRP, gid)`—Get the scheduling priority of the given
37/// process group.
38///
39/// A `pgid` of `None` means the process group of the calling process.
40///
41/// # References
42/// - [POSIX]
43/// - [Linux]
44/// - [Apple]
45///
46/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/getpriority.html
47/// [Linux]: https://man7.org/linux/man-pages/man2/getpriority.2.html
48/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
49#[cfg(not(target_os = "espidf"))]
50#[inline]
51#[doc(alias = "getpriority")]
52pub fn getpriority_pgrp(pgid: Option<Pid>) -> io::Result<i32> {
53 backend::process::syscalls::getpriority_pgrp(pgid)
54}
55
56/// `getpriority(PRIO_PROCESS, pid)`—Get the scheduling priority of the given
57/// process.
58///
59/// A `pid` of `None` means the calling process.
60///
61/// # References
62/// - [POSIX]
63/// - [Linux]
64/// - [Apple]
65///
66/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/getpriority.html
67/// [Linux]: https://man7.org/linux/man-pages/man2/getpriority.2.html
68/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
69#[cfg(not(target_os = "espidf"))]
70#[inline]
71#[doc(alias = "getpriority")]
72pub fn getpriority_process(pid: Option<Pid>) -> io::Result<i32> {
73 backend::process::syscalls::getpriority_process(pid)
74}
75
76/// `setpriority(PRIO_USER, uid)`—Get the scheduling priority of the given
77/// user.
78///
79/// # References
80/// - [POSIX]
81/// - [Linux]
82/// - [Apple]
83///
84/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/setpriority.html
85/// [Linux]: https://man7.org/linux/man-pages/man2/setpriority.2.html
86/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
87#[cfg(not(target_os = "espidf"))]
88#[inline]
89#[doc(alias = "setpriority")]
90pub fn setpriority_user(uid: Uid, priority: i32) -> io::Result<()> {
91 backend::process::syscalls::setpriority_user(uid, priority)
92}
93
94/// `setpriority(PRIO_PGRP, pgid)`—Get the scheduling priority of the given
95/// process group.
96///
97/// A `pgid` of `None` means the process group of the calling process.
98///
99/// # References
100/// - [POSIX]
101/// - [Linux]
102/// - [Apple]
103///
104/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/setpriority.html
105/// [Linux]: https://man7.org/linux/man-pages/man2/setpriority.2.html
106/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
107#[cfg(not(target_os = "espidf"))]
108#[inline]
109#[doc(alias = "setpriority")]
110pub fn setpriority_pgrp(pgid: Option<Pid>, priority: i32) -> io::Result<()> {
111 backend::process::syscalls::setpriority_pgrp(pgid, priority)
112}
113
114/// `setpriority(PRIO_PROCESS, pid)`—Get the scheduling priority of the given
115/// process.
116///
117/// A `pid` of `None` means the calling process.
118///
119/// # References
120/// - [POSIX]
121/// - [Linux]
122/// - [Apple]
123///
124/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/setpriority.html
125/// [Linux]: https://man7.org/linux/man-pages/man2/setpriority.2.html
126/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/setpriority.2.html
127#[cfg(not(target_os = "espidf"))]
128#[inline]
129#[doc(alias = "setpriority")]
130pub fn setpriority_process(pid: Option<Pid>, priority: i32) -> io::Result<()> {
131 backend::process::syscalls::setpriority_process(pid, priority)
132}
133