newvt(1)              UNIX System V(Essential Utilities)               newvt(1)


NAME
      newvt - opens virtual terminals.

SYNOPSIS
      newvt [-eprog] [-nvt_number]

DESCRIPTION
      Use the newvt command to open a new virtual terminal.  The newly opened
      virtual terminal will inherit your environment.

      -e    Specifies a program (prog) to execute in the new virtual terminal.
            Without the -e option, the program pointed to by the $SHELL
            environment variable is started in the new virtual terminal.  If
            $SHELL is NULL or points to a nonexecutable program, then /bin/sh
            is invoked.

      -n    Specifies a particular virtual terminal (vt_number) to open.  If
            the -n option is not specified, then the next available virtual
            terminal is opened.  Close virtual terminals by pressing CTRL-d
            (control d).  Repeat CTRL-d until all open virtual terminals are
            closed.

DIAGNOSTICS
      The newvt command will fail under the following conditions:

            If an illegal option is specified.
            If the device cannot be opened.
            If newvt is invoked from a remote terminal.
            If no virtual terminals are available (-n option not specified).
            If the requested virtual terminal is not available (-n option specified).
            If the requested virtual terminal cannot be opened.
            If the specified command cannot be executed (-e option specified).
            If the $SHELL program cannot be executed ($SHELL set and -e option
                 not specified).
            If /dev/vtmon cannot be opened.

SEE ALSO
      vtlmgr(1)
      vtgetty(1M) in the System Administrator's Reference Manual.















10/89                                                                    Page 1