Debian Codegraph @

.cargo/vendor/rustix/src/process/pidfd.rs

raw
1 use crate::fd::OwnedFd;
2 use crate::process::{Pid, Signal};
3 use crate::{backend, io};
4 use backend::fd::AsFd;
5
6 bitflags::bitflags! {
7 /// `PIDFD_*` flags for use with [`pidfd_open`].
8 ///
9 /// [`pidfd_open`]: crate::process::pidfd_open
10 #[repr(transparent)]
11 #[derive(Copy, Clone, Eq, PartialEq, Hash, Debug)]
12 pub struct PidfdFlags: backend::c::c_uint {
13 /// `PIDFD_NONBLOCK`.
14 const NONBLOCK = backend::c::PIDFD_NONBLOCK;
15
16 /// <https://docs.rs/bitflags/*/bitflags/#externally-defined-flags>
17 const _ = !0;
18 }
19 }
20
21 /// `syscall(SYS_pidfd_open, pid, flags)`—Creates a file descriptor for a
22 /// process.
23 ///
24 /// # References
25 /// - [Linux]
26 ///
27 /// [Linux]: https://man7.org/linux/man-pages/man2/pidfd_open.2.html
28 #[inline]
29 pub fn pidfd_open(pid: Pid, flags: PidfdFlags) -> io::Result<OwnedFd> {
30 backend::process::syscalls::pidfd_open(pid, flags)
31 }
32
33 /// `syscall(SYS_pidfd_send_signal, pidfd, sig, NULL, 0)`—Send a signal to a
34 /// process specified by a file descriptor.
35 ///
36 /// # References
37 /// - [Linux]
38 ///
39 /// [Linux]: https://man7.org/linux/man-pages/man2/pidfd_send_signal.2.html
40 #[inline]
41 pub fn pidfd_send_signal<Fd: AsFd>(pidfd: Fd, sig: Signal) -> io::Result<()> {
42 backend::process::syscalls::pidfd_send_signal(pidfd.as_fd(), sig)
43 }