详细说明原始套接字(protosocket)为uIP提供了一个与传统BSD套接.doc

详细说明:原始套接字(protosocket)为uIP提供了一个与传统BSD套接字接口类似的接口.不同于为传统uIP事件驱动接口写的程序,为原始套接字(protosocket)接口写的程序是顺序方式执行的,并且无需以明确的状态机方式实现.原始套接字(protosocket)只能用于TCP连接.原始大接字(protosocket)库使用原始线程(protothreads)来提供顺序控制流.这使得原始套接字在内存方面变得轻量型,但也同时意味着原始套接字继承了原始线程的功能限制.每个原始套接字只能生存于单个函数中.自动变量(栈变量)不能跨原始套接字函数调用存在.注意: 由于原始套接字库使用的是原始线程(protothreads),在调用原始套接字库函数时,局部变量并不总能得到保存.所以这里建议局部变量的使用要十分小心。 原始套接字库提供了一些无需处理重传和回应的发送数据函数，和一些无需对被分解成多个TCP段的数据进行处理的读取数据函数。由于每个原始套接字都作为一个“原始线程”来运行，应在使用原始套接字的函数起始处通过调用PSOCK_BEGIN() 的方式启用原始套接字。与之类似，原始套接字可以通过调用PSOCK_EXIT()结束掉。相关文件： psock.h??原始套接字库头文件 复制代码 相关结构体： struct psock_bufstruct psock??代表一个原始套接字。 复制代码 相关宏定义： 。 #define? ?? ?? ?PSOCK_INIT(psock, buffer, buffersize)? ?初始化一个原始套接字。 #define? ?? ?? ?PSOCK_BEGIN(psock)? ?在一个函数中启用一个原始套接字的原始线程。 #define? ?? ?? ?PSOCK_SEND(psock, data, datalen)? ?? ?发送数据。 #define? ?? ?? ?PSOCK_SEND_STR(psock, str)??发送一个以零结尾的字符串。 #define? ?? ?? ?PSOCK_GENERATOR_SEND(psock, generator, arg)? ?通过函数(generator)产生数据并发送出去。 #define? ?? ?? ?PSOCK_CLOSE(psock)? ?关闭一个原始套接字。 #define? ?? ?? ?PSOCK_READBUF(psock)? ?读数据直到缓冲区满。 #define? ?? ?? ?PSOCK_READTO(psock, c) 读数据到字符c. #define? ?? ?? ?PSOCK_DATALEN(psock) 获得上次读到的数据长度。 #define? ?? ?? ?PSOCK_EXIT(psock)??退出原始套接字的原始线程。 #define? ?? ?? ?PSOCK_CLOSE_EXIT(psock) 关闭一个原始套接字，并退出其原始线程。 #define? ?? ?? ?PSOCK_END(psock) 声明一个原始套接字的原始线程的结尾。 #define? ?? ?? ?PSOCK_NEWDATA(psock) 查明是否有数据到达原始套接字。 #define? ?? ?? ?PSOCK_WAIT_UNTIL(psock, condition) 等待，直到条件(condition)为真。 #define? ?? ?? ?PSOCK_WAIT_THREAD(psock, condition)? ?PT_WAIT_THREAD(((psock)-pt), (condition)) 复制代码 相关函数： u16_t psock_datalen(struct psock *psock) char psock_newdata(psock * s) 1. #define PSOCK_BEGIN(psock) 启用一个原始套接字的原始线程。此宏启用一个原始套接字关联的原始线程，必须在使用此原始套接字的函数调用其他原始套接字函数之前出现。参数：psock (struct psock *)指向要启用的原始套接字的结构体指针。应用例程:hello-world.c, and smtp.c.定义于psock.h的158行. 2.??#define PSOCK_CLOSE(psock)此宏用于关闭一个原始套接字,只能用于此原始套接字生存的原始线程中.参数：psock (struct psock *)指向要关闭的原始套接字的结构体指针。应用例程:hello-world.c, and smtp.c.定义于psock.h的235行. 3. #define PSOCK_CLOSE_E