PolarSSL v1.1.4
|
Error to string translation. More...
Go to the source code of this file.
Functions | |
void | error_strerror (int errnum, char *buffer, size_t buflen) |
Error code layout. |
Error to string translation.
Copyright (C) 2006-2010, Brainspark B.V.
This file is part of PolarSSL (http://www.polarssl.org) Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>
All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Definition in file error.h.
void error_strerror | ( | int | errnum, |
char * | buffer, | ||
size_t | buflen | ||
) |
Error code layout.
Currently we try to keep all error codes within the negative space of 16 bytes signed integers to support all platforms (-0x0000 - -0x8000). In addition we'd like to give two layers of information on the error if possible.
For that purpose the error codes are segmented in the following manner:
16 bit error code bit-segmentation
1 bit - Intentionally not used 3 bits - High level module ID 5 bits - Module-dependent error code 6 bits - Low level module errors 1 bit - Intentionally not used
Low-level module errors (0x007E-0x0002)
Module Nr Codes assigned MPI 7 0x0002-0x0010 ASN1 6 0x0014-0x001E AES 2 0x0020-0x0022 CAMELLIA 2 0x0024-0x0026 XTEA 1 0x0028-0x0028 BASE64 2 0x002A-0x002C PADLOCK 1 0x0030-0x0030 DES 1 0x0032-0x0032 NET 11 0x0040-0x0054 CTR_DBRG 3 0x0034-0x003A ENTROPY 3 0x003C-0x0040 MD2 1 0x0070-0x0070 MD4 1 0x0072-0x0072 MD5 1 0x0074-0x0074 SHA1 1 0x0076-0x0076 SHA2 1 0x0078-0x0078 SHA4 1 0x007A-0x007A
High-level module nr (3 bits - 0x1...-0x8...) Name ID Nr of Errors PEM 1 8 X509 2 21 DHM 3 6 RSA 4 9 MD 5 4 CIPHER 6 5 SSL 7 30
Module dependent error code (5 bits 0x.08.-0x.F8.) Translate a PolarSSL error code into a string representation, Result is truncated if necessary and always includes a terminating null byte.
errnum | error code |
buffer | buffer to place representation in |
buflen | length of the buffer |