Packet Drop Monitoring

Signed-off-by: JaiOCP <jai.kumar@broadcom.com>

Author: JaiOCP

doc/DropMonitor/SAI-Proposal-Packet-Drop-Monitoring-Spec.md

@@ -249,6 +249,8 @@ The SAI_TAM_EVENT_LEARN_ENTRY_ATTR_COUNTER_ID is allocated by the SAI adapter an
 
 The SAI_TAM_EVENT_LEARN_ENTRY_ATTR_COUNTER_ID is read using standard stats api.
 
+SAI_TAM_EVENT_LEARN_ENTRY_ATTR_ACL_ENTRY object is allocated by the SAI adapter for the learned entry and is used by NOS to age the entry if needed.
+
 ```
 /**
  * @brief Enum defining learn event.
@@ -407,6 +409,15 @@ typedef enum _sai_tam_event_learn_entry_attr_t
      */
     SAI_TAM_EVENT_LEARN_ENTRY_ATTR_COUNTER_ID,
 
+    /**
+     * @brief ACL table entry associated with this learn entry.
+     *
+     * @type sai_object_id_t
+     * @flags READ_ONLY
+     * @objects SAI_OBJECT_TYPE_ACL_ENTRY
+     */
+    SAI_TAM_EVENT_LEARN_ENTRY_ATTR_ACL_ENTRY,
+
     /**
      * @brief End of Attributes
      */
@@ -435,6 +446,13 @@ New data type is created to capture flow information as part of the bacllback.
  */
 typedef struct _sai_tam_event_learn_notification_data_t
 {
+    /**
+     * @brief TAM Learn entry ID
+     *
+     * @objects SAI_OBJECT_TYPE_TAM_EVENT_LEARN_ENTRY
+     */
+    sai_object_id_t le_id;
+
     /** Attributes count */
     uint32_t attr_count;
 
@@ -445,12 +463,6 @@ typedef struct _sai_tam_event_learn_notification_data_t
      */
     sai_attribute_t *attr;
 
-    /**
-     * @brief TAM Learn entry ID
-     *
-     * @objects SAI_OBJECT_TYPE_TAM_EVENT_LEARN_ENTRY
-     */
-    sai_object_id_t le_id;
 
 } sai_tam_event_learn_notification_data_t;
 ```
@@ -549,7 +561,12 @@ create_tam(
 
 ACL table is created with fields enabled that will be used to install the flow entry when the leraning happens. In this example flow is learned for the qset[ip proto, src ip, dst ip, sport, dport, ingress port].
 
-This table can later be queried by NOS for learned entries using the GET API. Conceptually there is no SET or REMOVE on this table and SAI adapter should fail any set/remove operation if done by the NOS.
+This table can later be queried by NOS for learned entries using the GET API. Learned entries can be aged out using the SAI_TAM_EVENT_LEARN_ENTRY_ATTR_ACL_ENTRY object.
+
+Conceptually there is no SET on the ACL table entries as they are created by SAI adapter.
+SAI adapter should fail any SET operation if done by the NOS.
+
+New SAI_ACL_BIND_POINT_TYPE_TAM bind point is introduced for ACL table. This is to provide hint to the SAI adapter that this ACL table is mainly used for TAM purposes. 
 
 
 ```

inc/saitam.h

@@ -2873,6 +2873,15 @@ typedef enum _sai_tam_event_learn_entry_attr_t
      */
     SAI_TAM_EVENT_LEARN_ENTRY_ATTR_COUNTER_ID,
 
+    /**
+     * @brief ACL table entry associated with this learn entry.
+     *
+     * @type sai_object_id_t
+     * @flags READ_ONLY
+     * @objects SAI_OBJECT_TYPE_ACL_ENTRY
+     */
+    SAI_TAM_EVENT_LEARN_ENTRY_ATTR_ACL_ENTRY,
+
     /**
      * @brief End of Attributes
      */
@@ -2993,23 +3002,22 @@ typedef sai_status_t (*sai_clear_tam_event_learn_entry_stats_fn)(
  */
 typedef struct _sai_tam_event_learn_notification_data_t
 {
-    /** Attributes count */
-    uint32_t attr_count;
-
     /**
-     * @brief Attributes
+     * @brief TAM Learn entry ID
      *
      * @objects SAI_OBJECT_TYPE_TAM_EVENT_LEARN_ENTRY
      */
-    sai_attribute_t *attr;
+    sai_object_id_t le_id;
+
+    /** Attributes count */
+    uint32_t attr_count;
 
     /**
-     * @brief TAM Learn entry ID
+     * @brief Attributes
      *
      * @objects SAI_OBJECT_TYPE_TAM_EVENT_LEARN_ENTRY
      */
-    sai_object_id_t le_id;
-
+    sai_attribute_t *attr;
 } sai_tam_event_learn_notification_data_t;
 
 /**

inc/saitypes.h

@@ -1033,8 +1033,10 @@ typedef enum _sai_acl_bind_point_type_t
     SAI_ACL_BIND_POINT_TYPE_ROUTER_INTF = SAI_ACL_BIND_POINT_TYPE_ROUTER_INTERFACE,
 
     /** Bind Point Type Switch */
-    SAI_ACL_BIND_POINT_TYPE_SWITCH
+    SAI_ACL_BIND_POINT_TYPE_SWITCH,
 
+    /** Bind Point Type TAM */
+    SAI_ACL_BIND_POINT_TYPE_TAM,
 } sai_acl_bind_point_type_t;
 
 /**