36 网络相关函数(四)——live555源码阅读(四)网络

36 网络相关函数(四)——live555源码阅读(四)网络

本文由乌合之众 lym瞎编，欢迎转载 blog.cnblogs.net/oloroso
本文由乌合之众 lym瞎编，欢迎转载 my.oschina.net/oloroso

简介

网络相关函数是一系列用于操作网络数据的函数。在多个文件中都有相关的函数的定义。还有一些函数是系统socket API相关函数，就不提了。
　　　这一系列的函数大多有一个特点，需要一个UsageEnvironmet&型的参数。
　　　这些方法大多在live555sourcecontrol\groupsock\include\GroupsockHelper.hh中声明。

7)createSocket创建socket方法

createSocket使用参数type创建一个相关类型的socket套接口。如果有相关定义，将为这个套接口添加”close on exec”执行时关闭属性。
注意，这个函数是static类型的，只在本文件(live555sourcecontrol\groupsock\GroupsockHelper.cpp)内使用。

// type socket类型，有SOCK_STREAM、SOCK_DGRAM、SOCK_RAW、SOCK_PACKET、SOCK_SEQPACKET等

static int createSocket(int type) {

    // Call "socket()" to create a (IPv4) socket of the specified type.

    // 调用“socket()创建一个（IPv4）指定类型的套接字。

    // But also set it to have the 'close on exec' property (if we can)

    // 还设置它具有“执行exec时关闭"属性（如果可以）

    int sock;

#ifdef SOCK_CLOEXEC

    sock = socket(AF_INET, type|SOCK_CLOEXEC, 0);

    if (sock != -1 || errno != EINVAL) return sock;

    // An "errno" of EINVAL likely means that the system wasn't happy with the SOCK_CLOEXEC; fall through and try again without it:

#endif

    sock = socket(AF_INET, type, 0);

#ifdef FD_CLOEXEC

    if (sock != -1) fcntl(sock, F_SETFD, FD_CLOEXEC);

#endif

    return sock;

}

8)closeSocket 关闭套接口

closesocket是winsock.h中声明的函数，用于关闭一个套接口

#define closeSocket closesocket     //关闭socket函数

在linux/unix等系统下，被替换为close函数

#define closeSocket close   //关闭socket

9)setsockopt 设置socket套接口选项

这个函数是一个socket API函数，还有一个对应的getsockopt函数。在这里简单提一下。
函数说明：用于任意类型、任意状态套接口的设置选项值。选项可能存在于多层协议中，它们总会出现在最上面的套接字层。当操作套接字选项时，选项位于的层和选项的名称必须给出。为了操作套接字层的选项，应该将层的值指定为SOL_SOCKET。为了操作其它层的选项，控制选项的合适协议号必须给出。例如，为了表示一个选项由TCP协议解析，层应该设定为协议号TCP。

函数原型：

    int setsockopt(int sockfd, int level, int optname,const void *optval, socklen_t optlen);

参数说明：

sockfd：标识一个套接口的描述字。
level：选项定义的层次；支持SOL_SOCKET、IPPROTO_TCP、IPPROTO_IP和IPPROTO_IPV6。
optname：需设置的选项。
optval：指针，指向存放选项待设置的新值的缓冲区。
optlen：optval缓冲区长度。

选项名称	说明	数据类型
	SOL_SOCKET
SO_BROADCAST	允许发送广播数据	int
SO_DEBUG	允许调试	int
SO_DONTROUTE	不查找路由	int
SO_ERROR	获得套接字错误	int
SO_KEEPALIVE	保持连接	int
SO_LINGER	延迟关闭连接	structlinger
SO_OOBINLINE	带外数据放入正常数据流	int
SO_RCVBUF	接收缓冲区大小	int
SO_SNDBUF	发送缓冲区大小	int
SO_RCVLOWAT	接收缓冲区下限	int
SO_SNDLOWAT	发送缓冲区下限	int
SO_RCVTIMEO	接收超时	structtimeval
SO_SNDTIMEO	发送超时	structtimeval
SO_REUSERADDR	允许重用本地地址和端口	int
SO_TYPE	获得套接字类型	int
SO_BSDCOMPAT	与BSD系统兼容	int
	IPPROTO_IP
IP_HDRINCL	在数据包中包含IP首部	int
IP_OPTINOS	IP首部选项	int
IP_TOS	服务类型
IP_MULTICAST_TTL	设置多播的TTL值
IP_MULTICAST_IF	获取或设置多播接口
IP_MULTICAST_LOOP	禁止多播数据回送到本地loop接口
IP_ADD_MEMBERSHIP	将指定的接口加入多播
IP_DROP_MEMBERSHIP	退出多播组
IP_TTL	生存时间	int
	IPPRO_TCP
TCP_MAXSEG	TCP最大数据段的大小	int
TCP_NODELAY	不使用Nagle算法	int

返回说明：

成功执行时，返回0。失败返回-1，errno被设为以下的某个值
EBADF：sock不是有效的文件描述词
EFAULT：optval指向的内存并非有效的进程空间
EINVAL：在调用setsockopt()时，optlen无效
ENOPROTOOPT：指定的协议层不能识别选项
ENOTSOCK：sock描述的不是套接字

SO_RCVBUF和SO_SNDBUF每个套接口都有一个发送缓冲区和一个接收缓冲区，使用这两个套接口选项可以改变缺省缓冲区大小。

// 接收缓冲区

int nRecvBuf=32*1024;         //设置为32K

setsockopt(s,SOL_SOCKET,SO_RCVBUF,(const char*)&nRecvBuf,sizeof(int));

//发送缓冲区

int nSendBuf=32*1024;//设置为32K

setsockopt(s,SOL_SOCKET,SO_SNDBUF,(const char*)&nSendBuf,sizeof(int));

注意：

当设置TCP套接口接收缓冲区的大小时，函数调用顺序是很重要的，因为TCP的窗口规模选项是在建立连接时用SYN与对方互换得到的。对于客户，SO_RCVBUF选项必须在connect之前设置；对于服务器，SO_RCVBUF选项必须在listen前设置。