util.go 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. // Copyright 2011 The Go Authors. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. // +build darwin dragonfly freebsd linux,!appengine netbsd openbsd
  5. // Package terminal provides support functions for dealing with terminals, as
  6. // commonly found on UNIX systems.
  7. //
  8. // Putting a terminal into raw mode is the most common requirement:
  9. //
  10. // oldState, err := terminal.MakeRaw(0)
  11. // if err != nil {
  12. // panic(err)
  13. // }
  14. // defer terminal.Restore(0, oldState)
  15. package terminal // import "golang.org/x/crypto/ssh/terminal"
  16. import (
  17. "io"
  18. "syscall"
  19. "unsafe"
  20. )
  21. // State contains the state of a terminal.
  22. type State struct {
  23. termios syscall.Termios
  24. }
  25. // IsTerminal returns true if the given file descriptor is a terminal.
  26. func IsTerminal(fd int) bool {
  27. var termios syscall.Termios
  28. _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlReadTermios, uintptr(unsafe.Pointer(&termios)), 0, 0, 0)
  29. return err == 0
  30. }
  31. // MakeRaw put the terminal connected to the given file descriptor into raw
  32. // mode and returns the previous state of the terminal so that it can be
  33. // restored.
  34. func MakeRaw(fd int) (*State, error) {
  35. var oldState State
  36. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlReadTermios, uintptr(unsafe.Pointer(&oldState.termios)), 0, 0, 0); err != 0 {
  37. return nil, err
  38. }
  39. newState := oldState.termios
  40. newState.Iflag &^= syscall.ISTRIP | syscall.INLCR | syscall.ICRNL | syscall.IGNCR | syscall.IXON | syscall.IXOFF
  41. newState.Lflag &^= syscall.ECHO | syscall.ICANON | syscall.ISIG
  42. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlWriteTermios, uintptr(unsafe.Pointer(&newState)), 0, 0, 0); err != 0 {
  43. return nil, err
  44. }
  45. return &oldState, nil
  46. }
  47. // GetState returns the current state of a terminal which may be useful to
  48. // restore the terminal after a signal.
  49. func GetState(fd int) (*State, error) {
  50. var oldState State
  51. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlReadTermios, uintptr(unsafe.Pointer(&oldState.termios)), 0, 0, 0); err != 0 {
  52. return nil, err
  53. }
  54. return &oldState, nil
  55. }
  56. // Restore restores the terminal connected to the given file descriptor to a
  57. // previous state.
  58. func Restore(fd int, state *State) error {
  59. _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlWriteTermios, uintptr(unsafe.Pointer(&state.termios)), 0, 0, 0)
  60. return err
  61. }
  62. // GetSize returns the dimensions of the given terminal.
  63. func GetSize(fd int) (width, height int, err error) {
  64. var dimensions [4]uint16
  65. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), uintptr(syscall.TIOCGWINSZ), uintptr(unsafe.Pointer(&dimensions)), 0, 0, 0); err != 0 {
  66. return -1, -1, err
  67. }
  68. return int(dimensions[1]), int(dimensions[0]), nil
  69. }
  70. // ReadPassword reads a line of input from a terminal without local echo. This
  71. // is commonly used for inputting passwords and other sensitive data. The slice
  72. // returned does not include the \n.
  73. func ReadPassword(fd int) ([]byte, error) {
  74. var oldState syscall.Termios
  75. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlReadTermios, uintptr(unsafe.Pointer(&oldState)), 0, 0, 0); err != 0 {
  76. return nil, err
  77. }
  78. newState := oldState
  79. newState.Lflag &^= syscall.ECHO
  80. newState.Lflag |= syscall.ICANON | syscall.ISIG
  81. newState.Iflag |= syscall.ICRNL
  82. if _, _, err := syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlWriteTermios, uintptr(unsafe.Pointer(&newState)), 0, 0, 0); err != 0 {
  83. return nil, err
  84. }
  85. defer func() {
  86. syscall.Syscall6(syscall.SYS_IOCTL, uintptr(fd), ioctlWriteTermios, uintptr(unsafe.Pointer(&oldState)), 0, 0, 0)
  87. }()
  88. var buf [16]byte
  89. var ret []byte
  90. for {
  91. n, err := syscall.Read(fd, buf[:])
  92. if err != nil {
  93. return nil, err
  94. }
  95. if n == 0 {
  96. if len(ret) == 0 {
  97. return nil, io.EOF
  98. }
  99. break
  100. }
  101. if buf[n-1] == '\n' {
  102. n--
  103. }
  104. ret = append(ret, buf[:n]...)
  105. if n < len(buf) {
  106. break
  107. }
  108. }
  109. return ret, nil
  110. }