Daiki Kato / mbed-os-lychee

mbed-os for GR-LYCHEE

Dependents:   mbed-os-example-blinky-gr-lychee GR-Boads_Camera_sample GR-Boards_Audio_Recoder GR-Boads_Camera_DisplayApp ... more

features/FEATURE_LWIP/lwip-interface/lwip/UPGRADING@0:f782d9c66c49, 2018-02-02 (annotated)

Committer:
dkato
Date:
Fri Feb 02 05:42:23 2018 +0000
Revision:
0:f782d9c66c49
mbed-os for GR-LYCHEE

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:f782d9c66c49 1 This file lists major changes between release versions that require
dkato 0:f782d9c66c49 2 ports or applications to be changed. Use it to update a port or an
dkato 0:f782d9c66c49 3 application written for an older version of lwIP to correctly work
dkato 0:f782d9c66c49 4 with newer versions.
dkato 0:f782d9c66c49 5
dkato 0:f782d9c66c49 6
dkato 0:f782d9c66c49 7 (git master)
dkato 0:f782d9c66c49 8
dkato 0:f782d9c66c49 9 * [Enter new changes just after this line - do not remove this line]
dkato 0:f782d9c66c49 10
dkato 0:f782d9c66c49 11 (2.0.1)
dkato 0:f782d9c66c49 12
dkato 0:f782d9c66c49 13 ++ Application changes:
dkato 0:f782d9c66c49 14
dkato 0:f782d9c66c49 15 * UDP does NOT receive multicast traffic from ALL netifs on an UDP PCB bound to a specific
dkato 0:f782d9c66c49 16 netif any more. Users need to bind to IP_ADDR_ANY to receive multicast traffic and compare
dkato 0:f782d9c66c49 17 ip_current_netif() to the desired netif for every packet.
dkato 0:f782d9c66c49 18 See bug #49662 for an explanation.
dkato 0:f782d9c66c49 19
dkato 0:f782d9c66c49 20 (2.0.0)
dkato 0:f782d9c66c49 21
dkato 0:f782d9c66c49 22 ++ Application changes:
dkato 0:f782d9c66c49 23
dkato 0:f782d9c66c49 24 * Changed netif "up" flag handling to be an administrative flag (as opposed to the previous meaning of
dkato 0:f782d9c66c49 25 "ip4-address-valid", a netif will now not be used for transmission if not up) -> even a DHCP netif
dkato 0:f782d9c66c49 26 has to be set "up" before starting the DHCP client
dkato 0:f782d9c66c49 27 * Added IPv6 support (dual-stack or IPv4/IPv6 only)
dkato 0:f782d9c66c49 28 * Changed ip_addr_t to be a union in dual-stack mode (use ip4_addr_t where referring to IPv4 only).
dkato 0:f782d9c66c49 29 * Major rewrite of SNMP (added MIB parser that creates code stubs for custom MIBs);
dkato 0:f782d9c66c49 30 supports SNMPv2c (experimental v3 support)
dkato 0:f782d9c66c49 31 * Moved some core applications from contrib repository to src/apps (and include/lwip/apps)
dkato 0:f782d9c66c49 32
dkato 0:f782d9c66c49 33 +++ Raw API:
dkato 0:f782d9c66c49 34 * Changed TCP listen backlog: removed tcp_accepted(), added the function pair tcp_backlog_delayed()/
dkato 0:f782d9c66c49 35 tcp_backlog_accepted() to explicitly delay backlog handling on a connection pcb
dkato 0:f782d9c66c49 36
dkato 0:f782d9c66c49 37 +++ Socket API:
dkato 0:f782d9c66c49 38 * Added an implementation for posix sendmsg()
dkato 0:f782d9c66c49 39 * Added LWIP_FIONREAD_LINUXMODE that makes ioctl/FIONREAD return the size of the next pending datagram
dkato 0:f782d9c66c49 40
dkato 0:f782d9c66c49 41 ++ Port changes
dkato 0:f782d9c66c49 42
dkato 0:f782d9c66c49 43 +++ new files:
dkato 0:f782d9c66c49 44 * MANY new and moved files!
dkato 0:f782d9c66c49 45 * Added src/Filelists.mk for use in Makefile projects
dkato 0:f782d9c66c49 46 * Continued moving stack-internal parts from abc.h to abc_priv.h in sub-folder "priv"
dkato 0:f782d9c66c49 47 to let abc.h only contain the actual application programmer's API
dkato 0:f782d9c66c49 48
dkato 0:f782d9c66c49 49 +++ sys layer:
dkato 0:f782d9c66c49 50 * Made LWIP_TCPIP_CORE_LOCKING==1 the default as it usually performs better than
dkato 0:f782d9c66c49 51 the traditional message passing (although with LWIP_COMPAT_MUTEX you are still
dkato 0:f782d9c66c49 52 open to priority inversion, so this is not recommended any more)
dkato 0:f782d9c66c49 53 * Added LWIP_NETCONN_SEM_PER_THREAD to use one "op_completed" semaphore per thread
dkato 0:f782d9c66c49 54 instead of using one per netconn (these semaphores are used even with core locking
dkato 0:f782d9c66c49 55 enabled as some longer lasting functions like big writes still need to delay)
dkato 0:f782d9c66c49 56 * Added generalized abstraction for itoa(), strnicmp(), stricmp() and strnstr()
dkato 0:f782d9c66c49 57 in def.h (to be overridden in cc.h) instead of config
dkato 0:f782d9c66c49 58 options for netbiosns, httpd, dns, etc. ...
dkato 0:f782d9c66c49 59 * New abstraction for hton* and ntoh* functions in def.h.
dkato 0:f782d9c66c49 60 To override them, use the following in cc.h:
dkato 0:f782d9c66c49 61 #define lwip_htons(x) <your_htons>
dkato 0:f782d9c66c49 62 #define lwip_htonl(x) <your_htonl>
dkato 0:f782d9c66c49 63
dkato 0:f782d9c66c49 64 +++ new options:
dkato 0:f782d9c66c49 65 * TODO
dkato 0:f782d9c66c49 66
dkato 0:f782d9c66c49 67 +++ new pools:
dkato 0:f782d9c66c49 68 * Added LWIP_MEMPOOL_* (declare/init/alloc/free) to declare private memp pools
dkato 0:f782d9c66c49 69 that share memp.c code but do not have to be made global via lwippools.h
dkato 0:f782d9c66c49 70 * Added pools for IPv6, MPU_COMPATIBLE, dns-api, netif-api, etc.
dkato 0:f782d9c66c49 71 * added hook LWIP_HOOK_MEMP_AVAILABLE() to get informed when a memp pool was empty and an item
dkato 0:f782d9c66c49 72 is now available
dkato 0:f782d9c66c49 73
dkato 0:f782d9c66c49 74 * Signature of LWIP_HOOK_VLAN_SET macro was changed
dkato 0:f782d9c66c49 75
dkato 0:f782d9c66c49 76 * LWIP_DECLARE_MEMORY_ALIGNED() may be used to declare aligned memory buffers (mem/memp)
dkato 0:f782d9c66c49 77 or to move buffers to dedicated memory using compiler attributes
dkato 0:f782d9c66c49 78
dkato 0:f782d9c66c49 79 * Standard C headers are used to define sized types and printf formatters
dkato 0:f782d9c66c49 80 (disable by setting LWIP_NO_STDINT_H=1 or LWIP_NO_INTTYPES_H=1 if your compiler
dkato 0:f782d9c66c49 81 does not support these)
dkato 0:f782d9c66c49 82
dkato 0:f782d9c66c49 83
dkato 0:f782d9c66c49 84 ++ Major bugfixes/improvements
dkato 0:f782d9c66c49 85
dkato 0:f782d9c66c49 86 * Added IPv6 support (dual-stack or IPv4/IPv6 only)
dkato 0:f782d9c66c49 87 * Major rewrite of PPP (incl. keep-up with apache pppd)
dkato 0:f782d9c66c49 88 see doc/ppp.txt for an upgrading how-to
dkato 0:f782d9c66c49 89 * Major rewrite of SNMP (incl. MIB parser)
dkato 0:f782d9c66c49 90 * Fixed timing issues that might have lead to losing a DHCP lease
dkato 0:f782d9c66c49 91 * Made rx processing path more robust against crafted errors
dkato 0:f782d9c66c49 92 * TCP window scaling support
dkato 0:f782d9c66c49 93 * modification of api modules to support FreeRTOS-MPU (don't pass stack-pointers to other threads)
dkato 0:f782d9c66c49 94 * made DNS client more robust
dkato 0:f782d9c66c49 95 * support PBUF_REF for RX packets
dkato 0:f782d9c66c49 96 * LWIP_NETCONN_FULLDUPLEX allows netconn/sockets to be used for reading/writing from separate
dkato 0:f782d9c66c49 97 threads each (needs LWIP_NETCONN_SEM_PER_THREAD)
dkato 0:f782d9c66c49 98 * Moved and reordered stats (mainly memp/mib2)
dkato 0:f782d9c66c49 99
dkato 0:f782d9c66c49 100 (1.4.0)
dkato 0:f782d9c66c49 101
dkato 0:f782d9c66c49 102 ++ Application changes:
dkato 0:f782d9c66c49 103
dkato 0:f782d9c66c49 104 * Replaced struct ip_addr by typedef ip_addr_t (struct ip_addr is kept for
dkato 0:f782d9c66c49 105 compatibility to old applications, but will be removed in the future).
dkato 0:f782d9c66c49 106
dkato 0:f782d9c66c49 107 * Renamed mem_realloc() to mem_trim() to prevent confusion with realloc()
dkato 0:f782d9c66c49 108
dkato 0:f782d9c66c49 109 +++ Raw API:
dkato 0:f782d9c66c49 110 * Changed the semantics of tcp_close() (since it was rather a
dkato 0:f782d9c66c49 111 shutdown before): Now the application does *NOT* get any calls to the recv
dkato 0:f782d9c66c49 112 callback (aside from NULL/closed) after calling tcp_close()
dkato 0:f782d9c66c49 113
dkato 0:f782d9c66c49 114 * When calling tcp_abort() from a raw API TCP callback function,
dkato 0:f782d9c66c49 115 make sure you return ERR_ABRT to prevent accessing unallocated memory.
dkato 0:f782d9c66c49 116 (ERR_ABRT now means the applicaiton has called tcp_abort!)
dkato 0:f782d9c66c49 117
dkato 0:f782d9c66c49 118 +++ Netconn API:
dkato 0:f782d9c66c49 119 * Changed netconn_receive() and netconn_accept() to return
dkato 0:f782d9c66c49 120 err_t, not a pointer to new data/netconn.
dkato 0:f782d9c66c49 121
dkato 0:f782d9c66c49 122 +++ Socket API:
dkato 0:f782d9c66c49 123 * LWIP_SO_RCVTIMEO: when accept() or recv() time out, they
dkato 0:f782d9c66c49 124 now set errno to EWOULDBLOCK/EAGAIN, not ETIMEDOUT.
dkato 0:f782d9c66c49 125
dkato 0:f782d9c66c49 126 * Added a minimal version of posix fctl() to have a
dkato 0:f782d9c66c49 127 standardised way to set O_NONBLOCK for nonblocking sockets.
dkato 0:f782d9c66c49 128
dkato 0:f782d9c66c49 129 +++ all APIs:
dkato 0:f782d9c66c49 130 * correctly implemented SO(F)_REUSEADDR
dkato 0:f782d9c66c49 131
dkato 0:f782d9c66c49 132 ++ Port changes
dkato 0:f782d9c66c49 133
dkato 0:f782d9c66c49 134 +++ new files:
dkato 0:f782d9c66c49 135
dkato 0:f782d9c66c49 136 * Added 4 new files: def.c, timers.c, timers.h, tcp_impl.h:
dkato 0:f782d9c66c49 137
dkato 0:f782d9c66c49 138 * Moved stack-internal parts of tcp.h to tcp_impl.h, tcp.h now only contains
dkato 0:f782d9c66c49 139 the actual application programmer's API
dkato 0:f782d9c66c49 140
dkato 0:f782d9c66c49 141 * Separated timer implementation from sys.h/.c, moved to timers.h/.c;
dkato 0:f782d9c66c49 142 Added timer implementation for NO_SYS==1, set NO_SYS_NO_TIMERS==1 if you
dkato 0:f782d9c66c49 143 still want to use your own timer implementation for NO_SYS==0 (as before).
dkato 0:f782d9c66c49 144
dkato 0:f782d9c66c49 145 +++ sys layer:
dkato 0:f782d9c66c49 146
dkato 0:f782d9c66c49 147 * Converted mbox- and semaphore-functions to take pointers to sys_mbox_t/
dkato 0:f782d9c66c49 148 sys_sem_t;
dkato 0:f782d9c66c49 149
dkato 0:f782d9c66c49 150 * Converted sys_mbox_new/sys_sem_new to take pointers and return err_t;
dkato 0:f782d9c66c49 151
dkato 0:f782d9c66c49 152 * Added Mutex concept in sys_arch (define LWIP_COMPAT_MUTEX to let sys.h use
dkato 0:f782d9c66c49 153 binary semaphores instead of mutexes - as before)
dkato 0:f782d9c66c49 154
dkato 0:f782d9c66c49 155 +++ new options:
dkato 0:f782d9c66c49 156
dkato 0:f782d9c66c49 157 * Don't waste memory when chaining segments, added option TCP_OVERSIZE to
dkato 0:f782d9c66c49 158 prevent creating many small pbufs when calling tcp_write with many small
dkato 0:f782d9c66c49 159 blocks of data. Instead, pbufs are allocated larger than needed and the
dkato 0:f782d9c66c49 160 space is used for later calls to tcp_write.
dkato 0:f782d9c66c49 161
dkato 0:f782d9c66c49 162 * Added LWIP_NETIF_TX_SINGLE_PBUF to always copy to try to create single pbufs
dkato 0:f782d9c66c49 163 in tcp_write/udp_send.
dkato 0:f782d9c66c49 164
dkato 0:f782d9c66c49 165 * Added an additional option LWIP_ETHERNET to support ethernet without ARP
dkato 0:f782d9c66c49 166 (necessary for pure PPPoE)
dkato 0:f782d9c66c49 167
dkato 0:f782d9c66c49 168 * Add MEMP_SEPARATE_POOLS to place memory pools in separate arrays. This may
dkato 0:f782d9c66c49 169 be used to place these pools into user-defined memory by using external
dkato 0:f782d9c66c49 170 declaration.
dkato 0:f782d9c66c49 171
dkato 0:f782d9c66c49 172 * Added TCP_SNDQUEUELOWAT corresponding to TCP_SNDLOWAT
dkato 0:f782d9c66c49 173
dkato 0:f782d9c66c49 174 +++ new pools:
dkato 0:f782d9c66c49 175
dkato 0:f782d9c66c49 176 * Netdb uses a memp pool for allocating memory when getaddrinfo() is called,
dkato 0:f782d9c66c49 177 so MEMP_NUM_NETDB has to be set accordingly.
dkato 0:f782d9c66c49 178
dkato 0:f782d9c66c49 179 * DNS_LOCAL_HOSTLIST_IS_DYNAMIC uses a memp pool instead of the heap, so
dkato 0:f782d9c66c49 180 MEMP_NUM_LOCALHOSTLIST has to be set accordingly.
dkato 0:f782d9c66c49 181
dkato 0:f782d9c66c49 182 * Snmp-agent uses a memp pools instead of the heap, so MEMP_NUM_SNMP_* have
dkato 0:f782d9c66c49 183 to be set accordingly.
dkato 0:f782d9c66c49 184
dkato 0:f782d9c66c49 185 * PPPoE uses a MEMP pool instead of the heap, so MEMP_NUM_PPPOE_INTERFACES
dkato 0:f782d9c66c49 186 has to be set accordingly
dkato 0:f782d9c66c49 187
dkato 0:f782d9c66c49 188 * Integrated loopif into netif.c - loopif does not have to be created by the
dkato 0:f782d9c66c49 189 port any more, just define LWIP_HAVE_LOOPIF to 1.
dkato 0:f782d9c66c49 190
dkato 0:f782d9c66c49 191 * Added define LWIP_RAND() for lwip-wide randomization (needs to be defined
dkato 0:f782d9c66c49 192 in cc.h, e.g. used by igmp)
dkato 0:f782d9c66c49 193
dkato 0:f782d9c66c49 194 * Added printf-formatter X8_F to printf u8_t as hex
dkato 0:f782d9c66c49 195
dkato 0:f782d9c66c49 196 * The heap now may be moved to user-defined memory by defining
dkato 0:f782d9c66c49 197 LWIP_RAM_HEAP_POINTER as a void pointer to that memory's address
dkato 0:f782d9c66c49 198
dkato 0:f782d9c66c49 199 * added autoip_set_struct() and dhcp_set_struct() to let autoip and dhcp work
dkato 0:f782d9c66c49 200 with user-allocated structs instead of calling mem_malloc
dkato 0:f782d9c66c49 201
dkato 0:f782d9c66c49 202 * Added const char* name to mem- and memp-stats for easier debugging.
dkato 0:f782d9c66c49 203
dkato 0:f782d9c66c49 204 * Calculate the TCP/UDP checksum while copying to only fetch data once:
dkato 0:f782d9c66c49 205 Define LWIP_CHKSUM_COPY to a memcpy-like function that returns the checksum
dkato 0:f782d9c66c49 206
dkato 0:f782d9c66c49 207 * Added SO_REUSE_RXTOALL to pass received UDP broadcast/multicast packets to
dkato 0:f782d9c66c49 208 more than one pcb.
dkato 0:f782d9c66c49 209
dkato 0:f782d9c66c49 210 * Changed the semantics of ARP_QUEUEING==0: ARP_QUEUEING now cannot be turned
dkato 0:f782d9c66c49 211 off any more, if this is set to 0, only one packet (the most recent one) is
dkato 0:f782d9c66c49 212 queued (like demanded by RFC 1122).
dkato 0:f782d9c66c49 213
dkato 0:f782d9c66c49 214
dkato 0:f782d9c66c49 215 ++ Major bugfixes/improvements
dkato 0:f782d9c66c49 216
dkato 0:f782d9c66c49 217 * Implemented tcp_shutdown() to only shut down one end of a connection
dkato 0:f782d9c66c49 218 * Implemented shutdown() at socket- and netconn-level
dkato 0:f782d9c66c49 219 * Added errorset support to select() + improved select speed overhead
dkato 0:f782d9c66c49 220 * Merged pppd to v2.3.11 (including some backported bugfixes from 2.4.x)
dkato 0:f782d9c66c49 221 * Added timer implementation for NO_SYS==1 (may be disabled with NO_SYS_NO_TIMERS==1
dkato 0:f782d9c66c49 222 * Use macros defined in ip_addr.h to work with IP addresses
dkato 0:f782d9c66c49 223 * Implemented many nonblocking socket/netconn functions
dkato 0:f782d9c66c49 224 * Fixed ARP input processing: only add a new entry if a request was directed as us
dkato 0:f782d9c66c49 225 * mem_realloc() to mem_trim() to prevent confusion with realloc()
dkato 0:f782d9c66c49 226 * Some improvements for AutoIP (don't route/forward link-local addresses, don't break
dkato 0:f782d9c66c49 227 existing connections when assigning a routable address)
dkato 0:f782d9c66c49 228 * Correctly handle remote side overrunning our rcv_wnd in ooseq case
dkato 0:f782d9c66c49 229 * Removed packing from ip_addr_t, the packed version is now only used in protocol headers
dkato 0:f782d9c66c49 230 * Corrected PBUF_POOL_BUFSIZE for ports where ETH_PAD_SIZE > 0
dkato 0:f782d9c66c49 231 * Added support for static ARP table entries
dkato 0:f782d9c66c49 232
dkato 0:f782d9c66c49 233 (STABLE-1.3.2)
dkato 0:f782d9c66c49 234
dkato 0:f782d9c66c49 235 * initial version of this file