Skip to content

docs: Describe SESSION_TRACK_GTIDS in the OK packet - #862

Open
altmannmarcelo wants to merge 1 commit into
mysql:trunkfrom
altmannmarcelo:doc-session-track-gtids
Open

altmannmarcelo wants to merge 1 commit into
mysql:trunkfrom
altmannmarcelo:doc-session-track-gtids

Conversation

@altmannmarcelo

@altmannmarcelo altmannmarcelo commented Oct 20, 2026 •

Copy link
Copy Markdown

What does this change do?

Describe its data field: an int encoding spec, where only 0 is defined, followed by the GTID set as a string. Note when the server sends it, and add an example captured with session_track_gtids = ALL_GTIDS.

Why is it needed?

The Session State Information docs covered the other trackers but not SESSION_TRACK_GTIDS. Its layout was defined only in code, so client libraries parsed it wrong.

How was it tested?

  • Added/updated MTR tests under mysql-test/
  • scripts/ci/mtr.sh passes locally
  • Ran the relevant full suite (name it): ______
  • N/A

Contributor checklist

  • Code is formatted (scripts/ci/format.sh)
  • Commits are focused with descriptive messages

AI assistance

  • I did not use AI assistance for this contribution
  • I used AI assistance for this contribution

If AI assistance was used, describe the tool(s) and extent of use:

Claude used to brainstorm and find the functions in the source code.

Areas touched

Docs

The Session State Information docs covered the other trackers but not
SESSION_TRACK_GTIDS. Its layout was defined only in code, so client
libraries parsed it wrong.

Describe its data field: an int<lenenc> encoding spec, where only 0 is
defined, followed by the GTID set as a string<lenenc>. Note when the
server sends it, and add an example captured with session_track_gtids =
ALL_GTIDS.
@altmannmarcelo
altmannmarcelo requested a review from a team October 20, 2026 17:34
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Oct 20, 2026
@github-actions github-actions Bot added Review Requested Review requested from code owners Build Failed PR build failed labels Oct 20, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No high-confidence defects found in this documentation-only change. Checked the documented layout and send conditions against the server encoder and client decoder, and validated the example's tracker type, length fields, and GTID text. No PR code or test scripts were executed.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • ab.chatgpt.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "ab.chatgpt.com"

See Network Configuration for more information.

Generated by Codex PR Review for #862 · codex · gpt60 · 57.6 AIC · ⌖ 23.8 AIC · ⊞ 13.9K
Comment /codex to run again

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

Labels

Build Failed PR build failed OCA Verified All contributors have signed the Oracle Contributor Agreement. Review Requested Review requested from code owners

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant