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

2.28 -> 3.6 migration help #9898

Open
mpg opened this issue Jan 13, 2025 · 1 comment
Open

2.28 -> 3.6 migration help #9898

mpg opened this issue Jan 13, 2025 · 1 comment
Labels
size-s Estimated task size: small (~2d)

Comments

@mpg
Copy link
Contributor

mpg commented Jan 13, 2025

As 2.28 reaches end of life, we can expect more people migrating to 3.6 (the current LTS branch).

We have not fully addressed yet all know issues related to making most struct members private. We should:

  • Encourage affected users to let us know so that we can properly support their use case in a future 3.6 release.
  • Explain that MBEDTLS_PRIVATE is a work-around that is less dangerous in an LTS branch than in general (thanks to our ABI stability goals in LTS branches). A good place would be the existing 3.0 migration guide.
    This should be mentioned in the release announcement.

It would also be good to do a general quick pass over docs/3.0-migration-guide.md to check if anything needs updating.

@mpg mpg added the size-s Estimated task size: small (~2d) label Jan 13, 2025
@mpg mpg moved this to 3.6.3 / 2.28.10 (final) release in Mbed TLS Epics Jan 13, 2025
@mpg
Copy link
Contributor Author

mpg commented Jan 14, 2025

It would also be good to do a general quick pass over docs/3.0-migration-guide.md to check if anything needs updating.

One thing that needs updating: the document is currently recommending mbedtls_ssl_conf_curves() which is deprecated in favour of mbedtls_ssl_conf_groups() since 3.1. Should probably mention conf_groups() only at this point (nobody should be using 3.0 as it's not maintained).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size-s Estimated task size: small (~2d)
Projects
Status: 3.6.3 / 2.28.10 (final) release
Development

No branches or pull requests

1 participant