/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #include "qtcprocess.h" #include "commandline.h" #include "executeondestruction.h" #include "hostosinfo.h" #include "launcherinterface.h" #include "launcherpackets.h" #include "launchersocket.h" #include "qtcassert.h" #include "stringutils.h" #include #include #include #include #include #include #include #ifdef QT_GUI_LIB // qmlpuppet does not use that. #include #include #endif #include #include #include #ifdef Q_OS_WIN #ifdef QTCREATOR_PCH_H #define CALLBACK WINAPI #endif #include #else #include #include #include #endif using namespace Utils::Internal; namespace Utils { namespace Internal { enum { debug = 0 }; enum { syncDebug = 0 }; enum { defaultMaxHangTimerCount = 10 }; static Q_LOGGING_CATEGORY(processLog, "qtc.utils.qtcprocess", QtWarningMsg) static DeviceProcessHooks s_deviceHooks; // Data for one channel buffer (stderr/stdout) class ChannelBuffer { public: void clearForRun(); void handleRest(); void append(const QByteArray &text); QByteArray rawData; QString incompleteLineBuffer; // lines not yet signaled QTextCodec *codec = nullptr; // Not owner std::unique_ptr codecState; std::function outputCallback; bool emitSingleLines = true; bool keepRawData = true; }; class ProcessInterface : public QObject { Q_OBJECT public: ProcessInterface() : QObject() {} virtual QByteArray readAllStandardOutput() = 0; virtual QByteArray readAllStandardError() = 0; virtual void setProcessEnvironment(const QProcessEnvironment &environment) = 0; virtual void setWorkingDirectory(const QString &dir) = 0; virtual void start(const QString &program, const QStringList &arguments, QIODevice::OpenMode mode) = 0; virtual void terminate() = 0; virtual void kill() = 0; virtual void close() = 0; virtual qint64 write(const QByteArray &data) = 0; virtual void closeWriteChannel() = 0; virtual void setStandardInputFile(const QString &fileName) = 0; virtual void setProcessChannelMode(QProcess::ProcessChannelMode mode) = 0; virtual qint64 bytesAvailable() const = 0; virtual QString program() const = 0; virtual QProcess::ProcessError error() const = 0; virtual QProcess::ProcessState state() const = 0; virtual qint64 processId() const = 0; virtual QProcess::ExitStatus exitStatus() const = 0; virtual QString errorString() const = 0; virtual void setErrorString(const QString &str) = 0; virtual bool waitForStarted(int msecs) = 0; virtual bool waitForReadyRead(int msecs) = 0; virtual bool waitForFinished(int msecs) = 0; virtual void setLowPriority() = 0; virtual bool lowPriority() const = 0; virtual void setDisableUnixTerminal() = 0; virtual void setKeepWriteChannelOpen() = 0; virtual bool keepsWriteChannelOpen() const = 0; #ifdef Q_OS_WIN virtual void setCreateProcessArgumentsModifier(QProcess::CreateProcessArgumentModifier modifier) = 0; virtual void setNativeArguments(const QString &arguments) = 0; #endif signals: void started(); void finished(int exitCode, QProcess::ExitStatus status); void errorOccurred(QProcess::ProcessError error); void readyReadStandardOutput(); void readyReadStandardError(); }; class ProcessHelper : public QProcess { public: ProcessHelper() { #if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0) && defined(Q_OS_UNIX) setChildProcessModifier([this] { setupChildProcess_impl(); }); #endif } #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) void setupChildProcess() override { setupChildProcess_impl(); } #endif void setupChildProcess_impl() { #if defined Q_OS_UNIX // nice value range is -20 to +19 where -20 is highest, 0 default and +19 is lowest if (m_lowPriority) { errno = 0; if (::nice(5) == -1 && errno != 0) perror("Failed to set nice value"); } // Disable terminal by becoming a session leader. if (m_disableUnixTerminal) setsid(); #endif } using QProcess::setErrorString; bool m_lowPriority = false; bool m_disableUnixTerminal = false; bool m_keepStdInOpen = false; }; class QProcessImpl : public ProcessInterface { public: QProcessImpl() : ProcessInterface() { connect(&m_process, &QProcess::started, this, &ProcessInterface::started); connect(&m_process, QOverload::of(&QProcess::finished), this, &ProcessInterface::finished); connect(&m_process, &QProcess::errorOccurred, this, &ProcessInterface::errorOccurred); connect(&m_process, &QProcess::readyReadStandardOutput, this, &ProcessInterface::readyReadStandardOutput); connect(&m_process, &QProcess::readyReadStandardError, this, &ProcessInterface::readyReadStandardError); } QByteArray readAllStandardOutput() override { return m_process.readAllStandardOutput(); } QByteArray readAllStandardError() override { return m_process.readAllStandardError(); } void setProcessEnvironment(const QProcessEnvironment &environment) override { m_process.setProcessEnvironment(environment); } void setWorkingDirectory(const QString &dir) override { m_process.setWorkingDirectory(dir); } void start(const QString &program, const QStringList &arguments, QIODevice::OpenMode mode) override { m_process.start(program, arguments, mode); } void terminate() override { m_process.terminate(); } void kill() override { m_process.kill(); } void close() override { m_process.close(); } qint64 write(const QByteArray &data) override { return m_process.write(data); } void closeWriteChannel() override { m_process.closeWriteChannel(); } void setStandardInputFile(const QString &fileName) override { m_process.setStandardInputFile(fileName); } void setProcessChannelMode(QProcess::ProcessChannelMode mode) override { m_process.setProcessChannelMode(mode); } qint64 bytesAvailable() const override { return m_process.bytesAvailable(); } QString program() const override { return m_process.program(); } QProcess::ProcessError error() const override { return m_process.error(); } QProcess::ProcessState state() const override { return m_process.state(); } qint64 processId() const override { return m_process.processId(); } QProcess::ExitStatus exitStatus() const override { return m_process.exitStatus(); } QString errorString() const override { return m_process.errorString(); } void setErrorString(const QString &str) override { m_process.setErrorString(str); } bool waitForStarted(int msecs) override { return m_process.waitForStarted(msecs); } bool waitForReadyRead(int msecs) override { return m_process.waitForReadyRead(msecs); } bool waitForFinished(int msecs) override { return m_process.waitForFinished(msecs); } void setLowPriority() override { m_process.m_lowPriority = true; } bool lowPriority() const override { return m_process.m_lowPriority; } void setDisableUnixTerminal() override { m_process.m_disableUnixTerminal = true; } void setKeepWriteChannelOpen() override { m_process.m_keepStdInOpen = true; } bool keepsWriteChannelOpen() const override { return m_process.m_keepStdInOpen; } #ifdef Q_OS_WIN void setCreateProcessArgumentsModifier(QProcess::CreateProcessArgumentModifier modifier) override { m_process.setCreateProcessArgumentsModifier(modifier); } void setNativeArguments(const QString &arguments) override { m_process.setNativeArguments(arguments); } #endif private: ProcessHelper m_process; }; class ProcessLauncherImpl : public ProcessInterface { public: ProcessLauncherImpl() : ProcessInterface() { connect(LauncherInterface::socket(), &LauncherSocket::ready, this, &ProcessLauncherImpl::handleSocketReady); connect(LauncherInterface::socket(), &LauncherSocket::errorOccurred, this, &ProcessLauncherImpl::handleSocketError); connect(LauncherInterface::socket(), &LauncherSocket::packetArrived, this, &ProcessLauncherImpl::handlePacket); } QByteArray readAllStandardOutput() override { return readAndClear(m_stdout); } QByteArray readAllStandardError() override { return readAndClear(m_stderr); } void setProcessEnvironment(const QProcessEnvironment &environment) override { m_environment = environment; } void setWorkingDirectory(const QString &dir) override { m_workingDirectory = dir; } void start(const QString &program, const QStringList &arguments, QIODevice::OpenMode mode) override; void terminate() override { cancel(); } // TODO: what are differences among terminate, kill and close? void kill() override { cancel(); } // TODO: see above void close() override { cancel(); } // TODO: see above qint64 write(const QByteArray &data) override { QTC_CHECK(false); return -1; } void closeWriteChannel() override { QTC_CHECK(false); } void setStandardInputFile(const QString &fileName) override { QTC_CHECK(false); } void setProcessChannelMode(QProcess::ProcessChannelMode mode) override { if (mode != QProcess::SeparateChannels && mode != QProcess::MergedChannels) { qWarning("setProcessChannelMode: The only supported modes are SeparateChannels and MergedChannels."); return; } m_channelMode = mode; } qint64 bytesAvailable() const override { QTC_CHECK(false); return 0; } QString program() const override { return m_command; } QProcess::ProcessError error() const override { return m_error; } QProcess::ProcessState state() const override { return m_state; } qint64 processId() const override { QTC_CHECK(false); return 0; } QProcess::ExitStatus exitStatus() const override { QTC_CHECK(false); return QProcess::NormalExit; } QString errorString() const override { return m_errorString; } void setErrorString(const QString &str) override { m_errorString = str; } bool waitForStarted(int msecs) override { QTC_CHECK(false); return false; } bool waitForReadyRead(int msecs) override { QTC_CHECK(false); return false; } bool waitForFinished(int msecs) override { QTC_CHECK(false); return false; } void setLowPriority() override { QTC_CHECK(false); } bool lowPriority() const override { QTC_CHECK(false); return false; } void setDisableUnixTerminal() override { QTC_CHECK(false); } void setKeepWriteChannelOpen() override { QTC_CHECK(false); } bool keepsWriteChannelOpen() const override { QTC_CHECK(false); return false; } #ifdef Q_OS_WIN void setCreateProcessArgumentsModifier(QProcess::CreateProcessArgumentModifier modifier) override { QTC_CHECK(false); } void setNativeArguments(const QString &arguments) override { QTC_CHECK(false); } #endif private: void doStart(); void cancel(); void sendPacket(const Internal::LauncherPacket &packet) { LauncherInterface::socket()->sendData(packet.serialize()); } QByteArray readAndClear(QByteArray &data) { const QByteArray tmp = data; data.clear(); return tmp; } void handleSocketError(const QString &message); void handlePacket(Internal::LauncherPacketType type, quintptr token, const QByteArray &payload); void handleErrorPacket(const QByteArray &packetData); void handleFinishedPacket(const QByteArray &packetData); void handleSocketReady(); quintptr token() const { return reinterpret_cast(this); } QString m_command; QStringList m_arguments; QProcessEnvironment m_environment; QString m_workingDirectory; QByteArray m_stdout; QByteArray m_stderr; QString m_errorString; QProcess::ProcessError m_error = QProcess::UnknownError; QProcess::ProcessState m_state = QProcess::NotRunning; QProcess::ProcessChannelMode m_channelMode = QProcess::SeparateChannels; int m_exitCode = 0; bool m_canceled = false; bool m_socketError = false; }; void ProcessLauncherImpl::start(const QString &program, const QStringList &arguments, QIODevice::OpenMode mode) { // TODO: pass the open mode to StartProcessPacket if (m_socketError) { m_error = QProcess::FailedToStart; emit errorOccurred(m_error); return; } m_command = program; m_arguments = arguments; m_state = QProcess::Starting; if (LauncherInterface::socket()->isReady()) doStart(); } void ProcessLauncherImpl::doStart() { emit started(); // Should be queued in order to behave the same as QProcess? m_state = QProcess::Running; StartProcessPacket p(token()); p.command = m_command; p.arguments = m_arguments; p.env = m_environment.toStringList(); p.workingDir = m_workingDirectory; p.mode = m_channelMode; sendPacket(p); } void ProcessLauncherImpl::cancel() { switch (m_state) { case QProcess::NotRunning: break; case QProcess::Starting: m_errorString = QCoreApplication::translate("Utils::QtcProcess", "Process canceled before it was started."); m_error = QProcess::FailedToStart; m_state = QProcess::NotRunning; emit errorOccurred(m_error); break; case QProcess::Running: sendPacket(StopProcessPacket(token())); m_state = QProcess::NotRunning; break; } m_canceled = true; } void ProcessLauncherImpl::handlePacket(LauncherPacketType type, quintptr token, const QByteArray &payload) { if (token != this->token()) return; switch (type) { case LauncherPacketType::ProcessError: handleErrorPacket(payload); break; case LauncherPacketType::ProcessFinished: handleFinishedPacket(payload); break; default: QTC_ASSERT(false, break); } } void ProcessLauncherImpl::handleSocketReady() { m_socketError = false; if (m_state == QProcess::Starting) doStart(); } void ProcessLauncherImpl::handleSocketError(const QString &message) { m_socketError = true; m_errorString = QCoreApplication::translate("Utils::QtcProcess", "Internal socket error: %1").arg(message); if (m_state != QProcess::NotRunning) { m_state = QProcess::NotRunning; m_error = QProcess::FailedToStart; emit errorOccurred(m_error); } } void ProcessLauncherImpl::handleErrorPacket(const QByteArray &packetData) { QTC_ASSERT(m_state != QProcess::NotRunning, return); const auto packet = LauncherPacket::extractPacket(token(), packetData); m_error = packet.error; m_errorString = packet.errorString; m_state = QProcess::NotRunning; emit errorOccurred(m_error); } void ProcessLauncherImpl::handleFinishedPacket(const QByteArray &packetData) { if (m_canceled) return; QTC_ASSERT(m_state == QProcess::Running, return); m_state = QProcess::NotRunning; const auto packet = LauncherPacket::extractPacket(token(), packetData); m_exitCode = packet.exitCode; m_stdout = packet.stdOut; m_stderr = packet.stdErr; if (!m_stdout.isEmpty()) emit readyReadStandardOutput(); if (!m_stderr.isEmpty()) emit readyReadStandardError(); m_errorString = packet.errorString; emit finished(m_exitCode, packet.exitStatus); } static ProcessInterface *newProcessInstance(QtcProcess::ProcessImpl processImpl) { if (processImpl == QtcProcess::QProcessImpl) return new QProcessImpl; return new ProcessLauncherImpl; } class QtcProcessPrivate : public QObject { public: explicit QtcProcessPrivate(QtcProcess *parent, QtcProcess::ProcessImpl processImpl) : q(parent), m_process(newProcessInstance(processImpl)) { connect(m_process, &ProcessInterface::started, q, &QtcProcess::started); connect(m_process, &ProcessInterface::finished, this, &QtcProcessPrivate::slotFinished); connect(m_process, &ProcessInterface::errorOccurred, this, &QtcProcessPrivate::slotError); connect(m_process, &ProcessInterface::readyReadStandardOutput, this, &QtcProcessPrivate::handleReadyReadStandardOutput); connect(m_process, &ProcessInterface::readyReadStandardError, this, &QtcProcessPrivate::handleReadyReadStandardError); connect(&m_timer, &QTimer::timeout, this, &QtcProcessPrivate::slotTimeout); m_timer.setInterval(1000); } ~QtcProcessPrivate() { delete m_process; } void handleReadyReadStandardOutput() { m_stdOut.append(m_process->readAllStandardOutput()); m_hangTimerCount = 0; emit q->readyReadStandardOutput(); } void handleReadyReadStandardError() { m_stdErr.append(m_process->readAllStandardError()); m_hangTimerCount = 0; emit q->readyReadStandardError(); } QtcProcess *q; ProcessInterface *m_process; CommandLine m_commandLine; FilePath m_workingDirectory; Environment m_environment; QByteArray m_writeData; bool m_haveEnv = false; bool m_useCtrlCStub = false; QProcess::OpenMode m_openMode = QProcess::ReadWrite; void slotTimeout(); void slotFinished(int exitCode, QProcess::ExitStatus e); void slotError(QProcess::ProcessError); void clearForRun(); QtcProcess::Result interpretExitCode(int exitCode); QTextCodec *m_codec = QTextCodec::codecForLocale(); QTimer m_timer; QEventLoop m_eventLoop; QtcProcess::Result m_result = QtcProcess::StartFailed; QProcess::ExitStatus m_exitStatus = QProcess::NormalExit; int m_exitCode = -1; ChannelBuffer m_stdOut; ChannelBuffer m_stdErr; ExitCodeInterpreter m_exitCodeInterpreter; int m_hangTimerCount = 0; int m_maxHangTimerCount = defaultMaxHangTimerCount; bool m_startFailure = false; bool m_timeOutMessageBoxEnabled = false; bool m_waitingForUser = false; bool m_processUserEvents = false; }; void QtcProcessPrivate::clearForRun() { m_hangTimerCount = 0; m_stdOut.clearForRun(); m_stdOut.codec = m_codec; m_stdErr.clearForRun(); m_stdErr.codec = m_codec; m_result = QtcProcess::StartFailed; m_exitCode = -1; m_startFailure = false; } QtcProcess::Result QtcProcessPrivate::interpretExitCode(int exitCode) { if (m_exitCodeInterpreter) return m_exitCodeInterpreter(exitCode); // default: return exitCode ? QtcProcess::FinishedWithError : QtcProcess::FinishedWithSuccess; } } // Internal /*! \class Utils::QtcProcess \brief The QtcProcess class provides functionality for with processes. \sa Utils::ProcessArgs */ QtcProcess::QtcProcess(ProcessImpl processImpl, QObject *parent) : QObject(parent), d(new QtcProcessPrivate(this, processImpl)) { static int qProcessExitStatusMeta = qRegisterMetaType(); static int qProcessProcessErrorMeta = qRegisterMetaType(); Q_UNUSED(qProcessExitStatusMeta) Q_UNUSED(qProcessProcessErrorMeta) } QtcProcess::QtcProcess(QObject *parent) : QtcProcess(QtcProcess::QProcessImpl, parent) {} QtcProcess::~QtcProcess() { delete d; } void QtcProcess::setEnvironment(const Environment &env) { d->m_environment = env; d->m_haveEnv = true; } const Environment &QtcProcess::environment() const { return d->m_environment; } void QtcProcess::setCommand(const CommandLine &cmdLine) { if (d->m_workingDirectory.needsDevice() && cmdLine.executable().needsDevice()) { QTC_CHECK(d->m_workingDirectory.host() == cmdLine.executable().host()); } d->m_commandLine = cmdLine; } const CommandLine &QtcProcess::commandLine() const { return d->m_commandLine; } FilePath QtcProcess::workingDirectory() const { return d->m_workingDirectory; } void QtcProcess::setWorkingDirectory(const FilePath &dir) { if (dir.needsDevice() && d->m_commandLine.executable().needsDevice()) { QTC_CHECK(dir.host() == d->m_commandLine.executable().host()); } d->m_workingDirectory = dir; } void QtcProcess::setWorkingDirectory(const QString &dir) { setWorkingDirectory(FilePath::fromString(dir)); } void QtcProcess::setUseCtrlCStub(bool enabled) { // Do not use the stub in debug mode. Activating the stub will shut down // Qt Creator otherwise, because they share the same Windows console. // See QTCREATORBUG-11995 for details. #ifndef QT_DEBUG d->m_useCtrlCStub = enabled; #else Q_UNUSED(enabled) #endif } void QtcProcess::start(const QString &cmd, const QStringList &args) { setCommand({cmd, args}); start(); } void QtcProcess::start() { d->clearForRun(); QTC_CHECK(d->m_writeData.isEmpty()); // FIXME: Use it. if (d->m_commandLine.executable().needsDevice()) { QTC_ASSERT(s_deviceHooks.startProcessHook, return); s_deviceHooks.startProcessHook(*this); return; } if (processLog().isDebugEnabled()) { static int n = 0; qCDebug(processLog) << "STARTING PROCESS: " << ++n << " " << d->m_commandLine.toUserOutput(); } Environment env; const OsType osType = HostOsInfo::hostOs(); if (d->m_haveEnv) { if (d->m_environment.size() == 0) qWarning("QtcProcess::start: Empty environment set when running '%s'.", qPrintable(d->m_commandLine.executable().toString())); env = d->m_environment; d->m_process->setProcessEnvironment(env.toProcessEnvironment()); } else { env = Environment::systemEnvironment(); } const QString workDir = d->m_workingDirectory.path(); d->m_process->setWorkingDirectory(workDir); QString command; ProcessArgs arguments; bool success = ProcessArgs::prepareCommand(d->m_commandLine.executable().toString(), d->m_commandLine.arguments(), &command, &arguments, osType, &env, &workDir); if (osType == OsTypeWindows) { QString args; if (d->m_useCtrlCStub) { if (d->m_process->lowPriority()) ProcessArgs::addArg(&args, "-nice"); ProcessArgs::addArg(&args, QDir::toNativeSeparators(command)); command = QCoreApplication::applicationDirPath() + QLatin1String("/qtcreator_ctrlc_stub.exe"); } else if (d->m_process->lowPriority()) { #ifdef Q_OS_WIN d->m_process->setCreateProcessArgumentsModifier( [](QProcess::CreateProcessArguments *args) { args->flags |= BELOW_NORMAL_PRIORITY_CLASS; }); #endif } ProcessArgs::addArgs(&args, arguments.toWindowsArgs()); #ifdef Q_OS_WIN d->m_process->setNativeArguments(args); #endif // Note: Arguments set with setNativeArgs will be appended to the ones // passed with start() below. d->m_process->start(command, QStringList(), d->m_openMode); } else { if (!success) { setErrorString(tr("Error in command line.")); // Should be FailedToStart, but we cannot set the process error from the outside, // so it would be inconsistent. emit errorOccurred(QProcess::UnknownError); return; } d->m_process->start(command, arguments.toUnixArgs(), d->m_openMode); } } #ifdef Q_OS_WIN static BOOL sendMessage(UINT message, HWND hwnd, LPARAM lParam) { DWORD dwProcessID; GetWindowThreadProcessId(hwnd, &dwProcessID); if ((DWORD)lParam == dwProcessID) { SendNotifyMessage(hwnd, message, 0, 0); return FALSE; } return TRUE; } BOOL CALLBACK sendShutDownMessageToAllWindowsOfProcess_enumWnd(HWND hwnd, LPARAM lParam) { static UINT uiShutDownMessage = RegisterWindowMessage(L"qtcctrlcstub_shutdown"); return sendMessage(uiShutDownMessage, hwnd, lParam); } BOOL CALLBACK sendInterruptMessageToAllWindowsOfProcess_enumWnd(HWND hwnd, LPARAM lParam) { static UINT uiInterruptMessage = RegisterWindowMessage(L"qtcctrlcstub_interrupt"); return sendMessage(uiInterruptMessage, hwnd, lParam); } #endif void QtcProcess::terminate() { #ifdef Q_OS_WIN if (d->m_useCtrlCStub) EnumWindows(sendShutDownMessageToAllWindowsOfProcess_enumWnd, processId()); else #endif d->m_process->terminate(); } void QtcProcess::interrupt() { #ifdef Q_OS_WIN QTC_ASSERT(d->m_useCtrlCStub, return); EnumWindows(sendInterruptMessageToAllWindowsOfProcess_enumWnd, processId()); #endif } void QtcProcess::setLowPriority() { d->m_process->setLowPriority(); } void QtcProcess::setDisableUnixTerminal() { d->m_process->setDisableUnixTerminal(); } void QtcProcess::setKeepWriteChannelOpen() { d->m_process->setKeepWriteChannelOpen(); } bool QtcProcess::keepsWriteChannelOpen() const { return d->m_process->keepsWriteChannelOpen(); } void QtcProcess::setStandardInputFile(const QString &inputFile) { d->m_process->setStandardInputFile(inputFile); } void QtcProcess::setRemoteProcessHooks(const DeviceProcessHooks &hooks) { s_deviceHooks = hooks; } void QtcProcess::setOpenMode(QIODevice::OpenMode mode) { d->m_openMode = mode; } bool QtcProcess::stopProcess() { if (state() == QProcess::NotRunning) return true; terminate(); if (state() == QProcess::NotRunning) return true; if (waitForFinished(300)) return true; kill(); return waitForFinished(300); } static bool askToKill(const QString &command) { #ifdef QT_GUI_LIB if (QThread::currentThread() != QCoreApplication::instance()->thread()) return true; const QString title = QtcProcess::tr("Process not Responding"); QString msg = command.isEmpty() ? QtcProcess::tr("The process is not responding.") : QtcProcess::tr("The process \"%1\" is not responding.").arg(command); msg += ' '; msg += QtcProcess::tr("Would you like to terminate it?"); // Restore the cursor that is set to wait while running. const bool hasOverrideCursor = QApplication::overrideCursor() != nullptr; if (hasOverrideCursor) QApplication::restoreOverrideCursor(); QMessageBox::StandardButton answer = QMessageBox::question(nullptr, title, msg, QMessageBox::Yes|QMessageBox::No); if (hasOverrideCursor) QApplication::setOverrideCursor(Qt::WaitCursor); return answer == QMessageBox::Yes; #else Q_UNUSED(command) return true; #endif } // Helper for running a process synchronously in the foreground with timeout // detection (taking effect after no more output // occurs on stderr/stdout as opposed to waitForFinished()). Returns false if a timeout // occurs. Checking of the process' exit state/code still has to be done. bool QtcProcess::readDataFromProcess(int timeoutS, QByteArray *stdOut, QByteArray *stdErr, bool showTimeOutMessageBox) { enum { syncDebug = 0 }; if (syncDebug) qDebug() << ">readDataFromProcess" << timeoutS; if (state() != QProcess::Running) { qWarning("readDataFromProcess: Process in non-running state passed in."); return false; } // Keep the process running until it has no longer has data bool finished = false; bool hasData = false; do { finished = waitForFinished(timeoutS > 0 ? timeoutS * 1000 : -1) || state() == QProcess::NotRunning; // First check 'stdout' if (d->m_process->bytesAvailable()) { // applies to readChannel() only hasData = true; const QByteArray newStdOut = d->m_process->readAllStandardOutput(); if (stdOut) stdOut->append(newStdOut); } // Check 'stderr' separately. This is a special handling // for 'git pull' and the like which prints its progress on stderr. const QByteArray newStdErr = d->m_process->readAllStandardError(); if (!newStdErr.isEmpty()) { hasData = true; if (stdErr) stdErr->append(newStdErr); } // Prompt user, pretend we have data if says 'No'. const bool hang = !hasData && !finished; hasData = hang && showTimeOutMessageBox && !askToKill(d->m_process->program()); } while (hasData && !finished); if (syncDebug) qDebug() << "m_result; } void QtcProcess::setResult(Result result) { d->m_result = result; } int QtcProcess::exitCode() const { return d->m_exitCode; } // Path utilities // Locate a binary in a directory, applying all kinds of // extensions the operating system supports. static QString checkBinary(const QDir &dir, const QString &binary) { // naive UNIX approach const QFileInfo info(dir.filePath(binary)); if (info.isFile() && info.isExecutable()) return info.absoluteFilePath(); // Does the OS have some weird extension concept or does the // binary have a 3 letter extension? if (HostOsInfo::isAnyUnixHost() && !HostOsInfo::isMacHost()) return QString(); const int dotIndex = binary.lastIndexOf(QLatin1Char('.')); if (dotIndex != -1 && dotIndex == binary.size() - 4) return QString(); switch (HostOsInfo::hostOs()) { case OsTypeLinux: case OsTypeOtherUnix: case OsTypeOther: break; case OsTypeWindows: { static const char *windowsExtensions[] = {".cmd", ".bat", ".exe", ".com"}; // Check the Windows extensions using the order const int windowsExtensionCount = sizeof(windowsExtensions)/sizeof(const char*); for (int e = 0; e < windowsExtensionCount; e ++) { const QFileInfo windowsBinary(dir.filePath(binary + QLatin1String(windowsExtensions[e]))); if (windowsBinary.isFile() && windowsBinary.isExecutable()) return windowsBinary.absoluteFilePath(); } } break; case OsTypeMac: { // Check for Mac app folders const QFileInfo appFolder(dir.filePath(binary + QLatin1String(".app"))); if (appFolder.isDir()) { QString macBinaryPath = appFolder.absoluteFilePath(); macBinaryPath += QLatin1String("/Contents/MacOS/"); macBinaryPath += binary; const QFileInfo macBinary(macBinaryPath); if (macBinary.isFile() && macBinary.isExecutable()) return macBinary.absoluteFilePath(); } } break; } return QString(); } QString QtcProcess::locateBinary(const QString &path, const QString &binary) { // Absolute file? const QFileInfo absInfo(binary); if (absInfo.isAbsolute()) return checkBinary(absInfo.dir(), absInfo.fileName()); // Windows finds binaries in the current directory if (HostOsInfo::isWindowsHost()) { const QString currentDirBinary = checkBinary(QDir::current(), binary); if (!currentDirBinary.isEmpty()) return currentDirBinary; } const QStringList paths = path.split(HostOsInfo::pathListSeparator()); if (paths.empty()) return QString(); const QStringList::const_iterator cend = paths.constEnd(); for (QStringList::const_iterator it = paths.constBegin(); it != cend; ++it) { const QDir dir(*it); const QString rc = checkBinary(dir, binary); if (!rc.isEmpty()) return rc; } return QString(); } Environment QtcProcess::systemEnvironmentForBinary(const FilePath &filePath) { if (filePath.needsDevice()) { QTC_ASSERT(s_deviceHooks.systemEnvironmentForBinary, return {}); return s_deviceHooks.systemEnvironmentForBinary(filePath); } return Environment::systemEnvironment(); } void QtcProcess::setProcessChannelMode(QProcess::ProcessChannelMode mode) { d->m_process->setProcessChannelMode(mode); } QProcess::ProcessError QtcProcess::error() const { return d->m_process->error(); } QProcess::ProcessState QtcProcess::state() const { return d->m_process->state(); } QString QtcProcess::errorString() const { return d->m_process->errorString(); } void QtcProcess::setErrorString(const QString &str) { d->m_process->setErrorString(str); } qint64 QtcProcess::processId() const { return d->m_process->processId(); } bool QtcProcess::waitForStarted(int msecs) { return d->m_process->waitForStarted(msecs); } bool QtcProcess::waitForReadyRead(int msecs) { return d->m_process->waitForReadyRead(msecs); } bool QtcProcess::waitForFinished(int msecs) { return d->m_process->waitForFinished(msecs); } QByteArray QtcProcess::readAllStandardOutput() { QByteArray buf = d->m_stdOut.rawData; d->m_stdOut.rawData.clear(); return buf; } QByteArray QtcProcess::readAllStandardError() { QByteArray buf = d->m_stdErr.rawData; d->m_stdErr.rawData.clear(); return buf; } QProcess::ExitStatus QtcProcess::exitStatus() const { return d->m_process->exitStatus(); } void QtcProcess::kill() { d->m_process->kill(); } qint64 QtcProcess::write(const QByteArray &input) { return d->m_process->write(input); } void QtcProcess::closeWriteChannel() { d->m_process->closeWriteChannel(); } void QtcProcess::close() { d->m_process->close(); } void QtcProcess::beginFeed() { d->clearForRun(); } void QtcProcess::endFeed() { d->slotFinished(0, QProcess::NormalExit); } void QtcProcess::feedStdOut(const QByteArray &data) { d->m_stdOut.append(data); d->m_hangTimerCount = 0; emit readyReadStandardOutput(); } QString QtcProcess::locateBinary(const QString &binary) { const QByteArray path = qgetenv("PATH"); return locateBinary(QString::fromLocal8Bit(path), binary); } /*! \class Utils::SynchronousProcess \brief The SynchronousProcess class runs a synchronous process in its own event loop that blocks only user input events. Thus, it allows for the GUI to repaint and append output to log windows. The callbacks set with setStdOutCallback(), setStdErrCallback() are called with complete lines based on the '\\n' marker. They would typically be used for log windows. Alternatively you can used setStdOutLineCallback() and setStdErrLineCallback() to process the output line by line. There is a timeout handling that takes effect after the last data have been read from stdout/stdin (as opposed to waitForFinished(), which measures time since it was invoked). It is thus also suitable for slow processes that continuously output data (like version system operations). The property timeOutMessageBoxEnabled influences whether a message box is shown asking the user if they want to kill the process on timeout (default: false). There are also static utility functions for dealing with fully synchronous processes, like reading the output with correct timeout handling. Caution: This class should NOT be used if there is a chance that the process triggers opening dialog boxes (for example, by file watchers triggering), as this will cause event loop problems. */ QString QtcProcess::exitMessage() { const QString fullCmd = commandLine().toUserOutput(); switch (result()) { case FinishedWithSuccess: return QtcProcess::tr("The command \"%1\" finished successfully.").arg(fullCmd); case FinishedWithError: return QtcProcess::tr("The command \"%1\" terminated with exit code %2.") .arg(fullCmd).arg(exitCode()); case TerminatedAbnormally: return QtcProcess::tr("The command \"%1\" terminated abnormally.").arg(fullCmd); case StartFailed: return QtcProcess::tr("The command \"%1\" could not be started.").arg(fullCmd); case Hang: return QtcProcess::tr("The command \"%1\" did not respond within the timeout limit (%2 s).") .arg(fullCmd).arg(d->m_maxHangTimerCount); } return QString(); } QByteArray QtcProcess::allRawOutput() const { QTC_CHECK(d->m_stdOut.keepRawData); QTC_CHECK(d->m_stdErr.keepRawData); if (!d->m_stdOut.rawData.isEmpty() && !d->m_stdErr.rawData.isEmpty()) { QByteArray result = d->m_stdOut.rawData; if (!result.endsWith('\n')) result += '\n'; result += d->m_stdErr.rawData; return result; } return !d->m_stdOut.rawData.isEmpty() ? d->m_stdOut.rawData : d->m_stdErr.rawData; } QString QtcProcess::allOutput() const { QTC_CHECK(d->m_stdOut.keepRawData); QTC_CHECK(d->m_stdErr.keepRawData); const QString out = stdOut(); const QString err = stdErr(); if (!out.isEmpty() && !err.isEmpty()) { QString result = out; if (!result.endsWith('\n')) result += '\n'; result += err; return result; } return !out.isEmpty() ? out : err; } QString QtcProcess::stdOut() const { QTC_CHECK(d->m_stdOut.keepRawData); return normalizeNewlines(d->m_codec->toUnicode(d->m_stdOut.rawData)); } QString QtcProcess::stdErr() const { QTC_CHECK(d->m_stdErr.keepRawData); return normalizeNewlines(d->m_codec->toUnicode(d->m_stdErr.rawData)); } QByteArray QtcProcess::rawStdOut() const { QTC_CHECK(d->m_stdOut.keepRawData); return d->m_stdOut.rawData; } QTCREATOR_UTILS_EXPORT QDebug operator<<(QDebug str, const QtcProcess &r) { QDebug nsp = str.nospace(); nsp << "QtcProcess: result=" << r.d->m_result << " ex=" << r.exitCode() << '\n' << r.d->m_stdOut.rawData.size() << " bytes stdout, stderr=" << r.d->m_stdErr.rawData << '\n'; return str; } void ChannelBuffer::clearForRun() { rawData.clear(); codecState.reset(new QTextCodec::ConverterState); incompleteLineBuffer.clear(); } /* Check for complete lines read from the device and return them, moving the * buffer position. */ void ChannelBuffer::append(const QByteArray &text) { if (text.isEmpty()) return; if (keepRawData) rawData += text; // Line-wise operation below: if (!outputCallback) return; // Convert and append the new input to the buffer of incomplete lines incompleteLineBuffer.append(codec->toUnicode(text.constData(), text.size(), codecState.get())); do { // Any completed lines in the incompleteLineBuffer? int pos = -1; if (emitSingleLines) { const int posn = incompleteLineBuffer.indexOf('\n'); const int posr = incompleteLineBuffer.indexOf('\r'); if (posn != -1) { if (posr != -1) { if (posn == posr + 1) pos = posn; // \r followed by \n -> line end, use the \n. else pos = qMin(posr, posn); // free floating \r and \n: Use the first one. } else { pos = posn; } } else { pos = posr; // Make sure internal '\r' triggers a line output } } else { pos = qMax(incompleteLineBuffer.lastIndexOf('\n'), incompleteLineBuffer.lastIndexOf('\r')); } if (pos == -1) break; // Get completed lines and remove them from the incompleteLinesBuffer: const QString line = QtcProcess::normalizeNewlines(incompleteLineBuffer.left(pos + 1)); incompleteLineBuffer = incompleteLineBuffer.mid(pos + 1); QTC_ASSERT(outputCallback, return); outputCallback(line); if (!emitSingleLines) break; } while (true); } void ChannelBuffer::handleRest() { if (outputCallback && !incompleteLineBuffer.isEmpty()) { outputCallback(incompleteLineBuffer); incompleteLineBuffer.clear(); } } void QtcProcess::setProcessUserEventWhileRunning() { d->m_processUserEvents = true; } void QtcProcess::setTimeoutS(int timeoutS) { if (timeoutS > 0) d->m_maxHangTimerCount = qMax(2, timeoutS); else d->m_maxHangTimerCount = INT_MAX / 1000; } void QtcProcess::setCodec(QTextCodec *c) { QTC_ASSERT(c, return); d->m_codec = c; } void QtcProcess::setTimeOutMessageBoxEnabled(bool v) { d->m_timeOutMessageBoxEnabled = v; } void QtcProcess::setExitCodeInterpreter(const ExitCodeInterpreter &interpreter) { d->m_exitCodeInterpreter = interpreter; } void QtcProcess::setWriteData(const QByteArray &writeData) { d->m_writeData = writeData; } #ifdef QT_GUI_LIB static bool isGuiThread() { return QThread::currentThread() == QCoreApplication::instance()->thread(); } #endif void QtcProcess::runBlocking() { // FIXME: Implement properly if (d->m_commandLine.executable().needsDevice()) { // writeData ? QtcProcess::start(); waitForFinished(); return; }; qCDebug(processLog).noquote() << "Starting blocking:" << d->m_commandLine.toUserOutput() << " process user events: " << d->m_processUserEvents; ExecuteOnDestruction logResult([this] { qCDebug(processLog) << *this; }); if (d->m_processUserEvents) { if (!d->m_writeData.isEmpty()) { connect(d->m_process, &ProcessInterface::started, this, [this] { write(d->m_writeData); closeWriteChannel(); }); } setOpenMode(d->m_writeData.isEmpty() ? QIODevice::ReadOnly : QIODevice::ReadWrite); QtcProcess::start(); // On Windows, start failure is triggered immediately if the // executable cannot be found in the path. Do not start the // event loop in that case. if (!d->m_startFailure) { d->m_timer.start(); #ifdef QT_GUI_LIB if (isGuiThread()) QApplication::setOverrideCursor(Qt::WaitCursor); #endif d->m_eventLoop.exec(QEventLoop::ExcludeUserInputEvents); d->m_stdOut.append(d->m_process->readAllStandardOutput()); d->m_stdErr.append(d->m_process->readAllStandardError()); d->m_timer.stop(); #ifdef QT_GUI_LIB if (isGuiThread()) QApplication::restoreOverrideCursor(); #endif } } else { setOpenMode(QIODevice::ReadOnly); QtcProcess::start(); if (!waitForStarted(d->m_maxHangTimerCount * 1000)) { d->m_result = QtcProcess::StartFailed; return; } closeWriteChannel(); if (!waitForFinished(d->m_maxHangTimerCount * 1000)) { d->m_result = QtcProcess::Hang; terminate(); if (!waitForFinished(1000)) { kill(); waitForFinished(1000); } } if (state() != QProcess::NotRunning) return; d->m_stdOut.append(d->m_process->readAllStandardOutput()); d->m_stdErr.append(d->m_process->readAllStandardError()); } } void QtcProcess::setStdOutCallback(const std::function &callback) { d->m_stdOut.outputCallback = callback; d->m_stdOut.emitSingleLines = false; d->m_stdOut.emitSingleLines = false; d->m_stdOut.keepRawData = false; } void QtcProcess::setStdOutLineCallback(const std::function &callback) { d->m_stdOut.outputCallback = callback; d->m_stdOut.emitSingleLines = true; d->m_stdOut.keepRawData = false; } void QtcProcess::setStdErrCallback(const std::function &callback) { d->m_stdErr.outputCallback = callback; d->m_stdErr.emitSingleLines = false; d->m_stdErr.keepRawData = false; } void QtcProcess::setStdErrLineCallback(const std::function &callback) { d->m_stdErr.outputCallback = callback; d->m_stdErr.emitSingleLines = true; d->m_stdErr.keepRawData = false; } void QtcProcessPrivate::slotTimeout() { if (!m_waitingForUser && (++m_hangTimerCount > m_maxHangTimerCount)) { if (debug) qDebug() << Q_FUNC_INFO << "HANG detected, killing"; m_waitingForUser = true; const bool terminate = !m_timeOutMessageBoxEnabled || askToKill(m_commandLine.executable().toString()); m_waitingForUser = false; if (terminate) { q->stopProcess(); m_result = QtcProcess::Hang; } else { m_hangTimerCount = 0; } } else { if (debug) qDebug() << Q_FUNC_INFO << m_hangTimerCount; } } void QtcProcessPrivate::slotFinished(int exitCode, QProcess::ExitStatus status) { if (debug) qDebug() << Q_FUNC_INFO << exitCode << status; m_hangTimerCount = 0; m_exitStatus = status; switch (status) { case QProcess::NormalExit: m_result = interpretExitCode(exitCode); m_exitCode = exitCode; break; case QProcess::CrashExit: // Was hang detected before and killed? if (m_result != QtcProcess::Hang) m_result = QtcProcess::TerminatedAbnormally; m_exitCode = -1; break; } m_eventLoop.quit(); m_stdOut.handleRest(); m_stdErr.handleRest(); emit q->finished(); } void QtcProcessPrivate::slotError(QProcess::ProcessError error) { m_hangTimerCount = 0; if (debug) qDebug() << Q_FUNC_INFO << error; // Was hang detected before and killed? if (m_result != QtcProcess::Hang) m_result = QtcProcess::StartFailed; m_startFailure = true; m_eventLoop.quit(); emit q->errorOccurred(error); } } // namespace Utils #include "qtcprocess.moc"