include/simgrid/kernel/routing/NetPoint.hpp

   1 /* Copyright (c) 2013-2021. The SimGrid Team. All rights reserved.          */
   2
   3 /* This program is free software; you can redistribute it and/or modify it
   4  * under the terms of the license (GNU LGPL) which comes with this package. */
   5
   6 #ifndef KERNEL_ROUTING_NETPOINT_HPP_
   7 #define KERNEL_ROUTING_NETPOINT_HPP_
   8
   9 #include <xbt/Extendable.hpp>
  10 #include <xbt/base.h>
  11 #include <xbt/signal.hpp>
  12
  13 #include <simgrid/kernel/routing/NetZoneImpl.hpp>
  14
  15 namespace simgrid {
  16
  17 extern template class XBT_PUBLIC xbt::Extendable<kernel::routing::NetPoint>;
  18
  19 namespace kernel {
  20 namespace routing {
  21
  22 /** @ingroup ROUTING_API
  23  *  @brief Network cards are the vertices in the graph representing the network, used to compute paths between nodes.
  24  *
  25  * @details This represents a position in the network. One can send information between two netpoints
  26  */
  27 class NetPoint : public xbt::Extendable<NetPoint> {
  28 public:
  29   enum class Type { Host, Router, NetZone };
  30
  31   NetPoint(const std::string& name, NetPoint::Type component_type, NetZoneImpl* netzone_p);
  32   ~NetPoint() = default;
  33
  34   // Our rank in the vertices_ array of the netzone that contains us.
  35   unsigned int id() const { return id_; }
  36   const std::string& get_name() const { return name_; }
  37   const char* get_cname() const { return name_.c_str(); }
  38   /** @brief the NetZone in which this NetPoint is included */
  39   NetZoneImpl* get_englobing_zone() { return englobing_zone_; }
  40
  41   bool is_netzone() const { return component_type_ == Type::NetZone; }
  42   bool is_host() const { return component_type_ == Type::Host; }
  43   bool is_router() const { return component_type_ == Type::Router; }
  44
  45   static xbt::signal<void(NetPoint&)> on_creation;
  46
  47   bool operator<(const NetPoint& rhs) const { return name_ < rhs.name_; }
  48
  49 private:
  50   unsigned int id_;
  51   std::string name_;
  52   NetPoint::Type component_type_;
  53   NetZoneImpl* englobing_zone_;
  54 };
  55 } // namespace routing
  56 } // namespace kernel
  57 } // namespace simgrid
  58
  59 XBT_PUBLIC simgrid::kernel::routing::NetPoint* sg_netpoint_by_name_or_null(const char* name);
  60
  61 #endif /* KERNEL_ROUTING_NETPOINT_HPP_ */