FD.io VPP  v19.04.4-rc0-5-ge88582fac
Vector Packet Processing
neighbour.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2017 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 
16 #ifndef __VOM_NEIGHBOUR_H__
17 #define __VOM_NEIGHBOUR_H__
18 
19 #include "vom/interface.hpp"
20 #include "vom/singular_db.hpp"
21 #include "vom/types.hpp"
22 
23 namespace VOM {
24 /**
25  * A entry in the neighbour entry (ARP or IPv6 ND)
26  */
27 class neighbour : public object_base
28 {
29 public:
30  struct flags_t : public enum_base<flags_t>
31  {
32  /**
33  * Constructor
34  */
35  flags_t(int v, const std::string s);
36 
37  /**
38  * Destructor
39  */
40  ~flags_t() = default;
41 
42  flags_t operator|(const flags_t& e1) const
43  {
44  flags_t e = *this;
45  e |= e1;
46  return e;
47  }
48 
49  const static flags_t NONE;
50  const static flags_t STATIC;
51  const static flags_t NO_FIB_ENTRY;
52  };
53 
54  /**
55  * The key for a neighbour entry;
56  * the interface and IP address
57  */
58  typedef std::pair<interface::key_t, boost::asio::ip::address> key_t;
59 
60  /**
61  * Construct an ARP entry
62  */
63  neighbour(const interface& itf,
64  const boost::asio::ip::address& ip_addr,
65  const mac_address_t& mac,
66  const flags_t flags = flags_t::STATIC);
67 
68  /**
69  * Copy Construct
70  */
71  neighbour(const neighbour& r);
72 
73  /**
74  * Destructor
75  */
76  ~neighbour();
77 
78  /**
79  * Return the object's key
80  */
81  const key_t key() const;
82 
83  /**
84  * Comparison operator
85  */
86  bool operator==(const neighbour& n) const;
87 
88  /**
89  * Return the matching 'singular instance'
90  */
91  std::shared_ptr<neighbour> singular() const;
92 
93  /**
94  * Find the neighbour fromits key
95  */
96  static std::shared_ptr<neighbour> find(const key_t& k);
97 
98  /**
99  * Dump all neighbours into the stream provided
100  */
101  static void dump(std::ostream& os);
102 
103  /**
104  * replay the object to create it in hardware
105  */
106  void replay(void);
107 
108  /**
109  * Convert to string for debugging
110  */
111  std::string to_string() const;
112 
113 private:
114  /**
115  * Class definition for listeners to OM events
116  */
118  {
119  public:
120  event_handler();
121  virtual ~event_handler() = default;
122 
123  /**
124  * Handle a populate event
125  */
126  void handle_populate(const client_db::key_t& key);
127 
128  /**
129  * Handle a replay event
130  */
131  void handle_replay();
132 
133  /**
134  * Show the object in the Singular DB
135  */
136  void show(std::ostream& os);
137 
138  /**
139  * Get the sortable Id of the listener
140  */
141  dependency_t order() const;
142  };
143 
144  /**
145  * event_handler to register with OM
146  */
147  static event_handler m_evh;
148 
149  /**
150  * Commit the acculmulated changes into VPP. i.e. to a 'HW" write.
151  */
152  void update(const neighbour& obj);
153 
154  /**
155  * Do the populate work
156  */
157  static void populate_i(const client_db::key_t& key,
158  std::shared_ptr<interface> itf,
159  const l3_proto_t& proto);
160 
161  /**
162  * Find or add the instnace of the neighbour in the OM
163  */
164  static std::shared_ptr<neighbour> find_or_add(const neighbour& temp);
165 
166  /*
167  * It's the VPPHW class that updates the objects in HW
168  */
169  friend class OM;
170 
171  /**
172  * It's the singular_db class that calls replay()
173  */
174  friend class singular_db<key_t, neighbour>;
175 
176  /**
177  * Sweep/reap the object if still stale
178  */
179  void sweep(void);
180 
181  /**
182  * HW configuration for the result of creating the bridge_domain
183  */
184  HW::item<bool> m_hw;
185 
186  /**
187  * The bridge_domain domain the bridge_domain is in.
188  */
189  std::shared_ptr<interface> m_itf;
190 
191  /**
192  * The IP address
193  */
194  boost::asio::ip::address m_ip_addr;
195 
196  /**
197  * The mac to match
198  */
199  mac_address_t m_mac;
200 
201  /**
202  * flags on the entry
203  */
204  flags_t m_flags;
205 
206  /**
207  * A map of all bridge_domains
208  */
209  static singular_db<key_t, neighbour> m_db;
210 };
211 
212 std::ostream& operator<<(std::ostream& os, const neighbour::key_t& key);
213 };
214 
215 /*
216  * fd.io coding-style-patch-verification: ON
217  *
218  * Local Variables:
219  * eval: (c-set-style "mozilla")
220  * End:
221  */
222 
223 #endif
typedef address
Definition: ip_types.api:30
u32 flags
Definition: vhost_user.h:115
const key_t key() const
Return the object&#39;s key.
Definition: neighbour.cpp:70
std::shared_ptr< neighbour > singular() const
Return the matching &#39;singular instance&#39;.
Definition: neighbour.cpp:129
A template base class for all enum types.
Definition: enum_base.hpp:30
const std::string key_t
In the opflex world each entity is known by a URI which can be converted into a string.
Definition: client_db.hpp:51
static const flags_t STATIC
Definition: neighbour.hpp:50
An L3 protocol can be used to construct a prefix that is used to match packets are part of a route...
Definition: prefix.hpp:52
bool operator==(const enum_base &e) const
Comparison operator.
Definition: enum_base.hpp:41
neighbour(const interface &itf, const boost::asio::ip::address &ip_addr, const mac_address_t &mac, const flags_t flags=flags_t::STATIC)
Construct an ARP entry.
Definition: neighbour.cpp:34
static const flags_t NONE
Definition: neighbour.hpp:49
flags_t operator|(const flags_t &e1) const
Definition: neighbour.hpp:42
A Database to store the unique &#39;singular&#39; instances of a single object type.
Definition: singular_db.hpp:33
A entry in the neighbour entry (ARP or IPv6 ND)
Definition: neighbour.hpp:27
flags_t(int v, const std::string s)
Constructor.
Definition: neighbour.cpp:29
A representation of an interface in VPP.
Definition: interface.hpp:41
Class definition for listeners to OM events.
Definition: om.hpp:284
inspect command handler Handler
Definition: inspect.hpp:54
static const flags_t NO_FIB_ENTRY
Definition: neighbour.hpp:51
const std::string & to_string() const
convert to string format for debug purposes
Definition: enum_base.hpp:36
void event_handler(void *tls_async)
Definition: tls_async.c:340
void replay(void)
replay the object to create it in hardware
Definition: neighbour.cpp:86
dependency_t
There needs to be a strict order in which object types are read from VPP (at boot time) and replayed ...
Definition: types.hpp:43
The interface to writing objects into VPP OM.
Definition: om.hpp:140
A base class for all object_base in the VPP object_base-Model.
Definition: object_base.hpp:29
static void dump(std::ostream &os)
Dump all neighbours into the stream provided.
Definition: neighbour.cpp:135
std::ostream & operator<<(std::ostream &os, const std::pair< direction_t, interface::key_t > &key)
static std::shared_ptr< neighbour > find(const key_t &k)
Find the neighbour fromits key.
Definition: neighbour.cpp:123
The VPP Object Model (VOM) library.
Definition: acl_binding.cpp:19
~flags_t()=default
Destructor.
void show(char *chroot_path, int verbose)
Definition: svmtool.c:105
~neighbour()
Destructor.
Definition: neighbour.cpp:55
std::pair< interface::key_t, boost::asio::ip::address > key_t
The key for a neighbour entry; the interface and IP address.
Definition: neighbour.hpp:58
Type def of a Ethernet address.
Definition: types.hpp:295
vl_api_mac_address_t mac
Definition: gbp.api:120