logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

openvt.1 (2488B)

    

  1. .\" Copyright 1994-95 Jon Tombs (jon@gtex02.us.es, jon@robots.ox.ac.uk)
  2. .\" May be distributed under the GNU General Public License
  3. .TH OPENVT 1 "19 Jul 1996" "kbd"
  4. .SH NAME
  5. openvt \- start a program on a new virtual terminal (VT).
  6. .SH SYNOPSIS
  7. .B openvt
  8. [\-c vtnumber] [OPTIONS] [\-\-] command
  9. .SH DESCRIPTION
  10. .B openvt
  11. will find the first available VT, and run on it the given
  12. .B command
  13. with the given
  14. .B "command options",
  15. standard input, output and error are directed to that terminal. The current
  16. search path ($PATH) is used to find the requested command. If no command is
  17. specified then the environment variable $SHELL is used.
  18. .SS OPTIONS
  19. .TP
  20. .I "\-c, \-\-console=VTNUMBER"
  21. Use the given VT number and not the first available. Note you
  22. must have write access to the supplied VT for this to work.
  23. .TP
  24. .I "\-f, \-\-force"
  25. Force opening a VT without checking whether it is already in use.
  26. .TP
  27. .I "\-e, \-\-exec"
  28. Directly execute the given command, without forking.
  29. This option is meant for use in
  30. .IR /etc/inittab .
  31. .TP
  32. .I "\-s, \-\-switch"
  33. Switch to the new VT when starting the command. The VT of the new command
  34. will be made the new current VT.
  35. .TP
  36. .I "\-u, \-\-user"
  37. Figure out the owner of the current VT, and run login as that user.
  38. Suitable to be called by init. Shouldn't be used with \fI\-c\fR or \fI\-l\fR.
  39. .TP
  40. .I "\-l, \-\-login"
  41. Make the command a login shell. A \- is prepended to the name of the command
  42. to be executed.
  43. .TP
  44. .I "\-v, \-\-verbose"
  45. Be a bit more verbose.
  46. .TP
  47. .I "\-w, \-\-wait"
  48. wait for command to complete. If \-w and \-s are used together then
  49. .B openvt
  50. will switch back to the controlling terminal when the command completes.
  51. .TP
  52. .I "\-V, \-\-version"
  53. print program version and exit.
  54. .TP
  55. .I "\-h, \-\-help"
  56. show this text and exit.
  57. .TP
  58. .I "\-\-"
  59. end of options to
  60. .BR openvt .
  61. .SH NOTE
  62. If
  63. .B openvt
  64. is compiled with a getopt_long() and you wish to set
  65. options to the command to be run, then you must supply
  66. the end of options \-\- flag before the command.
  67. .SH EXAMPLES
  68. .B openvt
  69. can be used to start a shell on the next free VT, by using the command:
  70. .TP
  71. .I "openvt bash"
  72. .TP
  74. To start the shell as a login shell, use:
  75. .TP
  76. .I "openvt -l bash"
  77. .TP
  79. To get a long listing you must supply the \-\- separator:
  80. .TP
  81. .I "openvt -- ls -l"
  82. .SH HISTORY
  83. Earlier,
  84. .B openvt
  85. was called
  86. .BR open .
  87. It was written by Jon Tombs <jon@gtex02.us.es> or <jon@robots.ox.ac.uk>.
  88. The \fI\-w\fR idea is from "sam".
  90. .SH "SEE ALSO"
  91. .BR chvt (1),
  92. .BR doshell (8),
  93. .BR login (1)