Part XLI. lwIP - the lightweight IP stack for eCosPro

Jonathan Larmour

eCosCentric Limited

Adam Dunkels

LWIP Documentation Notices

Table of Contents

154. lwIP overview
154.1. Introduction
154.2. lwIP sources and ports
154.3. External documentation
154.4. Licensing
155. Basic concepts
155.1. Structure
155.2. Application Programming Interfaces (APIs)
155.3. Protocol implementations
155.4. Packet data buffers
155.5. Configurability
155.6. Limitations
155.7. Quick Start
156. Port
156.1. Port status
156.2. Implementation
156.2.1. System Configuration
156.2.2. System Source
156.2.3. Threads
156.3. Extensions
156.4. eCos API reference
cyg_lwip_init — Initialise lwIP network stack
cyg_lwip_netif_print_info — Output network interface address information
cyg_net_eth_phy_ctx_acquire — Allocate PHY event context
cyg_net_eth_phy_dsr — Notify lwIP stack of PHY event
cyg_lwip_tick_to_msec — Convert eCos kernel clock ticks to millisecond count
cyg_lwip_msec_to_tick — Convert millisecond count to eCos kernel clock ticks
cyg_lwip_statistics — Statistics output
157. Configuration
157.1. Configuration Overview
157.2. Configuring the lwIP stack
157.3. Performance and Footprint Tuning
157.3.1. Performance
157.3.2. Optimizations
157.3.3. Memory Footprint
158. Sequential API
158.1. Overview
158.2. Comparison with BSD sockets
158.2.1. BSD API Restrictions
158.3. Netbufs
158.4. TCP/IP thread
158.5. Usage
158.5.1. API declarations
158.5.2. Types
158.6. API reference
netbuf_new() — Allocate a netbuf structure
netbuf_delete() — Deallocate a netbuf structure
netbuf_alloc() — Allocate space in a netbuf
netbuf_free() — Deallocate buffer memory associated with a netbuf
netbuf_ref() — Associate a data pointer with a netbuf
netbuf_len() — Obtain the total length of a netbuf
netbuf_data() — Obtain a pointer to netbuf data
netbuf_next() — Traverse internal fragments in a netbuf
netbuf_first() — Reset fragment pointer to start of netbuf
netbuf_copy() — Copy all netbuf data to memory pointer
netbuf_copy_partial() — Copy some netbuf data to memory pointer
netbuf_chain() — Chain two netbufs together
netbuf_fromaddr() — Obtain the sender's IPv4 address for a netbuf
netbuf_fromaddr_ip6() — Obtain the sender's IPv6 address for a netbuf
netbuf_fromport() — Obtain the sender's port number for a netbuf
netconn_new() — Create a new connection structure
netconn_new_with_callback() — Create a new connection structure with a callback
netconn_new_with_proto_and_callback() — Create a new connection structure with a callback for a specific protocol
netconn_delete() — Deallocate a netconn
netconn_type() — Obtain the type of netconn
netconn_peer() — Obtain the remote host IP address/port of a netconn
netconn_addr() — Obtain the local host IPv4 address/port of a netconn
netconn_bind() — Set local IP address/port of a netconn
netconn_bind_ip6() — Set local IPv6 address/port of a netconn
netconn_connect() — Connect netconn to remote peer
netconn_connect_ip6() — Connect netconn to remote peer
netconn_disconnect() — Disconnect UDP connection
netconn_listen() — Make a listening TCP netconn
netconn_accept() — Wait for incoming connections
netconn_recv() — Wait for data
netconn_recv_tcp_pbuf() — Wait for data
netconn_recved() — Update receive window
netconn_write() — Send data on TCP connection
netconn_send() — Send data on UDP connection
netconn_close() — Close a connection
netconn_shutdown() — Shutdown a connection
netconn_set_noautorecved() — Set the connection no-auto-recved state
netconn_get_noautorecved() — Get the connection no-auto-recved state
netconn_err() — Obtain connection error status
159. Raw API
159.1. Overview
159.2. Usage
159.3. Callbacks
tcp_arg() — Set the application connection state
159.4. TCP connection setup
tcp_new() — Create a new TCP PCB
tcp_bind() — Bind PCB to local IP address and port
tcp_listen() — Make PCB listen for incoming connections
tcp_accept() — Set callback used for new incoming connections
tcp_connect() — Open connection to remote host
159.5. Sending TCP data
tcp_write() — Enqueue data for transmission
tcp_sent() — Set callback for successful transmission
159.6. Receiving TCP data
tcp_recv() — Set callback for incoming data
tcp_recved() — Indicate receipt of data
159.7. Application polling
tcp_poll() — Set application poll callback
159.8. Closing connections, aborting connections and errors
tcp_close() — Close the connection
tcp_abort() — Abort the connection
tcp_err() — Set callback for errors
159.9. Lower layer TCP interface
159.10. UDP interface
udp_new() — Create a new UDP pcb
udp_remove() — Remove a UDP pcb
udp_bind() — Bind PCB to local IP address and port
udp_connect() — Set remote UDP peer
udp_disconnect() — Set remote UDP peer
udp_send() — Send UDP packet
udp_recv() — Set callback for incoming UDP data
159.11. System initialization
159.11.1. Initialization detail
160. Debug and Test
160.1. Debugging
160.1.1. Asserts
160.1.2. Memory Allocations
160.1.3. Statistics
160.1.4. GDB/RedBoot
160.1.5. Host Tools
160.2. Testing
160.2.1. lwipsnmp
160.2.2. lwipsntp
160.2.3. lwiperf
160.2.4. unitwrap
160.2.5. socket
160.2.6. tcpecho
160.2.7. udpecho
160.2.8. frag
160.2.9. nc_test_slave
160.2.10. httpd
160.2.11. httpd2
160.2.12. lookup
160.2.13. sys_timeout
160.2.14. lwiphttpd