/usr/include/k3processcontroller.h is in kdelibs5-dev 4:4.14.38-0ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 | /* 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., 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 KDE3SUPPORT_EXPORT_DEPRECATED 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
|