DASH HA

experimental/saiexperimentaldashdevice.h

@@ -0,0 +1,195 @@
+/**
+ * Copyright (c) 2024 Microsoft Open Technologies, Inc.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License"); you may
+ *    not use this file except in compliance with the License. You may obtain
+ *    a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR
+ *    CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT
+ *    LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE, FITNESS
+ *    FOR A PARTICULAR PURPOSE, MERCHANTABILITY OR NON-INFRINGEMENT.
+ *
+ *    See the Apache Version 2.0 License for specific language governing
+ *    permissions and limitations under the License.
+ *
+ *    Microsoft would like to thank the following companies for their review and
+ *    assistance with these files: Intel Corporation, Mellanox Technologies Ltd,
+ *    Dell Products, L.P., Facebook, Inc., Marvell International Ltd.
+ *
+ * @file    saiexperimentaldashdevice.h
+ *
+ * @brief   This module defines SAI P4 extension  interface
+ */
+
+#if !defined (__SAIEXPERIMENTALDASHDEVICE_H_)
+#define __SAIEXPERIMENTALDASHDEVICE_H_
+
+#include <saitypes.h>
+
+/**
+ * @defgroup SAIEXPERIMENTALDASH_DEVICE SAI - Extension specific API definitions
+ *
+ * @{
+ */
+
+/**
+ * @brief Attribute ID for DASH device
+ */
+typedef enum _sai_dash_device_attr_t
+{
+    /**
+     * @brief Start of attributes
+     */
+    SAI_DASH_DEVICE_ATTR_START,
+
+    /**
+     * @brief Any non-VNET VNI or GRE keys that need to be allowed
+     *
+     * @par PrivateLink GRE key is an example
+     *
+     * @type sai_vni_range_list_t
+     * @flags CREATE_ONLY
+     * @default empty
+     */
+    SAI_DASH_DEVICE_ATTR_TRUSTED_VNI_LIST = SAI_DASH_DEVICE_ATTR_START,
+
+    /**
+     * @brief HA Local IP for control traffic
+     *
+     * @type sai_ip_address_t
+     * @flags CREATE_AND_SET
+     * @default empty
+     */
+    SAI_DASH_DEVICE_ATTR_HA_CONTROL_LOCAL_IP,
+
+    /**
+     * @brief HA Peer IP for control traffic
+     *
+     * @type sai_ip_address_t
+     * @flags CREATE_AND_SET
+     * @default empty
+     */
+    SAI_DASH_DEVICE_ATTR_HA_CONTROL_PEER_IP,
+
+    /**
+     * @brief List of HA VIPs
+     *
+     * @type sai_dash_vip_info_list_t
+     * @flags CREATE_AND_SET
+     * @default empty
+     */
+    SAI_DASH_DEVICE_ATTR_HA_VIP_INFO_LIST,
+
+    /**
+     * @brief HA heartbeat interval time in ms
+     *
+     * @type sai_uint32_t
+     * @flags CREATE_AND_SET
+     * @default 0
+     */
+    SAI_DASH_DEVICE_ATTR_HA_HEARTBEAT_INTERVAL,
+
+    /**
+     * @brief Number of HA heartbeats missed before declaring Peer unreachable
+     *
+     * @type sai_uint32_t
+     * @flags CREATE_AND_SET
+     * @default 0
+     */
+    SAI_DASH_DEVICE_ATTR_HA_HEARTBEAT_COUNT,
+
+    /**
+     * @brief Time in ms required for network to converge after switchover
+     *
+     * @par Any traffic directed to wrong DPU after this time will be blackholed
+     *
+     * @type sai_uint32_t
+     * @flags CREATE_AND_SET
+     * @default 100
+     */
+    SAI_DASH_DEVICE_ATTR_VIP_CONVERGENCE_TIMEOUT,
+
+#if 0
+
+    /**
+     * @brief Allow automatic flow reconcile on transition to Standalone
+     *
+     * @type bool
+     * @flags CREATE_AND_SET
+     * @default false
+     */
+    SAI_DASH_DEVICE_ATTR_HA_AUTO_FLOW_RECONCILE_ENABLE,
+#endif
+
+    /**
+     * @brief End of attributes
+     */
+    SAI_DASH_DEVICE_ATTR_END,
+} sai_dash_device_attr_t;
+
+/**
+ * @brief Create and return a DASH device object
+ *
+ * @param[out] dash_device_id Device id
+ * @param[in] switch_id Switch id
+ * @param[in] attr_count Number of attributes
+ * @param[in] attr_list Array of attributes
+ *
+ * @return #SAI_STATUS_SUCCESS on success Failure status code on error
+ */
+typedef sai_status_t (*sai_create_dash_device_fn)(
+        _Out_ sai_object_id_t *dash_device_id,
+        _In_ sai_object_id_t switch_id,
+        _In_ uint32_t attr_count,
+        _In_ const sai_attribute_t *attr_list);
+
+/**
+ * @brief Remove DASH device object
+ *
+ * @param[in] dash_device_id Device id
+ *
+ * @return #SAI_STATUS_SUCCESS on success Failure status code on error
+ */
+typedef sai_status_t (*sai_remove_dash_device_fn)(
+        _In_ sai_object_id_t dash_device_id);
+
+/**
+ * @brief Set DASH device attribute
+ *
+ * @param[in] dash_device_id Entry id
+ * @param[in] attr Attribute
+ *
+ * @return #SAI_STATUS_SUCCESS on success Failure status code on error
+ */
+typedef sai_status_t (*sai_set_dash_device_attribute_fn)(
+        _In_ sai_object_id_t dash_device_id,
+        _In_ const sai_attribute_t *attr);
+
+/**
+ * @brief Get DASH device attribute
+ *
+ * @param[in] dash_device_id Entry id
+ * @param[in] attr_count Number of attributes
+ * @param[inout] attr_list Array of attributes
+ *
+ * @return #SAI_STATUS_SUCCESS on success Failure status code on error
+ */
+typedef sai_status_t (*sai_get_dash_device_attribute_fn)(
+        _In_ sai_object_id_t dash_device_id,
+        _In_ uint32_t attr_count,
+        _Inout_ sai_attribute_t *attr_list);
+
+typedef struct _sai_dash_device_api_t
+{
+    sai_create_dash_device_fn                           create_dash_device;
+    sai_remove_dash_device_fn                           remove_dash_device;
+    sai_set_dash_device_attribute_fn                    set_dash_device_attribute;
+    sai_get_dash_device_attribute_fn                    get_dash_device_attribute;
+
+} sai_dash_device_api_t;
+
+/**
+ * @}
+ */
+#endif /** __SAIEXPERIMENTALDASHDEVICE_H_ */

experimental/saiexperimentaldasheni.h

@@ -430,6 +430,27 @@ typedef enum _sai_eni_attr_t
      */
     SAI_ENI_ATTR_OUTBOUND_V6_STAGE5_DASH_ACL_GROUP_ID,
 
+    /**
+     * @brief Owner of ENI, when DPU participates in HA
+     *
+     * @par Irrespective of the DPU in the HA pair where traffic actually lands,
+     * only the DASH ACL rules configured on the owner DPU will be evaluated
+     * for all flows belonging to this ENI.
+     *
+     * @type bool
+     * @flags MANDATORY_ON_CREATE | CREATE_ONLY
+     */
+    SAI_ENI_ATTR_HA_OWNER,
+
+    /**
+     * @brief VIP associated with this ENI, when DPU participates in HA
+     *
+     * @type sai_uint32_t
+     * @flags CREATE_ONLY
+     * @default 0
+     */
+    SAI_ENI_ATTR_HA_VIP_ID,
+
     /**
      * @brief End of attributes
      */