tiocsctty(9)

💅 tiocsctty — set controlling tty 💅

okay so bestie, welcome to the tiocsctty(9) page from the Kernel API Manual ✨ this one is lowkey all about job control, and it's giving "session leader makes a tty official" energy. no cap 🫶

✨ NAME ✨

tiocsctty — set controlling tty

🌸 SYNOPSIS 🌸

int tiocsctty (struct tty_struct *tty , struct file *file , int arg );

🎀 ARGUMENTS 🎀

• tty — the tty structure, aka the tty we're talking about 💖
• file — the file structure used to check permissions 🔐
• arg — the user argument 🫡

💖 DESCRIPTION 💖

okay so this ioctl is literally used to manage job control. It permits a session leader to set this tty as the controlling tty for the session. periodt. 👑

🔒 Locking (the important bits)

• It takes tty_lock to serialize proc_set_tty for this tty 🧵
• It takes tasklist_lock internally to walk sessions 🚶‍♀️
• It takes ->siglock when updating signal->tty 📡

🔥 SEE ALSO 🔥

Kernel file ./drivers/tty/tty_jobctrl.c is the place, and the whole squad is:

• __tty_check_change(9)
• __proc_set_tty(9)
• tty_signal_session_leader(9)
• disassociate_ctty(9)
• tty_get_pgrp(9)
• tiocgpgrp(9)
• tiocspgrp(9)
• tiocgsid(9)

mwah 💋 cute little sign-off: source/version is ./drivers/tty, date is October 2026, page is tiocsctty(9) — byeee bestie, go get that controlling tty sorted 🫶✨