From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Library:Mbed TLS" |
|---|
| claim | "In Mbed TLS up to 3.6 (the layout is documented in include/mbedtls/error.h) error codes are negative 16-bit values: bits 12-14 a high-level module (1 PEM/PKCS12, 2 X509/PKCS5, 3 DHM/PK, 4 RSA/ECP, 5 MD/HKDF/PKCS7/SSL, 6 CIPHER/SSL, 7 SSL), bits 7-11 the module's error, bits 0-6 a low-level module error (MPI 0x02-0x10, AES 0x20-0x25, NET 0x42-0x52, ASN1 0x60-0x6C ...). High-level functions return the sum of both (MBEDTLS_ERROR_ADD), e.g. -0x4080 RSA_BAD_INPUT_DATA + -0x0010 MPI_ALLOC_FAILED = -0x4090; mbedtls_strerror prints the two texts joined by " : ". In Mbed TLS 4.0 / TF-PSA-Crypto 1.0 several MBEDTLS_ERR_* names are aliases of PSA_ERROR_* codes (for example MBEDTLS_ERR_SSL_BAD_INPUT_DATA = PSA_ERROR_INVALID_ARGUMENT), so this bit layout no longer describes all codes there." |
|---|
| scope | | level | "library" |
|---|
| applies_to | "Library:Mbed TLS" |
|---|
| observed_in | |
|---|
|
|---|
| data | | effect | "error = -(high_module_error | low_module_error); decode by taking -err & 0xFF80 and -err & 0x007F" |
|---|
| function | "mbedtls_error_add, mbedtls_strerror" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "16 bit error code bit-segmentation: 1 bit unused (sign), 3 bits high level module ID, 5 bits module-dependent error code, 7 bits low level module errors; tables of low-level ranges and high-level IDs" |
|---|
| repo | "https://github.com/Mbed-TLS/mbedtls" |
|---|
| commit | "068ff080b369adfac81509f9b57b2afabaf82dc5" |
|---|
| path | "include/mbedtls/error.h" |
|---|
| lines | "18-90" |
|---|
|
| type | "source" |
|---|
| detail | "#define MBEDTLS_ERR_RSA_BAD_INPUT_DATA -0x4080 (rsa.h line 33); #define MBEDTLS_ERR_MPI_ALLOC_FAILED -0x0010 (bignum.h line 39); error.c line 846 " : "" |
|---|
| repo | "https://github.com/Mbed-TLS/mbedtls" |
|---|
| commit | "068ff080b369adfac81509f9b57b2afabaf82dc5" |
|---|
| path | "include/mbedtls/rsa.h" |
|---|
| lines | "33" |
|---|
|
| type | "source" |
|---|
| detail | "4.0.0: ssl.h defines MBEDTLS_ERR_SSL_BAD_INPUT_DATA as PSA_ERROR_INVALID_ARGUMENT (and ALLOC_FAILED as PSA_ERROR_INSUFFICIENT_MEMORY) while others keep -0x7xxx; TF-PSA-Crypto drivers/builtin/include/mbedtls/private/error_common.h (submodule commit 76920edddcad00ac41b248e12d937b845df7bedb) says the high/low distinction is obsolete since Mbed TLS 4.0" |
|---|
| repo | "https://github.com/Mbed-TLS/mbedtls" |
|---|
| commit | "ec4044008d2d069da38288bc76b0fee34ec78646" |
|---|
| path | "include/mbedtls/ssl.h" |
|---|
| lines | "43-110" |
|---|
|
| type | "source" |
|---|
| detail | "3.6.0 include/mbedtls/error.h still has the same 1+3+5+7 bit comment and MBEDTLS_ERROR_ADD" |
|---|
| repo | "https://github.com/Mbed-TLS/mbedtls" |
|---|
| commit | "2ca6c285a0dd3f33982dd57299012dacab1ff206" |
|---|
| path | "include/mbedtls/error.h" |
|---|
| lines | "18-120" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Error code layout" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-17T08:11:27.588Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T06:02:48.403Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read include/mbedtls/error.h lines 18-95 at Mbed-TLS 068ff08: 1 unused sign bit, 3 bits high-level module, 5 bits module error, 7 bits low-level; low-level ranges MPI 0x02-0x10, AES 0x20-0x25, NET 0x42-0x52, ASN1 0x60-0x6C and the high-level ID table match. Did not re-read error.c or rsa.h/bignum.h constants." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T06:08:26.761Z" |
|---|
| summary | "The 16-bit high/low layout holds up to Mbed TLS 3.6; in 4.0 many codes became PSA_ERROR_* values and the high/low distinction is documented as obsolete (read include/mbedtls/error.h at 3.6.0, ssl.h…" |
|---|
| changed | |
|---|
|
|
|---|