| Hanno Becker | 548b136 | 2021-05-14 16:09:15 +0100 | [diff] [blame] | 1 | Remove the SSL API mbedtls_ssl_get_session_pointer() |
| 2 | ----------------------------------------------------------------- |
| 3 | |
| 4 | This affects two classes of users: |
| 5 | |
| 6 | 1. Users who manually inspect parts of the current session through |
| 7 | direct structure field access. |
| 8 | |
| 9 | 2. Users of session resumption who query the current session |
| 10 | via `mbedtls_ssl_get_session_pointer()` prior to saving or exporting |
| 11 | it via `mbedtls_ssl_session_copy()` or `mbedtls_ssl_session_save()`, |
| 12 | respectively. |
| 13 | |
| 14 | Migration paths: |
| 15 | |
| 16 | 1. Mbed TLS 3.0 does not offer a migration path for the usecase 1: Like many |
| 17 | other Mbed TLS structures, the structure of `mbedtls_ssl_session` is no |
| 18 | longer part of the public API in Mbed TLS 3.0, and direct structure field |
| 19 | access is no longer supported. Please see the corresponding migration guide. |
| 20 | |
| 21 | 2. Users should replace calls to `mbedtls_ssl_get_session_pointer()` by |
| 22 | calls to `mbedtls_ssl_get_session()` as demonstrated in the example |
| 23 | program `programs/ssl/ssl_client2.c`. |
