0.6.0-1 release

[manu/suphp.git] / src / Application.hpp

diff --git a/src/Application.hpp b/src/Application.hpp
new file mode 100644 (file)
index 0000000..be7ed82
--- /dev/null
+++ b/src/Application.hpp
@@ -0,0 +1,126 @@
+/*
+    suPHP - (c)2002-2005 Sebastian Marsching <sebastian@marsching.com>
+
+    This file is part of suPHP.
+
+    suPHP is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    suPHP 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 General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with suPHP; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+*/
+
+#ifndef SUPHP_APPLICATION_H
+
+namespace suPHP {
+    class Application;
+};
+
+enum TargetMode {
+    TARGETMODE_PHP,
+    TARGETMODE_SELFEXECUTE
+};
+
+#define SUPHP_APPLICATION_H
+
+#include <string>
+#include <iostream>
+
+#include "Environment.hpp"
+#include "CommandLine.hpp"
+#include "SystemException.hpp"
+#include "SoftException.hpp"
+#include "SecurityException.hpp"
+
+namespace suPHP {
+    /**
+     * Main application class.
+     * Contains the main() function.
+     */
+    class Application {
+    private:
+       /**
+        * Print message containing version information
+        */
+       void printAboutMessage();
+       
+       /**
+        * Checks wheter process has root privileges
+        * and calling user is webserver user
+        */
+       void checkProcessPermissions(Configuration& config) 
+           throw (SecurityException, LookupException);
+       /**
+        * Checks scriptfile.
+        * Includes check for path, symbollink and permissions
+        */
+       void checkScriptFile(const std::string& scriptFilename, 
+                            const Configuration& config, 
+                            const Environment& environment) const
+           throw (SystemException, SoftException);
+       
+       /**
+        * Changes process permission (user and group).
+        * Uses preprocessor macros to distinguish between modes
+        */
+       void changeProcessPermissions(const std::string& scriptFilename,
+                                     const Configuration& config,
+                                     const Environment& environment) const
+           throw (SystemException, SoftException, SecurityException);
+
+       /**
+        * Prepares the environment before invoking the script
+        */
+       Environment prepareEnvironment(const Environment& sourceEnv,
+                                      const Configuration& config,
+                                      TargetMode mode)
+           throw (KeyNotFoundException);
+
+       /**
+        * Returns interpreter for script being executed
+        */
+       std::string getInterpreter(const Environment& env,
+                                  const Configuration& config)
+           throw (SecurityException);
+       
+       /**
+        * Returns mode interpreter is using
+        */
+       TargetMode getTargetMode(const std::string& interpreter)
+           throw (SecurityException);
+
+       /**
+        * Runs script
+        */
+       void executeScript(const std::string& scriptFilename,
+                          const std::string& interpreter,
+                          TargetMode mode,
+                          const Environment& env,
+                          const Configuration& config) const
+           throw (SoftException);
+
+
+    public:
+       /**
+        * Constructer
+        */
+       Application();
+       
+       /**
+        * Function called by the main() function
+        */
+       int run(CommandLine& cmdline, Environment& env);
+    };
+};
+
+int main(int argc, char **argv);
+
+#endif // SUPHP_APPLICATION_H