Bulk get/set for switches

Refer: https://github.com/opencomputeproject/SAI/blob/master/inc/saitypes.h#L1725

sai_bulk_object_create_fn
    - Accepts @param[in] attr_list List of attributes for every object.

sai_bulk_object_set_attribute_fn
    - Accepts @param[in] attr_list List of attributes for every object, one per object.

sai_bulk_object_get_attribute_fn
    - Accepts @param[in] attr_count List of attr_count. Caller passes the
      number of attribute for each object to get.

In other words bulk set and get accept "list of attributes" for "list
of objects", while the bulk set only accepts "one attribute per object".

Thus, today, there is no mechanism to "set a list of attributes on one
or more objects". This PR addresses that. It keeps the old set method
for backward compatibility but marks ti as deprecated.

It also introduces bulk get/set for switches and leverages this new
method.

Signed-off-by: Shrikrishna (Shri) Khare <skhare@meta.com>

Author: Shrikrishna (Shri) Khare

inc/saiswitch.h

@@ -4061,6 +4061,8 @@ typedef struct _sai_switch_api_t
     sai_get_switch_tunnel_attribute_fn     get_switch_tunnel_attribute;
     sai_switch_mdio_cl22_read_fn           switch_mdio_cl22_read;
     sai_switch_mdio_cl22_write_fn          switch_mdio_cl22_write;
+    sai_bulk_object_set_attribute_ext_fn   set_switches_attribute;
+    sai_bulk_object_get_attribute_fn       get_switches_attribute
 
 } sai_switch_api_t;
 

inc/saitypes.h

@@ -1767,7 +1767,7 @@ typedef sai_status_t (*sai_bulk_object_remove_fn)(
         _Out_ sai_status_t *object_statuses);
 
 /**
- * @brief Bulk objects set attributes.
+ * @brief Bulk objects set attributes. Deprecated for backward compatibility
  *
  * @param[in] object_count Number of objects to set on attribute
  * @param[in] object_id List of object ids
@@ -1787,6 +1787,30 @@ typedef sai_status_t (*sai_bulk_object_set_attribute_fn)(
         _In_ sai_bulk_op_error_mode_t mode,
         _Out_ sai_status_t *object_statuses);
 
+/**
+ * @brief Bulk objects set attributes extended.
+ *
+ * @param[in] object_count Number of objects to set on attribute
+ * @param[in] object_id List of object ids
+ * @param[in] attr_count List of attr_count. Caller passes the number
+ *    of attribute for each object to get.
+ * @param[in] attr_list List of attributes for every object, one per object.
+ * @param[in] mode Bulk operation error handling mode.
+ * @param[out] object_statuses List of status for every object. Caller needs to allocate the buffer.
+ *
+ * @return #SAI_STATUS_SUCCESS when set attributes on all objects succeeded or
+ * #SAI_STATUS_FAILURE when any of the objects fails to set attribute. When
+ * there is failure, Caller is expected to go through the list of returned
+ * statuses to find out which fails and which succeeds.
+ */
+typedef sai_status_t (*sai_bulk_object_set_attribute_ext_fn)(
+        _In_ uint32_t object_count,
+        _In_ const sai_object_id_t *object_id,
+        _In_ const uint32_t *attr_count,
+        _In_ const sai_attribute_t **attr_list,
+        _In_ sai_bulk_op_error_mode_t mode,
+        _Out_ sai_status_t *object_statuses);
+
 /**
  * @brief Bulk objects get attributes.
  *