Skip to content

[doc][vpp] HLD for Router Interface Loopback Packet Action on the VPP dataplane#258

Closed
aaronber0614 wants to merge 2 commits into
sonic-net:masterfrom
aaronber0614:vpp-iface-loopback-action
Closed

[doc][vpp] HLD for Router Interface Loopback Packet Action on the VPP dataplane#258
aaronber0614 wants to merge 2 commits into
sonic-net:masterfrom
aaronber0614:vpp-iface-loopback-action

Conversation

@aaronber0614

@aaronber0614 aaronber0614 commented Jul 9, 2026

Copy link
Copy Markdown

Why I did it

Document the design for SAI_ROUTER_INTERFACE_ATTR_LOOPBACK_PACKET_ACTION (drop or forward a routed "hairpin" packet whose next hop egresses its ingress RIF) on the VPP dataplane, ahead of the implementation PRs, so reviewers can align on the approach first.

Feature tracking issue: sonic-net/sonic-buildimage#25788

How I did it

Added a feature HLD under docs/HLD/ following the existing feature-HLD convention: motivation, the RIF-shape matrix, the plugin approach (with alternatives considered), the SAI and CONFIG_DB surface, the VPP node, binary API and counter design, a test plan with live-DUT validation results, and the pre-existing defects found during enablement.

How to verify it

Documentation only. Renders under docs/HLD/vpp-iface-loopback-action.md.

Which release branch to backport (provide reason below if selected)

None.

Description for the changelog

Add HLD: Router Interface Loopback Packet Action on the VPP dataplane.

Part of sonic-net/sonic-buildimage#25788.


PR series (landing order)

Tracking issue: sonic-net/sonic-buildimage#25788

  1. HLD: [doc][vpp] HLD for Router Interface Loopback Packet Action on the VPP dataplane #258
  2. sonic_ext plugin, nodes and binary API: [vpp] Add sonic_ext RIF loopback packet action nodes and binary API #259
  3. vslib/vpp SAI adapter and defect fixes: [vpp] SAI RIF loopback packet action and pre-existing VPP vslib defect fixes sonic-sairedis#1983 (depends on 2)
  4. Testbed virtio ctrl_vlan off: [vpp][testbed] Disable virtio ctrl_vlan on VPP KVM DUTs sonic-mgmt#26035
  5. Enablement, lands last: [vpp][ci] Enable iface_loopback_action test on the t1-lag-vpp testbed sonic-mgmt#26036 (depends on 2, 3, 4)

aaronber0614 and others added 2 commits July 9, 2026 19:06
…BACK_PACKET_ACTION)

HLD for supporting SAI_ROUTER_INTERFACE_ATTR_LOOPBACK_PACKET_ACTION on sonic-vpp: drop or forward a routed packet that hairpins back out the RIF it ingressed on, via the consolidated sonic_ext VPP plugin's ip4/ip6-loopback output-arc nodes, programmed per-RIF by saivpp. Tracks sonic-net/sonic-buildimage#25788.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Aaron Bernardino <aaronber@microsoft.com>
§8.4 previously cited only test_loopback_action_basic ("1 passed,
~8.5 min"); the module now runs and passes all three cases
(basic + port_flap + reload) in ~17 min. Update §8.4 and the §9
intro accordingly. No design changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mssonicbld

Copy link
Copy Markdown

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines successfully started running 1 pipeline(s).

@aaronber0614

Copy link
Copy Markdown
Author

Moving this HLD to the SONiC design-docs repo per review guidance: it now lives at doc/vpp/vpp-iface-loopback-action.md in sonic-net/SONiC#2462. Closing this PR in favor of that one. The rest of the implementation series is unchanged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants