Skip to content

SRv6 SID Marking #2222

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: master
Choose a base branch
from
+82 −0
Draft

SRv6 SID Marking #2222

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4887b6a
SID Marking APIs
j-bos Oct 13, 2025
4ff33d5
Initial .md file
j-bos Oct 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 57 additions & 0 deletions doc/SAI-IPv6-Segment-Routing-VPN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -664,6 +664,63 @@ has a NULL object id for SID-list.
saistatus = sai_route_api->create_route(&route_entry, 2, route_entry_attrs);
```

## SRv6 SID Marking Feature

This section describes the SID Marking feature for SRv6 VPN, which enables VPN SIDs to carry QoS and policy information derived from packet classification. Two new tunnel map types support SID Marking by allowing VPN SID selection based on forwarding class (which is mapped from DSCP via QoS Maps or ACL classification) and hierarchical policy lookup.

### SAI_TUNNEL_MAP_TYPE_FORWARDING_CLASS_TO_SRV6_VPN_SID - SID Marking

#### Overview

The `SAI_TUNNEL_MAP_TYPE_FORWARDING_CLASS_TO_SRV6_VPN_SID` tunnel map type implements the core SID Marking capability. It enables VPN SIDs to be "marked" with QoS information by selecting different VPN SIDs based on forwarding class. The forwarding class is derived from packet DSCP values through QoS Map classification or ACL-based classification, allowing the ingress node to encode traffic priority directly into the VPN SID itself. This marked VPN SID then carries the QoS information end-to-end through the SRv6 network.

#### API Attributes

**Tunnel Map Type:**
```c
SAI_TUNNEL_MAP_TYPE_FORWARDING_CLASS_TO_SRV6_VPN_SID = 0x0000000f
```

**Tunnel Map Entry Attributes:**
```c
// Key: Forwarding Class
SAI_TUNNEL_MAP_ENTRY_ATTR_FORWARDING_CLASS_KEY = 0x00000013
// Type: sai_uint32_t
// Flags: MANDATORY_ON_CREATE | CREATE_ONLY

// Value: SRv6 VPN SID
SAI_TUNNEL_MAP_ENTRY_ATTR_SRV6_VPN_SID_VALUE = 0x00000011
// Type: sai_ip6_t
// Flags: MANDATORY_ON_CREATE | CREATE_ONLY
```

### SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_TUNNEL_MAP_ID - Hierarchical SID Marking

#### Overview

The `SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_TUNNEL_MAP_ID` tunnel map type enables hierarchical, two-level lookup for VPN SID selection. This indirection allows combining the prefix-based derivation with the forwarding-class-based SID Marking.

#### API Attributes

**Tunnel Map Type:**
```c
SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_TUNNEL_MAP_ID = 0x0000000e
```

**Tunnel Map Entry Attributes:**
```c
// Key: Prefix Aggregation ID
SAI_TUNNEL_MAP_ENTRY_ATTR_PREFIX_AGG_ID_KEY = 0x00000010
// Type: sai_uint32_t
// Flags: MANDATORY_ON_CREATE | CREATE_ONLY

// Value: Tunnel Map Object ID
SAI_TUNNEL_MAP_ENTRY_ATTR_TUNNEL_MAP_ID_VALUE = 0x00000012
// Type: sai_object_id_t
// Flags: MANDATORY_ON_CREATE | CREATE_ONLY
// Objects: SAI_OBJECT_TYPE_TUNNEL_MAP
```

## References
1. [IPv6 Segment Routing Header (SRH)](https://tools.ietf.org/html/rfc8754)
2. [Segment Routing over IPv6 (SRv6) Network Programming](https://tools.ietf.org/html/rfc8986)
Expand Down
25 changes: 25 additions & 0 deletions inc/saitunnel.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,12 @@ typedef enum _sai_tunnel_map_type_t
/** TUNNEL Map Prefix Aggregation ID to SRV6 VPN SID */
SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_SRV6_VPN_SID = 0x0000000d,

/** TUNNEL Map Prefix Aggregation ID to Tunnel Map ID */
SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_TUNNEL_MAP_ID = 0x0000000e,

/** TUNNEL Map Forwarding Class to SRV6 VPN SID */
SAI_TUNNEL_MAP_TYPE_FORWARDING_CLASS_TO_SRV6_VPN_SID = 0x0000000f,

/** Custom range base value */
SAI_TUNNEL_MAP_TYPE_CUSTOM_RANGE_BASE = 0x10000000

Expand Down Expand Up @@ -259,6 +265,25 @@ typedef enum _sai_tunnel_map_entry_attr_t
*/
SAI_TUNNEL_MAP_ENTRY_ATTR_SRV6_VPN_SID_VALUE = 0x00000011,

/**
* @brief Tunnel Map ID value
*
* @type sai_object_id_t
* @flags MANDATORY_ON_CREATE | CREATE_ONLY
* @objects SAI_OBJECT_TYPE_TUNNEL_MAP
* @condition SAI_TUNNEL_MAP_ENTRY_ATTR_TUNNEL_MAP_TYPE == SAI_TUNNEL_MAP_TYPE_PREFIX_AGG_ID_TO_TUNNEL_MAP_ID
*/
SAI_TUNNEL_MAP_ENTRY_ATTR_TUNNEL_MAP_ID_VALUE = 0x00000012,

/**
* @brief Forwarding Class value
*
* @type sai_uint32_t
* @flags MANDATORY_ON_CREATE | CREATE_ONLY
* @condition SAI_TUNNEL_MAP_ENTRY_ATTR_TUNNEL_MAP_TYPE == SAI_TUNNEL_MAP_TYPE_FORWARDING_CLASS_TO_SRV6_VPN_SID
*/
SAI_TUNNEL_MAP_ENTRY_ATTR_FORWARDING_CLASS_KEY = 0x00000013,

/**
* @brief End of attributes
*/
Expand Down