lwIP在Socket模式下接口:BSD Socket API.doc
文本预览下载声明
关于BSD Socket API
在网上找到的两个网站,是关于BSD Sockets API的,这是与lwIP在Socket模式下兼容的。里面对API函数做了较为详细的介绍,先记下来,有空翻译一下
/macdev/Development/MITSupportLib/SocketsLib/Documentation/sockets.html
/embedded/tcpipembedded/index.html?page=opensource/0107.html
最常用的BSD API函数:
socket:创建一个插口(socket)
bind:将本地端口号和IP地址绑定到插口上
listen:TCP监听
accept:TCP监听接受处理
connect:TCP客户端连接
select:特殊插口设置
send/sendto:发送数据包到已连接/未连接插口上
recv/recvfrom:接收数据包从已连接/未连接插口上
getsockopt/setsockopt:获取/改变插口选项
getpeername/getsockname:获取远端/本地地址信息
close:关闭插口
shutdown:按设置关闭插口
gethostbyname/gethostbyaddr:地址域名映射
read:从插口缓存读数据
write:想插口缓存写数据
#include sys/types.h#include sys/socket.h
int socket( int domain, int type, int protocol );
创建通讯用的“插口”(插口socket可以理解为IP地址和端口号组合成的地址),创建成功返回插口ID(出错返回-1)。
参数:domain协议族(AF_UNIX是UNIX,AF_INET是IPv4协议,AF_ROUTE是路由器协议);type类型(SOCK_STREAM是TCP,SOCK_DGRAM是UDP,SOCK_RAW是RAM活IPv4);protocol为0。
该函数返回大于等于0的整数作为插口ID,如果出错返回-1
#include sys/types.h#include sys/socket.hint bind ( int sockFd, const struct sockaddr *sockAddr, int addrLen );
将插口名、本地端口号和本地IP地址绑定到指定插口上。一般在用作服务器时使用该函数。返回0成功,-1未成功。
参数:sockFd插口ID,由socket函数创建;sockAddr结构体包含插口地址信息,AF_UNIX用下面结构体
struct sockaddr {????????? unsigned short sa_family;???? // Address Family (domain)????????? char?????????? sa_data[14]]; // Protocol Address};
AF_INET用下面的结构体,使用前需初始化,下面使用TCP函数时相同。
struct sockaddr_in {????????? short????????? sin_family;??? // Address Family????????? unsigned short sin_port;????? // Port Number????????? struct in_addr sin_addr;????? // Internet Address????????? unsigned char sin_zero[8];?? // Pad structure};
addrLen是上述结构体长度。
#include sys/socket.h
int listen ( int sockFd, int backlog );
TCP服务器监听指定插口
参数:sockFd已创建并被绑定的插口;backlog允许接收的客服端数量。
include sys/types.h#include sys/socket.hint accept ( int sockFd, struct sockaddr *clientAddr, int *addrLen )
TCP服务器监听到连接时的响应函数。
参数:sockFd已创建、绑定并监听的插口;clientAddr远端连接信息;addrLen结构体长度。
#include sys/types.h#include sys/socket.hint connect ( int sockFd, struct sockaddr *servAddr, int addrLen );
TCP/UDP客服端申请TCP/UDP服务器的链接
显示全部