1//! Process-oriented `ioctl`s.
2//!
3//! # Safety
4//!
5//! This module invokes `ioctl`s.
6
7#![allow(unsafe_code)]
8
9use crate::{backend, io, ioctl};
10use backend::c;
11use backend::fd::AsFd;
12
13/// `ioctl(fd, TIOCSCTTY, 0)`—Sets the controlling terminal for the process.
14///
15/// # References
16/// - [Linux]
17/// - [FreeBSD]
18/// - [NetBSD]
19/// - [OpenBSD]
20///
21/// [Linux]: https://man7.org/linux/man-pages/man4/tty_ioctl.4.html
22/// [FreeBSD]: https://man.freebsd.org/cgi/man.cgi?query=tty&sektion=4
23/// [NetBSD]: https://man.netbsd.org/tty.4
24/// [OpenBSD]: https://man.openbsd.org/tty.4
25#[cfg(not(any(windows, target_os = "aix", target_os = "redox", target_os = "wasi")))]
26#[inline]
27#[doc(alias = "TIOCSCTTY")]
28pub fn ioctl_tiocsctty<Fd: AsFd>(fd: Fd) -> io::Result<()> {
29 unsafe { ioctl::ioctl(fd, ioctl:Tiocsctty) }
30}
31
32#[cfg(not(any(windows, target_os = "aix", target_os = "redox", target_os = "wasi")))]
33struct Tiocsctty;
34
35#[cfg(not(any(windows, target_os = "aix", target_os = "redox", target_os = "wasi")))]
36unsafe impl ioctl::Ioctl for Tiocsctty {
37 type Output = ();
38
39 const IS_MUTATING: bool = false;
40 const OPCODE: ioctl::Opcode = ioctl::Opcode::old(raw:c::TIOCSCTTY as ioctl::RawOpcode);
41
42 fn as_ptr(&mut self) -> *mut c::c_void {
43 (&0_u32) as *const u32 as *mut c::c_void
44 }
45
46 unsafe fn output_from_ptr(
47 _: ioctl::IoctlOutput,
48 _: *mut c::c_void,
49 ) -> io::Result<Self::Output> {
50 Ok(())
51 }
52}
53