| Gilles Peskine | 2c77014 | 2025-06-25 15:39:10 +0200 | [diff] [blame^] | 1 | ## Private declarations |
| 2 | |
| 3 | Sample programs have not been fully updated yet and some of them might still |
| 4 | use APIs that are no longer public. You can recognize them by the fact that they |
| 5 | define the macro `MBEDTLS_DECLARE_PRIVATE_IDENTIFIERS` (or |
| 6 | `MBEDTLS_ALLOW_PRIVATE_ACCESS`) at the very top (before including headers). When |
| 7 | you see one of these two macros in a sample program, be aware it has not been |
| 8 | updated and parts of it do not demonstrate current practice. |
| 9 | |
| 10 | We strongly recommend against defining `MBEDTLS_DECLARE_PRIVATE_IDENTIFIERS` or |
| 11 | `MBEDTLS_ALLOW_PRIVATE_ACCESS` in your own application. If you do so, your code |
| 12 | may not compile or work with future minor releases. If there's something you |
| 13 | want to do that you feel can only be achieved by using one of these two macros, |
| 14 | please reach out on github or the mailing list. |