• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /**
2  * @file
3  * Error Management module
4  *
5  */
6 
7 /*
8  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without modification,
12  * are permitted provided that the following conditions are met:
13  *
14  * 1. Redistributions of source code must retain the above copyright notice,
15  *    this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright notice,
17  *    this list of conditions and the following disclaimer in the documentation
18  *    and/or other materials provided with the distribution.
19  * 3. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
23  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
24  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
25  * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
27  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
30  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
31  * OF SUCH DAMAGE.
32  *
33  * This file is part of the lwIP TCP/IP stack.
34  *
35  * Author: Adam Dunkels <adam@sics.se>
36  *
37  */
38 
39 #include "lwip/err.h"
40 #include "lwip/def.h"
41 #include "lwip/sys.h"
42 
43 #include "lwip/errno.h"
44 
45 #if !NO_SYS
46 /** Table to quickly map an lwIP error (err_t) to a socket error
47   * by using -err as an index */
48 static const int err_to_errno_table[] = {
49   0,             /* ERR_OK          0      No error, everything OK. */
50   ENOMEM,        /* ERR_MEM        -1      Out of memory error.     */
51   ENOBUFS,       /* ERR_BUF        -2      Buffer error.            */
52   EWOULDBLOCK,   /* ERR_TIMEOUT    -3      Timeout                  */
53   EHOSTUNREACH,  /* ERR_RTE        -4      Routing problem.         */
54   EINPROGRESS,   /* ERR_INPROGRESS -5      Operation in progress    */
55   EINVAL,        /* ERR_VAL        -6      Illegal value.           */
56   EWOULDBLOCK,   /* ERR_WOULDBLOCK -7      Operation would block.   */
57   EADDRINUSE,    /* ERR_USE        -8      Address in use.          */
58   EALREADY,      /* ERR_ALREADY    -9      Already connecting.      */
59   EISCONN,       /* ERR_ISCONN     -10     Conn already established.*/
60   ENOTCONN,      /* ERR_CONN       -11     Not connected.           */
61   -1,            /* ERR_IF         -12     Low-level netif error    */
62   EMSGSIZE,      /* ERR_MSGSIZE    -13     Message too long. */
63   ENODEV,        /* ERR_NODEV      -14     No such device. */
64   ENXIO,         /* ERR_NODEVADDR  -15     No such device or address. */
65   EDESTADDRREQ,  /* ERR_NODEST     -16     socket is not connection-mode & no peer address is set. */
66   ENETDOWN,      /* ERR_NETDOWN    -17     Network is down. */
67   EAFNOSUPPORT,  /* ERR_AFNOSUPP   -18     Address family not supported by protocol. */
68   EADDRNOTAVAIL, /* ERR_NOADDR     -19     Cannot assign requested address */
69   EOPNOTSUPP,    /* ERR_OPNOTSUPP  -20     Operation not supported on transport endpoint */
70   ENETUNREACH,   /* ERR_NETUNREACH -21     No route to the network */
71   ETIMEDOUT,     /* ERR_CONNECTIMEOUT -22  Connection request timedout */
72   EPIPE,         /* ERR_PIPE       -23     PIPE Error. */
73   EAFNOSUPPORT,  /* ERR_AFNOSUPPORT -24    AF not supported */
74   ENOPROTOOPT,   /* ERR_NOPROTOOPT -25     Protocol not available */
75   EACCES,        /* ERR_ACCESS     -26     Error to access */
76   ENFILE,        /* ERR_NFILE      -27     Socket out of resources */
77   EIO,           /* ERR_RESERVE3   -28     Reserved for future use */
78   EIO,           /* ERR_RESERVE4   -29     Reserved for future use */
79   EIO,           /* ERR_RESERVE5   -30     Reserved for future use */
80   EIO,           /* ERR_RESERVE6   -31     Reserved for future use */
81   EIO,           /* ERR_RESERVE7   -32     Reserved for future use */
82   ECONNABORTED,  /* ERR_ABRT       -33     Connection aborted. */
83   ECONNRESET,    /* ERR_RST        -34     Connection reset. */
84   ENOTCONN,      /* ERR_CLSD       -35     Connection closed. */
85   EIO,           /* ERR_ARG        -36     Illegal argument. */
86   ECONNREFUSED,  /* ERR_CONNREFUSED -37    Connection refused. */
87   -2,            /* ERR_MAX_VAL    -38     Invalid error */
88 };
89 
90 int
err_to_errno(err_t err)91 err_to_errno(err_t err)
92 {
93   if ((err > 0) || (-err >= (err_t)LWIP_ARRAYSIZE(err_to_errno_table))) {
94     return EIO;
95   }
96   return err_to_errno_table[-err];
97 }
98 #endif /* !NO_SYS */
99 
100 #ifdef LWIP_DEBUG
101 
102 static const char *err_strerr[] = {
103   "Ok.",                    /* ERR_OK          0  */
104   "Out of memory error.",   /* ERR_MEM        -1  */
105   "Buffer error.",          /* ERR_BUF        -2  */
106   "Timeout.",               /* ERR_TIMEOUT    -3  */
107   "Routing problem.",       /* ERR_RTE        -4  */
108   "Operation in progress.", /* ERR_INPROGRESS -5  */
109   "Illegal value.",         /* ERR_VAL        -6  */
110   "Operation would block.", /* ERR_WOULDBLOCK -7  */
111   "Address in use.",        /* ERR_USE        -8  */
112   "Already connecting.",    /* ERR_ALREADY    -9  */
113   "Already connected.",     /* ERR_ISCONN     -10 */
114   "Not connected.",         /* ERR_CONN       -11 */
115   "Low-level netif error.", /* ERR_IF         -12 */
116   "Message too long.",          /* ERR_MSGSIZE    -13 */
117   "No such device.",            /* ERR_NODEV      -14 */
118   "No such device or address.", /* ERR_NODEVADDR  -15 */
119   "socket is not connection-mode & no peer address is set.", /* ERR_NODEST  -16 */
120   "Network is down.",           /* ERR_NETDOWN    -17 */
121   "Address family not supported by protocol.",     /* ERR_AFNOSUPP   -18 */
122   "Cannot assign requested address",               /* ERR_NOADDR     -19 */
123   "Operation not supported on transport endpoint", /* ERR_OPNOTSUPP  -20 */
124   "No route to the network",    /* ERR_NETUNREACH  -21 */
125   "Connection request timedout", /* ERR_CONNECTIMEOUT -22 */
126   "PIPE Error.",                /* ERR_PIPE       -23 */
127   "AF not supported",           /* ERR_AFNOSUPPORT -24 */
128   "Protocol not available",     /* ERR_NOPROTOOPT -25 */
129   "Reserved for future use",    /* ERR_RESERVE1   -26 */
130   "Reserved for future use",    /* ERR_RESERVE2   -27 */
131   "Reserved for future use",    /* ERR_RESERVE3   -28 */
132   "Reserved for future use",    /* ERR_RESERVE4   -29 */
133   "Reserved for future use",    /* ERR_RESERVE5   -30 */
134   "Reserved for future use",    /* ERR_RESERVE6   -31 */
135   "Reserved for future use",    /* ERR_RESERVE7   -32 */
136   "Connection aborted.",        /* ERR_ABRT       -33 */
137   "Connection reset.",          /* ERR_RST        -34 */
138   "Connection closed.",         /* ERR_CLSD       -35 */
139   "Illegal argument.",          /* ERR_ARG        -36 */
140   "Connection refused.",        /* ERR_CONNREFUSED -37 */
141   "Invalid error code"          /* ERR_MAX_VAL    -38 */
142 };
143 
144 /**
145  * Convert an lwip internal error to a string representation.
146  *
147  * @param err an lwip internal err_t
148  * @return a string representation for err
149  */
150 const char *
lwip_strerr(err_t err)151 lwip_strerr(err_t err)
152 {
153   if ((err > 0) || (-err >= (err_t)LWIP_ARRAYSIZE(err_strerr))) {
154     return "Unknown error.";
155   }
156   return err_strerr[-err];
157 }
158 
159 #endif /* LWIP_DEBUG */
160