- Gettext support to resource policies descriptions.

- Renamed default_resource_policy_manager to match the design.
- Audited some other files.


git-svn-id: svn://svn.gna.org/svn/sgpemv2/trunk@1232 3ecf2c5c-341e-0410-92b4-d18e462d057c
This commit is contained in:
matrevis 2006-09-17 15:32:56 +00:00
parent 37e4d7572b
commit 859df07a89
11 changed files with 233 additions and 65 deletions

View File

@ -206,11 +206,11 @@ src_backend_libbackend_la_SOURCES = \
src/backend/concrete_simulation_statistics.cc \ src/backend/concrete_simulation_statistics.cc \
src/backend/concrete_statistics.cc \ src/backend/concrete_statistics.cc \
src/backend/concrete_thread_statistics.cc \ src/backend/concrete_thread_statistics.cc \
src/backend/cpp_resource_policy_manager.cc \
src/backend/cpu_policies_gatekeeper.cc \ src/backend/cpu_policies_gatekeeper.cc \
src/backend/cpu_policy.cc \ src/backend/cpu_policy.cc \
src/backend/cpu_policy_exception.cc \ src/backend/cpu_policy_exception.cc \
src/backend/cpu_policy_manager.cc \ src/backend/cpu_policy_manager.cc \
src/backend/default_resource_policy_manager.cc \
src/backend/dynamic_process.cc \ src/backend/dynamic_process.cc \
src/backend/dynamic_request.cc \ src/backend/dynamic_request.cc \
src/backend/dynamic_resource.cc \ src/backend/dynamic_resource.cc \
@ -268,11 +268,11 @@ src_backend_libbackend_la_SOURCES = \
# Please note that the first listed header is generated by # Please note that the first listed header is generated by
# configure. # configure.
pkginclude_HEADERS += \ pkginclude_HEADERS += \
src/backend/sgpemv2/cpp_resource_policy_manager.hh \
src/backend/sgpemv2/cpu_policies_gatekeeper.hh \ src/backend/sgpemv2/cpu_policies_gatekeeper.hh \
src/backend/sgpemv2/cpu_policy.hh \ src/backend/sgpemv2/cpu_policy.hh \
src/backend/sgpemv2/cpu_policy_exception.hh \ src/backend/sgpemv2/cpu_policy_exception.hh \
src/backend/sgpemv2/cpu_policy_manager.hh \ src/backend/sgpemv2/cpu_policy_manager.hh \
src/backend/sgpemv2/default_resource_policy_manager.hh \
src/backend/sgpemv2/environment.hh \ src/backend/sgpemv2/environment.hh \
src/backend/sgpemv2/global_preferences.hh \ src/backend/sgpemv2/global_preferences.hh \
src/backend/sgpemv2/history.hh \ src/backend/sgpemv2/history.hh \

View File

