vhangup(2) [bsd man page]

VHANGUP(2)							System Calls Manual							VHANGUP(2)

NAME

       vhangup - virtually ``hangup'' the current control terminal

SYNOPSIS

       vhangup()

DESCRIPTION

       Vhangup is used by the initialization process init(8) (among others) to arrange that users are given "clean"' terminals at login, by revok-
       ing access of the previous users' processes to the terminal.  To effect this, vhangup searches the system tables for references to the con-
       trol  terminal  of  the	invoking process, revoking access permissions on each instance of the terminal that it finds.  Further attempts to
       access the terminal by the affected processes will yield i/o errors (EBADF).  Finally, a hangup signal (SIGHUP)	is  sent  to  the  process
       group of the control terminal.

SEE ALSO

       init (8)

BUGS

       Access to the control terminal via /dev/tty is still possible.

       This call should be replaced by an automatic mechanism that takes place on process exit.

4th Berkeley Distribution					   June 30, 1985							VHANGUP(2)

VHANGUP(2)						     Linux Programmer's Manual							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 3.44 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/.

Linux								    2007-07-26								VHANGUP(2)