summaryrefslogtreecommitdiff
path: root/qtermwidget/k3processcontroller.h
diff options
context:
space:
mode:
Diffstat (limited to 'qtermwidget/k3processcontroller.h')
-rw-r--r--qtermwidget/k3processcontroller.h137
1 files changed, 137 insertions, 0 deletions
diff --git a/qtermwidget/k3processcontroller.h b/qtermwidget/k3processcontroller.h
new file mode 100644
index 0000000..c077af2
--- /dev/null
+++ b/qtermwidget/k3processcontroller.h
@@ -0,0 +1,137 @@
+/* This file is part of the KDE libraries
+ Copyright (C) 1997 Christian Czezakte (e9025461@student.tuwien.ac.at)
+
+ Rewritten for QT4 by e_k <e_k at users.sourceforge.net>, Copyright (C)2008
+
+ 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., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
+*/
+
+#ifndef K3PROCCTRL_H
+#define K3PROCCTRL_H
+
+#include <QtCore/QList>
+#include <k3process.h>
+
+
+/**
+ * @short Used internally by K3Process
+ * @internal
+ * @author Christian Czezatke <e9025461@student.tuwien.ac.at>
+ *
+ * A class for internal use by K3Process only. -- Exactly one instance
+ * of this class is created by KApplication.
+ *
+ * This class takes care of the actual (UN*X) signal handling.
+ */
+class K3ProcessController : public QObject
+{
+ Q_OBJECT
+
+public:
+ /**
+ * Create an instance if none exists yet.
+ * Called by KApplication::KApplication()
+ */
+ static void ref();
+
+ /**
+ * Destroy the instance if one exists and it is not referenced any more.
+ * Called by KApplication::~KApplication()
+ */
+ static void deref();
+
+ /**
+ * Only a single instance of this class is allowed at a time.
+ * This method provides access to that instance.
+ */
+ static K3ProcessController *instance();
+
+ /**
+ * Automatically called upon SIGCHLD. Never call it directly.
+ * If your application (or some library it uses) redirects SIGCHLD,
+ * the new signal handler (and only it) should call the old handler
+ * returned by sigaction().
+ * @internal
+ */
+ static void theSigCHLDHandler(int signal); // KDE4: private
+
+ /**
+ * Wait for any process to exit and handle their exit without
+ * starting an event loop.
+ * This function may cause K3Process to emit any of its signals.
+ *
+ * @param timeout the timeout in seconds. -1 means no timeout.
+ * @return true if a process exited, false
+ * if no process exited within @p timeout seconds.
+ */
+ bool waitForProcessExit(int timeout);
+
+ /**
+ * Call this function to defer processing of the data that became available
+ * on notifierFd().
+ */
+ void unscheduleCheck();
+
+ /**
+ * This function @em must be called at some point after calling
+ * unscheduleCheck().
+ */
+ void rescheduleCheck();
+
+ /*
+ * Obtain the file descriptor K3ProcessController uses to get notified
+ * about process exits. select() or poll() on it if you create a custom
+ * event loop that needs to act upon SIGCHLD.
+ * @return the file descriptor of the reading end of the notification pipe
+ */
+ int notifierFd() const;
+
+ /**
+ * @internal
+ */
+ void addKProcess( K3Process* );
+ /**
+ * @internal
+ */
+ void removeKProcess( K3Process* );
+ /**
+ * @internal
+ */
+ void addProcess( int pid );
+
+private Q_SLOTS:
+ void slotDoHousekeeping();
+
+private:
+ friend class I_just_love_gcc;
+
+ static void setupHandlers();
+ static void resetHandlers();
+
+ // Disallow instantiation
+ K3ProcessController();
+ ~K3ProcessController();
+
+ // Disallow assignment and copy-construction
+ K3ProcessController( const K3ProcessController& );
+ K3ProcessController& operator= ( const K3ProcessController& );
+
+ class Private;
+ Private * const d;
+};
+
+#endif
+