| Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/corelib/io/qprocess.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||||||||
| 2 | ** | - | ||||||||||||
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||||||||
| 4 | ** Copyright (C) 2016 Intel Corporation. | - | ||||||||||||
| 5 | ** Contact: https://www.qt.io/licensing/ | - | ||||||||||||
| 6 | ** | - | ||||||||||||
| 7 | ** This file is part of the QtCore module of the Qt Toolkit. | - | ||||||||||||
| 8 | ** | - | ||||||||||||
| 9 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||||||||
| 10 | ** Commercial License Usage | - | ||||||||||||
| 11 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||
| 12 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||
| 13 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||
| 14 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||
| 15 | ** and conditions see https://www.qt.io/terms-conditions. For further | - | ||||||||||||
| 16 | ** information use the contact form at https://www.qt.io/contact-us. | - | ||||||||||||
| 17 | ** | - | ||||||||||||
| 18 | ** GNU Lesser General Public License Usage | - | ||||||||||||
| 19 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||
| 20 | ** General Public License version 3 as published by the Free Software | - | ||||||||||||
| 21 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | - | ||||||||||||
| 22 | ** packaging of this file. Please review the following information to | - | ||||||||||||
| 23 | ** ensure the GNU Lesser General Public License version 3 requirements | - | ||||||||||||
| 24 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | - | ||||||||||||
| 25 | ** | - | ||||||||||||
| 26 | ** GNU General Public License Usage | - | ||||||||||||
| 27 | ** Alternatively, this file may be used under the terms of the GNU | - | ||||||||||||
| 28 | ** General Public License version 2.0 or (at your option) the GNU General | - | ||||||||||||
| 29 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||||||||
| 30 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||||||||
| 31 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||||||||
| 32 | ** included in the packaging of this file. Please review the following | - | ||||||||||||
| 33 | ** information to ensure the GNU General Public License requirements will | - | ||||||||||||
| 34 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||||||||
| 35 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||||||||
| 36 | ** | - | ||||||||||||
| 37 | ** $QT_END_LICENSE$ | - | ||||||||||||
| 38 | ** | - | ||||||||||||
| 39 | ****************************************************************************/ | - | ||||||||||||
| 40 | - | |||||||||||||
| 41 | //#define QPROCESS_DEBUG | - | ||||||||||||
| 42 | - | |||||||||||||
| 43 | #include <qdebug.h> | - | ||||||||||||
| 44 | #include <qdir.h> | - | ||||||||||||
| 45 | #if defined(Q_OS_WIN) | - | ||||||||||||
| 46 | #include <qtimer.h> | - | ||||||||||||
| 47 | #endif | - | ||||||||||||
| 48 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 49 | #include <qstring.h> | - | ||||||||||||
| 50 | #include <ctype.h> | - | ||||||||||||
| 51 | #if !defined(Q_OS_WINCE) | - | ||||||||||||
| 52 | #include <errno.h> | - | ||||||||||||
| 53 | #endif | - | ||||||||||||
| 54 | - | |||||||||||||
| 55 | QT_BEGIN_NAMESPACE | - | ||||||||||||
| 56 | /* | - | ||||||||||||
| 57 | Returns a human readable representation of the first \a len | - | ||||||||||||
| 58 | characters in \a data. | - | ||||||||||||
| 59 | */ | - | ||||||||||||
| 60 | static QByteArray qt_prettyDebug(const char *data, int len, int maxSize) | - | ||||||||||||
| 61 | { | - | ||||||||||||
| 62 | if (!data) return "(null)"; | - | ||||||||||||
| 63 | QByteArray out; | - | ||||||||||||
| 64 | for (int i = 0; i < len && i < maxSize; ++i) { | - | ||||||||||||
| 65 | char c = data[i]; | - | ||||||||||||
| 66 | if (isprint(c)) { | - | ||||||||||||
| 67 | out += c; | - | ||||||||||||
| 68 | } else switch (c) { | - | ||||||||||||
| 69 | case '\n': out += "\\n"; break; | - | ||||||||||||
| 70 | case '\r': out += "\\r"; break; | - | ||||||||||||
| 71 | case '\t': out += "\\t"; break; | - | ||||||||||||
| 72 | default: | - | ||||||||||||
| 73 | char buf[5]; | - | ||||||||||||
| 74 | qsnprintf(buf, sizeof(buf), "\\%3o", c); | - | ||||||||||||
| 75 | buf[4] = '\0'; | - | ||||||||||||
| 76 | out += QByteArray(buf); | - | ||||||||||||
| 77 | } | - | ||||||||||||
| 78 | } | - | ||||||||||||
| 79 | - | |||||||||||||
| 80 | if (len < maxSize) | - | ||||||||||||
| 81 | out += "..."; | - | ||||||||||||
| 82 | - | |||||||||||||
| 83 | return out; | - | ||||||||||||
| 84 | } | - | ||||||||||||
| 85 | - | |||||||||||||
| 86 | QT_END_NAMESPACE | - | ||||||||||||
| 87 | - | |||||||||||||
| 88 | #endif | - | ||||||||||||
| 89 | - | |||||||||||||
| 90 | #include "qprocess.h" | - | ||||||||||||
| 91 | #include "qprocess_p.h" | - | ||||||||||||
| 92 | - | |||||||||||||
| 93 | #include <qbytearray.h> | - | ||||||||||||
| 94 | #include <qelapsedtimer.h> | - | ||||||||||||
| 95 | #include <qcoreapplication.h> | - | ||||||||||||
| 96 | #include <qsocketnotifier.h> | - | ||||||||||||
| 97 | #include <qtimer.h> | - | ||||||||||||
| 98 | - | |||||||||||||
| 99 | #ifdef Q_OS_WIN | - | ||||||||||||
| 100 | #include <qwineventnotifier.h> | - | ||||||||||||
| 101 | #else | - | ||||||||||||
| 102 | #include <private/qcore_unix_p.h> | - | ||||||||||||
| 103 | #endif | - | ||||||||||||
| 104 | - | |||||||||||||
| 105 | #ifndef QT_NO_PROCESS | - | ||||||||||||
| 106 | - | |||||||||||||
| 107 | QT_BEGIN_NAMESPACE | - | ||||||||||||
| 108 | - | |||||||||||||
| 109 | /*! | - | ||||||||||||
| 110 | \since 5.6 | - | ||||||||||||
| 111 | - | |||||||||||||
| 112 | \macro QT_NO_PROCESS_COMBINED_ARGUMENT_START | - | ||||||||||||
| 113 | \relates QProcess | - | ||||||||||||
| 114 | - | |||||||||||||
| 115 | Disables the | - | ||||||||||||
| 116 | \l {QProcess::start(const QString &, OpenMode)}{QProcess::start()} | - | ||||||||||||
| 117 | overload taking a single string. | - | ||||||||||||
| 118 | In most cases where it is used, the user intends for the first argument | - | ||||||||||||
| 119 | to be treated atomically as per the other overload. | - | ||||||||||||
| 120 | - | |||||||||||||
| 121 | \sa QProcess::start(const QString &command, OpenMode mode) | - | ||||||||||||
| 122 | */ | - | ||||||||||||
| 123 | - | |||||||||||||
| 124 | /*! | - | ||||||||||||
| 125 | \class QProcessEnvironment | - | ||||||||||||
| 126 | \inmodule QtCore | - | ||||||||||||
| 127 | - | |||||||||||||
| 128 | \brief The QProcessEnvironment class holds the environment variables that | - | ||||||||||||
| 129 | can be passed to a program. | - | ||||||||||||
| 130 | - | |||||||||||||
| 131 | \ingroup io | - | ||||||||||||
| 132 | \ingroup misc | - | ||||||||||||
| 133 | \ingroup shared | - | ||||||||||||
| 134 | \reentrant | - | ||||||||||||
| 135 | \since 4.6 | - | ||||||||||||
| 136 | - | |||||||||||||
| 137 | A process's environment is composed of a set of key=value pairs known as | - | ||||||||||||
| 138 | environment variables. The QProcessEnvironment class wraps that concept | - | ||||||||||||
| 139 | and allows easy manipulation of those variables. It's meant to be used | - | ||||||||||||
| 140 | along with QProcess, to set the environment for child processes. It | - | ||||||||||||
| 141 | cannot be used to change the current process's environment. | - | ||||||||||||
| 142 | - | |||||||||||||
| 143 | The environment of the calling process can be obtained using | - | ||||||||||||
| 144 | QProcessEnvironment::systemEnvironment(). | - | ||||||||||||
| 145 | - | |||||||||||||
| 146 | On Unix systems, the variable names are case-sensitive. Note that the | - | ||||||||||||
| 147 | Unix environment allows both variable names and contents to contain arbitrary | - | ||||||||||||
| 148 | binary data (except for the NUL character). QProcessEnvironment will preserve | - | ||||||||||||
| 149 | such variables, but does not support manipulating variables whose names or | - | ||||||||||||
| 150 | values cannot be encoded by the current locale settings (see | - | ||||||||||||
| 151 | QTextCodec::codecForLocale). | - | ||||||||||||
| 152 | - | |||||||||||||
| 153 | On Windows, the variable names are case-insensitive, but case-preserving. | - | ||||||||||||
| 154 | QProcessEnvironment behaves accordingly. | - | ||||||||||||
| 155 | - | |||||||||||||
| 156 | \sa QProcess, QProcess::systemEnvironment(), QProcess::setProcessEnvironment() | - | ||||||||||||
| 157 | */ | - | ||||||||||||
| 158 | - | |||||||||||||
| 159 | QStringList QProcessEnvironmentPrivate::toList() const | - | ||||||||||||
| 160 | { | - | ||||||||||||
| 161 | QStringList result; | - | ||||||||||||
| 162 | result.reserve(hash.size()); | - | ||||||||||||
| 163 | for (Hash::const_iterator it = hash.cbegin(), end = hash.cend(); it != end; ++it)
| 2290-16172 | ||||||||||||
| 164 | result << nameToString(it.key()) + QLatin1Char('=') + valueToString(it.value()); executed 16172 times by 2 tests: result << nameToString(it.key()) + QLatin1Char('=') + valueToString(it.value());Executed by:
| 16172 | ||||||||||||
| 165 | return result; executed 2290 times by 2 tests: return result;Executed by:
| 2290 | ||||||||||||
| 166 | } | - | ||||||||||||
| 167 | - | |||||||||||||
| 168 | QProcessEnvironment QProcessEnvironmentPrivate::fromList(const QStringList &list) | - | ||||||||||||
| 169 | { | - | ||||||||||||
| 170 | QProcessEnvironment env; | - | ||||||||||||
| 171 | QStringList::ConstIterator it = list.constBegin(), | - | ||||||||||||
| 172 | end = list.constEnd(); | - | ||||||||||||
| 173 | for ( ; it != end; ++it) {
| 137-4176 | ||||||||||||
| 174 | int pos = it->indexOf(QLatin1Char('='), 1); | - | ||||||||||||
| 175 | if (pos < 1)
| 0-4176 | ||||||||||||
| 176 | continue; never executed: continue; | 0 | ||||||||||||
| 177 | - | |||||||||||||
| 178 | QString value = it->mid(pos + 1); | - | ||||||||||||
| 179 | QString name = *it; | - | ||||||||||||
| 180 | name.truncate(pos); | - | ||||||||||||
| 181 | env.insert(name, value); | - | ||||||||||||
| 182 | } executed 4176 times by 4 tests: end of blockExecuted by:
| 4176 | ||||||||||||
| 183 | return env; executed 137 times by 4 tests: return env;Executed by:
| 137 | ||||||||||||
| 184 | } | - | ||||||||||||
| 185 | - | |||||||||||||
| 186 | QStringList QProcessEnvironmentPrivate::keys() const | - | ||||||||||||
| 187 | { | - | ||||||||||||
| 188 | QStringList result; | - | ||||||||||||
| 189 | result.reserve(hash.size()); | - | ||||||||||||
| 190 | Hash::ConstIterator it = hash.constBegin(), | - | ||||||||||||
| 191 | end = hash.constEnd(); | - | ||||||||||||
| 192 | for ( ; it != end; ++it)
| 5-41 | ||||||||||||
| 193 | result << nameToString(it.key()); executed 41 times by 2 tests: result << nameToString(it.key());Executed by:
| 41 | ||||||||||||
| 194 | return result; executed 5 times by 2 tests: return result;Executed by:
| 5 | ||||||||||||
| 195 | } | - | ||||||||||||
| 196 | - | |||||||||||||
| 197 | void QProcessEnvironmentPrivate::insert(const QProcessEnvironmentPrivate &other) | - | ||||||||||||
| 198 | { | - | ||||||||||||
| 199 | Hash::ConstIterator it = other.hash.constBegin(), | - | ||||||||||||
| 200 | end = other.hash.constEnd(); | - | ||||||||||||
| 201 | for ( ; it != end; ++it)
| 2-6 | ||||||||||||
| 202 | hash.insert(it.key(), it.value()); executed 6 times by 1 test: hash.insert(it.key(), it.value());Executed by:
| 6 | ||||||||||||
| 203 | - | |||||||||||||
| 204 | #ifdef Q_OS_UNIX | - | ||||||||||||
| 205 | QHash<QString, Key>::ConstIterator nit = other.nameMap.constBegin(), | - | ||||||||||||
| 206 | nend = other.nameMap.constEnd(); | - | ||||||||||||
| 207 | for ( ; nit != nend; ++nit)
| 2-6 | ||||||||||||
| 208 | nameMap.insert(nit.key(), nit.value()); executed 6 times by 1 test: nameMap.insert(nit.key(), nit.value());Executed by:
| 6 | ||||||||||||
| 209 | #endif | - | ||||||||||||
| 210 | } executed 2 times by 1 test: end of blockExecuted by:
| 2 | ||||||||||||
| 211 | - | |||||||||||||
| 212 | /*! | - | ||||||||||||
| 213 | Creates a new QProcessEnvironment object. This constructor creates an | - | ||||||||||||
| 214 | empty environment. If set on a QProcess, this will cause the current | - | ||||||||||||
| 215 | environment variables to be removed. | - | ||||||||||||
| 216 | */ | - | ||||||||||||
| 217 | QProcessEnvironment::QProcessEnvironment() | - | ||||||||||||
| 218 | : d(0) | - | ||||||||||||
| 219 | { | - | ||||||||||||
| 220 | } executed 2787 times by 36 tests: end of blockExecuted by:
| 2787 | ||||||||||||
| 221 | - | |||||||||||||
| 222 | /*! | - | ||||||||||||
| 223 | Frees the resources associated with this QProcessEnvironment object. | - | ||||||||||||
| 224 | */ | - | ||||||||||||
| 225 | QProcessEnvironment::~QProcessEnvironment() | - | ||||||||||||
| 226 | { | - | ||||||||||||
| 227 | } | - | ||||||||||||
| 228 | - | |||||||||||||
| 229 | /*! | - | ||||||||||||
| 230 | Creates a QProcessEnvironment object that is a copy of \a other. | - | ||||||||||||
| 231 | */ | - | ||||||||||||
| 232 | QProcessEnvironment::QProcessEnvironment(const QProcessEnvironment &other) | - | ||||||||||||
| 233 | : d(other.d) | - | ||||||||||||
| 234 | { | - | ||||||||||||
| 235 | } executed 789 times by 1 test: end of blockExecuted by:
| 789 | ||||||||||||
| 236 | - | |||||||||||||
| 237 | /*! | - | ||||||||||||
| 238 | Copies the contents of the \a other QProcessEnvironment object into this | - | ||||||||||||
| 239 | one. | - | ||||||||||||
| 240 | */ | - | ||||||||||||
| 241 | QProcessEnvironment &QProcessEnvironment::operator=(const QProcessEnvironment &other) | - | ||||||||||||
| 242 | { | - | ||||||||||||
| 243 | d = other.d; | - | ||||||||||||
| 244 | return *this; executed 1281 times by 6 tests: return *this;Executed by:
| 1281 | ||||||||||||
| 245 | } | - | ||||||||||||
| 246 | - | |||||||||||||
| 247 | /*! | - | ||||||||||||
| 248 | \fn void QProcessEnvironment::swap(QProcessEnvironment &other) | - | ||||||||||||
| 249 | \since 5.0 | - | ||||||||||||
| 250 | - | |||||||||||||
| 251 | Swaps this process environment instance with \a other. This | - | ||||||||||||
| 252 | function is very fast and never fails. | - | ||||||||||||
| 253 | */ | - | ||||||||||||
| 254 | - | |||||||||||||
| 255 | /*! | - | ||||||||||||
| 256 | \fn bool QProcessEnvironment::operator !=(const QProcessEnvironment &other) const | - | ||||||||||||
| 257 | - | |||||||||||||
| 258 | Returns \c true if this and the \a other QProcessEnvironment objects are different. | - | ||||||||||||
| 259 | - | |||||||||||||
| 260 | \sa operator==() | - | ||||||||||||
| 261 | */ | - | ||||||||||||
| 262 | - | |||||||||||||
| 263 | /*! | - | ||||||||||||
| 264 | Returns \c true if this and the \a other QProcessEnvironment objects are equal. | - | ||||||||||||
| 265 | - | |||||||||||||
| 266 | Two QProcessEnvironment objects are considered equal if they have the same | - | ||||||||||||
| 267 | set of key=value pairs. The comparison of keys is done case-sensitive on | - | ||||||||||||
| 268 | platforms where the environment is case-sensitive. | - | ||||||||||||
| 269 | - | |||||||||||||
| 270 | \sa operator!=(), contains() | - | ||||||||||||
| 271 | */ | - | ||||||||||||
| 272 | bool QProcessEnvironment::operator==(const QProcessEnvironment &other) const | - | ||||||||||||
| 273 | { | - | ||||||||||||
| 274 | if (d == other.d)
| 3-6 | ||||||||||||
| 275 | return true; executed 3 times by 1 test: return true;Executed by:
| 3 | ||||||||||||
| 276 | if (d) {
| 0-6 | ||||||||||||
| 277 | if (other.d) {
| 1-5 | ||||||||||||
| 278 | QProcessEnvironmentPrivate::OrderedMutexLocker locker(d, other.d); | - | ||||||||||||
| 279 | return d->hash == other.d->hash; executed 5 times by 1 test: return d->hash == other.d->hash;Executed by:
| 5 | ||||||||||||
| 280 | } else { | - | ||||||||||||
| 281 | return isEmpty(); executed 1 time by 1 test: return isEmpty();Executed by:
| 1 | ||||||||||||
| 282 | } | - | ||||||||||||
| 283 | } else { | - | ||||||||||||
| 284 | return other.isEmpty(); never executed: return other.isEmpty(); | 0 | ||||||||||||
| 285 | } | - | ||||||||||||
| 286 | } | - | ||||||||||||
| 287 | - | |||||||||||||
| 288 | /*! | - | ||||||||||||
| 289 | Returns \c true if this QProcessEnvironment object is empty: that is | - | ||||||||||||
| 290 | there are no key=value pairs set. | - | ||||||||||||
| 291 | - | |||||||||||||
| 292 | \sa clear(), systemEnvironment(), insert() | - | ||||||||||||
| 293 | */ | - | ||||||||||||
| 294 | bool QProcessEnvironment::isEmpty() const | - | ||||||||||||
| 295 | { | - | ||||||||||||
| 296 | // Needs no locking, as no hash nodes are accessed | - | ||||||||||||
| 297 | return d ? d->hash.isEmpty() : true; executed 800 times by 4 tests: return d ? d->hash.isEmpty() : true;Executed by:
| 800 | ||||||||||||
| 298 | } | - | ||||||||||||
| 299 | - | |||||||||||||
| 300 | /*! | - | ||||||||||||
| 301 | Removes all key=value pairs from this QProcessEnvironment object, making | - | ||||||||||||
| 302 | it empty. | - | ||||||||||||
| 303 | - | |||||||||||||
| 304 | \sa isEmpty(), systemEnvironment() | - | ||||||||||||
| 305 | */ | - | ||||||||||||
| 306 | void QProcessEnvironment::clear() | - | ||||||||||||
| 307 | { | - | ||||||||||||
| 308 | if (d)
| 0-7 | ||||||||||||
| 309 | d->hash.clear(); executed 7 times by 1 test: d->hash.clear();Executed by:
| 7 | ||||||||||||
| 310 | // Unix: Don't clear d->nameMap, as the environment is likely to be | - | ||||||||||||
| 311 | // re-populated with the same keys again. | - | ||||||||||||
| 312 | } executed 7 times by 1 test: end of blockExecuted by:
| 7 | ||||||||||||
| 313 | - | |||||||||||||
| 314 | /*! | - | ||||||||||||
| 315 | Returns \c true if the environment variable of name \a name is found in | - | ||||||||||||
| 316 | this QProcessEnvironment object. | - | ||||||||||||
| 317 | - | |||||||||||||
| 318 | - | |||||||||||||
| 319 | \sa insert(), value() | - | ||||||||||||
| 320 | */ | - | ||||||||||||
| 321 | bool QProcessEnvironment::contains(const QString &name) const | - | ||||||||||||
| 322 | { | - | ||||||||||||
| 323 | if (!d)
| 0-14 | ||||||||||||
| 324 | return false; never executed: return false; | 0 | ||||||||||||
| 325 | QProcessEnvironmentPrivate::MutexLocker locker(d); | - | ||||||||||||
| 326 | return d->hash.contains(d->prepareName(name)); executed 14 times by 2 tests: return d->hash.contains(d->prepareName(name));Executed by:
| 14 | ||||||||||||
| 327 | } | - | ||||||||||||
| 328 | - | |||||||||||||
| 329 | /*! | - | ||||||||||||
| 330 | Inserts the environment variable of name \a name and contents \a value | - | ||||||||||||
| 331 | into this QProcessEnvironment object. If that variable already existed, | - | ||||||||||||
| 332 | it is replaced by the new value. | - | ||||||||||||
| 333 | - | |||||||||||||
| 334 | On most systems, inserting a variable with no contents will have the | - | ||||||||||||
| 335 | same effect for applications as if the variable had not been set at all. | - | ||||||||||||
| 336 | However, to guarantee that there are no incompatibilities, to remove a | - | ||||||||||||
| 337 | variable, please use the remove() function. | - | ||||||||||||
| 338 | - | |||||||||||||
| 339 | \sa contains(), remove(), value() | - | ||||||||||||
| 340 | */ | - | ||||||||||||
| 341 | void QProcessEnvironment::insert(const QString &name, const QString &value) | - | ||||||||||||
| 342 | { | - | ||||||||||||
| 343 | // our re-impl of detach() detaches from null | - | ||||||||||||
| 344 | d.detach(); // detach before prepareName() | - | ||||||||||||
| 345 | d->hash.insert(d->prepareName(name), d->prepareValue(value)); | - | ||||||||||||
| 346 | } executed 4296 times by 7 tests: end of blockExecuted by:
| 4296 | ||||||||||||
| 347 | - | |||||||||||||
| 348 | /*! | - | ||||||||||||
| 349 | Removes the environment variable identified by \a name from this | - | ||||||||||||
| 350 | QProcessEnvironment object. If that variable did not exist before, | - | ||||||||||||
| 351 | nothing happens. | - | ||||||||||||
| 352 | - | |||||||||||||
| 353 | - | |||||||||||||
| 354 | \sa contains(), insert(), value() | - | ||||||||||||
| 355 | */ | - | ||||||||||||
| 356 | void QProcessEnvironment::remove(const QString &name) | - | ||||||||||||
| 357 | { | - | ||||||||||||
| 358 | if (d) {
| 0-3 | ||||||||||||
| 359 | d.detach(); // detach before prepareName() | - | ||||||||||||
| 360 | d->hash.remove(d->prepareName(name)); | - | ||||||||||||
| 361 | } executed 3 times by 2 tests: end of blockExecuted by:
| 3 | ||||||||||||
| 362 | } executed 3 times by 2 tests: end of blockExecuted by:
| 3 | ||||||||||||
| 363 | - | |||||||||||||
| 364 | /*! | - | ||||||||||||
| 365 | Searches this QProcessEnvironment object for a variable identified by | - | ||||||||||||
| 366 | \a name and returns its value. If the variable is not found in this object, | - | ||||||||||||
| 367 | then \a defaultValue is returned instead. | - | ||||||||||||
| 368 | - | |||||||||||||
| 369 | \sa contains(), insert(), remove() | - | ||||||||||||
| 370 | */ | - | ||||||||||||
| 371 | QString QProcessEnvironment::value(const QString &name, const QString &defaultValue) const | - | ||||||||||||
| 372 | { | - | ||||||||||||
| 373 | if (!d)
| 0-38 | ||||||||||||
| 374 | return defaultValue; never executed: return defaultValue; | 0 | ||||||||||||
| 375 | - | |||||||||||||
| 376 | QProcessEnvironmentPrivate::MutexLocker locker(d); | - | ||||||||||||
| 377 | QProcessEnvironmentPrivate::Hash::ConstIterator it = d->hash.constFind(d->prepareName(name)); | - | ||||||||||||
| 378 | if (it == d->hash.constEnd())
| 10-28 | ||||||||||||
| 379 | return defaultValue; executed 10 times by 2 tests: return defaultValue;Executed by:
| 10 | ||||||||||||
| 380 | - | |||||||||||||
| 381 | return d->valueToString(it.value()); executed 28 times by 3 tests: return d->valueToString(it.value());Executed by:
| 28 | ||||||||||||
| 382 | } | - | ||||||||||||
| 383 | - | |||||||||||||
| 384 | /*! | - | ||||||||||||
| 385 | Converts this QProcessEnvironment object into a list of strings, one for | - | ||||||||||||
| 386 | each environment variable that is set. The environment variable's name | - | ||||||||||||
| 387 | and its value are separated by an equal character ('='). | - | ||||||||||||
| 388 | - | |||||||||||||
| 389 | The QStringList contents returned by this function are suitable for | - | ||||||||||||
| 390 | presentation. | - | ||||||||||||
| 391 | Use with the QProcess::setEnvironment function is not recommended due to | - | ||||||||||||
| 392 | potential encoding problems under Unix, and worse performance. | - | ||||||||||||
| 393 | - | |||||||||||||
| 394 | \sa systemEnvironment(), QProcess::systemEnvironment(), | - | ||||||||||||
| 395 | QProcess::setProcessEnvironment() | - | ||||||||||||
| 396 | */ | - | ||||||||||||
| 397 | QStringList QProcessEnvironment::toStringList() const | - | ||||||||||||
| 398 | { | - | ||||||||||||
| 399 | if (!d)
| 2-2290 | ||||||||||||
| 400 | return QStringList(); executed 2 times by 2 tests: return QStringList();Executed by:
| 2 | ||||||||||||
| 401 | QProcessEnvironmentPrivate::MutexLocker locker(d); | - | ||||||||||||
| 402 | return d->toList(); executed 2290 times by 2 tests: return d->toList();Executed by:
| 2290 | ||||||||||||
| 403 | } | - | ||||||||||||
| 404 | - | |||||||||||||
| 405 | /*! | - | ||||||||||||
| 406 | \since 4.8 | - | ||||||||||||
| 407 | - | |||||||||||||
| 408 | Returns a list containing all the variable names in this QProcessEnvironment | - | ||||||||||||
| 409 | object. | - | ||||||||||||
| 410 | */ | - | ||||||||||||
| 411 | QStringList QProcessEnvironment::keys() const | - | ||||||||||||
| 412 | { | - | ||||||||||||
| 413 | if (!d)
| 1-5 | ||||||||||||
| 414 | return QStringList(); executed 1 time by 1 test: return QStringList();Executed by:
| 1 | ||||||||||||
| 415 | QProcessEnvironmentPrivate::MutexLocker locker(d); | - | ||||||||||||
| 416 | return d->keys(); executed 5 times by 2 tests: return d->keys();Executed by:
| 5 | ||||||||||||
| 417 | } | - | ||||||||||||
| 418 | - | |||||||||||||
| 419 | /*! | - | ||||||||||||
| 420 | \overload | - | ||||||||||||
| 421 | \since 4.8 | - | ||||||||||||
| 422 | - | |||||||||||||
| 423 | Inserts the contents of \a e in this QProcessEnvironment object. Variables in | - | ||||||||||||
| 424 | this object that also exist in \a e will be overwritten. | - | ||||||||||||
| 425 | */ | - | ||||||||||||
| 426 | void QProcessEnvironment::insert(const QProcessEnvironment &e) | - | ||||||||||||
| 427 | { | - | ||||||||||||
| 428 | if (!e.d)
| 0-2 | ||||||||||||
| 429 | return; never executed: return; | 0 | ||||||||||||
| 430 | - | |||||||||||||
| 431 | // our re-impl of detach() detaches from null | - | ||||||||||||
| 432 | QProcessEnvironmentPrivate::MutexLocker locker(e.d); | - | ||||||||||||
| 433 | d->insert(*e.d); | - | ||||||||||||
| 434 | } executed 2 times by 1 test: end of blockExecuted by:
| 2 | ||||||||||||
| 435 | - | |||||||||||||
| 436 | void QProcessPrivate::Channel::clear() | - | ||||||||||||
| 437 | { | - | ||||||||||||
| 438 | switch (type) { | - | ||||||||||||
| 439 | case PipeSource: executed 3 times by 1 test: case PipeSource:Executed by:
| 3 | ||||||||||||
| 440 | Q_ASSERT(process); | - | ||||||||||||
| 441 | process->stdinChannel.type = Normal; | - | ||||||||||||
| 442 | process->stdinChannel.process = 0; | - | ||||||||||||
| 443 | break; executed 3 times by 1 test: break;Executed by:
| 3 | ||||||||||||
| 444 | case PipeSink: never executed: case PipeSink: | 0 | ||||||||||||
| 445 | Q_ASSERT(process); | - | ||||||||||||
| 446 | process->stdoutChannel.type = Normal; | - | ||||||||||||
| 447 | process->stdoutChannel.process = 0; | - | ||||||||||||
| 448 | break; never executed: break; | 0 | ||||||||||||
| 449 | } | - | ||||||||||||
| 450 | - | |||||||||||||
| 451 | type = Normal; | - | ||||||||||||
| 452 | file.clear(); | - | ||||||||||||
| 453 | process = 0; | - | ||||||||||||
| 454 | } executed 21 times by 1 test: end of blockExecuted by:
| 21 | ||||||||||||
| 455 | - | |||||||||||||
| 456 | /*! \fn bool QProcessPrivate::startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory, qint64 *pid) | - | ||||||||||||
| 457 | - | |||||||||||||
| 458 | \internal | - | ||||||||||||
| 459 | */ | - | ||||||||||||
| 460 | - | |||||||||||||
| 461 | /*! | - | ||||||||||||
| 462 | \class QProcess | - | ||||||||||||
| 463 | \inmodule QtCore | - | ||||||||||||
| 464 | - | |||||||||||||
| 465 | \brief The QProcess class is used to start external programs and | - | ||||||||||||
| 466 | to communicate with them. | - | ||||||||||||
| 467 | - | |||||||||||||
| 468 | \ingroup io | - | ||||||||||||
| 469 | - | |||||||||||||
| 470 | \reentrant | - | ||||||||||||
| 471 | - | |||||||||||||
| 472 | \section1 Running a Process | - | ||||||||||||
| 473 | - | |||||||||||||
| 474 | To start a process, pass the name and command line arguments of | - | ||||||||||||
| 475 | the program you want to run as arguments to start(). Arguments | - | ||||||||||||
| 476 | are supplied as individual strings in a QStringList. | - | ||||||||||||
| 477 | - | |||||||||||||
| 478 | Alternatively, you can set the program to run with setProgram() | - | ||||||||||||
| 479 | and setArguments(), and then call start() or open(). | - | ||||||||||||
| 480 | - | |||||||||||||
| 481 | For example, the following code snippet runs the analog clock | - | ||||||||||||
| 482 | example in the Fusion style on X11 platforms by passing strings | - | ||||||||||||
| 483 | containing "-style" and "fusion" as two items in the list of | - | ||||||||||||
| 484 | arguments: | - | ||||||||||||
| 485 | - | |||||||||||||
| 486 | \snippet qprocess/qprocess-simpleexecution.cpp 0 | - | ||||||||||||
| 487 | \dots | - | ||||||||||||
| 488 | \snippet qprocess/qprocess-simpleexecution.cpp 1 | - | ||||||||||||
| 489 | \snippet qprocess/qprocess-simpleexecution.cpp 2 | - | ||||||||||||
| 490 | - | |||||||||||||
| 491 | QProcess then enters the \l Starting state, and when the program | - | ||||||||||||
| 492 | has started, QProcess enters the \l Running state and emits | - | ||||||||||||
| 493 | started(). | - | ||||||||||||
| 494 | - | |||||||||||||
| 495 | QProcess allows you to treat a process as a sequential I/O | - | ||||||||||||
| 496 | device. You can write to and read from the process just as you | - | ||||||||||||
| 497 | would access a network connection using QTcpSocket. You can then | - | ||||||||||||
| 498 | write to the process's standard input by calling write(), and | - | ||||||||||||
| 499 | read the standard output by calling read(), readLine(), and | - | ||||||||||||
| 500 | getChar(). Because it inherits QIODevice, QProcess can also be | - | ||||||||||||
| 501 | used as an input source for QXmlReader, or for generating data to | - | ||||||||||||
| 502 | be uploaded using QNetworkAccessManager. | - | ||||||||||||
| 503 | - | |||||||||||||
| 504 | When the process exits, QProcess reenters the \l NotRunning state | - | ||||||||||||
| 505 | (the initial state), and emits finished(). | - | ||||||||||||
| 506 | - | |||||||||||||
| 507 | The finished() signal provides the exit code and exit status of | - | ||||||||||||
| 508 | the process as arguments, and you can also call exitCode() to | - | ||||||||||||
| 509 | obtain the exit code of the last process that finished, and | - | ||||||||||||
| 510 | exitStatus() to obtain its exit status. If an error occurs at | - | ||||||||||||
| 511 | any point in time, QProcess will emit the errorOccurred() signal. | - | ||||||||||||
| 512 | You can also call error() to find the type of error that occurred | - | ||||||||||||
| 513 | last, and state() to find the current process state. | - | ||||||||||||
| 514 | - | |||||||||||||
| 515 | \section1 Communicating via Channels | - | ||||||||||||
| 516 | - | |||||||||||||
| 517 | Processes have two predefined output channels: The standard | - | ||||||||||||
| 518 | output channel (\c stdout) supplies regular console output, and | - | ||||||||||||
| 519 | the standard error channel (\c stderr) usually supplies the | - | ||||||||||||
| 520 | errors that are printed by the process. These channels represent | - | ||||||||||||
| 521 | two separate streams of data. You can toggle between them by | - | ||||||||||||
| 522 | calling setReadChannel(). QProcess emits readyRead() when data is | - | ||||||||||||
| 523 | available on the current read channel. It also emits | - | ||||||||||||
| 524 | readyReadStandardOutput() when new standard output data is | - | ||||||||||||
| 525 | available, and when new standard error data is available, | - | ||||||||||||
| 526 | readyReadStandardError() is emitted. Instead of calling read(), | - | ||||||||||||
| 527 | readLine(), or getChar(), you can explicitly read all data from | - | ||||||||||||
| 528 | either of the two channels by calling readAllStandardOutput() or | - | ||||||||||||
| 529 | readAllStandardError(). | - | ||||||||||||
| 530 | - | |||||||||||||
| 531 | The terminology for the channels can be misleading. Be aware that | - | ||||||||||||
| 532 | the process's output channels correspond to QProcess's | - | ||||||||||||
| 533 | \e read channels, whereas the process's input channels correspond | - | ||||||||||||
| 534 | to QProcess's \e write channels. This is because what we read | - | ||||||||||||
| 535 | using QProcess is the process's output, and what we write becomes | - | ||||||||||||
| 536 | the process's input. | - | ||||||||||||
| 537 | - | |||||||||||||
| 538 | QProcess can merge the two output channels, so that standard | - | ||||||||||||
| 539 | output and standard error data from the running process both use | - | ||||||||||||
| 540 | the standard output channel. Call setProcessChannelMode() with | - | ||||||||||||
| 541 | MergedChannels before starting the process to activate | - | ||||||||||||
| 542 | this feature. You also have the option of forwarding the output of | - | ||||||||||||
| 543 | the running process to the calling, main process, by passing | - | ||||||||||||
| 544 | ForwardedChannels as the argument. It is also possible to forward | - | ||||||||||||
| 545 | only one of the output channels - typically one would use | - | ||||||||||||
| 546 | ForwardedErrorChannel, but ForwardedOutputChannel also exists. | - | ||||||||||||
| 547 | Note that using channel forwarding is typically a bad idea in GUI | - | ||||||||||||
| 548 | applications - you should present errors graphically instead. | - | ||||||||||||
| 549 | - | |||||||||||||
| 550 | Certain processes need special environment settings in order to | - | ||||||||||||
| 551 | operate. You can set environment variables for your process by | - | ||||||||||||
| 552 | calling setProcessEnvironment(). To set a working directory, call | - | ||||||||||||
| 553 | setWorkingDirectory(). By default, processes are run in the | - | ||||||||||||
| 554 | current working directory of the calling process. | - | ||||||||||||
| 555 | - | |||||||||||||
| 556 | The positioning and the screen Z-order of windows belonging to | - | ||||||||||||
| 557 | GUI applications started with QProcess are controlled by | - | ||||||||||||
| 558 | the underlying windowing system. For Qt 5 applications, the | - | ||||||||||||
| 559 | positioning can be specified using the \c{-qwindowgeometry} | - | ||||||||||||
| 560 | command line option; X11 applications generally accept a | - | ||||||||||||
| 561 | \c{-geometry} command line option. | - | ||||||||||||
| 562 | - | |||||||||||||
| 563 | \note On QNX, setting the working directory may cause all | - | ||||||||||||
| 564 | application threads, with the exception of the QProcess caller | - | ||||||||||||
| 565 | thread, to temporarily freeze during the spawning process, | - | ||||||||||||
| 566 | owing to a limitation in the operating system. | - | ||||||||||||
| 567 | - | |||||||||||||
| 568 | \section1 Synchronous Process API | - | ||||||||||||
| 569 | - | |||||||||||||
| 570 | QProcess provides a set of functions which allow it to be used | - | ||||||||||||
| 571 | without an event loop, by suspending the calling thread until | - | ||||||||||||
| 572 | certain signals are emitted: | - | ||||||||||||
| 573 | - | |||||||||||||
| 574 | \list | - | ||||||||||||
| 575 | \li waitForStarted() blocks until the process has started. | - | ||||||||||||
| 576 | - | |||||||||||||
| 577 | \li waitForReadyRead() blocks until new data is | - | ||||||||||||
| 578 | available for reading on the current read channel. | - | ||||||||||||
| 579 | - | |||||||||||||
| 580 | \li waitForBytesWritten() blocks until one payload of | - | ||||||||||||
| 581 | data has been written to the process. | - | ||||||||||||
| 582 | - | |||||||||||||
| 583 | \li waitForFinished() blocks until the process has finished. | - | ||||||||||||
| 584 | \endlist | - | ||||||||||||
| 585 | - | |||||||||||||
| 586 | Calling these functions from the main thread (the thread that | - | ||||||||||||
| 587 | calls QApplication::exec()) may cause your user interface to | - | ||||||||||||
| 588 | freeze. | - | ||||||||||||
| 589 | - | |||||||||||||
| 590 | The following example runs \c gzip to compress the string "Qt | - | ||||||||||||
| 591 | rocks!", without an event loop: | - | ||||||||||||
| 592 | - | |||||||||||||
| 593 | \snippet process/process.cpp 0 | - | ||||||||||||
| 594 | - | |||||||||||||
| 595 | \section1 Notes for Windows Users | - | ||||||||||||
| 596 | - | |||||||||||||
| 597 | Some Windows commands (for example, \c dir) are not provided by | - | ||||||||||||
| 598 | separate applications, but by the command interpreter itself. | - | ||||||||||||
| 599 | If you attempt to use QProcess to execute these commands directly, | - | ||||||||||||
| 600 | it won't work. One possible solution is to execute the command | - | ||||||||||||
| 601 | interpreter itself (\c{cmd.exe} on some Windows systems), and ask | - | ||||||||||||
| 602 | the interpreter to execute the desired command. | - | ||||||||||||
| 603 | - | |||||||||||||
| 604 | \sa QBuffer, QFile, QTcpSocket | - | ||||||||||||
| 605 | */ | - | ||||||||||||
| 606 | - | |||||||||||||
| 607 | /*! | - | ||||||||||||
| 608 | \enum QProcess::ProcessChannel | - | ||||||||||||
| 609 | - | |||||||||||||
| 610 | This enum describes the process channels used by the running process. | - | ||||||||||||
| 611 | Pass one of these values to setReadChannel() to set the | - | ||||||||||||
| 612 | current read channel of QProcess. | - | ||||||||||||
| 613 | - | |||||||||||||
| 614 | \value StandardOutput The standard output (stdout) of the running | - | ||||||||||||
| 615 | process. | - | ||||||||||||
| 616 | - | |||||||||||||
| 617 | \value StandardError The standard error (stderr) of the running | - | ||||||||||||
| 618 | process. | - | ||||||||||||
| 619 | - | |||||||||||||
| 620 | \sa setReadChannel() | - | ||||||||||||
| 621 | */ | - | ||||||||||||
| 622 | - | |||||||||||||
| 623 | /*! | - | ||||||||||||
| 624 | \enum QProcess::ProcessChannelMode | - | ||||||||||||
| 625 | - | |||||||||||||
| 626 | This enum describes the process output channel modes of QProcess. | - | ||||||||||||
| 627 | Pass one of these values to setProcessChannelMode() to set the | - | ||||||||||||
| 628 | current read channel mode. | - | ||||||||||||
| 629 | - | |||||||||||||
| 630 | \value SeparateChannels QProcess manages the output of the | - | ||||||||||||
| 631 | running process, keeping standard output and standard error data | - | ||||||||||||
| 632 | in separate internal buffers. You can select the QProcess's | - | ||||||||||||
| 633 | current read channel by calling setReadChannel(). This is the | - | ||||||||||||
| 634 | default channel mode of QProcess. | - | ||||||||||||
| 635 | - | |||||||||||||
| 636 | \value MergedChannels QProcess merges the output of the running | - | ||||||||||||
| 637 | process into the standard output channel (\c stdout). The | - | ||||||||||||
| 638 | standard error channel (\c stderr) will not receive any data. The | - | ||||||||||||
| 639 | standard output and standard error data of the running process | - | ||||||||||||
| 640 | are interleaved. | - | ||||||||||||
| 641 | - | |||||||||||||
| 642 | \value ForwardedChannels QProcess forwards the output of the | - | ||||||||||||
| 643 | running process onto the main process. Anything the child process | - | ||||||||||||
| 644 | writes to its standard output and standard error will be written | - | ||||||||||||
| 645 | to the standard output and standard error of the main process. | - | ||||||||||||
| 646 | - | |||||||||||||
| 647 | \value ForwardedErrorChannel QProcess manages the standard output | - | ||||||||||||
| 648 | of the running process, but forwards its standard error onto the | - | ||||||||||||
| 649 | main process. This reflects the typical use of command line tools | - | ||||||||||||
| 650 | as filters, where the standard output is redirected to another | - | ||||||||||||
| 651 | process or a file, while standard error is printed to the console | - | ||||||||||||
| 652 | for diagnostic purposes. | - | ||||||||||||
| 653 | (This value was introduced in Qt 5.2.) | - | ||||||||||||
| 654 | - | |||||||||||||
| 655 | \value ForwardedOutputChannel Complementary to ForwardedErrorChannel. | - | ||||||||||||
| 656 | (This value was introduced in Qt 5.2.) | - | ||||||||||||
| 657 | - | |||||||||||||
| 658 | \note Windows intentionally suppresses output from GUI-only | - | ||||||||||||
| 659 | applications to inherited consoles. | - | ||||||||||||
| 660 | This does \e not apply to output redirected to files or pipes. | - | ||||||||||||
| 661 | To forward the output of GUI-only applications on the console | - | ||||||||||||
| 662 | nonetheless, you must use SeparateChannels and do the forwarding | - | ||||||||||||
| 663 | yourself by reading the output and writing it to the appropriate | - | ||||||||||||
| 664 | output channels. | - | ||||||||||||
| 665 | - | |||||||||||||
| 666 | \sa setProcessChannelMode() | - | ||||||||||||
| 667 | */ | - | ||||||||||||
| 668 | - | |||||||||||||
| 669 | /*! | - | ||||||||||||
| 670 | \enum QProcess::InputChannelMode | - | ||||||||||||
| 671 | \since 5.2 | - | ||||||||||||
| 672 | - | |||||||||||||
| 673 | This enum describes the process input channel modes of QProcess. | - | ||||||||||||
| 674 | Pass one of these values to setInputChannelMode() to set the | - | ||||||||||||
| 675 | current write channel mode. | - | ||||||||||||
| 676 | - | |||||||||||||
| 677 | \value ManagedInputChannel QProcess manages the input of the running | - | ||||||||||||
| 678 | process. This is the default input channel mode of QProcess. | - | ||||||||||||
| 679 | - | |||||||||||||
| 680 | \value ForwardedInputChannel QProcess forwards the input of the main | - | ||||||||||||
| 681 | process onto the running process. The child process reads its standard | - | ||||||||||||
| 682 | input from the same source as the main process. | - | ||||||||||||
| 683 | Note that the main process must not try to read its standard input | - | ||||||||||||
| 684 | while the child process is running. | - | ||||||||||||
| 685 | - | |||||||||||||
| 686 | \sa setInputChannelMode() | - | ||||||||||||
| 687 | */ | - | ||||||||||||
| 688 | - | |||||||||||||
| 689 | /*! | - | ||||||||||||
| 690 | \enum QProcess::ProcessError | - | ||||||||||||
| 691 | - | |||||||||||||
| 692 | This enum describes the different types of errors that are | - | ||||||||||||
| 693 | reported by QProcess. | - | ||||||||||||
| 694 | - | |||||||||||||
| 695 | \value FailedToStart The process failed to start. Either the | - | ||||||||||||
| 696 | invoked program is missing, or you may have insufficient | - | ||||||||||||
| 697 | permissions to invoke the program. | - | ||||||||||||
| 698 | - | |||||||||||||
| 699 | \value Crashed The process crashed some time after starting | - | ||||||||||||
| 700 | successfully. | - | ||||||||||||
| 701 | - | |||||||||||||
| 702 | \value Timedout The last waitFor...() function timed out. The | - | ||||||||||||
| 703 | state of QProcess is unchanged, and you can try calling | - | ||||||||||||
| 704 | waitFor...() again. | - | ||||||||||||
| 705 | - | |||||||||||||
| 706 | \value WriteError An error occurred when attempting to write to the | - | ||||||||||||
| 707 | process. For example, the process may not be running, or it may | - | ||||||||||||
| 708 | have closed its input channel. | - | ||||||||||||
| 709 | - | |||||||||||||
| 710 | \value ReadError An error occurred when attempting to read from | - | ||||||||||||
| 711 | the process. For example, the process may not be running. | - | ||||||||||||
| 712 | - | |||||||||||||
| 713 | \value UnknownError An unknown error occurred. This is the default | - | ||||||||||||
| 714 | return value of error(). | - | ||||||||||||
| 715 | - | |||||||||||||
| 716 | \sa error() | - | ||||||||||||
| 717 | */ | - | ||||||||||||
| 718 | - | |||||||||||||
| 719 | /*! | - | ||||||||||||
| 720 | \enum QProcess::ProcessState | - | ||||||||||||
| 721 | - | |||||||||||||
| 722 | This enum describes the different states of QProcess. | - | ||||||||||||
| 723 | - | |||||||||||||
| 724 | \value NotRunning The process is not running. | - | ||||||||||||
| 725 | - | |||||||||||||
| 726 | \value Starting The process is starting, but the program has not | - | ||||||||||||
| 727 | yet been invoked. | - | ||||||||||||
| 728 | - | |||||||||||||
| 729 | \value Running The process is running and is ready for reading and | - | ||||||||||||
| 730 | writing. | - | ||||||||||||
| 731 | - | |||||||||||||
| 732 | \sa state() | - | ||||||||||||
| 733 | */ | - | ||||||||||||
| 734 | - | |||||||||||||
| 735 | /*! | - | ||||||||||||
| 736 | \enum QProcess::ExitStatus | - | ||||||||||||
| 737 | - | |||||||||||||
| 738 | This enum describes the different exit statuses of QProcess. | - | ||||||||||||
| 739 | - | |||||||||||||
| 740 | \value NormalExit The process exited normally. | - | ||||||||||||
| 741 | - | |||||||||||||
| 742 | \value CrashExit The process crashed. | - | ||||||||||||
| 743 | - | |||||||||||||
| 744 | \sa exitStatus() | - | ||||||||||||
| 745 | */ | - | ||||||||||||
| 746 | - | |||||||||||||
| 747 | /*! | - | ||||||||||||
| 748 | \typedef QProcess::CreateProcessArgumentModifier | - | ||||||||||||
| 749 | \note This typedef is only available on desktop Windows. | - | ||||||||||||
| 750 | - | |||||||||||||
| 751 | On Windows, QProcess uses the Win32 API function \c CreateProcess to | - | ||||||||||||
| 752 | start child processes. While QProcess provides a comfortable way to start | - | ||||||||||||
| 753 | processes without worrying about platform | - | ||||||||||||
| 754 | details, it is in some cases desirable to fine-tune the parameters that are | - | ||||||||||||
| 755 | passed to \c CreateProcess. This is done by defining a | - | ||||||||||||
| 756 | \c CreateProcessArgumentModifier function and passing it to | - | ||||||||||||
| 757 | \c setCreateProcessArgumentsModifier. | - | ||||||||||||
| 758 | - | |||||||||||||
| 759 | A \c CreateProcessArgumentModifier function takes one parameter: a pointer | - | ||||||||||||
| 760 | to a \c CreateProcessArguments struct. The members of this struct will be | - | ||||||||||||
| 761 | passed to \c CreateProcess after the \c CreateProcessArgumentModifier | - | ||||||||||||
| 762 | function is called. | - | ||||||||||||
| 763 | - | |||||||||||||
| 764 | The following example demonstrates how to pass custom flags to | - | ||||||||||||
| 765 | \c CreateProcess. | - | ||||||||||||
| 766 | When starting a console process B from a console process A, QProcess will | - | ||||||||||||
| 767 | reuse the console window of process A for process B by default. In this | - | ||||||||||||
| 768 | example, a new console window with a custom color scheme is created for the | - | ||||||||||||
| 769 | child process B instead. | - | ||||||||||||
| 770 | - | |||||||||||||
| 771 | \snippet qprocess/qprocess-createprocessargumentsmodifier.cpp 0 | - | ||||||||||||
| 772 | - | |||||||||||||
| 773 | \sa QProcess::CreateProcessArguments | - | ||||||||||||
| 774 | \sa setCreateProcessArgumentsModifier() | - | ||||||||||||
| 775 | */ | - | ||||||||||||
| 776 | - | |||||||||||||
| 777 | /*! | - | ||||||||||||
| 778 | \class QProcess::CreateProcessArguments | - | ||||||||||||
| 779 | \note This struct is only available on the Windows platform. | - | ||||||||||||
| 780 | - | |||||||||||||
| 781 | This struct is a representation of all parameters of the Windows API | - | ||||||||||||
| 782 | function \c CreateProcess. It is used as parameter for | - | ||||||||||||
| 783 | \c CreateProcessArgumentModifier functions. | - | ||||||||||||
| 784 | - | |||||||||||||
| 785 | \sa QProcess::CreateProcessArgumentModifier | - | ||||||||||||
| 786 | */ | - | ||||||||||||
| 787 | - | |||||||||||||
| 788 | /*! | - | ||||||||||||
| 789 | \fn void QProcess::error(QProcess::ProcessError error) | - | ||||||||||||
| 790 | \obsolete | - | ||||||||||||
| 791 | - | |||||||||||||
| 792 | Use errorOccurred() instead. | - | ||||||||||||
| 793 | */ | - | ||||||||||||
| 794 | - | |||||||||||||
| 795 | /*! | - | ||||||||||||
| 796 | \fn void QProcess::errorOccurred(QProcess::ProcessError error) | - | ||||||||||||
| 797 | \since 5.6 | - | ||||||||||||
| 798 | - | |||||||||||||
| 799 | This signal is emitted when an error occurs with the process. The | - | ||||||||||||
| 800 | specified \a error describes the type of error that occurred. | - | ||||||||||||
| 801 | */ | - | ||||||||||||
| 802 | - | |||||||||||||
| 803 | /*! | - | ||||||||||||
| 804 | \fn void QProcess::started() | - | ||||||||||||
| 805 | - | |||||||||||||
| 806 | This signal is emitted by QProcess when the process has started, | - | ||||||||||||
| 807 | and state() returns \l Running. | - | ||||||||||||
| 808 | */ | - | ||||||||||||
| 809 | - | |||||||||||||
| 810 | /*! | - | ||||||||||||
| 811 | \fn void QProcess::stateChanged(QProcess::ProcessState newState) | - | ||||||||||||
| 812 | - | |||||||||||||
| 813 | This signal is emitted whenever the state of QProcess changes. The | - | ||||||||||||
| 814 | \a newState argument is the state QProcess changed to. | - | ||||||||||||
| 815 | */ | - | ||||||||||||
| 816 | - | |||||||||||||
| 817 | /*! | - | ||||||||||||
| 818 | \fn void QProcess::finished(int exitCode) | - | ||||||||||||
| 819 | \obsolete | - | ||||||||||||
| 820 | \overload | - | ||||||||||||
| 821 | - | |||||||||||||
| 822 | Use finished(int exitCode, QProcess::ExitStatus status) instead. | - | ||||||||||||
| 823 | */ | - | ||||||||||||
| 824 | - | |||||||||||||
| 825 | /*! | - | ||||||||||||
| 826 | \fn void QProcess::finished(int exitCode, QProcess::ExitStatus exitStatus) | - | ||||||||||||
| 827 | - | |||||||||||||
| 828 | This signal is emitted when the process finishes. \a exitCode is the exit | - | ||||||||||||
| 829 | code of the process (only valid for normal exits), and \a exitStatus is | - | ||||||||||||
| 830 | the exit status. | - | ||||||||||||
| 831 | After the process has finished, the buffers in QProcess are still intact. | - | ||||||||||||
| 832 | You can still read any data that the process may have written before it | - | ||||||||||||
| 833 | finished. | - | ||||||||||||
| 834 | - | |||||||||||||
| 835 | \sa exitStatus() | - | ||||||||||||
| 836 | */ | - | ||||||||||||
| 837 | - | |||||||||||||
| 838 | /*! | - | ||||||||||||
| 839 | \fn void QProcess::readyReadStandardOutput() | - | ||||||||||||
| 840 | - | |||||||||||||
| 841 | This signal is emitted when the process has made new data | - | ||||||||||||
| 842 | available through its standard output channel (\c stdout). It is | - | ||||||||||||
| 843 | emitted regardless of the current \l{readChannel()}{read channel}. | - | ||||||||||||
| 844 | - | |||||||||||||
| 845 | \sa readAllStandardOutput(), readChannel() | - | ||||||||||||
| 846 | */ | - | ||||||||||||
| 847 | - | |||||||||||||
| 848 | /*! | - | ||||||||||||
| 849 | \fn void QProcess::readyReadStandardError() | - | ||||||||||||
| 850 | - | |||||||||||||
| 851 | This signal is emitted when the process has made new data | - | ||||||||||||
| 852 | available through its standard error channel (\c stderr). It is | - | ||||||||||||
| 853 | emitted regardless of the current \l{readChannel()}{read | - | ||||||||||||
| 854 | channel}. | - | ||||||||||||
| 855 | - | |||||||||||||
| 856 | \sa readAllStandardError(), readChannel() | - | ||||||||||||
| 857 | */ | - | ||||||||||||
| 858 | - | |||||||||||||
| 859 | /*! | - | ||||||||||||
| 860 | \internal | - | ||||||||||||
| 861 | */ | - | ||||||||||||
| 862 | QProcessPrivate::QProcessPrivate() | - | ||||||||||||
| 863 | { | - | ||||||||||||
| 864 | readBufferChunkSize = QRINGBUFFER_CHUNKSIZE; | - | ||||||||||||
| 865 | writeBufferChunkSize = QRINGBUFFER_CHUNKSIZE; | - | ||||||||||||
| 866 | processChannelMode = QProcess::SeparateChannels; | - | ||||||||||||
| 867 | inputChannelMode = QProcess::ManagedInputChannel; | - | ||||||||||||
| 868 | processError = QProcess::UnknownError; | - | ||||||||||||
| 869 | processState = QProcess::NotRunning; | - | ||||||||||||
| 870 | pid = 0; | - | ||||||||||||
| 871 | sequenceNumber = 0; | - | ||||||||||||
| 872 | exitCode = 0; | - | ||||||||||||
| 873 | exitStatus = QProcess::NormalExit; | - | ||||||||||||
| 874 | startupSocketNotifier = 0; | - | ||||||||||||
| 875 | deathNotifier = 0; | - | ||||||||||||
| 876 | childStartedPipe[0] = INVALID_Q_PIPE; | - | ||||||||||||
| 877 | childStartedPipe[1] = INVALID_Q_PIPE; | - | ||||||||||||
| 878 | forkfd = -1; | - | ||||||||||||
| 879 | crashed = false; | - | ||||||||||||
| 880 | dying = false; | - | ||||||||||||
| 881 | emittedReadyRead = false; | - | ||||||||||||
| 882 | emittedBytesWritten = false; | - | ||||||||||||
| 883 | #ifdef Q_OS_WIN | - | ||||||||||||
| 884 | stdinWriteTrigger = 0; | - | ||||||||||||
| 885 | processFinishedNotifier = 0; | - | ||||||||||||
| 886 | #endif // Q_OS_WIN | - | ||||||||||||
| 887 | } executed 2280 times by 35 tests: end of blockExecuted by:
| 2280 | ||||||||||||
| 888 | - | |||||||||||||
| 889 | /*! | - | ||||||||||||
| 890 | \internal | - | ||||||||||||
| 891 | */ | - | ||||||||||||
| 892 | QProcessPrivate::~QProcessPrivate() | - | ||||||||||||
| 893 | { | - | ||||||||||||
| 894 | if (stdinChannel.process)
| 3-2281 | ||||||||||||
| 895 | stdinChannel.process->stdoutChannel.clear(); executed 3 times by 1 test: stdinChannel.process->stdoutChannel.clear();Executed by:
| 3 | ||||||||||||
| 896 | if (stdoutChannel.process)
| 0-2284 | ||||||||||||
| 897 | stdoutChannel.process->stdinChannel.clear(); never executed: stdoutChannel.process->stdinChannel.clear(); | 0 | ||||||||||||
| 898 | } executed 2284 times by 40 tests: end of blockExecuted by:
| 2284 | ||||||||||||
| 899 | - | |||||||||||||
| 900 | /*! | - | ||||||||||||
| 901 | \internal | - | ||||||||||||
| 902 | */ | - | ||||||||||||
| 903 | void QProcessPrivate::cleanup() | - | ||||||||||||
| 904 | { | - | ||||||||||||
| 905 | q_func()->setProcessState(QProcess::NotRunning); | - | ||||||||||||
| 906 | #ifdef Q_OS_WIN | - | ||||||||||||
| 907 | if (pid) { | - | ||||||||||||
| 908 | CloseHandle(pid->hThread); | - | ||||||||||||
| 909 | CloseHandle(pid->hProcess); | - | ||||||||||||
| 910 | delete pid; | - | ||||||||||||
| 911 | pid = 0; | - | ||||||||||||
| 912 | } | - | ||||||||||||
| 913 | if (stdinWriteTrigger) { | - | ||||||||||||
| 914 | delete stdinWriteTrigger; | - | ||||||||||||
| 915 | stdinWriteTrigger = 0; | - | ||||||||||||
| 916 | } | - | ||||||||||||
| 917 | if (processFinishedNotifier) { | - | ||||||||||||
| 918 | delete processFinishedNotifier; | - | ||||||||||||
| 919 | processFinishedNotifier = 0; | - | ||||||||||||
| 920 | } | - | ||||||||||||
| 921 | - | |||||||||||||
| 922 | #endif | - | ||||||||||||
| 923 | pid = 0; | - | ||||||||||||
| 924 | sequenceNumber = 0; | - | ||||||||||||
| 925 | dying = false; | - | ||||||||||||
| 926 | - | |||||||||||||
| 927 | if (stdoutChannel.notifier) {
| 2375-2932 | ||||||||||||
| 928 | delete stdoutChannel.notifier; | - | ||||||||||||
| 929 | stdoutChannel.notifier = 0; | - | ||||||||||||
| 930 | } executed 2932 times by 37 tests: end of blockExecuted by:
| 2932 | ||||||||||||
| 931 | if (stderrChannel.notifier) {
| 2386-2921 | ||||||||||||
| 932 | delete stderrChannel.notifier; | - | ||||||||||||
| 933 | stderrChannel.notifier = 0; | - | ||||||||||||
| 934 | } executed 2921 times by 36 tests: end of blockExecuted by:
| 2921 | ||||||||||||
| 935 | if (stdinChannel.notifier) {
| 2308-2999 | ||||||||||||
| 936 | delete stdinChannel.notifier; | - | ||||||||||||
| 937 | stdinChannel.notifier = 0; | - | ||||||||||||
| 938 | } executed 2308 times by 34 tests: end of blockExecuted by:
| 2308 | ||||||||||||
| 939 | if (startupSocketNotifier) {
| 0-5307 | ||||||||||||
| 940 | delete startupSocketNotifier; | - | ||||||||||||
| 941 | startupSocketNotifier = 0; | - | ||||||||||||
| 942 | } never executed: end of block | 0 | ||||||||||||
| 943 | if (deathNotifier) {
| 0-5307 | ||||||||||||
| 944 | delete deathNotifier; | - | ||||||||||||
| 945 | deathNotifier = 0; | - | ||||||||||||
| 946 | } never executed: end of block | 0 | ||||||||||||
| 947 | closeChannel(&stdoutChannel); | - | ||||||||||||
| 948 | closeChannel(&stderrChannel); | - | ||||||||||||
| 949 | closeChannel(&stdinChannel); | - | ||||||||||||
| 950 | destroyPipe(childStartedPipe); | - | ||||||||||||
| 951 | #ifdef Q_OS_UNIX | - | ||||||||||||
| 952 | if (forkfd != -1)
| 0-5307 | ||||||||||||
| 953 | qt_safe_close(forkfd); never executed: qt_safe_close(forkfd); | 0 | ||||||||||||
| 954 | forkfd = -1; | - | ||||||||||||
| 955 | #endif | - | ||||||||||||
| 956 | } executed 5307 times by 44 tests: end of blockExecuted by:
| 5307 | ||||||||||||
| 957 | - | |||||||||||||
| 958 | /*! | - | ||||||||||||
| 959 | \internal | - | ||||||||||||
| 960 | */ | - | ||||||||||||
| 961 | void QProcessPrivate::setError(QProcess::ProcessError error, const QString &description) | - | ||||||||||||
| 962 | { | - | ||||||||||||
| 963 | processError = error; | - | ||||||||||||
| 964 | if (description.isEmpty()) {
| 119-710 | ||||||||||||
| 965 | switch (error) { | - | ||||||||||||
| 966 | case QProcess::FailedToStart: never executed: case QProcess::FailedToStart: | 0 | ||||||||||||
| 967 | errorString = QProcess::tr("Process failed to start"); | - | ||||||||||||
| 968 | break; never executed: break; | 0 | ||||||||||||
| 969 | case QProcess::Crashed: executed 103 times by 5 tests: case QProcess::Crashed:Executed by:
| 103 | ||||||||||||
| 970 | errorString = QProcess::tr("Process crashed"); | - | ||||||||||||
| 971 | break; executed 103 times by 5 tests: break;Executed by:
| 103 | ||||||||||||
| 972 | case QProcess::Timedout: executed 11 times by 3 tests: case QProcess::Timedout:Executed by:
| 11 | ||||||||||||
| 973 | errorString = QProcess::tr("Process operation timed out"); | - | ||||||||||||
| 974 | break; executed 11 times by 3 tests: break;Executed by:
| 11 | ||||||||||||
| 975 | case QProcess::ReadError: never executed: case QProcess::ReadError: | 0 | ||||||||||||
| 976 | errorString = QProcess::tr("Error reading from process"); | - | ||||||||||||
| 977 | break; never executed: break; | 0 | ||||||||||||
| 978 | case QProcess::WriteError: executed 5 times by 1 test: case QProcess::WriteError:Executed by:
| 5 | ||||||||||||
| 979 | errorString = QProcess::tr("Error writing to process"); | - | ||||||||||||
| 980 | break; executed 5 times by 1 test: break;Executed by:
| 5 | ||||||||||||
| 981 | case QProcess::UnknownError: never executed: case QProcess::UnknownError: | 0 | ||||||||||||
| 982 | errorString.clear(); | - | ||||||||||||
| 983 | break; never executed: break; | 0 | ||||||||||||
| 984 | } | - | ||||||||||||
| 985 | } else { executed 119 times by 6 tests: end of blockExecuted by:
| 119 | ||||||||||||
| 986 | errorString = description; | - | ||||||||||||
| 987 | } executed 710 times by 11 tests: end of blockExecuted by:
| 710 | ||||||||||||
| 988 | } | - | ||||||||||||
| 989 | - | |||||||||||||
| 990 | /*! | - | ||||||||||||
| 991 | \internal | - | ||||||||||||
| 992 | */ | - | ||||||||||||
| 993 | void QProcessPrivate::setErrorAndEmit(QProcess::ProcessError error, const QString &description) | - | ||||||||||||
| 994 | { | - | ||||||||||||
| 995 | Q_Q(QProcess); | - | ||||||||||||
| 996 | Q_ASSERT(error != QProcess::UnknownError); | - | ||||||||||||
| 997 | setError(error, description); | - | ||||||||||||
| 998 | emit q->errorOccurred(processError); | - | ||||||||||||
| 999 | emit q->error(processError); | - | ||||||||||||
| 1000 | } executed 818 times by 15 tests: end of blockExecuted by:
| 818 | ||||||||||||
| 1001 | - | |||||||||||||
| 1002 | /*! | - | ||||||||||||
| 1003 | \internal | - | ||||||||||||
| 1004 | Returns true if we emitted readyRead(). | - | ||||||||||||
| 1005 | */ | - | ||||||||||||
| 1006 | bool QProcessPrivate::tryReadFromChannel(Channel *channel) | - | ||||||||||||
| 1007 | { | - | ||||||||||||
| 1008 | Q_Q(QProcess); | - | ||||||||||||
| 1009 | if (channel->pipe[0] == INVALID_Q_PIPE)
| 4635-37468 | ||||||||||||
| 1010 | return false; executed 4635 times by 30 tests: return false;Executed by:
| 4635 | ||||||||||||
| 1011 | - | |||||||||||||
| 1012 | qint64 available = bytesAvailableInChannel(channel); | - | ||||||||||||
| 1013 | if (available == 0)
| 4607-32861 | ||||||||||||
| 1014 | available = 1; // always try to read at least one byte executed 4607 times by 30 tests: available = 1;Executed by:
| 4607 | ||||||||||||
| 1015 | - | |||||||||||||
| 1016 | QProcess::ProcessChannel channelIdx = (channel == &stdoutChannel
| 3097-34371 | ||||||||||||
| 1017 | ? QProcess::StandardOutput | - | ||||||||||||
| 1018 | : QProcess::StandardError); | - | ||||||||||||
| 1019 | Q_ASSERT(readBuffers.size() > int(channelIdx)); | - | ||||||||||||
| 1020 | QRingBuffer &readBuffer = readBuffers[int(channelIdx)]; | - | ||||||||||||
| 1021 | char *ptr = readBuffer.reserve(available); | - | ||||||||||||
| 1022 | qint64 readBytes = readFromChannel(channel, ptr, available); | - | ||||||||||||
| 1023 | if (readBytes <= 0)
| 4607-32861 | ||||||||||||
| 1024 | readBuffer.chop(available); executed 4607 times by 30 tests: readBuffer.chop(available);Executed by:
| 4607 | ||||||||||||
| 1025 | if (readBytes == -2) {
| 0-37468 | ||||||||||||
| 1026 | // EWOULDBLOCK | - | ||||||||||||
| 1027 | return false; never executed: return false; | 0 | ||||||||||||
| 1028 | } | - | ||||||||||||
| 1029 | if (readBytes == -1) {
| 0-37468 | ||||||||||||
| 1030 | setErrorAndEmit(QProcess::ReadError); | - | ||||||||||||
| 1031 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1032 | qDebug("QProcessPrivate::tryReadFromChannel(%d), failed to read from the process", channel - &stdinChannel); | - | ||||||||||||
| 1033 | #endif | - | ||||||||||||
| 1034 | return false; never executed: return false; | 0 | ||||||||||||
| 1035 | } | - | ||||||||||||
| 1036 | if (readBytes == 0) {
| 4607-32861 | ||||||||||||
| 1037 | // EOF | - | ||||||||||||
| 1038 | if (channel->notifier)
| 162-4445 | ||||||||||||
| 1039 | channel->notifier->setEnabled(false); executed 4445 times by 28 tests: channel->notifier->setEnabled(false);Executed by:
| 4445 | ||||||||||||
| 1040 | closeChannel(channel); | - | ||||||||||||
| 1041 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1042 | qDebug("QProcessPrivate::tryReadFromChannel(%d), 0 bytes available", channel - &stdinChannel); | - | ||||||||||||
| 1043 | #endif | - | ||||||||||||
| 1044 | return false; executed 4607 times by 30 tests: return false;Executed by:
| 4607 | ||||||||||||
| 1045 | } | - | ||||||||||||
| 1046 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1047 | qDebug("QProcessPrivate::tryReadFromChannel(%d), read %d bytes from the process' output", channel - &stdinChannel | - | ||||||||||||
| 1048 | int(readBytes)); | - | ||||||||||||
| 1049 | #endif | - | ||||||||||||
| 1050 | - | |||||||||||||
| 1051 | if (channel->closed) {
| 40-32821 | ||||||||||||
| 1052 | readBuffer.chop(readBytes); | - | ||||||||||||
| 1053 | return false; executed 40 times by 1 test: return false;Executed by:
| 40 | ||||||||||||
| 1054 | } | - | ||||||||||||
| 1055 | - | |||||||||||||
| 1056 | readBuffer.chop(available - readBytes); | - | ||||||||||||
| 1057 | - | |||||||||||||
| 1058 | bool didRead = false; | - | ||||||||||||
| 1059 | if (readBytes == 0) {
| 0-32821 | ||||||||||||
| 1060 | if (channel->notifier)
| 0 | ||||||||||||
| 1061 | channel->notifier->setEnabled(false); never executed: channel->notifier->setEnabled(false); | 0 | ||||||||||||
| 1062 | } else if (currentReadChannel == channelIdx) { never executed: end of block
| 0-31666 | ||||||||||||
| 1063 | didRead = true; | - | ||||||||||||
| 1064 | if (!emittedReadyRead) {
| 1-31665 | ||||||||||||
| 1065 | emittedReadyRead = true; | - | ||||||||||||
| 1066 | emit q->readyRead(); | - | ||||||||||||
| 1067 | emittedReadyRead = false; | - | ||||||||||||
| 1068 | } executed 31665 times by 22 tests: end of blockExecuted by:
| 31665 | ||||||||||||
| 1069 | } executed 31666 times by 22 tests: end of blockExecuted by:
| 31666 | ||||||||||||
| 1070 | emit q->channelReadyRead(int(channelIdx)); | - | ||||||||||||
| 1071 | if (channelIdx == QProcess::StandardOutput)
| 779-32042 | ||||||||||||
| 1072 | emit q->readyReadStandardOutput(QProcess::QPrivateSignal()); executed 32042 times by 22 tests: q->readyReadStandardOutput(QProcess::QPrivateSignal());Executed by:
| 32042 | ||||||||||||
| 1073 | else | - | ||||||||||||
| 1074 | emit q->readyReadStandardError(QProcess::QPrivateSignal()); executed 779 times by 11 tests: q->readyReadStandardError(QProcess::QPrivateSignal());Executed by:
| 779 | ||||||||||||
| 1075 | return didRead; executed 32821 times by 26 tests: return didRead;Executed by:
| 32821 | ||||||||||||
| 1076 | } | - | ||||||||||||
| 1077 | - | |||||||||||||
| 1078 | /*! | - | ||||||||||||
| 1079 | \internal | - | ||||||||||||
| 1080 | */ | - | ||||||||||||
| 1081 | bool QProcessPrivate::_q_canReadStandardOutput() | - | ||||||||||||
| 1082 | { | - | ||||||||||||
| 1083 | return tryReadFromChannel(&stdoutChannel); executed 36690 times by 30 tests: return tryReadFromChannel(&stdoutChannel);Executed by:
| 36690 | ||||||||||||
| 1084 | } | - | ||||||||||||
| 1085 | - | |||||||||||||
| 1086 | /*! | - | ||||||||||||
| 1087 | \internal | - | ||||||||||||
| 1088 | */ | - | ||||||||||||
| 1089 | bool QProcessPrivate::_q_canReadStandardError() | - | ||||||||||||
| 1090 | { | - | ||||||||||||
| 1091 | return tryReadFromChannel(&stderrChannel); executed 5413 times by 30 tests: return tryReadFromChannel(&stderrChannel);Executed by:
| 5413 | ||||||||||||
| 1092 | } | - | ||||||||||||
| 1093 | - | |||||||||||||
| 1094 | /*! | - | ||||||||||||
| 1095 | \internal | - | ||||||||||||
| 1096 | */ | - | ||||||||||||
| 1097 | bool QProcessPrivate::_q_canWrite() | - | ||||||||||||
| 1098 | { | - | ||||||||||||
| 1099 | if (stdinChannel.notifier)
| 0-3630 | ||||||||||||
| 1100 | stdinChannel.notifier->setEnabled(false); executed 3630 times by 6 tests: stdinChannel.notifier->setEnabled(false);Executed by:
| 3630 | ||||||||||||
| 1101 | - | |||||||||||||
| 1102 | if (writeBuffer.isEmpty()) {
| 0-3630 | ||||||||||||
| 1103 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1104 | qDebug("QProcessPrivate::canWrite(), not writing anything (empty write buffer)."); | - | ||||||||||||
| 1105 | #endif | - | ||||||||||||
| 1106 | return false; never executed: return false; | 0 | ||||||||||||
| 1107 | } | - | ||||||||||||
| 1108 | - | |||||||||||||
| 1109 | const bool writeSucceeded = writeToStdin(); | - | ||||||||||||
| 1110 | - | |||||||||||||
| 1111 | if (stdinChannel.notifier && !writeBuffer.isEmpty())
| 0-3630 | ||||||||||||
| 1112 | stdinChannel.notifier->setEnabled(true); executed 2715 times by 2 tests: stdinChannel.notifier->setEnabled(true);Executed by:
| 2715 | ||||||||||||
| 1113 | if (writeBuffer.isEmpty() && stdinChannel.closed)
| 456-2715 | ||||||||||||
| 1114 | closeWriteChannel(); executed 459 times by 3 tests: closeWriteChannel();Executed by:
| 459 | ||||||||||||
| 1115 | return writeSucceeded; executed 3630 times by 6 tests: return writeSucceeded;Executed by:
| 3630 | ||||||||||||
| 1116 | } | - | ||||||||||||
| 1117 | - | |||||||||||||
| 1118 | /*! | - | ||||||||||||
| 1119 | \internal | - | ||||||||||||
| 1120 | */ | - | ||||||||||||
| 1121 | bool QProcessPrivate::_q_processDied() | - | ||||||||||||
| 1122 | { | - | ||||||||||||
| 1123 | Q_Q(QProcess); | - | ||||||||||||
| 1124 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1125 | qDebug("QProcessPrivate::_q_processDied()"); | - | ||||||||||||
| 1126 | #endif | - | ||||||||||||
| 1127 | #ifdef Q_OS_UNIX | - | ||||||||||||
| 1128 | if (!waitForDeadChild())
| 0-2319 | ||||||||||||
| 1129 | return false; never executed: return false; | 0 | ||||||||||||
| 1130 | #endif | - | ||||||||||||
| 1131 | #ifdef Q_OS_WIN | - | ||||||||||||
| 1132 | if (processFinishedNotifier) | - | ||||||||||||
| 1133 | processFinishedNotifier->setEnabled(false); | - | ||||||||||||
| 1134 | drainOutputPipes(); | - | ||||||||||||
| 1135 | #endif | - | ||||||||||||
| 1136 | - | |||||||||||||
| 1137 | // the process may have died before it got a chance to report that it was | - | ||||||||||||
| 1138 | // either running or stopped, so we will call _q_startupNotification() and | - | ||||||||||||
| 1139 | // give it a chance to emit started() or errorOccurred(FailedToStart). | - | ||||||||||||
| 1140 | if (processState == QProcess::Starting) {
| 23-2296 | ||||||||||||
| 1141 | if (!_q_startupNotification())
| 0-23 | ||||||||||||
| 1142 | return true; never executed: return true; | 0 | ||||||||||||
| 1143 | } executed 23 times by 1 test: end of blockExecuted by:
| 23 | ||||||||||||
| 1144 | - | |||||||||||||
| 1145 | if (dying) {
| 0-2319 | ||||||||||||
| 1146 | // at this point we know the process is dead. prevent | - | ||||||||||||
| 1147 | // reentering this slot recursively by calling waitForFinished() | - | ||||||||||||
| 1148 | // or opening a dialog inside slots connected to the readyRead | - | ||||||||||||
| 1149 | // signals emitted below. | - | ||||||||||||
| 1150 | return true; never executed: return true; | 0 | ||||||||||||
| 1151 | } | - | ||||||||||||
| 1152 | dying = true; | - | ||||||||||||
| 1153 | - | |||||||||||||
| 1154 | // in case there is data in the pipe line and this slot by chance | - | ||||||||||||
| 1155 | // got called before the read notifications, call these two slots | - | ||||||||||||
| 1156 | // so the data is made available before the process dies. | - | ||||||||||||
| 1157 | _q_canReadStandardOutput(); | - | ||||||||||||
| 1158 | _q_canReadStandardError(); | - | ||||||||||||
| 1159 | - | |||||||||||||
| 1160 | findExitCode(); | - | ||||||||||||
| 1161 | - | |||||||||||||
| 1162 | if (crashed) {
| 103-2216 | ||||||||||||
| 1163 | exitStatus = QProcess::CrashExit; | - | ||||||||||||
| 1164 | setErrorAndEmit(QProcess::Crashed); | - | ||||||||||||
| 1165 | } executed 103 times by 5 tests: end of blockExecuted by:
| 103 | ||||||||||||
| 1166 | - | |||||||||||||
| 1167 | bool wasRunning = (processState == QProcess::Running); | - | ||||||||||||
| 1168 | - | |||||||||||||
| 1169 | cleanup(); | - | ||||||||||||
| 1170 | - | |||||||||||||
| 1171 | if (wasRunning) {
| 0-2319 | ||||||||||||
| 1172 | // we received EOF now: | - | ||||||||||||
| 1173 | emit q->readChannelFinished(); | - | ||||||||||||
| 1174 | // in the future: | - | ||||||||||||
| 1175 | //emit q->standardOutputClosed(); | - | ||||||||||||
| 1176 | //emit q->standardErrorClosed(); | - | ||||||||||||
| 1177 | - | |||||||||||||
| 1178 | emit q->finished(exitCode); | - | ||||||||||||
| 1179 | emit q->finished(exitCode, exitStatus); | - | ||||||||||||
| 1180 | } executed 2319 times by 30 tests: end of blockExecuted by:
| 2319 | ||||||||||||
| 1181 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1182 | qDebug("QProcessPrivate::_q_processDied() process is dead"); | - | ||||||||||||
| 1183 | #endif | - | ||||||||||||
| 1184 | return true; executed 2319 times by 30 tests: return true;Executed by:
| 2319 | ||||||||||||
| 1185 | } | - | ||||||||||||
| 1186 | - | |||||||||||||
| 1187 | /*! | - | ||||||||||||
| 1188 | \internal | - | ||||||||||||
| 1189 | */ | - | ||||||||||||
| 1190 | bool QProcessPrivate::_q_startupNotification() | - | ||||||||||||
| 1191 | { | - | ||||||||||||
| 1192 | Q_Q(QProcess); | - | ||||||||||||
| 1193 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1194 | qDebug("QProcessPrivate::startupNotification()"); | - | ||||||||||||
| 1195 | #endif | - | ||||||||||||
| 1196 | - | |||||||||||||
| 1197 | if (startupSocketNotifier)
| 81-2942 | ||||||||||||
| 1198 | startupSocketNotifier->setEnabled(false); executed 2942 times by 37 tests: startupSocketNotifier->setEnabled(false);Executed by:
| 2942 | ||||||||||||
| 1199 | QString errorMessage; | - | ||||||||||||
| 1200 | if (processStarted(&errorMessage)) {
| 704-2319 | ||||||||||||
| 1201 | q->setProcessState(QProcess::Running); | - | ||||||||||||
| 1202 | emit q->started(QProcess::QPrivateSignal()); | - | ||||||||||||
| 1203 | return true; executed 2319 times by 30 tests: return true;Executed by:
| 2319 | ||||||||||||
| 1204 | } | - | ||||||||||||
| 1205 | - | |||||||||||||
| 1206 | q->setProcessState(QProcess::NotRunning); | - | ||||||||||||
| 1207 | setErrorAndEmit(QProcess::FailedToStart, errorMessage); | - | ||||||||||||
| 1208 | #ifdef Q_OS_UNIX | - | ||||||||||||
| 1209 | // make sure the process manager removes this entry | - | ||||||||||||
| 1210 | waitForDeadChild(); | - | ||||||||||||
| 1211 | findExitCode(); | - | ||||||||||||
| 1212 | #endif | - | ||||||||||||
| 1213 | cleanup(); | - | ||||||||||||
| 1214 | return false; executed 704 times by 11 tests: return false;Executed by:
| 704 | ||||||||||||
| 1215 | } | - | ||||||||||||
| 1216 | - | |||||||||||||
| 1217 | /*! | - | ||||||||||||
| 1218 | \internal | - | ||||||||||||
| 1219 | */ | - | ||||||||||||
| 1220 | void QProcessPrivate::closeWriteChannel() | - | ||||||||||||
| 1221 | { | - | ||||||||||||
| 1222 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1223 | qDebug("QProcessPrivate::closeWriteChannel()"); | - | ||||||||||||
| 1224 | #endif | - | ||||||||||||
| 1225 | if (stdinChannel.notifier) {
| 0-629 | ||||||||||||
| 1226 | delete stdinChannel.notifier; | - | ||||||||||||
| 1227 | stdinChannel.notifier = 0; | - | ||||||||||||
| 1228 | } executed 629 times by 6 tests: end of blockExecuted by:
| 629 | ||||||||||||
| 1229 | #ifdef Q_OS_WIN | - | ||||||||||||
| 1230 | // ### Find a better fix, feeding the process little by little | - | ||||||||||||
| 1231 | // instead. | - | ||||||||||||
| 1232 | flushPipeWriter(); | - | ||||||||||||
| 1233 | #endif | - | ||||||||||||
| 1234 | closeChannel(&stdinChannel); | - | ||||||||||||
| 1235 | } executed 629 times by 6 tests: end of blockExecuted by:
| 629 | ||||||||||||
| 1236 | - | |||||||||||||
| 1237 | /*! | - | ||||||||||||
| 1238 | Constructs a QProcess object with the given \a parent. | - | ||||||||||||
| 1239 | */ | - | ||||||||||||
| 1240 | QProcess::QProcess(QObject *parent) | - | ||||||||||||
| 1241 | : QIODevice(*new QProcessPrivate, parent) | - | ||||||||||||
| 1242 | { | - | ||||||||||||
| 1243 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1244 | qDebug("QProcess::QProcess(%p)", parent); | - | ||||||||||||
| 1245 | #endif | - | ||||||||||||
| 1246 | } executed 2280 times by 35 tests: end of blockExecuted by:
| 2280 | ||||||||||||
| 1247 | - | |||||||||||||
| 1248 | /*! | - | ||||||||||||
| 1249 | Destructs the QProcess object, i.e., killing the process. | - | ||||||||||||
| 1250 | - | |||||||||||||
| 1251 | Note that this function will not return until the process is | - | ||||||||||||
| 1252 | terminated. | - | ||||||||||||
| 1253 | */ | - | ||||||||||||
| 1254 | QProcess::~QProcess() | - | ||||||||||||
| 1255 | { | - | ||||||||||||
| 1256 | Q_D(QProcess); | - | ||||||||||||
| 1257 | if (d->processState != NotRunning) {
| 1-2283 | ||||||||||||
| 1258 | qWarning().nospace() | - | ||||||||||||
| 1259 | << "QProcess: Destroyed while process (" << QDir::toNativeSeparators(program()) << ") is still running."; | - | ||||||||||||
| 1260 | kill(); | - | ||||||||||||
| 1261 | waitForFinished(); | - | ||||||||||||
| 1262 | } executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 1263 | #ifdef Q_OS_UNIX | - | ||||||||||||
| 1264 | // make sure the process manager removes this entry | - | ||||||||||||
| 1265 | d->findExitCode(); | - | ||||||||||||
| 1266 | #endif | - | ||||||||||||
| 1267 | d->cleanup(); | - | ||||||||||||
| 1268 | } executed 2284 times by 40 tests: end of blockExecuted by:
| 2284 | ||||||||||||
| 1269 | - | |||||||||||||
| 1270 | /*! | - | ||||||||||||
| 1271 | \obsolete | - | ||||||||||||
| 1272 | Returns the read channel mode of the QProcess. This function is | - | ||||||||||||
| 1273 | equivalent to processChannelMode() | - | ||||||||||||
| 1274 | - | |||||||||||||
| 1275 | \sa processChannelMode() | - | ||||||||||||
| 1276 | */ | - | ||||||||||||
| 1277 | QProcess::ProcessChannelMode QProcess::readChannelMode() const | - | ||||||||||||
| 1278 | { | - | ||||||||||||
| 1279 | return processChannelMode(); executed 4 times by 1 test: return processChannelMode();Executed by:
| 4 | ||||||||||||
| 1280 | } | - | ||||||||||||
| 1281 | - | |||||||||||||
| 1282 | /*! | - | ||||||||||||
| 1283 | \obsolete | - | ||||||||||||
| 1284 | - | |||||||||||||
| 1285 | Use setProcessChannelMode(\a mode) instead. | - | ||||||||||||
| 1286 | - | |||||||||||||
| 1287 | \sa setProcessChannelMode() | - | ||||||||||||
| 1288 | */ | - | ||||||||||||
| 1289 | void QProcess::setReadChannelMode(ProcessChannelMode mode) | - | ||||||||||||
| 1290 | { | - | ||||||||||||
| 1291 | setProcessChannelMode(mode); | - | ||||||||||||
| 1292 | } executed 26 times by 4 tests: end of blockExecuted by:
| 26 | ||||||||||||
| 1293 | - | |||||||||||||
| 1294 | /*! | - | ||||||||||||
| 1295 | \since 4.2 | - | ||||||||||||
| 1296 | - | |||||||||||||
| 1297 | Returns the channel mode of the QProcess standard output and | - | ||||||||||||
| 1298 | standard error channels. | - | ||||||||||||
| 1299 | - | |||||||||||||
| 1300 | \sa setProcessChannelMode(), ProcessChannelMode, setReadChannel() | - | ||||||||||||
| 1301 | */ | - | ||||||||||||
| 1302 | QProcess::ProcessChannelMode QProcess::processChannelMode() const | - | ||||||||||||
| 1303 | { | - | ||||||||||||
| 1304 | Q_D(const QProcess); | - | ||||||||||||
| 1305 | return d->processChannelMode; executed 9 times by 2 tests: return d->processChannelMode;Executed by:
| 9 | ||||||||||||
| 1306 | } | - | ||||||||||||
| 1307 | - | |||||||||||||
| 1308 | /*! | - | ||||||||||||
| 1309 | \since 4.2 | - | ||||||||||||
| 1310 | - | |||||||||||||
| 1311 | Sets the channel mode of the QProcess standard output and standard | - | ||||||||||||
| 1312 | error channels to the \a mode specified. | - | ||||||||||||
| 1313 | This mode will be used the next time start() is called. For example: | - | ||||||||||||
| 1314 | - | |||||||||||||
| 1315 | \snippet code/src_corelib_io_qprocess.cpp 0 | - | ||||||||||||
| 1316 | - | |||||||||||||
| 1317 | \sa processChannelMode(), ProcessChannelMode, setReadChannel() | - | ||||||||||||
| 1318 | */ | - | ||||||||||||
| 1319 | void QProcess::setProcessChannelMode(ProcessChannelMode mode) | - | ||||||||||||
| 1320 | { | - | ||||||||||||
| 1321 | Q_D(QProcess); | - | ||||||||||||
| 1322 | d->processChannelMode = mode; | - | ||||||||||||
| 1323 | } executed 172 times by 14 tests: end of blockExecuted by:
| 172 | ||||||||||||
| 1324 | - | |||||||||||||
| 1325 | /*! | - | ||||||||||||
| 1326 | \since 5.2 | - | ||||||||||||
| 1327 | - | |||||||||||||
| 1328 | Returns the channel mode of the QProcess standard input channel. | - | ||||||||||||
| 1329 | - | |||||||||||||
| 1330 | \sa setInputChannelMode(), InputChannelMode | - | ||||||||||||
| 1331 | */ | - | ||||||||||||
| 1332 | QProcess::InputChannelMode QProcess::inputChannelMode() const | - | ||||||||||||
| 1333 | { | - | ||||||||||||
| 1334 | Q_D(const QProcess); | - | ||||||||||||
| 1335 | return d->inputChannelMode; executed 5 times by 1 test: return d->inputChannelMode;Executed by:
| 5 | ||||||||||||
| 1336 | } | - | ||||||||||||
| 1337 | - | |||||||||||||
| 1338 | /*! | - | ||||||||||||
| 1339 | \since 5.2 | - | ||||||||||||
| 1340 | - | |||||||||||||
| 1341 | Sets the channel mode of the QProcess standard input | - | ||||||||||||
| 1342 | channel to the \a mode specified. | - | ||||||||||||
| 1343 | This mode will be used the next time start() is called. | - | ||||||||||||
| 1344 | - | |||||||||||||
| 1345 | \sa inputChannelMode(), InputChannelMode | - | ||||||||||||
| 1346 | */ | - | ||||||||||||
| 1347 | void QProcess::setInputChannelMode(InputChannelMode mode) | - | ||||||||||||
| 1348 | { | - | ||||||||||||
| 1349 | Q_D(QProcess); | - | ||||||||||||
| 1350 | d->inputChannelMode = mode; | - | ||||||||||||
| 1351 | } executed 5 times by 1 test: end of blockExecuted by:
| 5 | ||||||||||||
| 1352 | - | |||||||||||||
| 1353 | /*! | - | ||||||||||||
| 1354 | Returns the current read channel of the QProcess. | - | ||||||||||||
| 1355 | - | |||||||||||||
| 1356 | \sa setReadChannel() | - | ||||||||||||
| 1357 | */ | - | ||||||||||||
| 1358 | QProcess::ProcessChannel QProcess::readChannel() const | - | ||||||||||||
| 1359 | { | - | ||||||||||||
| 1360 | Q_D(const QProcess); | - | ||||||||||||
| 1361 | return ProcessChannel(d->currentReadChannel); executed 2523 times by 16 tests: return ProcessChannel(d->currentReadChannel);Executed by:
| 2523 | ||||||||||||
| 1362 | } | - | ||||||||||||
| 1363 | - | |||||||||||||
| 1364 | /*! | - | ||||||||||||
| 1365 | Sets the current read channel of the QProcess to the given \a | - | ||||||||||||
| 1366 | channel. The current input channel is used by the functions | - | ||||||||||||
| 1367 | read(), readAll(), readLine(), and getChar(). It also determines | - | ||||||||||||
| 1368 | which channel triggers QProcess to emit readyRead(). | - | ||||||||||||
| 1369 | - | |||||||||||||
| 1370 | \sa readChannel() | - | ||||||||||||
| 1371 | */ | - | ||||||||||||
| 1372 | void QProcess::setReadChannel(ProcessChannel channel) | - | ||||||||||||
| 1373 | { | - | ||||||||||||
| 1374 | QIODevice::setCurrentReadChannel(int(channel)); | - | ||||||||||||
| 1375 | } executed 5181 times by 18 tests: end of blockExecuted by:
| 5181 | ||||||||||||
| 1376 | - | |||||||||||||
| 1377 | /*! | - | ||||||||||||
| 1378 | Closes the read channel \a channel. After calling this function, | - | ||||||||||||
| 1379 | QProcess will no longer receive data on the channel. Any data that | - | ||||||||||||
| 1380 | has already been received is still available for reading. | - | ||||||||||||
| 1381 | - | |||||||||||||
| 1382 | Call this function to save memory, if you are not interested in | - | ||||||||||||
| 1383 | the output of the process. | - | ||||||||||||
| 1384 | - | |||||||||||||
| 1385 | \sa closeWriteChannel(), setReadChannel() | - | ||||||||||||
| 1386 | */ | - | ||||||||||||
| 1387 | void QProcess::closeReadChannel(ProcessChannel channel) | - | ||||||||||||
| 1388 | { | - | ||||||||||||
| 1389 | Q_D(QProcess); | - | ||||||||||||
| 1390 | - | |||||||||||||
| 1391 | if (channel == StandardOutput)
| 6 | ||||||||||||
| 1392 | d->stdoutChannel.closed = true; executed 6 times by 1 test: d->stdoutChannel.closed = true;Executed by:
| 6 | ||||||||||||
| 1393 | else | - | ||||||||||||
| 1394 | d->stderrChannel.closed = true; executed 6 times by 1 test: d->stderrChannel.closed = true;Executed by:
| 6 | ||||||||||||
| 1395 | } | - | ||||||||||||
| 1396 | - | |||||||||||||
| 1397 | /*! | - | ||||||||||||
| 1398 | Schedules the write channel of QProcess to be closed. The channel | - | ||||||||||||
| 1399 | will close once all data has been written to the process. After | - | ||||||||||||
| 1400 | calling this function, any attempts to write to the process will | - | ||||||||||||
| 1401 | fail. | - | ||||||||||||
| 1402 | - | |||||||||||||
| 1403 | Closing the write channel is necessary for programs that read | - | ||||||||||||
| 1404 | input data until the channel has been closed. For example, the | - | ||||||||||||
| 1405 | program "more" is used to display text data in a console on both | - | ||||||||||||
| 1406 | Unix and Windows. But it will not display the text data until | - | ||||||||||||
| 1407 | QProcess's write channel has been closed. Example: | - | ||||||||||||
| 1408 | - | |||||||||||||
| 1409 | \snippet code/src_corelib_io_qprocess.cpp 1 | - | ||||||||||||
| 1410 | - | |||||||||||||
| 1411 | The write channel is implicitly opened when start() is called. | - | ||||||||||||
| 1412 | - | |||||||||||||
| 1413 | \sa closeReadChannel() | - | ||||||||||||
| 1414 | */ | - | ||||||||||||
| 1415 | void QProcess::closeWriteChannel() | - | ||||||||||||
| 1416 | { | - | ||||||||||||
| 1417 | Q_D(QProcess); | - | ||||||||||||
| 1418 | d->stdinChannel.closed = true; // closing | - | ||||||||||||
| 1419 | if (d->writeBuffer.isEmpty())
| 170-462 | ||||||||||||
| 1420 | d->closeWriteChannel(); executed 170 times by 6 tests: d->closeWriteChannel();Executed by:
| 170 | ||||||||||||
| 1421 | } executed 632 times by 8 tests: end of blockExecuted by:
| 632 | ||||||||||||
| 1422 | - | |||||||||||||
| 1423 | /*! | - | ||||||||||||
| 1424 | \since 4.2 | - | ||||||||||||
| 1425 | - | |||||||||||||
| 1426 | Redirects the process' standard input to the file indicated by \a | - | ||||||||||||
| 1427 | fileName. When an input redirection is in place, the QProcess | - | ||||||||||||
| 1428 | object will be in read-only mode (calling write() will result in | - | ||||||||||||
| 1429 | error). | - | ||||||||||||
| 1430 | - | |||||||||||||
| 1431 | To make the process read EOF right away, pass nullDevice() here. | - | ||||||||||||
| 1432 | This is cleaner than using closeWriteChannel() before writing any | - | ||||||||||||
| 1433 | data, because it can be set up prior to starting the process. | - | ||||||||||||
| 1434 | - | |||||||||||||
| 1435 | If the file \a fileName does not exist at the moment start() is | - | ||||||||||||
| 1436 | called or is not readable, starting the process will fail. | - | ||||||||||||
| 1437 | - | |||||||||||||
| 1438 | Calling setStandardInputFile() after the process has started has no | - | ||||||||||||
| 1439 | effect. | - | ||||||||||||
| 1440 | - | |||||||||||||
| 1441 | \sa setStandardOutputFile(), setStandardErrorFile(), | - | ||||||||||||
| 1442 | setStandardOutputProcess() | - | ||||||||||||
| 1443 | */ | - | ||||||||||||
| 1444 | void QProcess::setStandardInputFile(const QString &fileName) | - | ||||||||||||
| 1445 | { | - | ||||||||||||
| 1446 | Q_D(QProcess); | - | ||||||||||||
| 1447 | d->stdinChannel = fileName; | - | ||||||||||||
| 1448 | } executed 2 times by 1 test: end of blockExecuted by:
| 2 | ||||||||||||
| 1449 | - | |||||||||||||
| 1450 | /*! | - | ||||||||||||
| 1451 | \since 4.2 | - | ||||||||||||
| 1452 | - | |||||||||||||
| 1453 | Redirects the process' standard output to the file \a | - | ||||||||||||
| 1454 | fileName. When the redirection is in place, the standard output | - | ||||||||||||
| 1455 | read channel is closed: reading from it using read() will always | - | ||||||||||||
| 1456 | fail, as will readAllStandardOutput(). | - | ||||||||||||
| 1457 | - | |||||||||||||
| 1458 | To discard all standard output from the process, pass nullDevice() | - | ||||||||||||
| 1459 | here. This is more efficient than simply never reading the standard | - | ||||||||||||
| 1460 | output, as no QProcess buffers are filled. | - | ||||||||||||
| 1461 | - | |||||||||||||
| 1462 | If the file \a fileName doesn't exist at the moment start() is | - | ||||||||||||
| 1463 | called, it will be created. If it cannot be created, the starting | - | ||||||||||||
| 1464 | will fail. | - | ||||||||||||
| 1465 | - | |||||||||||||
| 1466 | If the file exists and \a mode is QIODevice::Truncate, the file | - | ||||||||||||
| 1467 | will be truncated. Otherwise (if \a mode is QIODevice::Append), | - | ||||||||||||
| 1468 | the file will be appended to. | - | ||||||||||||
| 1469 | - | |||||||||||||
| 1470 | Calling setStandardOutputFile() after the process has started has | - | ||||||||||||
| 1471 | no effect. | - | ||||||||||||
| 1472 | - | |||||||||||||
| 1473 | \sa setStandardInputFile(), setStandardErrorFile(), | - | ||||||||||||
| 1474 | setStandardOutputProcess() | - | ||||||||||||
| 1475 | */ | - | ||||||||||||
| 1476 | void QProcess::setStandardOutputFile(const QString &fileName, OpenMode mode) | - | ||||||||||||
| 1477 | { | - | ||||||||||||
| 1478 | Q_ASSERT(mode == Append || mode == Truncate); | - | ||||||||||||
| 1479 | Q_D(QProcess); | - | ||||||||||||
| 1480 | - | |||||||||||||
| 1481 | d->stdoutChannel = fileName; | - | ||||||||||||
| 1482 | d->stdoutChannel.append = mode == Append; | - | ||||||||||||
| 1483 | } executed 7 times by 1 test: end of blockExecuted by:
| 7 | ||||||||||||
| 1484 | - | |||||||||||||
| 1485 | /*! | - | ||||||||||||
| 1486 | \since 4.2 | - | ||||||||||||
| 1487 | - | |||||||||||||
| 1488 | Redirects the process' standard error to the file \a | - | ||||||||||||
| 1489 | fileName. When the redirection is in place, the standard error | - | ||||||||||||
| 1490 | read channel is closed: reading from it using read() will always | - | ||||||||||||
| 1491 | fail, as will readAllStandardError(). The file will be appended to | - | ||||||||||||
| 1492 | if \a mode is Append, otherwise, it will be truncated. | - | ||||||||||||
| 1493 | - | |||||||||||||
| 1494 | See setStandardOutputFile() for more information on how the file | - | ||||||||||||
| 1495 | is opened. | - | ||||||||||||
| 1496 | - | |||||||||||||
| 1497 | Note: if setProcessChannelMode() was called with an argument of | - | ||||||||||||
| 1498 | QProcess::MergedChannels, this function has no effect. | - | ||||||||||||
| 1499 | - | |||||||||||||
| 1500 | \sa setStandardInputFile(), setStandardOutputFile(), | - | ||||||||||||
| 1501 | setStandardOutputProcess() | - | ||||||||||||
| 1502 | */ | - | ||||||||||||
| 1503 | void QProcess::setStandardErrorFile(const QString &fileName, OpenMode mode) | - | ||||||||||||
| 1504 | { | - | ||||||||||||
| 1505 | Q_ASSERT(mode == Append || mode == Truncate); | - | ||||||||||||
| 1506 | Q_D(QProcess); | - | ||||||||||||
| 1507 | - | |||||||||||||
| 1508 | d->stderrChannel = fileName; | - | ||||||||||||
| 1509 | d->stderrChannel.append = mode == Append; | - | ||||||||||||
| 1510 | } executed 3 times by 1 test: end of blockExecuted by:
| 3 | ||||||||||||
| 1511 | - | |||||||||||||
| 1512 | /*! | - | ||||||||||||
| 1513 | \since 4.2 | - | ||||||||||||
| 1514 | - | |||||||||||||
| 1515 | Pipes the standard output stream of this process to the \a | - | ||||||||||||
| 1516 | destination process' standard input. | - | ||||||||||||
| 1517 | - | |||||||||||||
| 1518 | The following shell command: | - | ||||||||||||
| 1519 | \snippet code/src_corelib_io_qprocess.cpp 2 | - | ||||||||||||
| 1520 | - | |||||||||||||
| 1521 | Can be accomplished with QProcess with the following code: | - | ||||||||||||
| 1522 | \snippet code/src_corelib_io_qprocess.cpp 3 | - | ||||||||||||
| 1523 | */ | - | ||||||||||||
| 1524 | void QProcess::setStandardOutputProcess(QProcess *destination) | - | ||||||||||||
| 1525 | { | - | ||||||||||||
| 1526 | QProcessPrivate *dfrom = d_func(); | - | ||||||||||||
| 1527 | QProcessPrivate *dto = destination->d_func(); | - | ||||||||||||
| 1528 | dfrom->stdoutChannel.pipeTo(dto); | - | ||||||||||||
| 1529 | dto->stdinChannel.pipeFrom(dfrom); | - | ||||||||||||
| 1530 | } executed 3 times by 1 test: end of blockExecuted by:
| 3 | ||||||||||||
| 1531 | - | |||||||||||||
| 1532 | #if defined(Q_OS_WIN) | - | ||||||||||||
| 1533 | - | |||||||||||||
| 1534 | /*! | - | ||||||||||||
| 1535 | \since 4.7 | - | ||||||||||||
| 1536 | - | |||||||||||||
| 1537 | Returns the additional native command line arguments for the program. | - | ||||||||||||
| 1538 | - | |||||||||||||
| 1539 | \note This function is available only on the Windows platform. | - | ||||||||||||
| 1540 | - | |||||||||||||
| 1541 | \sa setNativeArguments() | - | ||||||||||||
| 1542 | */ | - | ||||||||||||
| 1543 | QString QProcess::nativeArguments() const | - | ||||||||||||
| 1544 | { | - | ||||||||||||
| 1545 | Q_D(const QProcess); | - | ||||||||||||
| 1546 | return d->nativeArguments; | - | ||||||||||||
| 1547 | } | - | ||||||||||||
| 1548 | - | |||||||||||||
| 1549 | /*! | - | ||||||||||||
| 1550 | \since 4.7 | - | ||||||||||||
| 1551 | \overload | - | ||||||||||||
| 1552 | - | |||||||||||||
| 1553 | Sets additional native command line \a arguments for the program. | - | ||||||||||||
| 1554 | - | |||||||||||||
| 1555 | On operating systems where the system API for passing command line | - | ||||||||||||
| 1556 | \a arguments to a subprocess natively uses a single string, one can | - | ||||||||||||
| 1557 | conceive command lines which cannot be passed via QProcess's portable | - | ||||||||||||
| 1558 | list-based API. In such cases this function must be used to set a | - | ||||||||||||
| 1559 | string which is \e appended to the string composed from the usual | - | ||||||||||||
| 1560 | argument list, with a delimiting space. | - | ||||||||||||
| 1561 | - | |||||||||||||
| 1562 | \note This function is available only on the Windows platform. | - | ||||||||||||
| 1563 | - | |||||||||||||
| 1564 | \sa nativeArguments() | - | ||||||||||||
| 1565 | */ | - | ||||||||||||
| 1566 | void QProcess::setNativeArguments(const QString &arguments) | - | ||||||||||||
| 1567 | { | - | ||||||||||||
| 1568 | Q_D(QProcess); | - | ||||||||||||
| 1569 | d->nativeArguments = arguments; | - | ||||||||||||
| 1570 | } | - | ||||||||||||
| 1571 | - | |||||||||||||
| 1572 | /*! | - | ||||||||||||
| 1573 | \since 5.7 | - | ||||||||||||
| 1574 | - | |||||||||||||
| 1575 | Returns a previously set \c CreateProcess modifier function. | - | ||||||||||||
| 1576 | - | |||||||||||||
| 1577 | \note This function is available only on the Windows platform. | - | ||||||||||||
| 1578 | - | |||||||||||||
| 1579 | \sa setCreateProcessArgumentsModifier() | - | ||||||||||||
| 1580 | \sa QProcess::CreateProcessArgumentModifier | - | ||||||||||||
| 1581 | */ | - | ||||||||||||
| 1582 | QProcess::CreateProcessArgumentModifier QProcess::createProcessArgumentsModifier() const | - | ||||||||||||
| 1583 | { | - | ||||||||||||
| 1584 | Q_D(const QProcess); | - | ||||||||||||
| 1585 | return d->modifyCreateProcessArgs; | - | ||||||||||||
| 1586 | } | - | ||||||||||||
| 1587 | - | |||||||||||||
| 1588 | /*! | - | ||||||||||||
| 1589 | \since 5.7 | - | ||||||||||||
| 1590 | - | |||||||||||||
| 1591 | Sets the \a modifier for the \c CreateProcess Win32 API call. | - | ||||||||||||
| 1592 | Pass \c QProcess::CreateProcessArgumentModifier() to remove a previously set one. | - | ||||||||||||
| 1593 | - | |||||||||||||
| 1594 | \note This function is available only on the Windows platform and requires | - | ||||||||||||
| 1595 | C++11. | - | ||||||||||||
| 1596 | - | |||||||||||||
| 1597 | \sa QProcess::CreateProcessArgumentModifier | - | ||||||||||||
| 1598 | */ | - | ||||||||||||
| 1599 | void QProcess::setCreateProcessArgumentsModifier(CreateProcessArgumentModifier modifier) | - | ||||||||||||
| 1600 | { | - | ||||||||||||
| 1601 | Q_D(QProcess); | - | ||||||||||||
| 1602 | d->modifyCreateProcessArgs = modifier; | - | ||||||||||||
| 1603 | } | - | ||||||||||||
| 1604 | - | |||||||||||||
| 1605 | #endif | - | ||||||||||||
| 1606 | - | |||||||||||||
| 1607 | /*! | - | ||||||||||||
| 1608 | If QProcess has been assigned a working directory, this function returns | - | ||||||||||||
| 1609 | the working directory that the QProcess will enter before the program has | - | ||||||||||||
| 1610 | started. Otherwise, (i.e., no directory has been assigned,) an empty | - | ||||||||||||
| 1611 | string is returned, and QProcess will use the application's current | - | ||||||||||||
| 1612 | working directory instead. | - | ||||||||||||
| 1613 | - | |||||||||||||
| 1614 | \sa setWorkingDirectory() | - | ||||||||||||
| 1615 | */ | - | ||||||||||||
| 1616 | QString QProcess::workingDirectory() const | - | ||||||||||||
| 1617 | { | - | ||||||||||||
| 1618 | Q_D(const QProcess); | - | ||||||||||||
| 1619 | return d->workingDirectory; executed 1 time by 1 test: return d->workingDirectory;Executed by:
| 1 | ||||||||||||
| 1620 | } | - | ||||||||||||
| 1621 | - | |||||||||||||
| 1622 | /*! | - | ||||||||||||
| 1623 | Sets the working directory to \a dir. QProcess will start the | - | ||||||||||||
| 1624 | process in this directory. The default behavior is to start the | - | ||||||||||||
| 1625 | process in the working directory of the calling process. | - | ||||||||||||
| 1626 | - | |||||||||||||
| 1627 | \note On QNX, this may cause all application threads to | - | ||||||||||||
| 1628 | temporarily freeze. | - | ||||||||||||
| 1629 | - | |||||||||||||
| 1630 | \sa workingDirectory(), start() | - | ||||||||||||
| 1631 | */ | - | ||||||||||||
| 1632 | void QProcess::setWorkingDirectory(const QString &dir) | - | ||||||||||||
| 1633 | { | - | ||||||||||||
| 1634 | Q_D(QProcess); | - | ||||||||||||
| 1635 | d->workingDirectory = dir; | - | ||||||||||||
| 1636 | } executed 517 times by 4 tests: end of blockExecuted by:
| 517 | ||||||||||||
| 1637 | - | |||||||||||||
| 1638 | - | |||||||||||||
| 1639 | /*! | - | ||||||||||||
| 1640 | \deprecated | - | ||||||||||||
| 1641 | Use processId() instead. | - | ||||||||||||
| 1642 | - | |||||||||||||
| 1643 | Returns the native process identifier for the running process, if | - | ||||||||||||
| 1644 | available. If no process is currently running, \c 0 is returned. | - | ||||||||||||
| 1645 | - | |||||||||||||
| 1646 | \note Unlike \l processId(), pid() returns an integer on Unix and a pointer on Windows. | - | ||||||||||||
| 1647 | - | |||||||||||||
| 1648 | \sa Q_PID, processId() | - | ||||||||||||
| 1649 | */ | - | ||||||||||||
| 1650 | Q_PID QProcess::pid() const // ### Qt 6 remove or rename this method to processInformation() | - | ||||||||||||
| 1651 | { | - | ||||||||||||
| 1652 | Q_D(const QProcess); | - | ||||||||||||
| 1653 | return d->pid; executed 1 time by 1 test: return d->pid;Executed by:
| 1 | ||||||||||||
| 1654 | } | - | ||||||||||||
| 1655 | - | |||||||||||||
| 1656 | /*! | - | ||||||||||||
| 1657 | \since 5.3 | - | ||||||||||||
| 1658 | - | |||||||||||||
| 1659 | Returns the native process identifier for the running process, if | - | ||||||||||||
| 1660 | available. If no process is currently running, \c 0 is returned. | - | ||||||||||||
| 1661 | */ | - | ||||||||||||
| 1662 | qint64 QProcess::processId() const | - | ||||||||||||
| 1663 | { | - | ||||||||||||
| 1664 | Q_D(const QProcess); | - | ||||||||||||
| 1665 | #ifdef Q_OS_WIN | - | ||||||||||||
| 1666 | return d->pid ? d->pid->dwProcessId : 0; | - | ||||||||||||
| 1667 | #else | - | ||||||||||||
| 1668 | return d->pid; executed 15 times by 2 tests: return d->pid;Executed by:
| 15 | ||||||||||||
| 1669 | #endif | - | ||||||||||||
| 1670 | } | - | ||||||||||||
| 1671 | - | |||||||||||||
| 1672 | /*! \reimp | - | ||||||||||||
| 1673 | - | |||||||||||||
| 1674 | This function operates on the current read channel. | - | ||||||||||||
| 1675 | - | |||||||||||||
| 1676 | \sa readChannel(), setReadChannel() | - | ||||||||||||
| 1677 | */ | - | ||||||||||||
| 1678 | bool QProcess::canReadLine() const | - | ||||||||||||
| 1679 | { | - | ||||||||||||
| 1680 | return QIODevice::canReadLine(); executed 1 time by 1 test: return QIODevice::canReadLine();Executed by:
| 1 | ||||||||||||
| 1681 | } | - | ||||||||||||
| 1682 | - | |||||||||||||
| 1683 | /*! | - | ||||||||||||
| 1684 | Closes all communication with the process and kills it. After calling this | - | ||||||||||||
| 1685 | function, QProcess will no longer emit readyRead(), and data can no | - | ||||||||||||
| 1686 | longer be read or written. | - | ||||||||||||
| 1687 | */ | - | ||||||||||||
| 1688 | void QProcess::close() | - | ||||||||||||
| 1689 | { | - | ||||||||||||
| 1690 | Q_D(QProcess); | - | ||||||||||||
| 1691 | emit aboutToClose(); | - | ||||||||||||
| 1692 | while (waitForBytesWritten(-1))
| 0-5 | ||||||||||||
| 1693 | ; never executed: ; | 0 | ||||||||||||
| 1694 | kill(); | - | ||||||||||||
| 1695 | waitForFinished(-1); | - | ||||||||||||
| 1696 | d->setWriteChannelCount(0); | - | ||||||||||||
| 1697 | QIODevice::close(); | - | ||||||||||||
| 1698 | } executed 5 times by 5 tests: end of blockExecuted by:
| 5 | ||||||||||||
| 1699 | - | |||||||||||||
| 1700 | /*! \reimp | - | ||||||||||||
| 1701 | - | |||||||||||||
| 1702 | Returns \c true if the process is not running, and no more data is available | - | ||||||||||||
| 1703 | for reading; otherwise returns \c false. | - | ||||||||||||
| 1704 | */ | - | ||||||||||||
| 1705 | bool QProcess::atEnd() const | - | ||||||||||||
| 1706 | { | - | ||||||||||||
| 1707 | return QIODevice::atEnd(); executed 61 times by 3 tests: return QIODevice::atEnd();Executed by:
| 61 | ||||||||||||
| 1708 | } | - | ||||||||||||
| 1709 | - | |||||||||||||
| 1710 | /*! \reimp | - | ||||||||||||
| 1711 | */ | - | ||||||||||||
| 1712 | bool QProcess::isSequential() const | - | ||||||||||||
| 1713 | { | - | ||||||||||||
| 1714 | return true; executed 2056 times by 20 tests: return true;Executed by:
| 2056 | ||||||||||||
| 1715 | } | - | ||||||||||||
| 1716 | - | |||||||||||||
| 1717 | /*! \reimp | - | ||||||||||||
| 1718 | */ | - | ||||||||||||
| 1719 | qint64 QProcess::bytesAvailable() const | - | ||||||||||||
| 1720 | { | - | ||||||||||||
| 1721 | return QIODevice::bytesAvailable(); executed 872 times by 3 tests: return QIODevice::bytesAvailable();Executed by:
| 872 | ||||||||||||
| 1722 | } | - | ||||||||||||
| 1723 | - | |||||||||||||
| 1724 | /*! \reimp | - | ||||||||||||
| 1725 | */ | - | ||||||||||||
| 1726 | qint64 QProcess::bytesToWrite() const | - | ||||||||||||
| 1727 | { | - | ||||||||||||
| 1728 | qint64 size = QIODevice::bytesToWrite(); | - | ||||||||||||
| 1729 | #ifdef Q_OS_WIN | - | ||||||||||||
| 1730 | size += d_func()->pipeWriterBytesToWrite(); | - | ||||||||||||
| 1731 | #endif | - | ||||||||||||
| 1732 | return size; executed 3728 times by 2 tests: return size;Executed by:
| 3728 | ||||||||||||
| 1733 | } | - | ||||||||||||
| 1734 | - | |||||||||||||
| 1735 | /*! | - | ||||||||||||
| 1736 | Returns the type of error that occurred last. | - | ||||||||||||
| 1737 | - | |||||||||||||
| 1738 | \sa state() | - | ||||||||||||
| 1739 | */ | - | ||||||||||||
| 1740 | QProcess::ProcessError QProcess::error() const | - | ||||||||||||
| 1741 | { | - | ||||||||||||
| 1742 | Q_D(const QProcess); | - | ||||||||||||
| 1743 | return d->processError; executed 774 times by 4 tests: return d->processError;Executed by:
| 774 | ||||||||||||
| 1744 | } | - | ||||||||||||
| 1745 | - | |||||||||||||
| 1746 | /*! | - | ||||||||||||
| 1747 | Returns the current state of the process. | - | ||||||||||||
| 1748 | - | |||||||||||||
| 1749 | \sa stateChanged(), error() | - | ||||||||||||
| 1750 | */ | - | ||||||||||||
| 1751 | QProcess::ProcessState QProcess::state() const | - | ||||||||||||
| 1752 | { | - | ||||||||||||
| 1753 | Q_D(const QProcess); | - | ||||||||||||
| 1754 | return d->processState; executed 94 times by 5 tests: return d->processState;Executed by:
| 94 | ||||||||||||
| 1755 | } | - | ||||||||||||
| 1756 | - | |||||||||||||
| 1757 | /*! | - | ||||||||||||
| 1758 | \deprecated | - | ||||||||||||
| 1759 | Sets the environment that QProcess will pass to the child process. | - | ||||||||||||
| 1760 | The parameter \a environment is a list of key=value pairs. | - | ||||||||||||
| 1761 | - | |||||||||||||
| 1762 | For example, the following code adds the environment variable \c{TMPDIR}: | - | ||||||||||||
| 1763 | - | |||||||||||||
| 1764 | \snippet qprocess-environment/main.cpp 0 | - | ||||||||||||
| 1765 | - | |||||||||||||
| 1766 | \note This function is less efficient than the setProcessEnvironment() | - | ||||||||||||
| 1767 | function. | - | ||||||||||||
| 1768 | - | |||||||||||||
| 1769 | \sa environment(), setProcessEnvironment(), systemEnvironment() | - | ||||||||||||
| 1770 | */ | - | ||||||||||||
| 1771 | void QProcess::setEnvironment(const QStringList &environment) | - | ||||||||||||
| 1772 | { | - | ||||||||||||
| 1773 | setProcessEnvironment(QProcessEnvironmentPrivate::fromList(environment)); | - | ||||||||||||
| 1774 | } executed 137 times by 4 tests: end of blockExecuted by:
| 137 | ||||||||||||
| 1775 | - | |||||||||||||
| 1776 | /*! | - | ||||||||||||
| 1777 | \deprecated | - | ||||||||||||
| 1778 | Returns the environment that QProcess will pass to its child | - | ||||||||||||
| 1779 | process, or an empty QStringList if no environment has been set | - | ||||||||||||
| 1780 | using setEnvironment(). If no environment has been set, the | - | ||||||||||||
| 1781 | environment of the calling process will be used. | - | ||||||||||||
| 1782 | - | |||||||||||||
| 1783 | \sa processEnvironment(), setEnvironment(), systemEnvironment() | - | ||||||||||||
| 1784 | */ | - | ||||||||||||
| 1785 | QStringList QProcess::environment() const | - | ||||||||||||
| 1786 | { | - | ||||||||||||
| 1787 | Q_D(const QProcess); | - | ||||||||||||
| 1788 | return d->environment.toStringList(); executed 1 time by 1 test: return d->environment.toStringList();Executed by:
| 1 | ||||||||||||
| 1789 | } | - | ||||||||||||
| 1790 | - | |||||||||||||
| 1791 | /*! | - | ||||||||||||
| 1792 | \since 4.6 | - | ||||||||||||
| 1793 | Sets the \a environment that QProcess will pass to the child process. | - | ||||||||||||
| 1794 | - | |||||||||||||
| 1795 | For example, the following code adds the environment variable \c{TMPDIR}: | - | ||||||||||||
| 1796 | - | |||||||||||||
| 1797 | \snippet qprocess-environment/main.cpp 1 | - | ||||||||||||
| 1798 | - | |||||||||||||
| 1799 | Note how, on Windows, environment variable names are case-insensitive. | - | ||||||||||||
| 1800 | - | |||||||||||||
| 1801 | \sa processEnvironment(), QProcessEnvironment::systemEnvironment(), setEnvironment() | - | ||||||||||||
| 1802 | */ | - | ||||||||||||
| 1803 | void QProcess::setProcessEnvironment(const QProcessEnvironment &environment) | - | ||||||||||||
| 1804 | { | - | ||||||||||||
| 1805 | Q_D(QProcess); | - | ||||||||||||
| 1806 | d->environment = environment; | - | ||||||||||||
| 1807 | } executed 934 times by 6 tests: end of blockExecuted by:
| 934 | ||||||||||||
| 1808 | - | |||||||||||||
| 1809 | /*! | - | ||||||||||||
| 1810 | \since 4.6 | - | ||||||||||||
| 1811 | Returns the environment that QProcess will pass to its child | - | ||||||||||||
| 1812 | process, or an empty object if no environment has been set using | - | ||||||||||||
| 1813 | setEnvironment() or setProcessEnvironment(). If no environment has | - | ||||||||||||
| 1814 | been set, the environment of the calling process will be used. | - | ||||||||||||
| 1815 | - | |||||||||||||
| 1816 | \sa setProcessEnvironment(), setEnvironment(), QProcessEnvironment::isEmpty() | - | ||||||||||||
| 1817 | */ | - | ||||||||||||
| 1818 | QProcessEnvironment QProcess::processEnvironment() const | - | ||||||||||||
| 1819 | { | - | ||||||||||||
| 1820 | Q_D(const QProcess); | - | ||||||||||||
| 1821 | return d->environment; never executed: return d->environment; | 0 | ||||||||||||
| 1822 | } | - | ||||||||||||
| 1823 | - | |||||||||||||
| 1824 | /*! | - | ||||||||||||
| 1825 | Blocks until the process has started and the started() signal has | - | ||||||||||||
| 1826 | been emitted, or until \a msecs milliseconds have passed. | - | ||||||||||||
| 1827 | - | |||||||||||||
| 1828 | Returns \c true if the process was started successfully; otherwise | - | ||||||||||||
| 1829 | returns \c false (if the operation timed out or if an error | - | ||||||||||||
| 1830 | occurred). | - | ||||||||||||
| 1831 | - | |||||||||||||
| 1832 | This function can operate without an event loop. It is | - | ||||||||||||
| 1833 | useful when writing non-GUI applications and when performing | - | ||||||||||||
| 1834 | I/O operations in a non-GUI thread. | - | ||||||||||||
| 1835 | - | |||||||||||||
| 1836 | \warning Calling this function from the main (GUI) thread | - | ||||||||||||
| 1837 | might cause your user interface to freeze. | - | ||||||||||||
| 1838 | - | |||||||||||||
| 1839 | If msecs is -1, this function will not time out. | - | ||||||||||||
| 1840 | - | |||||||||||||
| 1841 | \note On some UNIX operating systems, this function may return true but | - | ||||||||||||
| 1842 | the process may later report a QProcess::FailedToStart error. | - | ||||||||||||
| 1843 | - | |||||||||||||
| 1844 | \sa started(), waitForReadyRead(), waitForBytesWritten(), waitForFinished() | - | ||||||||||||
| 1845 | */ | - | ||||||||||||
| 1846 | bool QProcess::waitForStarted(int msecs) | - | ||||||||||||
| 1847 | { | - | ||||||||||||
| 1848 | Q_D(QProcess); | - | ||||||||||||
| 1849 | if (d->processState == QProcess::Starting)
| 4-2796 | ||||||||||||
| 1850 | return d->waitForStarted(msecs); executed 2796 times by 37 tests: return d->waitForStarted(msecs);Executed by:
| 2796 | ||||||||||||
| 1851 | - | |||||||||||||
| 1852 | return d->processState == QProcess::Running; executed 4 times by 1 test: return d->processState == QProcess::Running;Executed by:
| 4 | ||||||||||||
| 1853 | } | - | ||||||||||||
| 1854 | - | |||||||||||||
| 1855 | /*! \reimp | - | ||||||||||||
| 1856 | */ | - | ||||||||||||
| 1857 | bool QProcess::waitForReadyRead(int msecs) | - | ||||||||||||
| 1858 | { | - | ||||||||||||
| 1859 | Q_D(QProcess); | - | ||||||||||||
| 1860 | - | |||||||||||||
| 1861 | if (d->processState == QProcess::NotRunning)
| 1-709 | ||||||||||||
| 1862 | return false; executed 1 time by 1 test: return false;Executed by:
| 1 | ||||||||||||
| 1863 | if (d->currentReadChannel == QProcess::StandardOutput && d->stdoutChannel.closed)
| 5-681 | ||||||||||||
| 1864 | return false; executed 5 times by 1 test: return false;Executed by:
| 5 | ||||||||||||
| 1865 | if (d->currentReadChannel == QProcess::StandardError && d->stderrChannel.closed)
| 5-676 | ||||||||||||
| 1866 | return false; executed 5 times by 1 test: return false;Executed by:
| 5 | ||||||||||||
| 1867 | return d->waitForReadyRead(msecs); executed 699 times by 9 tests: return d->waitForReadyRead(msecs);Executed by:
| 699 | ||||||||||||
| 1868 | } | - | ||||||||||||
| 1869 | - | |||||||||||||
| 1870 | /*! \reimp | - | ||||||||||||
| 1871 | */ | - | ||||||||||||
| 1872 | bool QProcess::waitForBytesWritten(int msecs) | - | ||||||||||||
| 1873 | { | - | ||||||||||||
| 1874 | Q_D(QProcess); | - | ||||||||||||
| 1875 | if (d->processState == QProcess::NotRunning)
| 4-3262 | ||||||||||||
| 1876 | return false; executed 4 times by 4 tests: return false;Executed by:
| 4 | ||||||||||||
| 1877 | if (d->processState == QProcess::Starting) {
| 535-2727 | ||||||||||||
| 1878 | QElapsedTimer stopWatch; | - | ||||||||||||
| 1879 | stopWatch.start(); | - | ||||||||||||
| 1880 | bool started = waitForStarted(msecs); | - | ||||||||||||
| 1881 | if (!started)
| 100-435 | ||||||||||||
| 1882 | return false; executed 100 times by 1 test: return false;Executed by:
| 100 | ||||||||||||
| 1883 | msecs = qt_subtract_from_timeout(msecs, stopWatch.elapsed()); | - | ||||||||||||
| 1884 | } executed 435 times by 1 test: end of blockExecuted by:
| 435 | ||||||||||||
| 1885 | - | |||||||||||||
| 1886 | return d->waitForBytesWritten(msecs); executed 3162 times by 2 tests: return d->waitForBytesWritten(msecs);Executed by:
| 3162 | ||||||||||||
| 1887 | } | - | ||||||||||||
| 1888 | - | |||||||||||||
| 1889 | /*! | - | ||||||||||||
| 1890 | Blocks until the process has finished and the finished() signal | - | ||||||||||||
| 1891 | has been emitted, or until \a msecs milliseconds have passed. | - | ||||||||||||
| 1892 | - | |||||||||||||
| 1893 | Returns \c true if the process finished; otherwise returns \c false (if | - | ||||||||||||
| 1894 | the operation timed out, if an error occurred, or if this QProcess | - | ||||||||||||
| 1895 | is already finished). | - | ||||||||||||
| 1896 | - | |||||||||||||
| 1897 | This function can operate without an event loop. It is | - | ||||||||||||
| 1898 | useful when writing non-GUI applications and when performing | - | ||||||||||||
| 1899 | I/O operations in a non-GUI thread. | - | ||||||||||||
| 1900 | - | |||||||||||||
| 1901 | \warning Calling this function from the main (GUI) thread | - | ||||||||||||
| 1902 | might cause your user interface to freeze. | - | ||||||||||||
| 1903 | - | |||||||||||||
| 1904 | If msecs is -1, this function will not time out. | - | ||||||||||||
| 1905 | - | |||||||||||||
| 1906 | \sa finished(), waitForStarted(), waitForReadyRead(), waitForBytesWritten() | - | ||||||||||||
| 1907 | */ | - | ||||||||||||
| 1908 | bool QProcess::waitForFinished(int msecs) | - | ||||||||||||
| 1909 | { | - | ||||||||||||
| 1910 | Q_D(QProcess); | - | ||||||||||||
| 1911 | if (d->processState == QProcess::NotRunning)
| 5-2373 | ||||||||||||
| 1912 | return false; executed 5 times by 5 tests: return false;Executed by:
| 5 | ||||||||||||
| 1913 | if (d->processState == QProcess::Starting) {
| 587-1786 | ||||||||||||
| 1914 | QElapsedTimer stopWatch; | - | ||||||||||||
| 1915 | stopWatch.start(); | - | ||||||||||||
| 1916 | bool started = waitForStarted(msecs); | - | ||||||||||||
| 1917 | if (!started)
| 117-470 | ||||||||||||
| 1918 | return false; executed 117 times by 7 tests: return false;Executed by:
| 117 | ||||||||||||
| 1919 | msecs = qt_subtract_from_timeout(msecs, stopWatch.elapsed()); | - | ||||||||||||
| 1920 | } executed 470 times by 9 tests: end of blockExecuted by:
| 470 | ||||||||||||
| 1921 | - | |||||||||||||
| 1922 | return d->waitForFinished(msecs); executed 2256 times by 29 tests: return d->waitForFinished(msecs);Executed by:
| 2256 | ||||||||||||
| 1923 | } | - | ||||||||||||
| 1924 | - | |||||||||||||
| 1925 | /*! | - | ||||||||||||
| 1926 | Sets the current state of the QProcess to the \a state specified. | - | ||||||||||||
| 1927 | - | |||||||||||||
| 1928 | \sa state() | - | ||||||||||||
| 1929 | */ | - | ||||||||||||
| 1930 | void QProcess::setProcessState(ProcessState state) | - | ||||||||||||
| 1931 | { | - | ||||||||||||
| 1932 | Q_D(QProcess); | - | ||||||||||||
| 1933 | if (d->processState == state)
| 2988-8365 | ||||||||||||
| 1934 | return; executed 2988 times by 40 tests: return;Executed by:
| 2988 | ||||||||||||
| 1935 | d->processState = state; | - | ||||||||||||
| 1936 | emit stateChanged(state, QPrivateSignal()); | - | ||||||||||||
| 1937 | } executed 8365 times by 39 tests: end of blockExecuted by:
| 8365 | ||||||||||||
| 1938 | - | |||||||||||||
| 1939 | /*! | - | ||||||||||||
| 1940 | This function is called in the child process context just before the | - | ||||||||||||
| 1941 | program is executed on Unix or \macos (i.e., after \c fork(), but before | - | ||||||||||||
| 1942 | \c execve()). Reimplement this function to do last minute initialization | - | ||||||||||||
| 1943 | of the child process. Example: | - | ||||||||||||
| 1944 | - | |||||||||||||
| 1945 | \snippet code/src_corelib_io_qprocess.cpp 4 | - | ||||||||||||
| 1946 | - | |||||||||||||
| 1947 | You cannot exit the process (by calling exit(), for instance) from | - | ||||||||||||
| 1948 | this function. If you need to stop the program before it starts | - | ||||||||||||
| 1949 | execution, your workaround is to emit finished() and then call | - | ||||||||||||
| 1950 | exit(). | - | ||||||||||||
| 1951 | - | |||||||||||||
| 1952 | \warning This function is called by QProcess on Unix and \macos | - | ||||||||||||
| 1953 | only. On Windows and QNX, it is not called. | - | ||||||||||||
| 1954 | */ | - | ||||||||||||
| 1955 | void QProcess::setupChildProcess() | - | ||||||||||||
| 1956 | { | - | ||||||||||||
| 1957 | } | - | ||||||||||||
| 1958 | - | |||||||||||||
| 1959 | /*! \reimp | - | ||||||||||||
| 1960 | */ | - | ||||||||||||
| 1961 | qint64 QProcess::readData(char *data, qint64 maxlen) | - | ||||||||||||
| 1962 | { | - | ||||||||||||
| 1963 | Q_D(QProcess); | - | ||||||||||||
| 1964 | Q_UNUSED(data); | - | ||||||||||||
| 1965 | if (!maxlen)
| 258-4081 | ||||||||||||
| 1966 | return 0; executed 258 times by 6 tests: return 0;Executed by:
| 258 | ||||||||||||
| 1967 | if (d->processState == QProcess::NotRunning)
| 598-3483 | ||||||||||||
| 1968 | return -1; // EOF executed 3483 times by 16 tests: return -1;Executed by:
| 3483 | ||||||||||||
| 1969 | return 0; executed 598 times by 5 tests: return 0;Executed by:
| 598 | ||||||||||||
| 1970 | } | - | ||||||||||||
| 1971 | - | |||||||||||||
| 1972 | /*! \reimp | - | ||||||||||||
| 1973 | */ | - | ||||||||||||
| 1974 | qint64 QProcess::writeData(const char *data, qint64 len) | - | ||||||||||||
| 1975 | { | - | ||||||||||||
| 1976 | Q_D(QProcess); | - | ||||||||||||
| 1977 | - | |||||||||||||
| 1978 | #if defined(Q_OS_WINCE) | - | ||||||||||||
| 1979 | Q_UNUSED(data); | - | ||||||||||||
| 1980 | Q_UNUSED(len); | - | ||||||||||||
| 1981 | d->setErrorAndEmit(QProcess::WriteError); | - | ||||||||||||
| 1982 | return -1; | - | ||||||||||||
| 1983 | #endif | - | ||||||||||||
| 1984 | - | |||||||||||||
| 1985 | if (d->stdinChannel.closed) {
| 0-1167 | ||||||||||||
| 1986 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 1987 | qDebug("QProcess::writeData(%p \"%s\", %lld) == 0 (write channel closing)", | - | ||||||||||||
| 1988 | data, qt_prettyDebug(data, len, 16).constData(), len); | - | ||||||||||||
| 1989 | #endif | - | ||||||||||||
| 1990 | return 0; never executed: return 0; | 0 | ||||||||||||
| 1991 | } | - | ||||||||||||
| 1992 | - | |||||||||||||
| 1993 | #if defined(Q_OS_WIN) | - | ||||||||||||
| 1994 | if (!d->stdinWriteTrigger) { | - | ||||||||||||
| 1995 | d->stdinWriteTrigger = new QTimer; | - | ||||||||||||
| 1996 | d->stdinWriteTrigger->setSingleShot(true); | - | ||||||||||||
| 1997 | QObjectPrivate::connect(d->stdinWriteTrigger, &QTimer::timeout, | - | ||||||||||||
| 1998 | d, &QProcessPrivate::_q_canWrite); | - | ||||||||||||
| 1999 | } | - | ||||||||||||
| 2000 | #endif | - | ||||||||||||
| 2001 | - | |||||||||||||
| 2002 | d->writeBuffer.append(data, len); | - | ||||||||||||
| 2003 | #ifdef Q_OS_WIN | - | ||||||||||||
| 2004 | if (!d->stdinWriteTrigger->isActive()) | - | ||||||||||||
| 2005 | d->stdinWriteTrigger->start(); | - | ||||||||||||
| 2006 | #else | - | ||||||||||||
| 2007 | if (d->stdinChannel.notifier)
| 0-1167 | ||||||||||||
| 2008 | d->stdinChannel.notifier->setEnabled(true); executed 1167 times by 7 tests: d->stdinChannel.notifier->setEnabled(true);Executed by:
| 1167 | ||||||||||||
| 2009 | #endif | - | ||||||||||||
| 2010 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 2011 | qDebug("QProcess::writeData(%p \"%s\", %lld) == %lld (written to buffer)", | - | ||||||||||||
| 2012 | data, qt_prettyDebug(data, len, 16).constData(), len, len); | - | ||||||||||||
| 2013 | #endif | - | ||||||||||||
| 2014 | return len; executed 1167 times by 7 tests: return len;Executed by:
| 1167 | ||||||||||||
| 2015 | } | - | ||||||||||||
| 2016 | - | |||||||||||||
| 2017 | /*! | - | ||||||||||||
| 2018 | Regardless of the current read channel, this function returns all | - | ||||||||||||
| 2019 | data available from the standard output of the process as a | - | ||||||||||||
| 2020 | QByteArray. | - | ||||||||||||
| 2021 | - | |||||||||||||
| 2022 | \sa readyReadStandardOutput(), readAllStandardError(), readChannel(), setReadChannel() | - | ||||||||||||
| 2023 | */ | - | ||||||||||||
| 2024 | QByteArray QProcess::readAllStandardOutput() | - | ||||||||||||
| 2025 | { | - | ||||||||||||
| 2026 | ProcessChannel tmp = readChannel(); | - | ||||||||||||
| 2027 | setReadChannel(StandardOutput); | - | ||||||||||||
| 2028 | QByteArray data = readAll(); | - | ||||||||||||
| 2029 | setReadChannel(tmp); | - | ||||||||||||
| 2030 | return data; executed 638 times by 11 tests: return data;Executed by:
| 638 | ||||||||||||
| 2031 | } | - | ||||||||||||
| 2032 | - | |||||||||||||
| 2033 | /*! | - | ||||||||||||
| 2034 | Regardless of the current read channel, this function returns all | - | ||||||||||||
| 2035 | data available from the standard error of the process as a | - | ||||||||||||
| 2036 | QByteArray. | - | ||||||||||||
| 2037 | - | |||||||||||||
| 2038 | \sa readyReadStandardError(), readAllStandardOutput(), readChannel(), setReadChannel() | - | ||||||||||||
| 2039 | */ | - | ||||||||||||
| 2040 | QByteArray QProcess::readAllStandardError() | - | ||||||||||||
| 2041 | { | - | ||||||||||||
| 2042 | ProcessChannel tmp = readChannel(); | - | ||||||||||||
| 2043 | setReadChannel(StandardError); | - | ||||||||||||
| 2044 | QByteArray data = readAll(); | - | ||||||||||||
| 2045 | setReadChannel(tmp); | - | ||||||||||||
| 2046 | return data; executed 1882 times by 13 tests: return data;Executed by:
| 1882 | ||||||||||||
| 2047 | } | - | ||||||||||||
| 2048 | - | |||||||||||||
| 2049 | /*! | - | ||||||||||||
| 2050 | Starts the given \a program in a new process, passing the command line | - | ||||||||||||
| 2051 | arguments in \a arguments. | - | ||||||||||||
| 2052 | - | |||||||||||||
| 2053 | The QProcess object will immediately enter the Starting state. If the | - | ||||||||||||
| 2054 | process starts successfully, QProcess will emit started(); otherwise, | - | ||||||||||||
| 2055 | errorOccurred() will be emitted. | - | ||||||||||||
| 2056 | - | |||||||||||||
| 2057 | \note Processes are started asynchronously, which means the started() | - | ||||||||||||
| 2058 | and errorOccurred() signals may be delayed. Call waitForStarted() to make | - | ||||||||||||
| 2059 | sure the process has started (or has failed to start) and those signals | - | ||||||||||||
| 2060 | have been emitted. | - | ||||||||||||
| 2061 | - | |||||||||||||
| 2062 | \note No further splitting of the arguments is performed. | - | ||||||||||||
| 2063 | - | |||||||||||||
| 2064 | \b{Windows:} The arguments are quoted and joined into a command line | - | ||||||||||||
| 2065 | that is compatible with the \c CommandLineToArgvW() Windows function. | - | ||||||||||||
| 2066 | For programs that have different command line quoting requirements, | - | ||||||||||||
| 2067 | you need to use setNativeArguments(). One notable program that does | - | ||||||||||||
| 2068 | not follow the \c CommandLineToArgvW() rules is cmd.exe and, by | - | ||||||||||||
| 2069 | consequence, all batch scripts. | - | ||||||||||||
| 2070 | - | |||||||||||||
| 2071 | The OpenMode is set to \a mode. | - | ||||||||||||
| 2072 | - | |||||||||||||
| 2073 | If the QProcess object is already running a process, a warning may be | - | ||||||||||||
| 2074 | printed at the console, and the existing process will continue running | - | ||||||||||||
| 2075 | unaffected. | - | ||||||||||||
| 2076 | - | |||||||||||||
| 2077 | \sa processId(), started(), waitForStarted(), setNativeArguments() | - | ||||||||||||
| 2078 | */ | - | ||||||||||||
| 2079 | void QProcess::start(const QString &program, const QStringList &arguments, OpenMode mode) | - | ||||||||||||
| 2080 | { | - | ||||||||||||
| 2081 | Q_D(QProcess); | - | ||||||||||||
| 2082 | if (d->processState != NotRunning) {
| 0-3022 | ||||||||||||
| 2083 | qWarning("QProcess::start: Process is already running"); | - | ||||||||||||
| 2084 | return; never executed: return; | 0 | ||||||||||||
| 2085 | } | - | ||||||||||||
| 2086 | if (program.isEmpty()) {
| 1-3021 | ||||||||||||
| 2087 | d->setErrorAndEmit(QProcess::FailedToStart, tr("No program defined")); | - | ||||||||||||
| 2088 | return; executed 1 time by 1 test: return;Executed by:
| 1 | ||||||||||||
| 2089 | } | - | ||||||||||||
| 2090 | - | |||||||||||||
| 2091 | d->program = program; | - | ||||||||||||
| 2092 | d->arguments = arguments; | - | ||||||||||||
| 2093 | - | |||||||||||||
| 2094 | d->start(mode); | - | ||||||||||||
| 2095 | } executed 3021 times by 39 tests: end of blockExecuted by:
| 3021 | ||||||||||||
| 2096 | - | |||||||||||||
| 2097 | /*! | - | ||||||||||||
| 2098 | \since 5.1 | - | ||||||||||||
| 2099 | \overload | - | ||||||||||||
| 2100 | - | |||||||||||||
| 2101 | Starts the program set by setProgram() with arguments set by setArguments(). | - | ||||||||||||
| 2102 | The OpenMode is set to \a mode. | - | ||||||||||||
| 2103 | - | |||||||||||||
| 2104 | \sa open(), setProgram(), setArguments() | - | ||||||||||||
| 2105 | */ | - | ||||||||||||
| 2106 | void QProcess::start(OpenMode mode) | - | ||||||||||||
| 2107 | { | - | ||||||||||||
| 2108 | Q_D(QProcess); | - | ||||||||||||
| 2109 | if (d->processState != NotRunning) {
| 0-2 | ||||||||||||
| 2110 | qWarning("QProcess::start: Process is already running"); | - | ||||||||||||
| 2111 | return; never executed: return; | 0 | ||||||||||||
| 2112 | } | - | ||||||||||||
| 2113 | if (d->program.isEmpty()) {
| 1 | ||||||||||||
| 2114 | d->setErrorAndEmit(QProcess::FailedToStart, tr("No program defined")); | - | ||||||||||||
| 2115 | return; executed 1 time by 1 test: return;Executed by:
| 1 | ||||||||||||
| 2116 | } | - | ||||||||||||
| 2117 | - | |||||||||||||
| 2118 | d->start(mode); | - | ||||||||||||
| 2119 | } executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 2120 | - | |||||||||||||
| 2121 | /*! | - | ||||||||||||
| 2122 | Starts the program set by setProgram() with arguments set by setArguments(). | - | ||||||||||||
| 2123 | The OpenMode is set to \a mode. | - | ||||||||||||
| 2124 | - | |||||||||||||
| 2125 | This method is an alias for start(), and exists only to fully implement | - | ||||||||||||
| 2126 | the interface defined by QIODevice. | - | ||||||||||||
| 2127 | - | |||||||||||||
| 2128 | \sa start(), setProgram(), setArguments() | - | ||||||||||||
| 2129 | */ | - | ||||||||||||
| 2130 | bool QProcess::open(OpenMode mode) | - | ||||||||||||
| 2131 | { | - | ||||||||||||
| 2132 | Q_D(QProcess); | - | ||||||||||||
| 2133 | if (d->processState != NotRunning) {
| 0-2 | ||||||||||||
| 2134 | qWarning("QProcess::start: Process is already running"); | - | ||||||||||||
| 2135 | return false; never executed: return false; | 0 | ||||||||||||
| 2136 | } | - | ||||||||||||
| 2137 | if (d->program.isEmpty()) {
| 1 | ||||||||||||
| 2138 | qWarning("QProcess::start: program not set"); | - | ||||||||||||
| 2139 | return false; executed 1 time by 1 test: return false;Executed by:
| 1 | ||||||||||||
| 2140 | } | - | ||||||||||||
| 2141 | - | |||||||||||||
| 2142 | d->start(mode); | - | ||||||||||||
| 2143 | return true; executed 1 time by 1 test: return true;Executed by:
| 1 | ||||||||||||
| 2144 | } | - | ||||||||||||
| 2145 | - | |||||||||||||
| 2146 | void QProcessPrivate::start(QIODevice::OpenMode mode) | - | ||||||||||||
| 2147 | { | - | ||||||||||||
| 2148 | Q_Q(QProcess); | - | ||||||||||||
| 2149 | #if defined QPROCESS_DEBUG | - | ||||||||||||
| 2150 | qDebug() << "QProcess::start(" << program << ',' << arguments << ',' << mode << ')'; | - | ||||||||||||
| 2151 | #endif | - | ||||||||||||
| 2152 | - | |||||||||||||
| 2153 | if (stdinChannel.type != QProcessPrivate::Channel::Normal)
| 5-3018 | ||||||||||||
| 2154 | mode &= ~QIODevice::WriteOnly; // not open for writing executed 5 times by 1 test: mode &= ~QIODevice::WriteOnly;Executed by:
| 5 | ||||||||||||
| 2155 | if (stdoutChannel.type != QProcessPrivate::Channel::Normal &&
| 9-3014 | ||||||||||||
| 2156 | (stderrChannel.type != QProcessPrivate::Channel::Normal ||
| 0-9 | ||||||||||||
| 2157 | processChannelMode == QProcess::MergedChannels))
| 3-6 | ||||||||||||
| 2158 | mode &= ~QIODevice::ReadOnly; // not open for reading executed 3 times by 1 test: mode &= ~QIODevice::ReadOnly;Executed by:
| 3 | ||||||||||||
| 2159 | if (mode == 0)
| 0-3023 | ||||||||||||
| 2160 | mode = QIODevice::Unbuffered; never executed: mode = QIODevice::Unbuffered; | 0 | ||||||||||||
| 2161 | #ifndef Q_OS_WINCE | - | ||||||||||||
| 2162 | if ((mode & QIODevice::ReadOnly) == 0) {
| 4-3019 | ||||||||||||
| 2163 | if (stdoutChannel.type == QProcessPrivate::Channel::Normal)
| 1-3 | ||||||||||||
| 2164 | q->setStandardOutputFile(q->nullDevice()); executed 1 time by 1 test: q->setStandardOutputFile(q->nullDevice());Executed by:
| 1 | ||||||||||||
| 2165 | if (stderrChannel.type == QProcessPrivate::Channel::Normal
| 0-4 | ||||||||||||
| 2166 | && processChannelMode != QProcess::MergedChannels)
| 1-3 | ||||||||||||
| 2167 | q->setStandardErrorFile(q->nullDevice()); executed 1 time by 1 test: q->setStandardErrorFile(q->nullDevice());Executed by:
| 1 | ||||||||||||
| 2168 | } executed 4 times by 1 test: end of blockExecuted by:
| 4 | ||||||||||||
| 2169 | #endif | - | ||||||||||||
| 2170 | - | |||||||||||||
| 2171 | q->QIODevice::open(mode); | - | ||||||||||||
| 2172 | - | |||||||||||||
| 2173 | if (q->isReadable() && processChannelMode != QProcess::MergedChannels)
| 4-3019 | ||||||||||||
| 2174 | setReadChannelCount(2); executed 3004 times by 38 tests: setReadChannelCount(2);Executed by:
| 3004 | ||||||||||||
| 2175 | - | |||||||||||||
| 2176 | stdinChannel.closed = false; | - | ||||||||||||
| 2177 | stdoutChannel.closed = false; | - | ||||||||||||
| 2178 | stderrChannel.closed = false; | - | ||||||||||||
| 2179 | - | |||||||||||||
| 2180 | exitCode = 0; | - | ||||||||||||
| 2181 | exitStatus = QProcess::NormalExit; | - | ||||||||||||
| 2182 | processError = QProcess::UnknownError; | - | ||||||||||||
| 2183 | errorString.clear(); | - | ||||||||||||
| 2184 | startProcess(); | - | ||||||||||||
| 2185 | } executed 3023 times by 39 tests: end of blockExecuted by:
| 3023 | ||||||||||||
| 2186 | - | |||||||||||||
| 2187 | - | |||||||||||||
| 2188 | static QStringList parseCombinedArgString(const QString &program) | - | ||||||||||||
| 2189 | { | - | ||||||||||||
| 2190 | QStringList args; | - | ||||||||||||
| 2191 | QString tmp; | - | ||||||||||||
| 2192 | int quoteCount = 0; | - | ||||||||||||
| 2193 | bool inQuote = false; | - | ||||||||||||
| 2194 | - | |||||||||||||
| 2195 | // handle quoting. tokens can be surrounded by double quotes | - | ||||||||||||
| 2196 | // "hello world". three consecutive double quotes represent | - | ||||||||||||
| 2197 | // the quote character itself. | - | ||||||||||||
| 2198 | for (int i = 0; i < program.size(); ++i) {
| 1327-60345 | ||||||||||||
| 2199 | if (program.at(i) == QLatin1Char('"')) {
| 372-59973 | ||||||||||||
| 2200 | ++quoteCount; | - | ||||||||||||
| 2201 | if (quoteCount == 3) {
| 84-288 | ||||||||||||
| 2202 | // third consecutive quote | - | ||||||||||||
| 2203 | quoteCount = 0; | - | ||||||||||||
| 2204 | tmp += program.at(i); | - | ||||||||||||
| 2205 | } executed 84 times by 1 test: end of blockExecuted by:
| 84 | ||||||||||||
| 2206 | continue; executed 372 times by 1 test: continue;Executed by:
| 372 | ||||||||||||
| 2207 | } | - | ||||||||||||
| 2208 | if (quoteCount) {
| 99-59874 | ||||||||||||
| 2209 | if (quoteCount == 1)
| 6-93 | ||||||||||||
| 2210 | inQuote = !inQuote; executed 93 times by 1 test: inQuote = !inQuote;Executed by:
| 93 | ||||||||||||
| 2211 | quoteCount = 0; | - | ||||||||||||
| 2212 | } executed 99 times by 1 test: end of blockExecuted by:
| 99 | ||||||||||||
| 2213 | if (!inQuote && program.at(i).isSpace()) {
| 330-59079 | ||||||||||||
| 2214 | if (!tmp.isEmpty()) {
| 13-317 | ||||||||||||
| 2215 | args += tmp; | - | ||||||||||||
| 2216 | tmp.clear(); | - | ||||||||||||
| 2217 | } executed 317 times by 4 tests: end of blockExecuted by:
| 317 | ||||||||||||
| 2218 | } else { executed 330 times by 4 tests: end of blockExecuted by:
| 330 | ||||||||||||
| 2219 | tmp += program.at(i); | - | ||||||||||||
| 2220 | } executed 59643 times by 16 tests: end of blockExecuted by:
| 59643 | ||||||||||||
| 2221 | } | - | ||||||||||||
| 2222 | if (!tmp.isEmpty())
| 10-1317 | ||||||||||||
| 2223 | args += tmp; executed 1317 times by 16 tests: args += tmp;Executed by:
| 1317 | ||||||||||||
| 2224 | - | |||||||||||||
| 2225 | return args; executed 1327 times by 16 tests: return args;Executed by:
| 1327 | ||||||||||||
| 2226 | } | - | ||||||||||||
| 2227 | - | |||||||||||||
| 2228 | /*! | - | ||||||||||||
| 2229 | \overload | - | ||||||||||||
| 2230 | - | |||||||||||||
| 2231 | Starts the command \a command in a new process. | - | ||||||||||||
| 2232 | The OpenMode is set to \a mode. | - | ||||||||||||
| 2233 | - | |||||||||||||
| 2234 | \a command is a single string of text containing both the program name | - | ||||||||||||
| 2235 | and its arguments. The arguments are separated by one or more spaces. | - | ||||||||||||
| 2236 | For example: | - | ||||||||||||
| 2237 | - | |||||||||||||
| 2238 | \snippet code/src_corelib_io_qprocess.cpp 5 | - | ||||||||||||
| 2239 | - | |||||||||||||
| 2240 | Arguments containing spaces must be quoted to be correctly supplied to | - | ||||||||||||
| 2241 | the new process. For example: | - | ||||||||||||
| 2242 | - | |||||||||||||
| 2243 | \snippet code/src_corelib_io_qprocess.cpp 6 | - | ||||||||||||
| 2244 | - | |||||||||||||
| 2245 | Literal quotes in the \a command string are represented by triple quotes. | - | ||||||||||||
| 2246 | For example: | - | ||||||||||||
| 2247 | - | |||||||||||||
| 2248 | \snippet code/src_corelib_io_qprocess.cpp 7 | - | ||||||||||||
| 2249 | - | |||||||||||||
| 2250 | After the \a command string has been split and unquoted, this function | - | ||||||||||||
| 2251 | behaves like the overload which takes the arguments as a string list. | - | ||||||||||||
| 2252 | - | |||||||||||||
| 2253 | You can disable this overload by defining \c | - | ||||||||||||
| 2254 | QT_NO_PROCESS_COMBINED_ARGUMENT_START when you compile your applications. | - | ||||||||||||
| 2255 | This can be useful if you want to ensure that you are not splitting arguments | - | ||||||||||||
| 2256 | unintentionally, for example. In virtually all cases, using the other overload | - | ||||||||||||
| 2257 | is the preferred method. | - | ||||||||||||
| 2258 | - | |||||||||||||
| 2259 | On operating systems where the system API for passing command line | - | ||||||||||||
| 2260 | arguments to a subprocess natively uses a single string (Windows), one can | - | ||||||||||||
| 2261 | conceive command lines which cannot be passed via QProcess's portable | - | ||||||||||||
| 2262 | list-based API. In these rare cases you need to use setProgram() and | - | ||||||||||||
| 2263 | setNativeArguments() instead of this function. | - | ||||||||||||
| 2264 | - | |||||||||||||
| 2265 | */ | - | ||||||||||||
| 2266 | #if !defined(QT_NO_PROCESS_COMBINED_ARGUMENT_START) | - | ||||||||||||
| 2267 | void QProcess::start(const QString &command, OpenMode mode) | - | ||||||||||||
| 2268 | { | - | ||||||||||||
| 2269 | QStringList args = parseCombinedArgString(command); | - | ||||||||||||
| 2270 | if (args.isEmpty()) {
| 4-1318 | ||||||||||||
| 2271 | Q_D(QProcess); | - | ||||||||||||
| 2272 | d->setErrorAndEmit(QProcess::FailedToStart, tr("No program defined")); | - | ||||||||||||
| 2273 | return; executed 4 times by 1 test: return;Executed by:
| 4 | ||||||||||||
| 2274 | } | - | ||||||||||||
| 2275 | - | |||||||||||||
| 2276 | const QString prog = args.takeFirst(); | - | ||||||||||||
| 2277 | - | |||||||||||||
| 2278 | start(prog, args, mode); | - | ||||||||||||
| 2279 | } executed 1318 times by 16 tests: end of blockExecuted by:
| 1318 | ||||||||||||
| 2280 | #endif | - | ||||||||||||
| 2281 | - | |||||||||||||
| 2282 | /*! | - | ||||||||||||
| 2283 | \since 5.0 | - | ||||||||||||
| 2284 | - | |||||||||||||
| 2285 | Returns the program the process was last started with. | - | ||||||||||||
| 2286 | - | |||||||||||||
| 2287 | \sa start() | - | ||||||||||||
| 2288 | */ | - | ||||||||||||
| 2289 | QString QProcess::program() const | - | ||||||||||||
| 2290 | { | - | ||||||||||||
| 2291 | Q_D(const QProcess); | - | ||||||||||||
| 2292 | return d->program; executed 2 times by 2 tests: return d->program;Executed by:
| 2 | ||||||||||||
| 2293 | } | - | ||||||||||||
| 2294 | - | |||||||||||||
| 2295 | /*! | - | ||||||||||||
| 2296 | \since 5.1 | - | ||||||||||||
| 2297 | - | |||||||||||||
| 2298 | Set the \a program to use when starting the process. | - | ||||||||||||
| 2299 | This function must be called before start(). | - | ||||||||||||
| 2300 | - | |||||||||||||
| 2301 | \sa start(), setArguments(), program() | - | ||||||||||||
| 2302 | */ | - | ||||||||||||
| 2303 | void QProcess::setProgram(const QString &program) | - | ||||||||||||
| 2304 | { | - | ||||||||||||
| 2305 | Q_D(QProcess); | - | ||||||||||||
| 2306 | if (d->processState != NotRunning) {
| 0-2 | ||||||||||||
| 2307 | qWarning("QProcess::setProgram: Process is already running"); | - | ||||||||||||
| 2308 | return; never executed: return; | 0 | ||||||||||||
| 2309 | } | - | ||||||||||||
| 2310 | d->program = program; | - | ||||||||||||
| 2311 | } executed 2 times by 1 test: end of blockExecuted by:
| 2 | ||||||||||||
| 2312 | - | |||||||||||||
| 2313 | /*! | - | ||||||||||||
| 2314 | \since 5.0 | - | ||||||||||||
| 2315 | - | |||||||||||||
| 2316 | Returns the command line arguments the process was last started with. | - | ||||||||||||
| 2317 | - | |||||||||||||
| 2318 | \sa start() | - | ||||||||||||
| 2319 | */ | - | ||||||||||||
| 2320 | QStringList QProcess::arguments() const | - | ||||||||||||
| 2321 | { | - | ||||||||||||
| 2322 | Q_D(const QProcess); | - | ||||||||||||
| 2323 | return d->arguments; executed 1 time by 1 test: return d->arguments;Executed by:
| 1 | ||||||||||||
| 2324 | } | - | ||||||||||||
| 2325 | - | |||||||||||||
| 2326 | /*! | - | ||||||||||||
| 2327 | \since 5.1 | - | ||||||||||||
| 2328 | - | |||||||||||||
| 2329 | Set the \a arguments to pass to the called program when starting the process. | - | ||||||||||||
| 2330 | This function must be called before start(). | - | ||||||||||||
| 2331 | - | |||||||||||||
| 2332 | \sa start(), setProgram(), arguments() | - | ||||||||||||
| 2333 | */ | - | ||||||||||||
| 2334 | void QProcess::setArguments(const QStringList &arguments) | - | ||||||||||||
| 2335 | { | - | ||||||||||||
| 2336 | Q_D(QProcess); | - | ||||||||||||
| 2337 | if (d->processState != NotRunning) {
| 0-1 | ||||||||||||
| 2338 | qWarning("QProcess::setProgram: Process is already running"); | - | ||||||||||||
| 2339 | return; never executed: return; | 0 | ||||||||||||
| 2340 | } | - | ||||||||||||
| 2341 | d->arguments = arguments; | - | ||||||||||||
| 2342 | } executed 1 time by 1 test: end of blockExecuted by:
| 1 | ||||||||||||
| 2343 | - | |||||||||||||
| 2344 | /*! | - | ||||||||||||
| 2345 | Attempts to terminate the process. | - | ||||||||||||
| 2346 | - | |||||||||||||
| 2347 | The process may not exit as a result of calling this function (it is given | - | ||||||||||||
| 2348 | the chance to prompt the user for any unsaved files, etc). | - | ||||||||||||
| 2349 | - | |||||||||||||
| 2350 | On Windows, terminate() posts a WM_CLOSE message to all top-level windows | - | ||||||||||||
| 2351 | of the process and then to the main thread of the process itself. On Unix | - | ||||||||||||
| 2352 | and \macos the \c SIGTERM signal is sent. | - | ||||||||||||
| 2353 | - | |||||||||||||
| 2354 | Console applications on Windows that do not run an event loop, or whose | - | ||||||||||||
| 2355 | event loop does not handle the WM_CLOSE message, can only be terminated by | - | ||||||||||||
| 2356 | calling kill(). | - | ||||||||||||
| 2357 | - | |||||||||||||
| 2358 | \sa kill() | - | ||||||||||||
| 2359 | */ | - | ||||||||||||
| 2360 | void QProcess::terminate() | - | ||||||||||||
| 2361 | { | - | ||||||||||||
| 2362 | Q_D(QProcess); | - | ||||||||||||
| 2363 | d->terminateProcess(); | - | ||||||||||||
| 2364 | } executed 14 times by 3 tests: end of blockExecuted by:
| 14 | ||||||||||||
| 2365 | - | |||||||||||||
| 2366 | /*! | - | ||||||||||||
| 2367 | Kills the current process, causing it to exit immediately. | - | ||||||||||||
| 2368 | - | |||||||||||||
| 2369 | On Windows, kill() uses TerminateProcess, and on Unix and \macos, the | - | ||||||||||||
| 2370 | SIGKILL signal is sent to the process. | - | ||||||||||||
| 2371 | - | |||||||||||||
| 2372 | \sa terminate() | - | ||||||||||||
| 2373 | */ | - | ||||||||||||
| 2374 | void QProcess::kill() | - | ||||||||||||
| 2375 | { | - | ||||||||||||
| 2376 | Q_D(QProcess); | - | ||||||||||||
| 2377 | d->killProcess(); | - | ||||||||||||
| 2378 | } executed 15 times by 7 tests: end of blockExecuted by:
| 15 | ||||||||||||
| 2379 | - | |||||||||||||
| 2380 | /*! | - | ||||||||||||
| 2381 | Returns the exit code of the last process that finished. | - | ||||||||||||
| 2382 | - | |||||||||||||
| 2383 | This value is not valid unless exitStatus() returns NormalExit. | - | ||||||||||||
| 2384 | */ | - | ||||||||||||
| 2385 | int QProcess::exitCode() const | - | ||||||||||||
| 2386 | { | - | ||||||||||||
| 2387 | Q_D(const QProcess); | - | ||||||||||||
| 2388 | return d->exitCode; executed 1261 times by 13 tests: return d->exitCode;Executed by:
| 1261 | ||||||||||||
| 2389 | } | - | ||||||||||||
| 2390 | - | |||||||||||||
| 2391 | /*! | - | ||||||||||||
| 2392 | \since 4.1 | - | ||||||||||||
| 2393 | - | |||||||||||||
| 2394 | Returns the exit status of the last process that finished. | - | ||||||||||||
| 2395 | - | |||||||||||||
| 2396 | On Windows, if the process was terminated with TerminateProcess() from | - | ||||||||||||
| 2397 | another application, this function will still return NormalExit | - | ||||||||||||
| 2398 | unless the exit code is less than 0. | - | ||||||||||||
| 2399 | */ | - | ||||||||||||
| 2400 | QProcess::ExitStatus QProcess::exitStatus() const | - | ||||||||||||
| 2401 | { | - | ||||||||||||
| 2402 | Q_D(const QProcess); | - | ||||||||||||
| 2403 | return d->exitStatus; executed 1508 times by 11 tests: return d->exitStatus;Executed by:
| 1508 | ||||||||||||
| 2404 | } | - | ||||||||||||
| 2405 | - | |||||||||||||
| 2406 | /*! | - | ||||||||||||
| 2407 | Starts the program \a program with the arguments \a arguments in a | - | ||||||||||||
| 2408 | new process, waits for it to finish, and then returns the exit | - | ||||||||||||
| 2409 | code of the process. Any data the new process writes to the | - | ||||||||||||
| 2410 | console is forwarded to the calling process. | - | ||||||||||||
| 2411 | - | |||||||||||||
| 2412 | The environment and working directory are inherited from the calling | - | ||||||||||||
| 2413 | process. | - | ||||||||||||
| 2414 | - | |||||||||||||
| 2415 | Argument handling is identical to the respective start() overload. | - | ||||||||||||
| 2416 | - | |||||||||||||
| 2417 | If the process cannot be started, -2 is returned. If the process | - | ||||||||||||
| 2418 | crashes, -1 is returned. Otherwise, the process' exit code is | - | ||||||||||||
| 2419 | returned. | - | ||||||||||||
| 2420 | - | |||||||||||||
| 2421 | \sa start() | - | ||||||||||||
| 2422 | */ | - | ||||||||||||
| 2423 | int QProcess::execute(const QString &program, const QStringList &arguments) | - | ||||||||||||
| 2424 | { | - | ||||||||||||
| 2425 | QProcess process; | - | ||||||||||||
| 2426 | process.setReadChannelMode(ForwardedChannels); | - | ||||||||||||
| 2427 | process.start(program, arguments); | - | ||||||||||||
| 2428 | if (!process.waitForFinished(-1) || process.error() == FailedToStart)
| 0-4 | ||||||||||||
| 2429 | return -2; executed 4 times by 1 test: return -2;Executed by:
| 4 | ||||||||||||
| 2430 | return process.exitStatus() == QProcess::NormalExit ? process.exitCode() : -1; executed 1 time by 1 test: return process.exitStatus() == QProcess::NormalExit ? process.exitCode() : -1;Executed by:
| 1 | ||||||||||||
| 2431 | } | - | ||||||||||||
| 2432 | - | |||||||||||||
| 2433 | /*! | - | ||||||||||||
| 2434 | \overload | - | ||||||||||||
| 2435 | - | |||||||||||||
| 2436 | Starts the program \a command in a new process, waits for it to finish, | - | ||||||||||||
| 2437 | and then returns the exit code. | - | ||||||||||||
| 2438 | - | |||||||||||||
| 2439 | Argument handling is identical to the respective start() overload. | - | ||||||||||||
| 2440 | - | |||||||||||||
| 2441 | After the \a command string has been split and unquoted, this function | - | ||||||||||||
| 2442 | behaves like the overload which takes the arguments as a string list. | - | ||||||||||||
| 2443 | - | |||||||||||||
| 2444 | \sa start() | - | ||||||||||||
| 2445 | */ | - | ||||||||||||
| 2446 | int QProcess::execute(const QString &command) | - | ||||||||||||
| 2447 | { | - | ||||||||||||
| 2448 | QProcess process; | - | ||||||||||||
| 2449 | process.setReadChannelMode(ForwardedChannels); | - | ||||||||||||
| 2450 | process.start(command); | - | ||||||||||||
| 2451 | if (!process.waitForFinished(-1) || process.error() == FailedToStart)
| 0-4 | ||||||||||||
| 2452 | return -2; executed 4 times by 3 tests: return -2;Executed by:
| 4 | ||||||||||||
| 2453 | return process.exitStatus() == QProcess::NormalExit ? process.exitCode() : -1; never executed: return process.exitStatus() == QProcess::NormalExit ? process.exitCode() : -1; | 0 | ||||||||||||
| 2454 | } | - | ||||||||||||
| 2455 | - | |||||||||||||
| 2456 | /*! | - | ||||||||||||
| 2457 | Starts the program \a program with the arguments \a arguments in a | - | ||||||||||||
| 2458 | new process, and detaches from it. Returns \c true on success; | - | ||||||||||||
| 2459 | otherwise returns \c false. If the calling process exits, the | - | ||||||||||||
| 2460 | detached process will continue to run unaffected. | - | ||||||||||||
| 2461 | - | |||||||||||||
| 2462 | Argument handling is identical to the respective start() overload. | - | ||||||||||||
| 2463 | - | |||||||||||||
| 2464 | \b{Unix:} The started process will run in its own session and act | - | ||||||||||||
| 2465 | like a daemon. | - | ||||||||||||
| 2466 | - | |||||||||||||
| 2467 | The process will be started in the directory \a workingDirectory. | - | ||||||||||||
| 2468 | If \a workingDirectory is empty, the working directory is inherited | - | ||||||||||||
| 2469 | from the calling process. | - | ||||||||||||
| 2470 | - | |||||||||||||
| 2471 | \note On QNX, this may cause all application threads to | - | ||||||||||||
| 2472 | temporarily freeze. | - | ||||||||||||
| 2473 | - | |||||||||||||
| 2474 | If the function is successful then *\a pid is set to the process | - | ||||||||||||
| 2475 | identifier of the started process. | - | ||||||||||||
| 2476 | - | |||||||||||||
| 2477 | \sa start() | - | ||||||||||||
| 2478 | */ | - | ||||||||||||
| 2479 | bool QProcess::startDetached(const QString &program, | - | ||||||||||||
| 2480 | const QStringList &arguments, | - | ||||||||||||
| 2481 | const QString &workingDirectory, | - | ||||||||||||
| 2482 | qint64 *pid) | - | ||||||||||||
| 2483 | { | - | ||||||||||||
| 2484 | return QProcessPrivate::startDetached(program, executed 1 time by 1 test: return QProcessPrivate::startDetached(program, arguments, workingDirectory, pid);Executed by:
| 1 | ||||||||||||
| 2485 | arguments, executed 1 time by 1 test: return QProcessPrivate::startDetached(program, arguments, workingDirectory, pid);Executed by:
| 1 | ||||||||||||
| 2486 | workingDirectory, executed 1 time by 1 test: return QProcessPrivate::startDetached(program, arguments, workingDirectory, pid);Executed by:
| 1 | ||||||||||||
| 2487 | pid); executed 1 time by 1 test: return QProcessPrivate::startDetached(program, arguments, workingDirectory, pid);Executed by:
| 1 | ||||||||||||
| 2488 | } | - | ||||||||||||
| 2489 | - | |||||||||||||
| 2490 | /*! | - | ||||||||||||
| 2491 | \internal | - | ||||||||||||
| 2492 | */ | - | ||||||||||||
| 2493 | bool QProcess::startDetached(const QString &program, | - | ||||||||||||
| 2494 | const QStringList &arguments) | - | ||||||||||||
| 2495 | { | - | ||||||||||||
| 2496 | return QProcessPrivate::startDetached(program, arguments); executed 1 time by 1 test: return QProcessPrivate::startDetached(program, arguments);Executed by:
| 1 | ||||||||||||
| 2497 | } | - | ||||||||||||
| 2498 | - | |||||||||||||
| 2499 | /*! | - | ||||||||||||
| 2500 | \overload | - | ||||||||||||
| 2501 | - | |||||||||||||
| 2502 | Starts the command \a command in a new process, and detaches from it. | - | ||||||||||||
| 2503 | Returns \c true on success; otherwise returns \c false. | - | ||||||||||||
| 2504 | - | |||||||||||||
| 2505 | Argument handling is identical to the respective start() overload. | - | ||||||||||||
| 2506 | - | |||||||||||||
| 2507 | After the \a command string has been split and unquoted, this function | - | ||||||||||||
| 2508 | behaves like the overload which takes the arguments as a string list. | - | ||||||||||||
| 2509 | - | |||||||||||||
| 2510 | \sa start(const QString &command, OpenMode mode) | - | ||||||||||||
| 2511 | */ | - | ||||||||||||
| 2512 | bool QProcess::startDetached(const QString &command) | - | ||||||||||||
| 2513 | { | - | ||||||||||||
| 2514 | QStringList args = parseCombinedArgString(command); | - | ||||||||||||
| 2515 | if (args.isEmpty())
| 2-3 | ||||||||||||
| 2516 | return false; executed 3 times by 1 test: return false;Executed by:
| 3 | ||||||||||||
| 2517 | - | |||||||||||||
| 2518 | const QString prog = args.takeFirst(); | - | ||||||||||||
| 2519 | - | |||||||||||||
| 2520 | return QProcessPrivate::startDetached(prog, args); executed 2 times by 1 test: return QProcessPrivate::startDetached(prog, args);Executed by:
| 2 | ||||||||||||
| 2521 | } | - | ||||||||||||
| 2522 | - | |||||||||||||
| 2523 | QT_BEGIN_INCLUDE_NAMESPACE | - | ||||||||||||
| 2524 | #if defined(Q_OS_MACX) | - | ||||||||||||
| 2525 | # include <crt_externs.h> | - | ||||||||||||
| 2526 | # define environ (*_NSGetEnviron()) | - | ||||||||||||
| 2527 | #elif defined(Q_OS_WINCE) || defined(Q_OS_IOS) | - | ||||||||||||
| 2528 | static char *qt_empty_environ[] = { 0 }; | - | ||||||||||||
| 2529 | #define environ qt_empty_environ | - | ||||||||||||
| 2530 | #elif !defined(Q_OS_WIN) | - | ||||||||||||
| 2531 | extern char **environ; | - | ||||||||||||
| 2532 | #endif | - | ||||||||||||
| 2533 | QT_END_INCLUDE_NAMESPACE | - | ||||||||||||
| 2534 | - | |||||||||||||
| 2535 | /*! | - | ||||||||||||
| 2536 | \since 4.1 | - | ||||||||||||
| 2537 | - | |||||||||||||
| 2538 | Returns the environment of the calling process as a list of | - | ||||||||||||
| 2539 | key=value pairs. Example: | - | ||||||||||||
| 2540 | - | |||||||||||||
| 2541 | \snippet code/src_corelib_io_qprocess.cpp 8 | - | ||||||||||||
| 2542 | - | |||||||||||||
| 2543 | This function does not cache the system environment. Therefore, it's | - | ||||||||||||
| 2544 | possible to obtain an updated version of the environment if low-level C | - | ||||||||||||
| 2545 | library functions like \tt setenv or \tt putenv have been called. | - | ||||||||||||
| 2546 | - | |||||||||||||
| 2547 | However, note that repeated calls to this function will recreate the | - | ||||||||||||
| 2548 | list of environment variables, which is a non-trivial operation. | - | ||||||||||||
| 2549 | - | |||||||||||||
| 2550 | \note For new code, it is recommended to use QProcessEnvironment::systemEnvironment() | - | ||||||||||||
| 2551 | - | |||||||||||||
| 2552 | \sa QProcessEnvironment::systemEnvironment(), setProcessEnvironment() | - | ||||||||||||
| 2553 | */ | - | ||||||||||||
| 2554 | QStringList QProcess::systemEnvironment() | - | ||||||||||||
| 2555 | { | - | ||||||||||||
| 2556 | QStringList tmp; | - | ||||||||||||
| 2557 | char *entry = 0; | - | ||||||||||||
| 2558 | int count = 0; | - | ||||||||||||
| 2559 | while ((entry = environ[count++]))
| 55-1651 | ||||||||||||
| 2560 | tmp << QString::fromLocal8Bit(entry); executed 1651 times by 4 tests: tmp << QString::fromLocal8Bit(entry);Executed by:
| 1651 | ||||||||||||
| 2561 | return tmp; executed 55 times by 4 tests: return tmp;Executed by:
| 55 | ||||||||||||
| 2562 | } | - | ||||||||||||
| 2563 | - | |||||||||||||
| 2564 | /*! | - | ||||||||||||
| 2565 | \fn QProcessEnvironment QProcessEnvironment::systemEnvironment() | - | ||||||||||||
| 2566 | - | |||||||||||||
| 2567 | \since 4.6 | - | ||||||||||||
| 2568 | - | |||||||||||||
| 2569 | \brief The systemEnvironment function returns the environment of | - | ||||||||||||
| 2570 | the calling process. | - | ||||||||||||
| 2571 | - | |||||||||||||
| 2572 | It is returned as a QProcessEnvironment. This function does not | - | ||||||||||||
| 2573 | cache the system environment. Therefore, it's possible to obtain | - | ||||||||||||
| 2574 | an updated version of the environment if low-level C library | - | ||||||||||||
| 2575 | functions like \tt setenv or \tt putenv have been called. | - | ||||||||||||
| 2576 | - | |||||||||||||
| 2577 | However, note that repeated calls to this function will recreate the | - | ||||||||||||
| 2578 | QProcessEnvironment object, which is a non-trivial operation. | - | ||||||||||||
| 2579 | - | |||||||||||||
| 2580 | \sa QProcess::systemEnvironment() | - | ||||||||||||
| 2581 | */ | - | ||||||||||||
| 2582 | - | |||||||||||||
| 2583 | /*! | - | ||||||||||||
| 2584 | \since 5.2 | - | ||||||||||||
| 2585 | - | |||||||||||||
| 2586 | \brief The null device of the operating system. | - | ||||||||||||
| 2587 | - | |||||||||||||
| 2588 | The returned file path uses native directory separators. | - | ||||||||||||
| 2589 | - | |||||||||||||
| 2590 | \sa QProcess::setStandardInputFile(), QProcess::setStandardOutputFile(), | - | ||||||||||||
| 2591 | QProcess::setStandardErrorFile() | - | ||||||||||||
| 2592 | */ | - | ||||||||||||
| 2593 | QString QProcess::nullDevice() | - | ||||||||||||
| 2594 | { | - | ||||||||||||
| 2595 | #ifdef Q_OS_WIN | - | ||||||||||||
| 2596 | return QStringLiteral("\\\\.\\NUL"); | - | ||||||||||||
| 2597 | #else | - | ||||||||||||
| 2598 | return QStringLiteral("/dev/null"); executed 5 times by 1 test: return ([]() -> QString { enum { Size = sizeof(u"" "/dev/null")/2 - 1 }; static const QStaticStringData<Size> qstring_literal = { { { { -1 } }, Size, 0, 0, sizeof(QStringData) }, u"" "/dev/null" }; QStringDataPtr holder = { qstring_literal.data_ptr() }; const QString qstring_literal_temp(holder); return qstring_literal_temp; }());Executed by:
executed 5 times by 1 test: return qstring_literal_temp;Executed by:
| 5 | ||||||||||||
| 2599 | #endif | - | ||||||||||||
| 2600 | } | - | ||||||||||||
| 2601 | - | |||||||||||||
| 2602 | /*! | - | ||||||||||||
| 2603 | \typedef Q_PID | - | ||||||||||||
| 2604 | \relates QProcess | - | ||||||||||||
| 2605 | - | |||||||||||||
| 2606 | Typedef for the identifiers used to represent processes on the underlying | - | ||||||||||||
| 2607 | platform. On Unix, this corresponds to \l qint64; on Windows, it | - | ||||||||||||
| 2608 | corresponds to \c{_PROCESS_INFORMATION*}. | - | ||||||||||||
| 2609 | - | |||||||||||||
| 2610 | \sa QProcess::pid() | - | ||||||||||||
| 2611 | */ | - | ||||||||||||
| 2612 | - | |||||||||||||
| 2613 | QT_END_NAMESPACE | - | ||||||||||||
| 2614 | - | |||||||||||||
| 2615 | #include "moc_qprocess.cpp" | - | ||||||||||||
| 2616 | - | |||||||||||||
| 2617 | #endif // QT_NO_PROCESS | - | ||||||||||||
| 2618 | - | |||||||||||||
| Source code | Switch to Preprocessed file |