ext/systemc/src/sysc/kernel/sc_object.h - public/gem5 - Git at Google

 /*****************************************************************************

   Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
   more contributor license agreements.  See the NOTICE file distributed
   with this work for additional information regarding copyright ownership.
   Accellera licenses this file to you under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with the
   License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
   implied.  See the License for the specific language governing
   permissions and limitations under the License.

  *****************************************************************************/

 /*****************************************************************************

   sc_object.h -- Abstract base class of all SystemC `simulation' objects.

   Original Author: Stan Y. Liao, Synopsys, Inc.

   CHANGE LOG AT THE END OF THE FILE
  *****************************************************************************/


 #ifndef SC_OBJECT_H
 #define SC_OBJECT_H


 #include "sysc/utils/sc_iostream.h"
 #include "sysc/kernel/sc_attribute.h"

 namespace sc_core {

 class sc_event;
 class sc_module;
 class sc_phase_callback_registry;
 class sc_runnable;
 class sc_simcontext;
 class sc_trace_file;
 class sc_trace_file_base;

 // ----------------------------------------------------------------------------
 //  CLASS : sc_object
 //
 //  Abstract base class of all SystemC `simulation' objects.
 // ----------------------------------------------------------------------------

 class sc_object
 {
     friend class sc_event;
     friend class sc_module;
     friend struct sc_invoke_method;
     friend class sc_module_dynalloc_list;
     friend class sc_object_manager;
     friend class sc_phase_callback_registry;
     friend class sc_process_b;
     friend class sc_runnable;
     friend class sc_simcontext;
     friend class sc_trace_file_base;

 public:
     typedef unsigned phase_cb_mask;

     const char* name() const
         { return m_name.c_str(); }

     const char* basename() const;

     virtual void print(::std::ostream& os=::std::cout ) const;

     // dump() is more detailed than print()
     virtual void dump(::std::ostream& os=::std::cout ) const;

     virtual void trace( sc_trace_file* tf ) const;

     virtual const char* kind() const { return "sc_object"; }

     sc_simcontext* simcontext() const
         { return m_simc; }

     // add attribute
     bool add_attribute( sc_attr_base& );

     // get attribute by name
           sc_attr_base* get_attribute( const std::string& name_ );
     const sc_attr_base* get_attribute( const std::string& name_ ) const;

     // remove attribute by name
     sc_attr_base* remove_attribute( const std::string& name_ );

     // remove all attributes
     void remove_all_attributes();

     // get the number of attributes
     int num_attributes() const;

     // get the attribute collection
           sc_attr_cltn& attr_cltn();
     const sc_attr_cltn& attr_cltn() const;

     virtual const std::vector<sc_event*>& get_child_events() const
         { return m_child_events; }

     virtual const std::vector<sc_object*>& get_child_objects() const
         { return m_child_objects; }

     sc_object* get_parent() const;
     sc_object* get_parent_object() const { return m_parent; }

 protected:

     sc_object();
     sc_object(const char* nm);

     sc_object( const sc_object& );
     sc_object& operator=( const sc_object& );


     virtual ~sc_object();

     virtual void add_child_event( sc_event* event_p );
     virtual void add_child_object( sc_object* object_p );
     virtual bool remove_child_event( sc_event* event_p );
     virtual bool remove_child_object( sc_object* object_p );

     phase_cb_mask register_simulation_phase_callback( phase_cb_mask );
     phase_cb_mask unregister_simulation_phase_callback( phase_cb_mask );

     class hierarchy_scope;

 private:
             void do_simulation_phase_callback();
     virtual void simulation_phase_callback();

     void detach();
     virtual void orphan_child_events();
     virtual void orphan_child_objects();
     void sc_object_init(const char* nm);

 private:

     /* Each simulation object is associated with a simulation context */
     mutable sc_attr_cltn*   m_attr_cltn_p;   // attributes for this object.
     std::vector<sc_event*>  m_child_events;  // list of child events.
     std::vector<sc_object*> m_child_objects; // list of child objects.
     std::string             m_name;          // name of this object.
     sc_object*              m_parent;        // parent for this object.
     sc_simcontext*          m_simc;          // simcontext ptr / empty indicator
 };

 inline
 sc_object&
 sc_object::operator=( sc_object const & )
 {
   // deliberately do nothing
   return *this;
 }

 // ----------------------------------------------------------------------------

 extern const char SC_HIERARCHY_CHAR;
 extern bool sc_enable_name_checking;


 inline
 sc_object* sc_get_parent( const sc_object* obj_p )
 {
 	return obj_p->get_parent_object();
 }

 } // namespace sc_core

 /*****************************************************************************

   MODIFICATION LOG - modifiers, enter your name, affiliation, date and
   changes you are making here.

       Name, Affiliation, Date: Andy Goodrich, Forte Design Systems
                                5 September 2003
   Description of Modification: - Made creation of attributes structure
                                  conditional on its being used. This eliminates
                                  100 bytes of storage for each normal sc_object.

  *****************************************************************************/

 // $Log: sc_object.h,v $
 // Revision 1.13  2011/08/29 18:04:32  acg
 //  Philipp A. Hartmann: miscellaneous clean ups.
 //
 // Revision 1.12  2011/08/26 20:46:10  acg
 //  Andy Goodrich: moved the modification log to the end of the file to
 //  eliminate source line number skew when check-ins are done.
 //
 // Revision 1.11  2011/03/06 15:55:11  acg
 //  Andy Goodrich: Changes for named events.
 //
 // Revision 1.10  2011/03/05 19:44:20  acg
 //  Andy Goodrich: changes for object and event naming and structures.
 //
 // Revision 1.9  2011/03/05 01:39:21  acg
 //  Andy Goodrich: changes for named events.
 //
 // Revision 1.8  2011/02/18 20:27:14  acg
 //  Andy Goodrich: Updated Copyrights.
 //
 // Revision 1.7  2011/02/13 21:47:37  acg
 //  Andy Goodrich: update copyright notice.
 //
 // Revision 1.6  2011/01/25 20:50:37  acg
 //  Andy Goodrich: changes for IEEE 1666 2011.
 //
 // Revision 1.5  2011/01/18 20:10:44  acg
 //  Andy Goodrich: changes for IEEE1666_2011 semantics.
 //
 // Revision 1.4  2010/07/22 20:02:33  acg
 //  Andy Goodrich: bug fixes.
 //
 // Revision 1.3  2009/02/28 00:26:58  acg
 //  Andy Goodrich: changed boost name space to sc_boost to allow use with
 //  full boost library applications.
 //
 // Revision 1.2  2008/05/22 17:06:26  acg
 //  Andy Goodrich: updated copyright notice to include 2008.
 //
 // Revision 1.1.1.1  2006/12/15 20:20:05  acg
 // SystemC 2.3
 //
 // Revision 1.5  2006/04/20 17:08:17  acg
 //  Andy Goodrich: 3.0 style process changes.
 //
 // Revision 1.4  2006/04/11 23:13:21  acg
 //   Andy Goodrich: Changes for reduced reset support that only includes
 //   sc_cthread, but has preliminary hooks for expanding to method and thread
 //   processes also.
 //
 // Revision 1.3  2006/01/13 18:44:30  acg
 // Added $Log to record CVS changes into the source.

 #endif // SC_OBJECT_H
	/*****************************************************************************

	Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
	more contributor license agreements. See the NOTICE file distributed
	with this work for additional information regarding copyright ownership.
	Accellera licenses this file to you under the Apache License, Version 2.0
	(the "License"); you may not use this file except in compliance with the
	License. You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
	implied. See the License for the specific language governing
	permissions and limitations under the License.

	*****************************************************************************/

	/*****************************************************************************

	sc_object.h -- Abstract base class of all SystemC `simulation' objects.

	Original Author: Stan Y. Liao, Synopsys, Inc.

	CHANGE LOG AT THE END OF THE FILE
	*****************************************************************************/


	#ifndef SC_OBJECT_H
	#define SC_OBJECT_H


	#include "sysc/utils/sc_iostream.h"
	#include "sysc/kernel/sc_attribute.h"

	namespace sc_core {

	class sc_event;
	class sc_module;
	class sc_phase_callback_registry;
	class sc_runnable;
	class sc_simcontext;
	class sc_trace_file;
	class sc_trace_file_base;

	// ----------------------------------------------------------------------------
	// CLASS : sc_object
	//
	// Abstract base class of all SystemC `simulation' objects.
	// ----------------------------------------------------------------------------

	class sc_object
	{
	friend class sc_event;
	friend class sc_module;
	friend struct sc_invoke_method;
	friend class sc_module_dynalloc_list;
	friend class sc_object_manager;
	friend class sc_phase_callback_registry;
	friend class sc_process_b;
	friend class sc_runnable;
	friend class sc_simcontext;
	friend class sc_trace_file_base;

	public:
	typedef unsigned phase_cb_mask;

	const char* name() const
	{ return m_name.c_str(); }

	const char* basename() const;

	virtual void print(::std::ostream& os=::std::cout ) const;

	// dump() is more detailed than print()
	virtual void dump(::std::ostream& os=::std::cout ) const;

	virtual void trace( sc_trace_file* tf ) const;

	virtual const char* kind() const { return "sc_object"; }

	sc_simcontext* simcontext() const
	{ return m_simc; }

	// add attribute
	bool add_attribute( sc_attr_base& );

	// get attribute by name
	sc_attr_base* get_attribute( const std::string& name_ );
	const sc_attr_base* get_attribute( const std::string& name_ ) const;

	// remove attribute by name
	sc_attr_base* remove_attribute( const std::string& name_ );

	// remove all attributes
	void remove_all_attributes();

	// get the number of attributes
	int num_attributes() const;

	// get the attribute collection
	sc_attr_cltn& attr_cltn();
	const sc_attr_cltn& attr_cltn() const;

	virtual const std::vector<sc_event*>& get_child_events() const
	{ return m_child_events; }

	virtual const std::vector<sc_object*>& get_child_objects() const
	{ return m_child_objects; }

	sc_object* get_parent() const;
	sc_object* get_parent_object() const { return m_parent; }

	protected:

	sc_object();
	sc_object(const char* nm);

	sc_object( const sc_object& );
	sc_object& operator=( const sc_object& );


	virtual ~sc_object();

	virtual void add_child_event( sc_event* event_p );
	virtual void add_child_object( sc_object* object_p );
	virtual bool remove_child_event( sc_event* event_p );
	virtual bool remove_child_object( sc_object* object_p );

	phase_cb_mask register_simulation_phase_callback( phase_cb_mask );
	phase_cb_mask unregister_simulation_phase_callback( phase_cb_mask );

	class hierarchy_scope;

	private:
	void do_simulation_phase_callback();
	virtual void simulation_phase_callback();

	void detach();
	virtual void orphan_child_events();
	virtual void orphan_child_objects();
	void sc_object_init(const char* nm);

	private:

	/* Each simulation object is associated with a simulation context */
	mutable sc_attr_cltn* m_attr_cltn_p; // attributes for this object.
	std::vector<sc_event*> m_child_events; // list of child events.
	std::vector<sc_object*> m_child_objects; // list of child objects.
	std::string m_name; // name of this object.
	sc_object* m_parent; // parent for this object.
	sc_simcontext* m_simc; // simcontext ptr / empty indicator
	};

	inline
	sc_object&
	sc_object::operator=( sc_object const & )
	{
	// deliberately do nothing
	return *this;
	}

	// ----------------------------------------------------------------------------

	extern const char SC_HIERARCHY_CHAR;
	extern bool sc_enable_name_checking;


	inline
	sc_object* sc_get_parent( const sc_object* obj_p )
	{
	return obj_p->get_parent_object();
	}

	} // namespace sc_core

	/*****************************************************************************

	MODIFICATION LOG - modifiers, enter your name, affiliation, date and
	changes you are making here.

	Name, Affiliation, Date: Andy Goodrich, Forte Design Systems
	5 September 2003
	Description of Modification: - Made creation of attributes structure
	conditional on its being used. This eliminates
	100 bytes of storage for each normal sc_object.

	*****************************************************************************/

	// $Log: sc_object.h,v $
	// Revision 1.13 2011/08/29 18:04:32 acg
	// Philipp A. Hartmann: miscellaneous clean ups.
	//
	// Revision 1.12 2011/08/26 20:46:10 acg
	// Andy Goodrich: moved the modification log to the end of the file to
	// eliminate source line number skew when check-ins are done.
	//
	// Revision 1.11 2011/03/06 15:55:11 acg
	// Andy Goodrich: Changes for named events.
	//
	// Revision 1.10 2011/03/05 19:44:20 acg
	// Andy Goodrich: changes for object and event naming and structures.
	//
	// Revision 1.9 2011/03/05 01:39:21 acg
	// Andy Goodrich: changes for named events.
	//
	// Revision 1.8 2011/02/18 20:27:14 acg
	// Andy Goodrich: Updated Copyrights.
	//
	// Revision 1.7 2011/02/13 21:47:37 acg
	// Andy Goodrich: update copyright notice.
	//
	// Revision 1.6 2011/01/25 20:50:37 acg
	// Andy Goodrich: changes for IEEE 1666 2011.
	//
	// Revision 1.5 2011/01/18 20:10:44 acg
	// Andy Goodrich: changes for IEEE1666_2011 semantics.
	//
	// Revision 1.4 2010/07/22 20:02:33 acg
	// Andy Goodrich: bug fixes.
	//
	// Revision 1.3 2009/02/28 00:26:58 acg
	// Andy Goodrich: changed boost name space to sc_boost to allow use with
	// full boost library applications.
	//
	// Revision 1.2 2008/05/22 17:06:26 acg
	// Andy Goodrich: updated copyright notice to include 2008.
	//
	// Revision 1.1.1.1 2006/12/15 20:20:05 acg
	// SystemC 2.3
	//
	// Revision 1.5 2006/04/20 17:08:17 acg
	// Andy Goodrich: 3.0 style process changes.
	//
	// Revision 1.4 2006/04/11 23:13:21 acg
	// Andy Goodrich: Changes for reduced reset support that only includes
	// sc_cthread, but has preliminary hooks for expanding to method and thread
	// processes also.
	//
	// Revision 1.3 2006/01/13 18:44:30 acg
	// Added $Log to record CVS changes into the source.

	#endif // SC_OBJECT_H