-#include "surf.hpp"
+#include "surf_interface.hpp"
#include <float.h>
#ifndef NETWORK_ROUTING_HPP_
/***********
* Classes *
***********/
-class As;
+
+/* Note: As and RoutingEdge are declard as struct instead of class, to keep
+ compatibility with C files where they are mentioned. */
+struct As;
typedef As *AsPtr;
class RoutingModelDescription;
typedef RoutingModelDescription *RoutingModelDescriptionPtr;
-class RoutingEdge;
+struct RoutingEdge;
typedef RoutingEdge *RoutingEdgePtr;
class Onelink;
class RoutingPlatf;
typedef RoutingPlatf *RoutingPlatfPtr;
-
-/*FIXME:class RoutingModelDescription {
- const char *p_name;
- const char *p_desc;
- AsPtr create();
- void end(AsPtr as);
-};*/
-
-class As {
+/** @ingroup SURF_routing_interface
+ * @brief The Autonomous System (AS) routing interface
+ * @details [TODO]
+ */
+struct As {
public:
xbt_dynar_t p_indexNetworkElm;
xbt_dict_t p_bypassRoutes; /* store bypass routes */
RoutingEdgePtr p_netElem;
xbt_dynar_t p_linkUpDownList;
+ /**
+ * @brief The As constructor
+ */
As(){};
- virtual ~As(){};
+ /**
+ * @brief The As destructor
+ */
+ virtual ~As(){
+ xbt_free(p_name);
+ };
+
+ /**
+ * @brief Get the route and latency between two RoutingEdgs
+ * @details [long description]
+ *
+ * @param src [description]
+ * @param dst [description]
+ * @param into [description]
+ * @param latency [description]
+ */
virtual void getRouteAndLatency(RoutingEdgePtr src, RoutingEdgePtr dst, sg_platf_route_cbarg_t into, double *latency)=0;
virtual xbt_dynar_t getOneLinkRoutes()=0;
virtual void getGraph(xbt_graph_t graph, xbt_dict_t nodes, xbt_dict_t edges)=0;
virtual void parseBypassroute(sg_platf_route_cbarg_t e_route)=0;
};
-class RoutingEdge {
+/** @ingroup SURF_routing_interface
+ * @brief A routing edge
+ * @details [long description]
+ */
+struct RoutingEdge {
public:
+ ~RoutingEdge() { xbt_free(p_name);};
AsPtr p_rcComponent;
e_surf_network_element_type_t p_rcType;
int m_id;
char *p_name;
};
-/*
- * Link of lenght 1, alongside with its source and destination. This is mainly usefull in the bindings to gtnets and ns3
+
+/** @ingroup SURF_routing_interface
+ * @brief Link of lenght 1, alongside with its source and destination. This is mainly usefull in the bindings to gtnets and ns3
*/
class Onelink {
public:
Onelink(void *link, RoutingEdgePtr src, RoutingEdgePtr dst)
- : p_link(link), p_src(src), p_dst(dst) {};
+ : p_src(src), p_dst(dst), p_link(link) {};
RoutingEdgePtr p_src;
RoutingEdgePtr p_dst;
void *p_link;
};
+/** @ingroup SURF_routing_interface
+ * @brief The class representing a whole routing platform
+ */
class RoutingPlatf {
public:
+ ~RoutingPlatf();
AsPtr p_root;
void *p_loopback;
xbt_dynar_t p_lastRoute;