Skip to content
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.

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

Make header field lengths and descriptions consistent #53

Open
nicorusti opened this issue Aug 25, 2024 · 0 comments
Open

Make header field lengths and descriptions consistent #53

nicorusti opened this issue Aug 25, 2024 · 0 comments

Comments

@nicorusti
Copy link
Member

We describe header fields and their lengths in various ways, for example:

  • FlowID: This 20-bit field
  • PayloadLen: Specifies the length of the payload in bytes. The payload includes (SCION) extension headers and the L4 payload. This field is 16 bits long, supporting a maximum payload size of 65'535 bytes.
  • Sometimes field length is missing and it is only inferrable from a figure

We should switch to something more consistent.

Ideas:

  • FieldName (xx bits): field description
  • Define and use a custom format, like RFC9000 (QUIC):
   Example Structure {
     One-bit Field (1),
     7-bit Field with Fixed Value (7) = 61,
     Field with Variable-Length Integer (i),
     Arbitrary-Length Field (..),
     Variable-Length Field (8..24),
     Field With Minimum Length (16..),
     Field With Maximum Length (..128),
     [Optional Field (64)],
     Repeated Field (8) ...,
   }

I'd ask Eliot for recommendations before doing anything, so I keep this issue with low prio

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

No branches or pull requests

1 participant