Skip to content

[doc]: Clarify HFT enterprise number layout - #2537

Merged
Pterosaur merged 1 commit into
sonic-net:masterfrom
Pterosaur:fix/hft-enterprise-number-layout
Sep 5, 2026
Merged

[doc]: Clarify HFT enterprise number layout#2537
Pterosaur merged 1 commit into
sonic-net:masterfrom
Pterosaur:fix/hft-enterprise-number-layout

Conversation

@Pterosaur

@Pterosaur Pterosaur commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

What I did

Clarified the HFT IPFIX enterprise-number wire layout and corrected the example value:

  • the first 16 bits on the wire encode the SAI object type;
  • the following 16 bits encode the SAI stats ID;
  • multi-byte values use network byte order.

For queue type 0x0015 and stat ID 0x0022, this gives 0x00150022, or wire bytes 00 15 00 22.

Why I did it

The previous formula placed the stat ID in the high 16 bits and contradicted both the adjacent bit diagram and the current countersyncd HFT IPFIX decoder.

How I verified it

This is a one-line documentation correction. git diff --check passes and the old example value no longer appears in the HLD.

The matching OCP SAI documentation change is submitted separately.

Matching OCP SAI PR: opencomputeproject/SAI#2346

Signed-off-by: Ze Gan <ganze718@gmail.com>
@mssonicbld

Copy link
Copy Markdown
Collaborator

/azp run

@azure-pipelines

Copy link
Copy Markdown
No pipelines are associated with this pull request.

Pterosaur added a commit to opencomputeproject/SAI that referenced this pull request Sep 5, 2026
What I did
Clarified the HFT IPFIX enterprise-number wire layout and corrected the example value:

the first 16 bits on the wire encode the SAI object type;
the following 16 bits encode the SAI stats ID;
multi-byte values use network byte order.
For queue type 0x0015 and stat ID 0x0022, this gives 0x00150022, or wire bytes 00 15 00 22.

Why I did it
The previous formula placed the stat ID in the high 16 bits and contradicted both the adjacent bit diagram and the current SONiC countersyncd HFT IPFIX decoder.

How I verified it
This is a one-line documentation correction. git diff --check passes and the old example value no longer appears in the document.

The matching sonic-net/SONiC HLD change is submitted separately.

Matching SONiC HLD PR: sonic-net/SONiC#2537

Signed-off-by: Ze Gan <ganze718@gmail.com>
@Pterosaur
Pterosaur merged commit 4641bed into sonic-net:master Sep 5, 2026
2 checks passed
@Pterosaur
Pterosaur deleted the fix/hft-enterprise-number-layout branch September 5, 2026 08:36
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.

3 participants