untitled

Transcription

1 Lwip Swedish Institute of Computer Science February 20, 2001 Adam Dunkels (QQ: ) (QQ: ) (QQ: ) (QQ: ) QQ ARM TCPIP LCD

2 LWIP TCP/IP LWIP LWIP lwip API lwip LWIP APILWIP 1 Introduction..1 2 Protocol layering..1 3 Overview Process model The operating system emulation layer Buffer and memory management Packet buffers pbufs Memory management..5 7 Network interfaces IP processing Receiving packets Sending packets Forwarding packets ICMP processing.8 9 UDP processing TCP processing Overview Data structures..10

3 10.3 Sequence number calculations Queuing and transmitting data Silly window avoidance Receiving segments Demultiplexing Receiving data Accepting new connections Fast retransmit Timers Round-trip time estimation Congestion control Interfacing the stack Application Program Interface Basic concepts Implementation of the API Statistical code analysis Lines of code Object code size Performance analysis API reference Data types Netbufs Bu er functions netbuf new() netbuf delete() netbuf alloc() netbuf free() netbuf ref() netbuf len() netbuf data() netbuf next() netbuf rst() netbuf copy() netbuf chain() netbuf fromaddr() netbuf fromport() Network connection functions netconn new() netconn delete() netconn type() netconn peer() netconn addr() netconn bind() netconn connect( netconn listen() netconn accept() netconn recv() netconn write() netconn send() netconn close() BSD socket library The representation of a socket Allocating a socket The socket() call Connection setup The bind() call...31

4 The connect() call The listen() call The accept() call Sending and receiving data The send() call The sendto() and sendmsg() calls The write() call The recv() and read() calls The recvfrom() and recvmsg() calls Code examples Using the API Directly interfacing the stack.. 39 Bibliography Protocol layering

5 3 Overview 4 Process model 5 lwip lwip

6 6 Pbuf lwip Pbufs BSD mbufs pbuf Pbufs pbuf pbufs Pbufs PBUF RAM PBUF ROMPBUF POOL 1 pbuf PBUF RAMpbuf 2pbuf pbuf pbufpbuf RAM where the first pbufin the chain is of the PBUF RAM typepbuf ROMpbuf pbuf PBUF POOL3pbufs pbufs consists of fixed size pbufs allocated from a pool of fixedsize pbufs. pbuf pbufs PBUF_POOL pbuf suitable foruse in an interrupt handler PBUF_ROM pbuftcp/ip pbufrom ( PBUF_ROM )

7 alignment9

8

9

10

11 9 UDP UDP checksumming UDP

12

13

14

15

16

17

18

19 12. API 1

20 13 2. LWIP Intel x86

21 14. LWIP X86 3. LWIP 6502

22 15. LWIP 6502

23 netbuf new() netbuf delete() netbufs int main() { struct netbuf *buf; buf = netbuf_new(); /* netbuf */ netbuf_alloc(buf, 100); /* 100 bytes buffer */ struct netbuf * netbuf new(void) void netbuf delete(struct netbuf *) /* netbuf */ /* [...] */ netbuf_delete(buf); /* netbuf */ } netbuf alloc()

24 netbuf free() netbuf buf buffer buffer netbuf buf netbuf ref() netbuf buf size netbuf netbuf_alloc() netbufmalloc() netbuf_ref()buffer netbuf_ref() int main() { struct netbuf *buf; char string[] = " "; /* netbuf */ buf = netbuf_new(); void * netbuf alloc(struct netbuf *buf, int size) int netbuf free(struct netbuf *buf) int netbuf ref(struct netbuf *buf, void *data, int size) /* */ netbuf_ref(buf, string, sizeof(string)); /* netbuf */ /* [...] */ /* netbuf */ netbuf_delete(buf); }

25 netbuf len() netbuf buf netbufnetbuf netbuf netbuf data() netbuf data len netbuf netbuf netbuf_first() netbuf_next() netbuf netbuf_next() netbuf_data() netbuf next() netbuf buf netbuf netbuf>0 <0. netbuf_next() buf netbuf /* [...] */ do { char *data; int len; int netbuf len(struct netbuf *buf) int netbuf data(struct netbuf *buf, void **data, int *len) int netbuf next(struct netbuf *buf) /* */ netbuf_data(buf, &data, &len); /* */ do_something(data, len); } while(netbuf_next(buf) >= 0); /* [...] */ netbuf first()

26 netbuf buf netbuf copy() netbuf bufdatanetbuf buflen data netbuf_copy()200 netbuf buf data void example_function(struct netbuf *buf) { char data[200]; netbuf_copy(buf, data, 200); /* */ } netbuf chain() netbufs netbuf netbuf fromaddr() void netbuf first(struct netbuf *buf) void netbuf copy(struct netbuf *buf, void *data, int len) void netbuf chain(struct netbuf *head, struct netbuf *tail) struct ip addr * netbuf fromaddr(struct netbuf *buf) netbuf buf IPnetbuf netbuf_fromport() netbuf fromport()

27 netbuf bufnetbuf netbuf_fromaddr() IP netconn new() TCP UDP NETCONN_TCP NETCONN_UDP netconn delete() netconn conn netconn type() connnetconn_new() NETCONN_TCP NETCONN_UDP netconn peer() unsigned short netbuf fromport(struct netbuf *buf) struct netconn * netconn new(enum netconn type type) void netconn delete(struct netconn *conn) enum netconn type netconn type(struct netconn *conn) int netconn peer(struct netconn *conn, struct ip addr **addr, unsigned short port) IPaddr port conn

28 conn IP netconn bind() conn IP addr TCPUDP addr IP netconn connect() UDP UDP remote_addr remote_port TCP netconn_connect() netconn listen() TCPconnTCP netconn accept() TCPconn netconn_listen() netconn_accept() 2000 TCP int main() { struct netconn *conn, *newconn; /* */ conn = netconn_new(netconn_tcp); /* IP 2000*/ netconn_bind(conn, NULL, 2000); /* */ netconn_listen(conn);

29 /* block*/ newconn = netconn_accept(conn); /* newconn */ process_connection(newconn); /* */ netconn_delete(newconn); netconn_delete(conn); } netconn recv() conn NULL netbuf netconn_ recv() example_function() void example_function(struct netconn *conn) { struct netbuf *buf; /* */ while((buf = netconn_recv(conn))!= NULL) { do_something(buf); } /* */ netconn_close(conn); } netconn write() TCP TCP conn bu &-#174;ers TCP It puts the data pointed to by data on the output queue for the TCP connection conn. len flags #define NETCONN_NOCOPY 0x00 #define NETCONN_COPY 0x01

30 NETCONN_COPY flag flag NETCONN_NOCOPY stay there for an indeterminate amount of time. ROM netconn_write() flag NETCONN_COPY text int main() { struct netconn *conn; char data[10]; char text[] = "Static text"; int i; /*conn */ /* [...] */ /* */ for(i = 0; i < 10; i++) data[i] = i; netconn_write(conn, data, 10, NETCONN_COPY); netconn_write(conn, text, sizeof(text), NETCONN_NOCOPY); /* */ for(i = 0; i < 10; i++) data[i] = 10 - i; /* take down the connection conn */ netconn_close(conn); } netconn send() UDPconn netbuf bufnetbuf IP MTU netbuf1000 netbuf IP UDP7000 UDP

31 int main() { struct netconn *conn; struct netbuf *buf; struct ip_addr addr; char *data; char text[] = "A static text"; int i; /* */ conn = netconn_new(netconn_udp); /* IP*/ addr.addr = htonl(0x0a000001); /* */ netconn_connect(conn, &addr, 7000); /* netbuf */ buf = netbuf_new(); data = netbuf_alloc(buf, 10); /* */ for(i = 0; i < 10; i++) data[i] = i; /* */ netconn_send(conn, buf); netbuf_ref(buf, text, sizeof(text)); /* text */ netconn_send(conn, buf); /*connection netbuf */ netconn_delete(conn); netconn_delete(buf); netconn close() conn 17 BSD socket BSD socket APILWIP API BSD socket API BSD socket APInetconn BSD socketsnetconn BSD socket

32 socketbsdsocket socket API UDP (SOCK DGRAM) TCP (SOCK STREAM)

33

34

35

36

37