vhangup(2)                     DG/UX R4.11MU05                    vhangup(2)


NAME
       vhangup - virtually hang up the current control terminal

SYNOPSIS
       void  vhangup ()

DESCRIPTION
       This function provides capabilities that are inherently
       implementation dependent.  It may change or cease to exist in the
       future.

       Vhangup revokes read and write access to the calling process's
       controlling terminal for all processes (including the calling
       process).  Further attempts to access this terminal will cause I/O
       errors (EBADF).  If the subject terminal has a process group
       associated with it, a hangup signal (SIGHUP) is sent to that process
       group.

ACCESS CONTROL
       The calling process must have appropriate privilege to successfully
       execute this system call.  For systems supporting the DG/UX
       Capability Option, appropriate privilege is defined as having one or
       more specific capabilities enabled in the effective capability set of
       the calling process.  See capdefaults(5) for the default capability
       for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       None.

DIAGNOSTICS
       None.

SEE ALSO
       init(1M), appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)