vendor/rustix/src/process/ioctl.rs

   1 //! Process-oriented `ioctl`s.
   2 //!
   3 //! # Safety
   4 //!
   5 //! This module invokes `ioctl`s.
   6
   7 #![allow(unsafe_code)]
   8
   9 use crate::{backend, io, ioctl};
  10 use backend::c;
  11 use backend::fd::AsFd;
  12
  13 /// `ioctl(fd, TIOCSCTTY, 0)`—Sets the controlling terminal for the processs.
  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")]
  28 pub fn ioctl_tiocsctty<Fd: AsFd>(fd: Fd) -> io::Result<()> {
  29     unsafe { ioctl::ioctl(fd, Tiocsctty) }
  30 }
  31
  32 #[cfg(not(any(windows, target_os = "aix", target_os = "redox", target_os = "wasi")))]
  33 struct Tiocsctty;
  34
  35 #[cfg(not(any(windows, target_os = "aix", target_os = "redox", target_os = "wasi")))]
  36 unsafe impl ioctl::Ioctl for Tiocsctty {
  37     type Output = ();
  38
  39     const IS_MUTATING: bool = false;
  40     const OPCODE: ioctl::Opcode = ioctl::Opcode::old(c::TIOCSCTTY as ioctl::RawOpcode);
  41
  42     fn as_ptr(&mut self) -> *mut c::c_void {
  43         (&0u32) 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 }