@ -36,14 +36,20 @@
namespace sgpem namespace sgpem
{ {
/** \brief A specialization of abstract class Policy /// \brief A specialization of abstract class Policy
///
Implements the Policy abstract class specified in the backend component to allow /// Implements the Policy abstract class specified in the backend component to allow
user-written Python policies to run. /// user-written Python policies to run.
///
This class represents a policy written in Python. Its methods interact with Python interpreter. /// This class represents a policy written in Python. Its methods interact
See the documentation of class Policy for more detailed informations. /// with Python interpreter.
*/ /// See the documentation of class Policy for more detailed informations.
///
/// Since both the methods get_name() and get_description() must be available before
/// backend::Policy activation, then map them to the class name and the return of
/// the __doc__() method, respectively.
/// That information can be obtained statically (without
/// instantiating an object of that class).
class PythonCPUPolicy; class PythonCPUPolicy;
class PythonCPUPolicyManager; class PythonCPUPolicyManager;
@ -55,58 +61,123 @@ namespace sgpem
/// \brief Constructor taking the name of the policy. /// \brief Constructor taking the name of the policy.
/// ///
/// Constructor taking the name of the policy. /// Constructor taking the name of the policy.
/// Perform the first half of the two-staged construction
/// ///
/// \param name the name of the policy /// A ::PythonPolicy object is instantiated as soon as its ::PythonPolicyManager
/// calls collect_policies(). In order to save memory, since only a small subset
/// of policies can be activated in a given time frame, this constructor only
/// takes care to determine the policy name and description, without actually
/// preparing a separate PyInterpreter and/or PyThreadState.
/// @see activate().
/// @throw an exception when the policy is malformed and therefore not usable.
/// @param name the name of the policy
PythonCPUPolicy(const char* name) throw(MalformedPolicyException); PythonCPUPolicy(const char* name) throw(MalformedPolicyException);
/// \brief Standard virtual destructor /// \brief Standard virtual destructor
/// ///
virtual ~PythonCPUPolicy(); virtual ~PythonCPUPolicy();
/** /// \brief Configures the policy, asynchronously.
Calls the method \c async_configure ///
*/ /// Configures the policy, asynchronously. Calls the method \c async_configure
void configure() throw(UserInterruptException, MalformedPolicyException); /// Performs the following operations in this order:
/** /// -# Erases the content of the PolicyParameters attribute
Calls the method \c async_sort_queue /// -# Calls associated method async_configure() from the loaded
*/ /// ::ScriptAdapter, which has been properly initialized from the activate() method
void sort_queue() const throw(UserInterruptException, MalformedPolicyException); /// -# Wait for the async call to return, calling wait_unlock()
/// @throw an exception when the policy is malformed and therefore not usable,
/// or when the policy is taking too long to terminate its work.
/// @see ::CPUPolicy::configure().
void configure() throw(UserInterruptException, MalformedPolicyException);
/** /// \brief Sorts the queue, asynchronously.
\returns A textual description of this policy. ///
*/ /// Sorts the queue, asynchronously. Calls the method \c async_sort_queue.
Glib::ustring get_description() const; /// @throw an exception when the policy is malformed and therefore not usable,
/// or when the policy is taking too long to terminate its work.
/// @see ::CPUPolicy::sort_queue().
void sort_queue() const throw(UserInterruptException, MalformedPolicyException);
Glib::ustring get_name() const; /// \brief Returns a textual description of the policy.
///
/// Returns a textual description of this policy.
/// Tries to get the result of calling __doc__() of the corresponding
/// Python-implemented Policy object, if available. Else, returns the empty string.
/// @return long description of the policy.
/// @see ::CPUPolicy::get_description().
Glib::ustring get_description() const;
/** /// \brief Returns a human-readable name of this policy.
\returns \c TRUE if the policy is preemptive. ///
\returns \c FALSE if the policy is not preemptive. /// Returns a human-readable name of this policy.
*/ /// The name of the script file, stripped by its extension --
bool is_pre_emptive() const throw(UserInterruptException, MalformedPolicyException); /// typically, it's regexp(/.py(c?)/i)
/// @return the name of this policy.
/// @see ::CPUPolicy::get_name().
Glib::ustring get_name() const;
/** /// \brief Returns whether this policy is preemptive or not, asynchronously.
\returns The integer value of its time-slice. ///
*/ /// Returns whether this policy is preemptive or not, asynchronously.
int get_time_slice() const throw(UserInterruptException, MalformedPolicyException); /// Calls ScriptAdapter::async_is_preemptive(). Waits for an answer into wait_unlock()
/// @throw an exception when the policy is malformed and therefore not usable,
/// or when the policy is taking too long to terminate its work.
/// @return \c TRUE if the policy is preemptive.
/// @return \c FALSE if the policy is not preemptive.
/// @see ::CPUPolicy::is_pre_emptive().
bool is_pre_emptive() const throw(UserInterruptException, MalformedPolicyException);
/// \brief Returns the lenght of the time slice, asynchronously.
///
/// Returns the lenght of the time slice, asynchronously.
/// Calls ScriptAdapter::async_get_timeslice(). Waits for an answer into wait_unlock()
/// @throw an exception when the policy is malformed and therefore not usable,
/// or when the policy is taking too long to terminate its work.
/// @return the lenght of the time slice.
/// @see ::CPUPolicy::get_time_slice().
int get_time_slice() const throw(UserInterruptException, MalformedPolicyException);
/// \brief Load the corresponding Python module and initialize a new Policy object (in Python).
///
/// It will have its own PyThreadState and/or PyInterpreter.
/// @throw an exception when the policy is malformed and therefore not usable,
/// or when the policy is taking too long to terminate its work.
/// @see ::CPUPolicy::activate().
void activate() throw(UserInterruptException, MalformedPolicyException); void activate() throw(UserInterruptException, MalformedPolicyException);
/// \brief Activates the policy.
///
/// Cleanup operations to perform before another policy is loaded.
/// @see ::CPUPolicy::deactivate().
void deactivate(); void deactivate();
private: private:
PythonCPUPolicy(const PythonCPUPolicy&); PythonCPUPolicy(const PythonCPUPolicy&);
PythonCPUPolicy& operator=(const PythonCPUPolicy&); PythonCPUPolicy& operator=(const PythonCPUPolicy&);
/// \brief Helps in implementing an asynchronous call to a method.
///
/// Enters in a loop waiting for a ::ScriptAdapter method to return. If this
/// doesn't happen before a timeout expires, puts Policy and the Python
/// interpreter in a safe state and throws UserInterruptException.
///
/// After an "async*()" call, the global Python interpreter lock has to be
/// released. This is necessary to let the Python threads to run.
/// After having waited for a specified amount of time (we're polling),
/// the lock is taken again, and we check if the thread has finished via
/// the mutex present in ::ScriptAdapter. If so, wait_unlock() terminates
/// successfully. Else it stays in its main loop.
void wait_unlock() const throw(UserInterruptException, MalformedPolicyException); void wait_unlock() const throw(UserInterruptException, MalformedPolicyException);
/// \brief Returns a brief description of a thrown exception.
/// Returns the description of the exception occurred.
static std::string get_exception_information(); static std::string get_exception_information();
static Glib::StaticRecMutex _mtx; static Glib::StaticRecMutex _mtx;
PyObject* _upolicy_dict; PyObject* _upolicy_dict;
PyObject* _adapter; PyObject* _adapter;
Glib::ustring _name; Glib::ustring _name;
Glib::ustring _description; Glib::ustring _description;
}; };

