src/corelib/io/qprocess.cpp
changeset 22 79de32ba3296
parent 18 2f34d5167611
child 30 5dc02b23752f
equal deleted inserted replaced
19:fcece45ef507 22:79de32ba3296
   549     If you attempt to use QProcess to execute these commands directly,
   549     If you attempt to use QProcess to execute these commands directly,
   550     it won't work. One possible solution is to execute the command
   550     it won't work. One possible solution is to execute the command
   551     interpreter itself (\c{cmd.exe} on some Windows systems), and ask
   551     interpreter itself (\c{cmd.exe} on some Windows systems), and ask
   552     the interpreter to execute the desired command.
   552     the interpreter to execute the desired command.
   553 
   553 
       
   554     \section1 Symbian Platform Security Requirements
       
   555 
       
   556     On Symbian, processes which use the functions kill() or terminate()
       
   557     must have the \c PowerMgmt platform security capability. If the client
       
   558     process lacks this capability, these functions will fail.
       
   559 
       
   560     Platform security capabilities are added via the
       
   561     \l{qmake-variable-reference.html#target-capability}{TARGET.CAPABILITY}
       
   562     qmake variable.
       
   563 
   554     \sa QBuffer, QFile, QTcpSocket
   564     \sa QBuffer, QFile, QTcpSocket
   555 */
   565 */
   556 
   566 
   557 /*!
   567 /*!
   558     \enum QProcess::ProcessChannel
   568     \enum QProcess::ProcessChannel
  2004 
  2014 
  2005     Console applications on Windows that do not run an event loop, or whose
  2015     Console applications on Windows that do not run an event loop, or whose
  2006     event loop does not handle the WM_CLOSE message, can only be terminated by
  2016     event loop does not handle the WM_CLOSE message, can only be terminated by
  2007     calling kill().
  2017     calling kill().
  2008 
  2018 
       
  2019     On Symbian, this function requires platform security capability
       
  2020     \c PowerMgmt. If absent, the process will panic with KERN-EXEC 46.
       
  2021 
  2009     \note Terminating running processes from other processes will typically
  2022     \note Terminating running processes from other processes will typically
  2010     cause a panic in Symbian due to platform security.
  2023     cause a panic in Symbian due to platform security.
  2011 
  2024 
       
  2025     \sa \l {Symbian Platform Security Requirements}
  2012     \sa kill()
  2026     \sa kill()
  2013 */
  2027 */
  2014 void QProcess::terminate()
  2028 void QProcess::terminate()
  2015 {
  2029 {
  2016     Q_D(QProcess);
  2030     Q_D(QProcess);
  2021     Kills the current process, causing it to exit immediately.
  2035     Kills the current process, causing it to exit immediately.
  2022 
  2036 
  2023     On Windows, kill() uses TerminateProcess, and on Unix and Mac OS X, the
  2037     On Windows, kill() uses TerminateProcess, and on Unix and Mac OS X, the
  2024     SIGKILL signal is sent to the process.
  2038     SIGKILL signal is sent to the process.
  2025 
  2039 
       
  2040     On Symbian, this function requires platform security capability
       
  2041     \c PowerMgmt. If absent, the process will panic with KERN-EXEC 46.
       
  2042 
       
  2043     \sa \l {Symbian Platform Security Requirements}
  2026     \sa terminate()
  2044     \sa terminate()
  2027 */
  2045 */
  2028 void QProcess::kill()
  2046 void QProcess::kill()
  2029 {
  2047 {
  2030     Q_D(QProcess);
  2048     Q_D(QProcess);