KShellProcess Class Reference

A class derived from KProcess to start child processes through a shell. More...

#include <kprocess.h>

Inheritance diagram for KShellProcess:

KProcess QObject

List of all members.


Public Member Functions

 KShellProcess (const char *shellname=0)
 ~KShellProcess ()
virtual bool start (RunMode runmode=NotifyOnExit, Communication comm=NoCommunication)

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.

Deprecated:
Use KProcess and KProcess::setUseShell(true) instead.

Author:
Christian Czezatke <e9025461@student.tuwien.ac.at>

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 (  ) 

Destructor.

Definition at line 1121 of file kprocess.cpp.


Member Function Documentation

QString KShellProcess::quote ( const QString arg  )  [static]

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.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys