Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdenetwork@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 39 insertions, 0 deletions

diff --git a/kppp/KPPPIface.h b/kppp/KPPPIface.h
new file mode 100644
index 00000000..2b5a6cb5
--- /dev/null
+++ b/kppp/KPPPIface.h
@@ -0,0 +1,39 @@
+#ifndef KPPPIFACE_H
+#define KPPPIFACE_H
+
+#include <dcopobject.h>
+
+/* IMPORTANT: when using the aboutToDisconnect signal bear in mind that
+
+    - if pppd dies, aboutToDisconnect will never be emitted because the
+      connection is already dead by the time kppp knows about it.
+      disconnected() will be emitted regardless of the cause of
+      disconnection.
+
+    - during a normal disconnection aboutToDisconnect will be emitted 
+      shortly before disconnection, but in systems under heavy load there's 
+      no warranty that the signal will be delivered to the applications 
+      before the disconnection is performed. DCOP works this way, 
+      sorry.
+
+*/
+
+class KpppIface : virtual public DCOPObject
+{
+  K_DCOP
+
+  k_dcop:
+    virtual void beginConnect() = 0;
+    virtual void disconnect() = 0;
+    virtual bool isConnected() const = 0;
+    
+  k_dcop_signals:
+    
+    void aboutToConnect();
+    void connected();
+    void aboutToDisconnect();	// see the note above
+    void disconnected();
+
+};
+
+#endif