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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 63 insertions, 0 deletions

diff --git a/kdesu/su.h b/kdesu/su.h
new file mode 100644
index 000000000..c82e459eb
--- /dev/null
+++ b/kdesu/su.h
@@ -0,0 +1,63 @@
+/* vi: ts=8 sts=4 sw=4
+ *
+ * $Id$
+ *
+ * This file is part of the KDE project, module kdesu.
+ * Copyright (C) 1999,2000 Geert Jansen <jansen@kde.org>
+ *
+ * This is free software; you can use this library under the GNU Library 
+ * General Public License, version 2. See the file "COPYING.LIB" for the 
+ * exact licensing terms.
+ */
+
+#ifndef __SU_h_Included__
+#define __SU_h_Included__
+
+#include <qcstring.h>
+
+#include <kdelibs_export.h>
+
+#include "stub.h"
+
+/**
+ * Executes a command under elevated privileges, using su.
+ */
+
+class KDESU_EXPORT SuProcess: public StubProcess
+{
+public:
+    SuProcess(const QCString &user=0, const QCString &command=0);
+    ~SuProcess();
+
+    enum Errors { SuNotFound=1, SuNotAllowed, SuIncorrectPassword };
+
+    /**
+     * Executes the command. This will wait for the command to finish.
+     */
+    enum checkMode { NoCheck=0, Install=1, NeedPassword=2 } ;
+    int exec(const char *password, int check=NoCheck);
+
+    /** 
+     * Checks if the stub is installed and the password is correct.
+     * @return Zero if everything is correct, nonzero otherwise.
+     */
+    int checkInstall(const char *password);
+
+    /**
+     * Checks if a password is needed.
+     */
+    int checkNeedPassword();
+
+private:
+    enum SuErrors { error=-1, ok=0, killme=1, notauthorized=2 } ;
+    int ConverseSU(const char *password);
+
+protected:
+    virtual void virtual_hook( int id, void* data );
+private:
+    class SuProcessPrivate;
+    SuProcessPrivate *d;
+    QString superUserCommand;
+};
+
+#endif