View File

@ -31,28 +31,58 @@
namespace sgpem namespace sgpem
{ {
//class CPUPolicyManager;
/// \brief Manages Python user-implemented policies
///
/// Manages the creation, the organization and the destruction of the
/// cpu policies implemented using Python.
///
/// It is also responsible for handling malformed policies: as soon as the
/// application detects the presence of a malformed policy, it will ask this
/// class to terminate the Python interpreter and to reinitialize the objects
/// which were previously created by the manager itself.
class PythonCPUPolicyManager; class PythonCPUPolicyManager;
/** \brief Manages Python user-implemented policies
*
* This singleton manages the creation and destruction
* of a Python policy.
*/
class SG_DLLEXPORT PythonCPUPolicyManager : public CPUPolicyManager class SG_DLLEXPORT PythonCPUPolicyManager : public CPUPolicyManager
{ {
public: public:
/// \brief Standard constructor.
///
/// Standard constructor.
/// Calls collect_policies() to instantiate all manageable .py policy scripts.
PythonCPUPolicyManager(); PythonCPUPolicyManager();
/// \brief Standard virtual destructor.
///
/// Standard virtual desctuctor.
~PythonCPUPolicyManager(); ~PythonCPUPolicyManager();
/// \brief Returns policies found and instantiated by collect_policies().
///
/// Returns policies found and instantiated by collect_policies().
/// \return the policies found and instantiated by collect_policies().
const std::vector<CPUPolicy*>& get_avail_policies(); const std::vector<CPUPolicy*>& get_avail_policies();
protected: protected:
/** The selected and active PyhonCPUPolicy object. */
/// \brief Scans through directories for loadable Python scripts.
///
/// Scans through directories for loadable Python scripts.
/// For each found valid python script, tries to load it, and assess if it contains at least a class which:
/// -# type(classname) is of type "classobj"
/// -# classname.__bases is a tuple containing Policy::Policy
void collect_policies(); void collect_policies();
private: private:
/// \brief Standard copy constructor.
///
/// Standard private copy constructor.
PythonCPUPolicyManager(const PythonCPUPolicyManager&); PythonCPUPolicyManager(const PythonCPUPolicyManager&);
/// \brief Standard private operator assign.
///
/// Standard private operator assign.
PythonCPUPolicyManager& operator=(const PythonCPUPolicyManager&); PythonCPUPolicyManager& operator=(const PythonCPUPolicyManager&);
}; };

View File

@ -1,4 +1,4 @@
// src/backend/default_resource_policy_manager.cc - Copyright 2005, 2006, University // src/backend/cpp_resource_policy_manager.cc - Copyright 2005, 2006, University
// of Padova, dept. of Pure and Applied // of Padova, dept. of Pure and Applied
// Mathematics // Mathematics
// //
@ -19,20 +19,20 @@
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
#include <sgpemv2/cpp_resource_policy_manager.hh>
#include <sgpemv2/resource_policy_lifo.hh> #include <sgpemv2/resource_policy_lifo.hh>
#include <sgpemv2/resource_policy_fifo.hh> #include <sgpemv2/resource_policy_fifo.hh>
#include <sgpemv2/resource_policy_priority.hh> #include <sgpemv2/resource_policy_priority.hh>
#include <sgpemv2/resource_policy_priority_inheritance.hh> #include <sgpemv2/resource_policy_priority_inheritance.hh>
#include <sgpemv2/default_resource_policy_manager.hh>
#include <sgpemv2/resource_policies_gatekeeper.hh> #include <sgpemv2/resource_policies_gatekeeper.hh>
using namespace sgpem; using namespace sgpem;
// instantiate a default instance of this class. // instantiate a default instance of this class.
DefaultResourcePolicyManager DefaultResourcePolicyManager::_default_instance; CppResourcePolicyManager CppResourcePolicyManager::_default_instance;
DefaultResourcePolicyManager::DefaultResourcePolicyManager() CppResourcePolicyManager::CppResourcePolicyManager()
{ {
ResourcePoliciesGatekeeper::get_instance().register_manager(this); ResourcePoliciesGatekeeper::get_instance().register_manager(this);
// Includes default policies. // Includes default policies.
@ -43,13 +43,13 @@ DefaultResourcePolicyManager::DefaultResourcePolicyManager()
} }
DefaultResourcePolicyManager::~DefaultResourcePolicyManager() CppResourcePolicyManager::~CppResourcePolicyManager()
{ {
ResourcePoliciesGatekeeper::get_instance().unregister_manager(this); ResourcePoliciesGatekeeper::get_instance().unregister_manager(this);
} }
const std::vector<ResourcePolicy*>& const std::vector<ResourcePolicy*>&
DefaultResourcePolicyManager::get_avail_policies() const CppResourcePolicyManager::get_avail_policies() const
{ {
return _policies; return _policies;
} }

View File

@ -70,13 +70,13 @@ ResourcePolicyFiFo::enforce(Environment& environment, Environment::SubRequestQue
Glib::ustring Glib::ustring
ResourcePolicyFiFo::get_description() const ResourcePolicyFiFo::get_description() const
{ {
return "A resource policy which satisfies earlier requests before older ones."; return _("A resource policy which satisfies earlier requests before older ones.");
} }
Glib::ustring Glib::ustring
ResourcePolicyFiFo::get_name() const ResourcePolicyFiFo::get_name() const
{ {
return "First In, First Out"; return _("First In, First Out");
} }

View File

@ -82,13 +82,13 @@ ResourcePolicyLiFo::enforce(Environment& environment, Environment::SubRequestQue
Glib::ustring Glib::ustring
ResourcePolicyLiFo::get_description() const ResourcePolicyLiFo::get_description() const
{ {
return "A resource policy which allows a request to be immediately allocated if there is enough space."; return _("A resource policy which allows a request to be immediately allocated if there is enough space.");
} }
Glib::ustring Glib::ustring
ResourcePolicyLiFo::get_name() const ResourcePolicyLiFo::get_name() const
{ {
return "Last In, First Out"; return _("Last In, First Out");
} }

View File

@ -85,13 +85,13 @@ ResourcePolicyPriority::enforce(Environment& environment, Environment::SubReques
Glib::ustring Glib::ustring
ResourcePolicyPriority::get_description() const ResourcePolicyPriority::get_description() const
{ {
return "A resource policy which satisfies higher priority requests before lower priority ones."; return _("A resource policy which satisfies higher priority requests before lower priority ones.");
} }
Glib::ustring Glib::ustring
ResourcePolicyPriority::get_name() const ResourcePolicyPriority::get_name() const
{ {
return "Higher Priority First"; return _("Higher Priority First");
} }

View File

@ -98,13 +98,13 @@ ResourcePolicyPriorityInheritance::enforce(Environment& environment, Environment
Glib::ustring Glib::ustring
ResourcePolicyPriorityInheritance::get_description() const ResourcePolicyPriorityInheritance::get_description() const
{ {
return "A resource policy which solves the priority inversion problem by raising the priority of a thread to the maximum relative to the queue."; return _("A resource policy which solves the priority inversion problem by raising the priority of a thread to the maximum relative to the queue.");
} }
Glib::ustring Glib::ustring
ResourcePolicyPriorityInheritance::get_name() const ResourcePolicyPriorityInheritance::get_name() const
{ {
return "Basic Priority Inheritance Protocol"; return _("Basic Priority Inheritance Protocol");
} }

View File

@ -0,0 +1,67 @@
// src/backend/sgpemv2/cpp_resource_policy_manager.hh - Copyright 2005, 2006, University
// of Padova, dept. of Pure and Applied
// Mathematics
//
// This file is part of SGPEMv2.
//
// This 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.
//
// SGPEMv2 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 SGPEMv2; if not, write to the Free Software
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
#ifndef CPP_RESOURCE_POLICY_MANAGER_HH
#define CPP_RESOURCE_POLICY_MANAGER_HH 1
namespace sgpem
{
class ResourcePolicy;
}
#include <sgpemv2/sgpemv2-visibility.hh>
#include <sgpemv2/resource_policy_manager.hh>
#include <vector>
namespace sgpem
{
class CppResourcePolicyManager;
/**
ResourcePolicyManager is the Abstract Factory for \ref ResourcePolicy objects.
*/
class SG_DLLEXPORT CppResourcePolicyManager : public ResourcePolicyManager
{
public:
/** \brief CppResourcePolicyManager constructor
*
* Registers itself to the ResourcePoliciesGatekeeper singleton.
*/
CppResourcePolicyManager();
virtual ~CppResourcePolicyManager();
virtual const std::vector<ResourcePolicy*>& get_avail_policies() const;
private:
std::vector<ResourcePolicy*> _policies;
// an Instance of this class is created by default and it is registered to
// the ResourcePolicyGateKeeper
static CppResourcePolicyManager _default_instance;
};
} //~ namespace sgpem
#endif

View File

@ -1,4 +1,4 @@
// src/backend/default_resource_policy_manager.hh - Copyright 2005, 2006, University // src/backend/sgpemv2/cpp_resource_policy_manager.hh - Copyright 2005, 2006, University
// of Padova, dept. of Pure and Applied // of Padova, dept. of Pure and Applied
// Mathematics // Mathematics
// //
@ -18,8 +18,8 @@
// along with SGPEMv2; if not, write to the Free Software // along with SGPEMv2; if not, write to the Free Software
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
#ifndef DEFAULT_RESOURCE_POLICY_MANAGER_HH #ifndef CPP_RESOURCE_POLICY_MANAGER_HH
#define DEFAULT_RESOURCE_POLICY_MANAGER_HH 1 #define CPP_RESOURCE_POLICY_MANAGER_HH 1
namespace sgpem namespace sgpem
{ {
@ -35,21 +35,21 @@ namespace sgpem
namespace sgpem namespace sgpem
{ {
class DefaultResourcePolicyManager; class CppResourcePolicyManager;
/** /**
ResourcePolicyManager is the Abstract Factory for \ref ResourcePolicy objects. ResourcePolicyManager is the Abstract Factory for \ref ResourcePolicy objects.
*/ */
class SG_DLLEXPORT DefaultResourcePolicyManager : public ResourcePolicyManager class SG_DLLEXPORT CppResourcePolicyManager : public ResourcePolicyManager
{ {
public: public:
/** \brief DefaultResourcePolicyManager constructor /** \brief CppResourcePolicyManager constructor
* *
* Registers itself to the ResourcePoliciesGatekeeper singleton. * Registers itself to the ResourcePoliciesGatekeeper singleton.
*/ */
DefaultResourcePolicyManager(); CppResourcePolicyManager();
virtual ~DefaultResourcePolicyManager(); virtual ~CppResourcePolicyManager();
virtual const std::vector<ResourcePolicy*>& get_avail_policies() const; virtual const std::vector<ResourcePolicy*>& get_avail_policies() const;
@ -58,7 +58,7 @@ namespace sgpem
// an Instance of this class is created by default and it is registered to // an Instance of this class is created by default and it is registered to
// the ResourcePolicyGateKeeper // the ResourcePolicyGateKeeper
static DefaultResourcePolicyManager _default_instance; static CppResourcePolicyManager _default_instance;
}; };
} //~ namespace sgpem } //~ namespace sgpem

View File

@ -1,4 +1,4 @@
// src/backend/resource_policy_priority.hh - Copyright 2005, 2006, University // src/backend/sgpemv2/resource_policy_priority.hh - Copyright 2005, 2006, University
// of Padova, dept. of Pure and Applied // of Padova, dept. of Pure and Applied
// Mathematics // Mathematics
// //