---
name: "vhangup"
section: "2"
platform: "linux"
package: "man-pages"
version: "6.19-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/vhangup"
---

# vhangup(2)

virtually hangup the current terminal

## NAME

vhangup - virtually hangup the current terminal

## LIBRARY

Standard C library (*libc*, *-lc*)

## SYNOPSIS

```
#include <unistd.h>
```

**int vhangup(void);**

Feature Test Macro Requirements for glibc (see [**feature\_test\_macros**(7)](/feature_test_macros/7.md)):

**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)
```

## DESCRIPTION

**vhangup**() simulates a hangup on the current terminal. This call arranges for other users to have a “clean” terminal at login time.

## RETURN VALUE

On success, zero is returned. On error, -1 is returned, and *errno* is set to indicate the error.

## ERRORS

- **EPERM**

  The calling process has insufficient privilege to call **vhangup**(); the **CAP\_SYS\_TTY\_CONFIG** capability is required.

## STANDARDS

Linux.

## SEE ALSO

[**init**(1)](/init/1.md), [**capabilities**(7)](/capabilities/7.md)