usr/src/man/man2/vhangup.2

   1 '\" te
   2 .\" Copyright (c) 1998, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Copyright (c) 1980 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   4 .TH VHANGUP 2 "Mar 19, 1998"
   5 .SH NAME
   6 vhangup \- virtually "hangup" the current controlling terminal
   7 .SH SYNOPSIS
   8 .LP
   9 .nf
  10 #include <unistd.h>
  11
  12 \fBvoid\fR \fBvhangup\fR(\fBvoid\fR);
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBvhangup()\fR function is used by the initialization process
  19 \fBinit\fR(1M) (among others) to ensure that users are given "clean" terminals
  20 at login by revoking access of the previous users' processes to the terminal.
  21 To effect this, \fBvhangup()\fR searches the system tables for references to
  22 the controlling terminal of the invoking process and revokes access permissions
  23 on each instance of the terminal that it finds. Further attempts to access the
  24 terminal by the affected processes will yield I/O errors (\fBEBADF\fR or
  25 \fBEIO\fR). A \fBSIGHUP\fR (hangup signal) is sent to the process group of the
  26 controlling terminal.
  27 .SH SEE ALSO
  28 .sp
  29 .LP
  30 \fBinit\fR(1M)
  31 .SH BUGS
  32 .sp
  33 .LP
  34 Access to the controlling terminal using \fB/dev/tty\fR is still possible.
  35 .sp
  36 .LP
  37 This call should be replaced by an automatic mechanism that takes place on
  38 process exit.