vtgetty(1M)           UNIX System V(Essential Utilities)            vtgetty(1M)


NAME
      vtgetty - sets terminal type, modes, speed, and line discipline.

SYNOPSIS
      /etc/vtgetty [-h] [-ttimeout] line [ [speed[type [linedisc]]]

DESCRIPTION
      The vtgetty command is a program invoked by init(1M).  It is the second
      process in the series (init-vtgetty-getty-login-shell) that passes its
      arguments and executes /etc/getty.  The /etc/getty process will
      ultimately connect a user with the UNIX system.  vtgetty can be executed
      only by the super-user (a process with the user-ID of root).

      The command options are identical to those of getty(1M).

      Initially, vtgetty opens the device and determines if any virtual
      terminals (vts) are open for that device.  If there are active vts, the
      user will be prompted to determine if the vts should be closed
      automatically or manually when the user logs out.

      If the automatic option is selected, vtgetty will send the signals,
      SIGHUP and SIGTERM, to each open vt.

      It will then wait 3 seconds and send a SIGKILL signal to the vts to
      ensure that all the vts are terminated.

      If the manual closure option is selected, the highest numbered vt will be
      activated and the user can manually close the vt.  This will be repeated
      until all open vts are manually closed.

DIAGNOSTICS
      vtgetty will fail under the following conditions:

            If there is no memory available.
            If it cannot open the device it was given.
            If it cannot convert from a file descriptor to a file pointer.
            If it cannot get the file status [stat(2)] of the device it was
      given.
            If an ioctl(2) call fails.

FILES
      /etc/gettydefs

SEE ALSO
      getty(1M), init(1M), kill(1M), tty(1M), ioctl(2), stat(2), gettydefs(4),
      inittab(4) in the Programmer's Reference Manual.








10/89                                                                    Page 1