SAI Distributed HW Resource Infra

Author: JaiOCP

doc/SAI-Proposal-HW-Resource.md

@@ -29,11 +29,23 @@ New data type sai_object_stage_t is introduced. This data type specifies if a re
 
 ## Capability Query
 ----------------
-Capability query API is enhanced with a query for attribute stage.NOS can query the attribute for a given HW support
+New  query API is introduced for an attribute's stage. NOS can query the stage of an object's attribute for a given HW support. One of the following stage is returned as part the API
+- SAI_ATTR_STAGE_NA: Stage is not applicable
 - SAI_ATTR_STAGE_BOTH: Attribute is common to ingress and egress stage
 - SAI_ATTR_STAGE_INGRESS: Attribute is applicable only to ingress stage
 - SAI_ATTR_STAGE_EGRESS: Attribute is applicabe only to egress stage
 
+Length of the returned array "stage" is attr_count. Caller must provide the buffer for array "stage".
+ 
+```
+sai_status_t sai_query_object_stage(
+        _In_ sai_object_id_t switch_id,
+        _In_ sai_object_type_t object_type,
+        _In_ uint32_t attr_count,
+        _In_ const sai_attribute_t *attr_list,
+        _Out_ sai_object_stage_t *stage);
+```
+
 ## HOSTIF Trap Group
 -----------------
 A new CREATE_ONLY trap group attribute is introduced. NOS can set this attribute to specify the stage of the trap group.

inc/saiobject.h

@@ -138,10 +138,6 @@ typedef struct _sai_attr_capability_t
      */
     bool get_implemented;
 
-    /**
-     * @brief Attribute stage if applicable
-     */
-    sai_attr_stage_t attr_stage;
 } sai_attr_capability_t;
 
 /**
@@ -327,6 +323,24 @@ sai_status_t sai_bulk_object_clear_stats(
         _In_ sai_stats_mode_t mode,
         _Inout_ sai_status_t *object_statuses);
 
+/**
+ * @brief Query the HW stage of an attribute for the specified object type
+ *
+ * @param[in] switch_id SAI Switch object id
+ * @param[in] object_type SAI object type
+ * @param[in] attr_count Count of attributes
+ * @param[in] attr_list List of attributes
+ * @param[out] stage HW stage of the attributes. Length of the array should be attr_count. Caller must allocate the buffer.
+ *
+ * @return #SAI_STATUS_SUCCESS on success, failure status code on error
+ */
+sai_status_t sai_query_object_stage(
+        _In_ sai_object_id_t switch_id,
+        _In_ sai_object_type_t object_type,
+        _In_ uint32_t attr_count,
+        _In_ const sai_attribute_t *attr_list,
+        _Out_ sai_object_stage_t *stage);
+
 /**
  * @}
  */