KDECore
KShellProcess Class Reference
A class derived from KProcess to start child processes through a shell. More...
#include <kprocess.h>
Public Member Functions | |
KShellProcess (const char *shellname=0) | |
virtual bool | start (RunMode runmode=NotifyOnExit, Communication comm=NoCommunication) |
~KShellProcess () | |
Static Public Member Functions | |
static QString | quote (const QString &arg) |
Protected Member Functions | |
virtual void | virtual_hook (int id, void *data) |
Detailed Description
A class derived from KProcess to start child processes through a shell.Use KProcess and KProcess::setUseShell(true) instead.
Definition at line 899 of file kprocess.h.
Constructor & Destructor Documentation
KShellProcess::KShellProcess | ( | const char * | shellname = 0 |
) |
Constructor.
If no shellname is specified, the user's default shell is used.
Definition at line 1115 of file kprocess.cpp.
KShellProcess::~KShellProcess | ( | ) |
Member Function Documentation
This function can be used to quote an argument string such that the shell processes it properly.
This is e. g. necessary for user-provided file names which may contain spaces or quotes. It also prevents expansion of wild cards and environment variables.
- Parameters:
-
arg the argument to quote
- Returns:
- the quoted argument
- Since:
- 3.1
Reimplemented from KProcess.
Definition at line 1124 of file kprocess.cpp.
bool KShellProcess::start | ( | RunMode | runmode = NotifyOnExit , |
|
Communication | comm = NoCommunication | |||
) | [virtual] |
Starts the process.
For a detailed description of the various run modes and communication semantics, have a look at the general description of the KProcess class. Note that if you use setUsePty( Stdout | Stderr, <bool> ), you cannot use Stdout | Stderr here - instead, use Stdout only to receive the mixed output.
The following problems could cause this function to return false:
- The process is already running.
- The command line argument list is empty.
- The the
comm
parameter is incompatible with the selected pty usage. - The starting of the process failed (could not fork).
- The executable was not found.
- Parameters:
-
runmode The Run-mode for the process. comm Specifies which communication links should be established to the child process (stdin/stdout/stderr). By default, no communication takes place and the respective communication signals will never get emitted.
- Returns:
- true on success, false on error (see above for error conditions)
Reimplemented from KProcess.
Definition at line 1129 of file kprocess.cpp.
void KShellProcess::virtual_hook | ( | int | id, | |
void * | data | |||
) | [protected, virtual] |
The documentation for this class was generated from the following files: