LwIP_TCPIP 常用函数

《LwIP_TCPIP 常用函数》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、一TCP的PCB结构此PCB管理tcp协议，包括连接、数据包、收发等状态一、tcp.c实现的函数：1、err_ttcp_close(structtcp_pcb*pcb)说明：断开PCB中的连接，释放其占用资源，无论其正在监听或已经建立了连接。参数：pcb表示要关闭的协议控制块。返回：ERR_OK表示连接已经被断开，其它表示pcb没有被断开，其资源没有被释放。PCB（protocolcontrolblock）协议控制块，包括tcp和udp等多种，每种协议有自己的协议控制块，如tcp_pcb。另外，er

2、r开头的数据类型一般是int型，表示状态，一般不需理会。2、err_ttcp_bind(structtcp_pcb*pcb,structip_addr*ipaddr,u16_tport)说明：设置某个协议控制块用于连接的本地ip地址和端口号。参数：pcb协议控制块；ipaddr表示ip地址的结构体，用IP_ADDR_ANY设置默认本地ip地址；port表示16位端口号。返回：ERR_USE表示端口号被占用，ERR_OK表示设置成功ip_addr结构体中只有一个32位整数项：ipaddr->addr，

3、ip地址应由高到低位依次填充该项。这个IP地址的结构体应该在使用本函数前事先定义好。3、structtcp_pcb*tcp_listen_with_backlog(structtcp_pcb*pcb,u8_tbacklog)说明：设置该TCP协议控制块为连接监听状态，即作为主机角色来等待客户端申请连接。参数：pcb协议控制块；backlog最大连接数限制，8位无符号整数，最大为255。一般应用是我们用tcp_listen(pcb)宏来替换这个函数，这个宏将backlog自动设置为255。3、void

4、tcp_recved(strcuttcp_pcb*pcb,u16_tlen)说明：在应用程序处理接收的数据之前，应该先调用该函数来扩大tcp窗口长度。参数：pcb协议控制块；len应用程序总共读取的数据长度。4、staticu16_ttcp_new_port(void)说明：分配一个新的端口号，（不与已经使用的端口号重复）返回：新端口号，16位无符号整数。5、err_ttcp_connect(structtcp_pcb*pcb,structip_addr*ipaddr,u16_tport,err_t

5、(*connected)(void*arg,structtcp_pcb*tpcb,err_terr))说明：作为一个客户端的角色来连接一个主机，连接成功后会调用参数中提供的“connected”函数（自己编写的函数，用于处理连接后的工作）。参数：pcb协议控制块；ipaddr远端主机ip地址；port远端主机端口号；connected需要被调用的函数地址（函数名），否则会出错。返回：状态，ERR_VAL表示参数错误（ip地址错误），ERR_OK表示连接申请已经发出，其它表示连接申请不能发出。6、vo

6、idtcp_setprio(structtcp_pcb*pcb,u8_tprio)说明：设置连接的优先级，直接修改pcb->prio项。参数：pcb协议控制块，prio优先级7、staticvoidtcp_kill_prio(u8_tprio)说明：终止比prio优先级低或相等的其它有效的连接。参数：prio最小优先级。8、structtcp_pcb*tcp_alloc(u8_tprio)说明：创建一个新的TCP协议控制块，为其pcb分配新空间并自动填充。参数：prio新pcb的优先级，可能会终止其

7、它连接。返回：新pcb指针，状态是CLOSED关闭的。9、structtcp_pcb*tcp_new(void)说明：用于创建一个新TCP协议控制块。该pcb在用tcp_bind函数绑定前，并不放在TCPPCB链表中。返回：状态是关闭的新pcb指针。这个函数直接用中间优先级64（可设置）去调用tcp_alloc函数返回结果。10、voidtcp_arg(structtcp_pcb*pcb,void*arg）说明：用于给tcp_recv函数（下一个讲）中指定的回调函数传递参数。参数：所传递的参数（以指

8、针的形式）。这个函数直接修改pcb->callback_arg项。11、voidtcp_recv(structtcp_pcb*pcb,err_t(*recv)(void*arg,structtcp_pcb*tpcb,structpbuf*p,err_terr))说明：用于指定当TCP连接接收到数据后所调用的函数。参数：pcb协议控制块；recv所指定的函数地址（函数名）这个函数直接修改pcb->recv项。12、voidtcp_send(structtcp_pcb*p