annotate lldb/source/Host/common/Terminal.cpp @ 173:0572611fdcc8 llvm10 llvm12

reorgnization done
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 11:55:54 +0900
parents 1d019706d866
children 2e18cbf3894f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
150
anatofuz
parents:
diff changeset
1 //===-- Terminal.cpp ------------------------------------------------------===//
anatofuz
parents:
diff changeset
2 //
anatofuz
parents:
diff changeset
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
anatofuz
parents:
diff changeset
4 // See https://llvm.org/LICENSE.txt for license information.
anatofuz
parents:
diff changeset
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
anatofuz
parents:
diff changeset
6 //
anatofuz
parents:
diff changeset
7 //===----------------------------------------------------------------------===//
anatofuz
parents:
diff changeset
8
anatofuz
parents:
diff changeset
9 #include "lldb/Host/Terminal.h"
anatofuz
parents:
diff changeset
10
anatofuz
parents:
diff changeset
11 #include "lldb/Host/Config.h"
anatofuz
parents:
diff changeset
12 #include "lldb/Host/PosixApi.h"
anatofuz
parents:
diff changeset
13 #include "llvm/ADT/STLExtras.h"
anatofuz
parents:
diff changeset
14
anatofuz
parents:
diff changeset
15 #include <fcntl.h>
anatofuz
parents:
diff changeset
16 #include <signal.h>
anatofuz
parents:
diff changeset
17
anatofuz
parents:
diff changeset
18 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
19 #include <termios.h>
anatofuz
parents:
diff changeset
20 #endif
anatofuz
parents:
diff changeset
21
anatofuz
parents:
diff changeset
22 using namespace lldb_private;
anatofuz
parents:
diff changeset
23
anatofuz
parents:
diff changeset
24 bool Terminal::IsATerminal() const { return m_fd >= 0 && ::isatty(m_fd); }
anatofuz
parents:
diff changeset
25
anatofuz
parents:
diff changeset
26 bool Terminal::SetEcho(bool enabled) {
anatofuz
parents:
diff changeset
27 if (FileDescriptorIsValid()) {
anatofuz
parents:
diff changeset
28 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
29 if (IsATerminal()) {
anatofuz
parents:
diff changeset
30 struct termios fd_termios;
anatofuz
parents:
diff changeset
31 if (::tcgetattr(m_fd, &fd_termios) == 0) {
anatofuz
parents:
diff changeset
32 bool set_corectly = false;
anatofuz
parents:
diff changeset
33 if (enabled) {
anatofuz
parents:
diff changeset
34 if (fd_termios.c_lflag & ECHO)
anatofuz
parents:
diff changeset
35 set_corectly = true;
anatofuz
parents:
diff changeset
36 else
anatofuz
parents:
diff changeset
37 fd_termios.c_lflag |= ECHO;
anatofuz
parents:
diff changeset
38 } else {
anatofuz
parents:
diff changeset
39 if (fd_termios.c_lflag & ECHO)
anatofuz
parents:
diff changeset
40 fd_termios.c_lflag &= ~ECHO;
anatofuz
parents:
diff changeset
41 else
anatofuz
parents:
diff changeset
42 set_corectly = true;
anatofuz
parents:
diff changeset
43 }
anatofuz
parents:
diff changeset
44
anatofuz
parents:
diff changeset
45 if (set_corectly)
anatofuz
parents:
diff changeset
46 return true;
anatofuz
parents:
diff changeset
47 return ::tcsetattr(m_fd, TCSANOW, &fd_termios) == 0;
anatofuz
parents:
diff changeset
48 }
anatofuz
parents:
diff changeset
49 }
anatofuz
parents:
diff changeset
50 #endif // #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
51 }
anatofuz
parents:
diff changeset
52 return false;
anatofuz
parents:
diff changeset
53 }
anatofuz
parents:
diff changeset
54
anatofuz
parents:
diff changeset
55 bool Terminal::SetCanonical(bool enabled) {
anatofuz
parents:
diff changeset
56 if (FileDescriptorIsValid()) {
anatofuz
parents:
diff changeset
57 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
58 if (IsATerminal()) {
anatofuz
parents:
diff changeset
59 struct termios fd_termios;
anatofuz
parents:
diff changeset
60 if (::tcgetattr(m_fd, &fd_termios) == 0) {
anatofuz
parents:
diff changeset
61 bool set_corectly = false;
anatofuz
parents:
diff changeset
62 if (enabled) {
anatofuz
parents:
diff changeset
63 if (fd_termios.c_lflag & ICANON)
anatofuz
parents:
diff changeset
64 set_corectly = true;
anatofuz
parents:
diff changeset
65 else
anatofuz
parents:
diff changeset
66 fd_termios.c_lflag |= ICANON;
anatofuz
parents:
diff changeset
67 } else {
anatofuz
parents:
diff changeset
68 if (fd_termios.c_lflag & ICANON)
anatofuz
parents:
diff changeset
69 fd_termios.c_lflag &= ~ICANON;
anatofuz
parents:
diff changeset
70 else
anatofuz
parents:
diff changeset
71 set_corectly = true;
anatofuz
parents:
diff changeset
72 }
anatofuz
parents:
diff changeset
73
anatofuz
parents:
diff changeset
74 if (set_corectly)
anatofuz
parents:
diff changeset
75 return true;
anatofuz
parents:
diff changeset
76 return ::tcsetattr(m_fd, TCSANOW, &fd_termios) == 0;
anatofuz
parents:
diff changeset
77 }
anatofuz
parents:
diff changeset
78 }
anatofuz
parents:
diff changeset
79 #endif // #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
80 }
anatofuz
parents:
diff changeset
81 return false;
anatofuz
parents:
diff changeset
82 }
anatofuz
parents:
diff changeset
83
anatofuz
parents:
diff changeset
84 // Default constructor
anatofuz
parents:
diff changeset
85 TerminalState::TerminalState()
anatofuz
parents:
diff changeset
86 : m_tty(), m_tflags(-1),
anatofuz
parents:
diff changeset
87 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
88 m_termios_up(),
anatofuz
parents:
diff changeset
89 #endif
anatofuz
parents:
diff changeset
90 m_process_group(-1) {
anatofuz
parents:
diff changeset
91 }
anatofuz
parents:
diff changeset
92
anatofuz
parents:
diff changeset
93 // Destructor
anatofuz
parents:
diff changeset
94 TerminalState::~TerminalState() {}
anatofuz
parents:
diff changeset
95
anatofuz
parents:
diff changeset
96 void TerminalState::Clear() {
anatofuz
parents:
diff changeset
97 m_tty.Clear();
anatofuz
parents:
diff changeset
98 m_tflags = -1;
anatofuz
parents:
diff changeset
99 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
100 m_termios_up.reset();
anatofuz
parents:
diff changeset
101 #endif
anatofuz
parents:
diff changeset
102 m_process_group = -1;
anatofuz
parents:
diff changeset
103 }
anatofuz
parents:
diff changeset
104
anatofuz
parents:
diff changeset
105 // Save the current state of the TTY for the file descriptor "fd" and if
anatofuz
parents:
diff changeset
106 // "save_process_group" is true, attempt to save the process group info for the
anatofuz
parents:
diff changeset
107 // TTY.
anatofuz
parents:
diff changeset
108 bool TerminalState::Save(int fd, bool save_process_group) {
anatofuz
parents:
diff changeset
109 m_tty.SetFileDescriptor(fd);
anatofuz
parents:
diff changeset
110 if (m_tty.IsATerminal()) {
anatofuz
parents:
diff changeset
111 #if LLDB_ENABLE_POSIX
anatofuz
parents:
diff changeset
112 m_tflags = ::fcntl(fd, F_GETFL, 0);
anatofuz
parents:
diff changeset
113 #endif
anatofuz
parents:
diff changeset
114 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
115 if (m_termios_up == nullptr)
anatofuz
parents:
diff changeset
116 m_termios_up.reset(new struct termios);
anatofuz
parents:
diff changeset
117 int err = ::tcgetattr(fd, m_termios_up.get());
anatofuz
parents:
diff changeset
118 if (err != 0)
anatofuz
parents:
diff changeset
119 m_termios_up.reset();
anatofuz
parents:
diff changeset
120 #endif // #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
121 #if LLDB_ENABLE_POSIX
anatofuz
parents:
diff changeset
122 if (save_process_group)
anatofuz
parents:
diff changeset
123 m_process_group = ::tcgetpgrp(0);
anatofuz
parents:
diff changeset
124 else
anatofuz
parents:
diff changeset
125 m_process_group = -1;
anatofuz
parents:
diff changeset
126 #endif
anatofuz
parents:
diff changeset
127 } else {
anatofuz
parents:
diff changeset
128 m_tty.Clear();
anatofuz
parents:
diff changeset
129 m_tflags = -1;
anatofuz
parents:
diff changeset
130 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
131 m_termios_up.reset();
anatofuz
parents:
diff changeset
132 #endif
anatofuz
parents:
diff changeset
133 m_process_group = -1;
anatofuz
parents:
diff changeset
134 }
anatofuz
parents:
diff changeset
135 return IsValid();
anatofuz
parents:
diff changeset
136 }
anatofuz
parents:
diff changeset
137
anatofuz
parents:
diff changeset
138 // Restore the state of the TTY using the cached values from a previous call to
anatofuz
parents:
diff changeset
139 // Save().
anatofuz
parents:
diff changeset
140 bool TerminalState::Restore() const {
anatofuz
parents:
diff changeset
141 #if LLDB_ENABLE_POSIX
anatofuz
parents:
diff changeset
142 if (IsValid()) {
anatofuz
parents:
diff changeset
143 const int fd = m_tty.GetFileDescriptor();
anatofuz
parents:
diff changeset
144 if (TFlagsIsValid())
anatofuz
parents:
diff changeset
145 fcntl(fd, F_SETFL, m_tflags);
anatofuz
parents:
diff changeset
146
anatofuz
parents:
diff changeset
147 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
148 if (TTYStateIsValid())
anatofuz
parents:
diff changeset
149 tcsetattr(fd, TCSANOW, m_termios_up.get());
anatofuz
parents:
diff changeset
150 #endif // #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
151
anatofuz
parents:
diff changeset
152 if (ProcessGroupIsValid()) {
anatofuz
parents:
diff changeset
153 // Save the original signal handler.
anatofuz
parents:
diff changeset
154 void (*saved_sigttou_callback)(int) = nullptr;
anatofuz
parents:
diff changeset
155 saved_sigttou_callback = (void (*)(int))signal(SIGTTOU, SIG_IGN);
anatofuz
parents:
diff changeset
156 // Set the process group
anatofuz
parents:
diff changeset
157 tcsetpgrp(fd, m_process_group);
anatofuz
parents:
diff changeset
158 // Restore the original signal handler.
anatofuz
parents:
diff changeset
159 signal(SIGTTOU, saved_sigttou_callback);
anatofuz
parents:
diff changeset
160 }
anatofuz
parents:
diff changeset
161 return true;
anatofuz
parents:
diff changeset
162 }
anatofuz
parents:
diff changeset
163 #endif
anatofuz
parents:
diff changeset
164 return false;
anatofuz
parents:
diff changeset
165 }
anatofuz
parents:
diff changeset
166
anatofuz
parents:
diff changeset
167 // Returns true if this object has valid saved TTY state settings that can be
anatofuz
parents:
diff changeset
168 // used to restore a previous state.
anatofuz
parents:
diff changeset
169 bool TerminalState::IsValid() const {
anatofuz
parents:
diff changeset
170 return m_tty.FileDescriptorIsValid() &&
anatofuz
parents:
diff changeset
171 (TFlagsIsValid() || TTYStateIsValid());
anatofuz
parents:
diff changeset
172 }
anatofuz
parents:
diff changeset
173
anatofuz
parents:
diff changeset
174 // Returns true if m_tflags is valid
anatofuz
parents:
diff changeset
175 bool TerminalState::TFlagsIsValid() const { return m_tflags != -1; }
anatofuz
parents:
diff changeset
176
anatofuz
parents:
diff changeset
177 // Returns true if m_ttystate is valid
anatofuz
parents:
diff changeset
178 bool TerminalState::TTYStateIsValid() const {
anatofuz
parents:
diff changeset
179 #if LLDB_ENABLE_TERMIOS
anatofuz
parents:
diff changeset
180 return m_termios_up != nullptr;
anatofuz
parents:
diff changeset
181 #else
anatofuz
parents:
diff changeset
182 return false;
anatofuz
parents:
diff changeset
183 #endif
anatofuz
parents:
diff changeset
184 }
anatofuz
parents:
diff changeset
185
anatofuz
parents:
diff changeset
186 // Returns true if m_process_group is valid
anatofuz
parents:
diff changeset
187 bool TerminalState::ProcessGroupIsValid() const {
anatofuz
parents:
diff changeset
188 return static_cast<int32_t>(m_process_group) != -1;
anatofuz
parents:
diff changeset
189 }
anatofuz
parents:
diff changeset
190
anatofuz
parents:
diff changeset
191 // Constructor
anatofuz
parents:
diff changeset
192 TerminalStateSwitcher::TerminalStateSwitcher() : m_currentState(UINT32_MAX) {}
anatofuz
parents:
diff changeset
193
anatofuz
parents:
diff changeset
194 // Destructor
anatofuz
parents:
diff changeset
195 TerminalStateSwitcher::~TerminalStateSwitcher() {}
anatofuz
parents:
diff changeset
196
anatofuz
parents:
diff changeset
197 // Returns the number of states that this switcher contains
anatofuz
parents:
diff changeset
198 uint32_t TerminalStateSwitcher::GetNumberOfStates() const {
anatofuz
parents:
diff changeset
199 return llvm::array_lengthof(m_ttystates);
anatofuz
parents:
diff changeset
200 }
anatofuz
parents:
diff changeset
201
anatofuz
parents:
diff changeset
202 // Restore the state at index "idx".
anatofuz
parents:
diff changeset
203 //
anatofuz
parents:
diff changeset
204 // Returns true if the restore was successful, false otherwise.
anatofuz
parents:
diff changeset
205 bool TerminalStateSwitcher::Restore(uint32_t idx) const {
anatofuz
parents:
diff changeset
206 const uint32_t num_states = GetNumberOfStates();
anatofuz
parents:
diff changeset
207 if (idx >= num_states)
anatofuz
parents:
diff changeset
208 return false;
anatofuz
parents:
diff changeset
209
anatofuz
parents:
diff changeset
210 // See if we already are in this state?
anatofuz
parents:
diff changeset
211 if (m_currentState < num_states && (idx == m_currentState) &&
anatofuz
parents:
diff changeset
212 m_ttystates[idx].IsValid())
anatofuz
parents:
diff changeset
213 return true;
anatofuz
parents:
diff changeset
214
anatofuz
parents:
diff changeset
215 // Set the state to match the index passed in and only update the current
anatofuz
parents:
diff changeset
216 // state if there are no errors.
anatofuz
parents:
diff changeset
217 if (m_ttystates[idx].Restore()) {
anatofuz
parents:
diff changeset
218 m_currentState = idx;
anatofuz
parents:
diff changeset
219 return true;
anatofuz
parents:
diff changeset
220 }
anatofuz
parents:
diff changeset
221
anatofuz
parents:
diff changeset
222 // We failed to set the state. The tty state was invalid or not initialized.
anatofuz
parents:
diff changeset
223 return false;
anatofuz
parents:
diff changeset
224 }
anatofuz
parents:
diff changeset
225
anatofuz
parents:
diff changeset
226 // Save the state at index "idx" for file descriptor "fd" and save the process
anatofuz
parents:
diff changeset
227 // group if requested.
anatofuz
parents:
diff changeset
228 //
anatofuz
parents:
diff changeset
229 // Returns true if the restore was successful, false otherwise.
anatofuz
parents:
diff changeset
230 bool TerminalStateSwitcher::Save(uint32_t idx, int fd,
anatofuz
parents:
diff changeset
231 bool save_process_group) {
anatofuz
parents:
diff changeset
232 const uint32_t num_states = GetNumberOfStates();
anatofuz
parents:
diff changeset
233 if (idx < num_states)
anatofuz
parents:
diff changeset
234 return m_ttystates[idx].Save(fd, save_process_group);
anatofuz
parents:
diff changeset
235 return false;
anatofuz
parents:
diff changeset
236 }