Seth Woolley's Man Viewer

VHANGUP(2)                 Linux Programmer's Manual                VHANGUP(2)



NAME
       vhangup - virtually hangup the current tty(1,4)

SYNOPSIS
       #include <unistd.h>

       int vhangup(void);

DESCRIPTION
       vhangup simulates a hangup on the current terminal.  This call arranges
       for other users(1,5) to have a "clean" tty(1,4) at login(1,3,5) time.

RETURN VALUE
       On success, zero is returned.  On error(8,n), -1 is returned, and  errno  is
       set(7,n,1 builtins) 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(1,8)  programs
       intended to be portable.

SEE ALSO
       capabilities(7), init(8)



Linux 2.6.6                       2004-05-27                        VHANGUP(2)