Add bpf_redirect_map for AF_XDP sockets

.github/workflows/ci.yml

@@ -729,6 +729,64 @@ jobs:
       shell: PowerShell
       run: tools/check-drivers.ps1 -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -Verbose -AllowEbpf:($env:XDP_EBPF_BASELINE -ne '0')
 
+  sample_tests:
+    name: Sample Tests
+    needs: build
+    strategy:
+      fail-fast: false
+      matrix:
+        windows: [2022, 2025]
+        configuration: [Release, Debug]
+        platform: [x64]
+    runs-on:
+     - self-hosted
+     - "1ES.Pool=xdp-ci-functional${{ matrix.platform != 'x64' && format('-{0}', matrix.platform) || '' }}-gh"
+     - "1ES.ImageOverride=WS${{ matrix.windows }}${{ matrix.platform != 'x64' && format('-{0}', matrix.platform) || '' }}-Functional"
+     - "JobId=samples_${{ matrix.windows }}_${{ matrix.configuration }}_${{ matrix.platform }}-${{ github.run_id }}-${{ github.run_number }}-${{ github.run_attempt }}"
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      with:
+        sparse-checkout: tools
+    - name: Check Drivers
+      shell: PowerShell
+      run: tools/check-drivers.ps1 -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -Verbose -AllowEbpf
+    - name: Prepare Machine
+      shell: PowerShell
+      run: tools/prepare-machine.ps1 -ForFunctionalTest -Platform ${{ matrix.platform }} -RequireNoReboot -Verbose
+    - name: Download Artifacts
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c
+      with:
+        name: bin_${{ matrix.configuration }}_${{ matrix.platform }}
+        path: artifacts/bin
+    - name: Test rxfilter sample
+      shell: PowerShell
+      timeout-minutes: 15
+      run: tools/sample-rxfilter-test.ps1 -Verbose -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -Duration 10
+    - name: Test xskfwd sample
+      shell: PowerShell
+      timeout-minutes: 15
+      run: tools/sample-xskfwd-test.ps1 -Verbose -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -Duration 10
+    - name: Test xskrestricted sample
+      shell: PowerShell
+      timeout-minutes: 15
+      run: tools/sample-xskrestricted-test.ps1 -Verbose -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -TimeoutSeconds 10
+    - name: Convert Logs
+      if: ${{ always() }}
+      timeout-minutes: 15
+      shell: PowerShell
+      run: tools/log.ps1 -Convert -Name sample_* -Verbose -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }}
+    - name: Upload Logs
+      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+      if: ${{ always() }}
+      with:
+        name: logs_samples_win${{ matrix.windows }}_${{ matrix.configuration }}_${{ matrix.platform }}
+        path: artifacts/logs
+    - name: Check Drivers
+      if: ${{ always() }}
+      shell: PowerShell
+      run: tools/check-drivers.ps1 -Config ${{ matrix.configuration }} -Platform ${{ matrix.platform }} -Verbose -AllowEbpf:($env:XDP_EBPF_BASELINE -ne '0')
+
   create_artifacts:
     name: Create Release Artifacts
     needs: build
@@ -775,7 +833,7 @@ jobs:
   all_tests_complete:
     name: All Tests Complete
     if: always()
-    needs: [functional_tests, stress_tests, pktfuzz_tests, xskperf_tests, ring_perf_tests, rxfilter_perf_tests, xskfwdkm_test, xskmaprx_test, xskrestricted_test, downlevel_functional_tests]
+    needs: [build, build_allpackage, onebranch_build_validation, functional_tests, stress_tests, pktfuzz_tests, xskperf_tests, ring_perf_tests, rxfilter_perf_tests, xskfwdkm_test, xskmaprx_test, xskrestricted_test, downlevel_functional_tests, create_artifacts, sample_tests]
     runs-on: ubuntu-latest
     permissions: {}
     steps:

docs/api/XDP_HOOK_ID.md

@@ -1,5 +1,9 @@
 # XDP_HOOK_ID structure
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Specifies an XDP hook point.
 
 ## Syntax

docs/api/XDP_MATCH_PATTERN.md

@@ -1,5 +1,9 @@
 # XDP_MATCH_PATTERN structure
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Specifies an XDP inspection program rule match pattern.
 
 ```C

docs/api/XDP_MATCH_TYPE.md

@@ -1,6 +1,10 @@
 
 # XDP_MATCH_TYPE structure
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Specifies an XDP inspection program rule match type.
 
 ## Syntax

docs/api/XDP_RULE.md

@@ -1,5 +1,9 @@
 # XDP_RULE structure
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Specifies an XDP inspection program rule.
 
 ## Syntax

docs/api/XDP_RULE_ACTION.md

@@ -1,5 +1,9 @@
 # XDP_RULE_ACTION structure
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Specifies an XDP inspection program rule action.
 
 ## Syntax

docs/api/XdpCreateProgram.md

@@ -1,5 +1,9 @@
 # XdpCreateProgram function
 
+> **Deprecated:** The built-in rules-based program API is planned for removal.
+> All users should migrate to eBPF programs. See the
+> [eBPF Integration Guide](../ebpf.md) for migration instructions and examples.
+
 Creates a new XDP program.
 
 ## Syntax

docs/architecture.md

@@ -13,7 +13,7 @@ XDP for Windows is a high-performance packet processing framework inspired by Li
   - **Native XDP**: Requires NIC driver support for maximum performance and direct data path access.
 - Provides programmable hook points for packet inspection, modification, and redirection.
 - Implements shared memory rings for high-speed packet transfer between kernel and user mode.
-- Supports eBPF (experimental) for programmable packet processing.
+- Supports [eBPF](./ebpf.md) for programmable packet processing.
 
 ### 2. XDP API Headers (User Mode APIs)
 - Header-only APIs that expose the XDP API to applications (available for `XDP_API_VERSION_3` or later).
@@ -48,7 +48,8 @@ XDP for Windows is a high-performance packet processing framework inspired by Li
 - The driver is signed and uses standard Windows security mechanisms.
 
 ## Extensibility
-- XDP for Windows is designed to be extensible via eBPF (experimental) and a primitive built-in rules-based program engine.
+- XDP for Windows is designed to be extensible via [eBPF programs](./ebpf.md) through integration with [eBPF for Windows](https://github.com/microsoft/ebpf-for-windows).
+- The legacy built-in rules-based program engine is deprecated and planned for removal. See the [eBPF Integration Guide](./ebpf.md) for migration guidance.
 - New hook points and interface types can be added as needed.
 
 ## Comparison to Linux XDP
@@ -60,6 +61,8 @@ XDP for Windows is a high-performance packet processing framework inspired by Li
 ## References
 - [Usage Guide](./usage.md)
 - [AF_XDP API](./afxdp.md)
+- [eBPF Integration Guide](./ebpf.md)
+- [eBPF Redirect Map (XSKMAP)](./ebpf-redirect-map.md)
 - [FAQ](./faq.md)
 - [Threat Model](./threat-model.md)