vhangup(2)

✨ vhangup(2) — virtually hangup the current terminal ✨

okay bestie, so this is vhangup, from section 2 of the Linux manual (that's the system calls girlies 💅). Buckle up, it's a short one but it's iconic.

---

💖 NAME 💖

vhangup — virtually hangup the current terminal

🌸 LIBRARY 🌸

Standard C library (libc, -lc). yes queen, you just link it like normal 🫶

✨ SYNOPSIS ✨

#include <unistd.h>

int vhangup(void);

🎀 Feature Test Macro Requirements for glibc 🎀

(peep feature_test_macros(7) if you wanna know the whole lore)

For vhangup():

• Since glibc 2.21:
  • _DEFAULT_SOURCE
• In glibc 2.19 and 2.20:
  • _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
• Up to and including glibc 2.19:
  • _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

like, the vibes of these macros changed over the glibc eras, okay? don't @ me, just define the right one 🔥

---

👑 DESCRIPTION 👑

vhangup() simulates a hangup on the current terminal. basically it's giving "you don't get to linger here" energy 💀

This call arranges for other users to have a "clean" terminal at login time. so when the next person logs in, they get a fresh, untouched tty — no leftover nonsense from whoever was there before. immaculate. pristine. main character terminal 🌈✨

---

🦋 RETURN VALUE 🦋

• On success, zero is returned. slay 💖
• On error, -1 is returned, and errno is set to indicate the error. not slay 😭

---

🍓 ERRORS 🍓

• EPERM — The calling process has insufficient privilege to call vhangup(); the CAP_SYS_TTY_CONFIG capability is required. so like… you need the keys to the kingdom, bestie. no cap, this one's a privileged move 👑

---

💜 STANDARDS 💜

Linux. periodt. 🎀

---

🔥 SEE ALSO 🔥

• init(1)
• capabilities(7)

---

ngl this syscall is short but she is powerful — messing with terminals at login means you better know exactly what you're doing, so double-check that CAP_SYS_TTY_CONFIG before you go feral 🙈

---

and that's the whole page, bestie 💅 this one came straight from the Linux man-pages 6.20, dated 2026-02-08. go forth and hang up those terminals (virtually). bye ilysm 🫶✨