VHANGUP(2)

NAME
vhangup - virtually hangup the current tty

SYNOPSIS
#include <unistd.h>

int vhangup(void);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

vhangup(): _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” tty at login time.

RETURN VALUE
On success, zero is returned. On error, -1 is returned, and errno is set appropriately.

ERRORS

EPERM
    The calling process has insufficient privilege to call vhangup(); the CAP_SYS_TTY_CONFIG capability is required.

CONFORMING TO
This call is Linux specific, and should not be used in programs intended to be portable.

SEE ALSO
capabilities(7), init(8)

COLOPHON
This page is part of release 2.70 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.