/* This file is part of the KDE libraries
Copyright (C) 1997 Christian Czezakte (e9025461@student.tuwien.ac.at)
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
//
// KPROCESSCONTROLLER -- A helper class for KProcess
//
// version 0.3.1, Jan 8th 1997
//
// (C) Christian Czezatke
// e9025461@student.tuwien.ac.at
//
#ifndef __KPROCCTRL_H__
#define __KPROCCTRL_H__
#include
#include
#include "kprocess.h"
class KProcessControllerPrivate;
class QSocketNotifier;
/**
* @short Used internally by @ref KProcess
* @internal
* @author Christian Czezakte
*
* A class for internal use by KProcess only. -- Exactly one instance
* of this class is generated by the first instance of KProcess that is
* created (a pointer to it gets stored in @ref theKProcessController ).
*
* This class takes care of the actual (UN*X) signal handling.
*/
class KProcessController : public QObject
{
Q_OBJECT
public:
KProcessController();
~KProcessController();
//CC: WARNING! Destructor Not virtual (but you don't derive classes from this anyhow...)
public:
/**
* Only a single instance of this class is allowed at a time,
* and this static variable is used to track the one instance.
*/
static KProcessController *theKProcessController;
/**
* Automatically called upon SIGCHLD.
*
* Normally you do not need to do anything with this function but
* if your application needs to disable SIGCHLD for some time for
* reasons beyond your control, you should call this function afterwards
* to make sure that no SIGCHLDs where missed.
*/
static void theSigCHLDHandler(int signal);
// handler for sigchld
/**
* @internal
*/
static void setupHandlers();
/**
* @internal
*/
static void resetHandlers();
/**
* @internal
*/
void addKProcess( KProcess* );
/**
* @internal
*/
void removeKProcess( KProcess* );
/**
* Wait for any process to exit and handle their exit without
* starting an event loop.
* This function may cause KProcess to emit any of its signals.
*
* @param timeout the timeout in seconds
* @return true if a process exited, false
* if no process exited within @p timeout seconds.
* @since 3.1
*/
bool waitForProcessExit(int timeout);
public slots:
/**
* @internal
*/
void slotDoHousekeeping(int socket);
private slots:
void delayedChildrenCleanup();
private:
int fd[2];
QSocketNotifier *notifier;
static struct sigaction oldChildHandlerData;
static bool handlerSet;
QValueList processList;
QTimer delayedChildrenCleanupTimer;
// Disallow assignment and copy-construction
KProcessController( const KProcessController& );
KProcessController& operator= ( const KProcessController& );
KProcessControllerPrivate *d;
};
#endif
| Generated by: root on sparc64.ports.openbsd.org on Sun Sep 14 00:02:40 2003, using kdoc 2.0a54. |