LWIP源码分析
----- caoxw
1 LWIP的结构
LWIP(Light weight internet protocol)的主要模块包括:配置模块、初始化模块、NetIf 模块、mem(memp)模块、netarp模块、ip模块、udp模块、icmp 模块、igmp模块、dhcp 模块、tcp模块、snmp模块等。下面主要对我们需要关心的协议处理进行说明和梳理。
配置模块:
配置模块通过各种宏定义的方式对系统、子模块进行了配置。比如,通过宏,配置了mem管理模块的参数。该配置模块还通过宏,配置了协议栈所支持的协议簇,通过宏定制的方式,决定了支持那些协议。主要的文件是opt.h。
初始化模块:
初始化模块入口的文件为tcpip.c,其初始化入口函数为:
void tcpip_init(void (* initfunc)(void *), void *arg)
该入口通过调用lwip_init()函数,初始化了所有的子模块,并启动了协议栈管理进程。同时,该函数还带有回调钩子及其参数。可以在需要的地方进行调用。
协议栈数据分发管理进程负责了输入报文的处理、超时处理、API函数以及回调的处理,原型如下:
static void tcpip_thread(void *arg)
NetIf模块:
Netif模块为协议栈与底层驱动的接口模块,其将底层的一个网口设备描述成协议栈的一个接口设备(net interface)。该模块的主要文件为netif.c。其通过链表的方式描述了系统中的所有网口设备。
Netif的数据结构描述了网口的参数,包括IP地址、MAC地址、link状态、网口号、收发函数等等参数。一个网口设备的数据收发主要通过该结构进行。
Mem(memp)模块:
Mem模块同一管理了协议栈使用的内容缓冲区,并管理pbuf结构以及报文的字段处理。主要的文件包括mem.c、memp.c、pbuf.c。
netarp模块:
netarp模块是处理arp协议的模块,主要源文件为etharp.c。其主要入口函数为:
err_t ethernet_input(struct pbuf *p, struct netif *netif)
该入口函数通过判断输入报文p的协议类型来决定是按照arp协议进行处理还是将该报文提交到IP协议。如果报文是arp报文,该接口则调用etharp_arp_input,进行arp请求处理。
如果是ip报文,该接口就调用etharp_ip_input进行arp更新,并调用ip_input接口,将报文提交给ip层。
在该模块中,创建了设备的地址映射arp表,并提供地址映射关系查询接口。同时还提供了arp报文的发送接口。如下:
err_t etharp_output(struct netif *netif, struct pbuf *q, struct ip_addr *ipaddr)
该接口需要注册到netif的output字段,ip层在输出报文时,通过该接口获取目标机的MAC地址,组合最终报文后,由该接口调用底层设备的驱动接口发送数据。
在etharp_output接口中,判断报文类型,如果是广播包或者组播包,就调用etharp_send_ip (组装目标mac和源mac)接口,etharp_send_ip调用netif结构中的设备驱动注册的linkoutput 钩子函数发送最终报文。如果是单播包,etharp_output接口就调用etharp_query进行ip地址和MAC地址的映射,来获取到目标机的MAC地址。并在etharp_query中调用etharp_send_ip 来发送最终组合报文。
ip模块:
ip模块实现了协议的ip层处理,主要文件为ip.c。其主要入口函数为:
err_t ip_input(struct pbuf *p, struct netif *inp)
该接口通过判断输入报文的协议类型,将其输入到相应的上层协议模块中去。比如,将udp报文送到udp_input。
该模块另外一个接口是输入函数,原型如下:
err_t ip_output(struct pbuf *p, struct ip_addr *src, struct ip_addr *dest, u8_t ttl, u8_t tos, u8_t proto)
该接口通过路由表或者传输ip后,调用netif的output字段函数钩子发送报文。
udp模块:
udp模块实现了udp协议层的协议处理,主要文件为udp.c。该模块通过PCB控制块将应用端口跟应用程序做了绑定。在接收到新报文时,分析其对应的PCB,找到对应的处理钩子,进行应用的处理。主要入口函数为:
void udp_input(struct pbuf *p, struct netif *inp)
该模块负责输出的接口如下:
err_t udp_send(struct udp_pcb *pcb, struct pbuf *p)
该模块负责将一个PCB跟一个本地端口进行绑定的接口如下:
err_t udp_bind(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
该模块负责将一个PCB跟一个远端端口绑定的接口如下:
err_t udp_connect(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
icmp 模块:
该模块负责icmp协议的处理,其比较简单。主要的处理接口如下:
Void icmp_input(struct pbuf *p, struct netif *inp)
上述接口负责icmp输入报文的分析和处理。
igmp模块:
igmp模块负责分组管理。其主要的接口函数如下:
void igmp_input(struct pbuf *p, struct netif *inp, struct ip_addr *dest)
该接口负责IGMP协议报文的处理,比如分析当前报文是请求还是应答。
err_t igmp_joingroup(struct ip_addr *ifaddr, struct ip_addr *groupaddr)
该接口将一个网口加入一个组。
err_t igmp_leavegroup(struct ip_addr *ifaddr, struct ip_addr *groupaddr)
该接口将一个网口从一个组中移出。