TrustedFirmware Git Browser
Code Review Sign In
review.trustedfirmware.org / mirror / mbed-tls / 1e9423704a2379228828152a2f05d123e181cf9f / . / include / polarssl / error.h
blob: a28842d5876434bc6ed3cd9c37a22707225857a3 [file] [log] [blame]
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]1/**
2 * \file error.h
3 *
4 * \brief Error to string translation
5 *
6 * Copyright (C) 2006-2010, Brainspark B.V.
7 *
8 * This file is part of PolarSSL (http://www.polarssl.org)
9 * Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>
10 *
11 * All rights reserved.
12 *
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2 of the License, or
16 * (at your option) any later version.
17 *
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License along
24 * with this program; if not, write to the Free Software Foundation, Inc.,
25 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 */
27#ifndef POLARSSL_ERROR_H
28#define POLARSSL_ERROR_H
29
Paul Bakkereae09db2013-06-06 12:35:54 +0200[diff] [blame]30#include <string.h>
31
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]32/**
33 * Error code layout.
34 *
35 * Currently we try to keep all error codes within the negative space of 16
36 * bytes signed integers to support all platforms (-0x0000 - -0x8000). In
37 * addition we'd like to give two layers of information on the error if
38 * possible.
39 *
40 * For that purpose the error codes are segmented in the following manner:
41 *
42 * 16 bit error code bit-segmentation
43 *
44 * 1 bit - Intentionally not used
45 * 3 bits - High level module ID
46 * 5 bits - Module-dependent error code
47 * 6 bits - Low level module errors
48 * 1 bit - Intentionally not used
49 *
50 * Low-level module errors (0x007E-0x0002)
51 *
52 * Module Nr Codes assigned
Paul Bakker69e095c2011-12-10 21:55:01 +0000[diff] [blame]53 * MPI 7 0x0002-0x0010
Paul Bakkerd8ef1672012-04-18 14:17:32 +0000[diff] [blame]54 * GCM 2 0x0012-0x0014
Paul Bakkera9379c02012-07-04 11:02:11 +0000[diff] [blame]55 * BLOWFISH 2 0x0016-0x0018
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]56 * AES 2 0x0020-0x0022
57 * CAMELLIA 2 0x0024-0x0026
58 * XTEA 1 0x0028-0x0028
Paul Bakker69e095c2011-12-10 21:55:01 +0000[diff] [blame]59 * BASE64 2 0x002A-0x002C
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]60 * PADLOCK 1 0x0030-0x0030
61 * DES 1 0x0032-0x0032
Paul Bakker69e095c2011-12-10 21:55:01 +0000[diff] [blame]62 * CTR_DBRG 3 0x0034-0x003A
Paul Bakker43655f42011-12-15 20:11:16 +0000[diff] [blame]63 * ENTROPY 3 0x003C-0x0040
Paul Bakkerbdb912d2012-02-13 23:11:30 +0000[diff] [blame]64 * NET 11 0x0042-0x0056
Paul Bakker1e942372014-03-26 11:54:05 +0100[diff] [blame^]65 * ENTROPY 1 0x0058-0x0058
Paul Bakkerbdb912d2012-02-13 23:11:30 +0000[diff] [blame]66 * ASN1 7 0x0060-0x006C
Paul Bakker69e095c2011-12-10 21:55:01 +0000[diff] [blame]67 * MD2 1 0x0070-0x0070
68 * MD4 1 0x0072-0x0072
69 * MD5 1 0x0074-0x0074
70 * SHA1 1 0x0076-0x0076
71 * SHA2 1 0x0078-0x0078
72 * SHA4 1 0x007A-0x007A
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]73 *
74 * High-level module nr (3 bits - 0x1...-0x8...)
75 * Name ID Nr of Errors
Paul Bakker9255e832013-06-06 14:58:28 +0200[diff] [blame]76 * PEM 1 9
Paul Bakker14a222c2013-06-18 16:35:48 +0200[diff] [blame]77 * PKCS#12 1 4 (Started from top)
Paul Bakker1fd43212013-06-17 15:14:42 +0200[diff] [blame]78 * X509 2 23
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]79 * DHM 3 6
Paul Bakker1fd43212013-06-17 15:14:42 +0200[diff] [blame]80 * PKCS5 3 4 (Started from top)
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]81 * RSA 4 9
Paul Bakker8913f822012-01-14 18:07:41 +0000[diff] [blame]82 * MD 5 4
83 * CIPHER 6 5
Manuel Pégourié-Gonnardbe046732014-03-10 21:20:29 +0100[diff] [blame]84 * SSL 6 3 (Started from top)
Paul Bakker05ef8352012-05-08 09:17:57 +0000[diff] [blame]85 * SSL 7 31
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]86 *
87 * Module dependent error code (5 bits 0x.08.-0x.F8.)
88 */
89
Paul Bakkerbcd5db42011-05-20 12:30:59 +0000[diff] [blame]90#ifdef __cplusplus
91extern "C" {
92#endif
93
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]94/**
95 * \brief Translate a PolarSSL error code into a string representation,
96 * Result is truncated if necessary and always includes a terminating
97 * null byte.
98 *
99 * \param errnum error code
100 * \param buffer buffer to place representation in
101 * \param buflen length of the buffer
102 */
103void error_strerror( int errnum, char *buffer, size_t buflen );
104
Paul Bakkerbcd5db42011-05-20 12:30:59 +0000[diff] [blame]105#ifdef __cplusplus
106}
107#endif
108
Paul Bakker9d781402011-05-09 16:17:09 +0000[diff] [blame]109#endif /* error.h */