src/vpp-api/vom/sub_interface.hpp

   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_SUB_INTERFACE_H__
  17 #define __VOM_SUB_INTERFACE_H__
  18
  19 #include "vom/interface.hpp"
  20
  21 namespace VOM {
  22 /**
  23  * A Sub-interface. e.g. a VLAN sub-interface on an Ethernet interface
  24  */
  25 class sub_interface : public interface
  26 {
  27   /*
  28    * Typedef for VLAN ID
  29    */
  30   typedef uint16_t vlan_id_t;
  31
  32 public:
  33   /**
  34    * Construct a new object matching the desried state
  35    */
  36   sub_interface(const interface& parent, admin_state_t state, vlan_id_t vlan);
  37   /**
  38    * Destructor
  39    */
  40   ~sub_interface();
  41   /**
  42    * Copy Constructor
  43    */
  44   sub_interface(const sub_interface& o);
  45
  46   /**
  47    * Return the matching 'singular instance' of the sub-interface
  48    */
  49   std::shared_ptr<sub_interface> singular() const;
  50
  51 private:
  52   /**
  53    * Construct with handle
  54    */
  55   sub_interface(const handle_t& handle,
  56                 const interface& parent,
  57                 admin_state_t state,
  58                 vlan_id_t vlan);
  59   friend class interface_factory;
  60
  61   /**
  62    * The interface class can construct interfaces with handles
  63    */
  64   friend class interface;
  65
  66   /**
  67    * Return the matching 'instance' of the sub-interface
  68    *  over-ride from the base class
  69    */
  70   std::shared_ptr<interface> singular_i() const;
  71
  72   /**
  73    * Virtual functions to construct an interface create commands.
  74    */
  75   virtual std::queue<cmd*>& mk_create_cmd(std::queue<cmd*>& cmds);
  76
  77   /**
  78    * Virtual functions to construct an interface delete commands.
  79    */
  80   virtual std::queue<cmd*>& mk_delete_cmd(std::queue<cmd*>& cmds);
  81
  82   /**
  83    * From the name of the parent and the vlan,
  84    * construct the sub-interface's name
  85    */
  86   static std::string mk_name(const interface& parent, vlan_id_t vlan);
  87
  88   /**
  89    * Refernece conter lock on the parent
  90    */
  91   const std::shared_ptr<interface> m_parent;
  92
  93   /**
  94    * VLAN ID
  95    */
  96   vlan_id_t m_vlan;
  97 };
  98 };
  99
 100 /*
 101  * fd.io coding-style-patch-verification: ON
 102  *
 103  * Local Variables:
 104  * eval: (c-set-style "mozilla")
 105  * End:
 106  */
 107
 108 #endif