socket 编程常用函数

一

  SOCKET   socket(
        int   af,         
        int   type,       
        int   protocol   
      );

      应用程序调用socket函数来创建一个能够进行网络通信的套接字。第一个参数指定应用程序使用的通信协议的协议族，对于TCP/IP协议族，该参数置 PF_INET;第二个参数指定要创建的套接字类型，流套接字类型为SOCK_STREAM、数据报套接字类型为SOCK_DGRAM；第三个参数指定应用程序所使用的通信协议。该函数如果调用成功就返回新创建的套接字的描述符，如果失败就返回INVALID_SOCKET。

参数描述：
参数一：af
名字/常量 描述
AF_INET 这是大多数用来产生socket的协议，使用TCP或UDP来传输，用在IPv4的地址
AF_INET6 与上面类似，不过是来用在IPv6的地址
AF_UNIX 本地协议，使用在Unix和Linux系统上，它很少使用，一般都是当客户端和服务器在同一台及其上的时候使用
参数二：Socket类型
名字/常量 描述
SOCK_STREAM 这个协议是按照顺序的、可靠的、数据完整的基于字节流的连接。这是一个使用最多的socket类型，这个socket是使用TCP来进行传输。
SOCK_DGRAM 这个协议是无连接的、固定长度的传输调用。该协议是不可靠的，使用UDP来进行它的连接。
SOCK_SEQPACKET 这个协议是双线路的、可靠的连接，发送固定长度的数据包进行传输。必须把这个包完整的接受才能进行读取。
SOCK_RAW 这个socket类型提供单一的网络访问，这个socket类型使用ICMP公共协议。（ping、traceroute使用该协议）
SOCK_RDM 这个类型是很少使用的，在大部分的操作系统上没有实现，它是提供给数据链路层使用，不保证数据包的顺序
参数三：公共协议
名字/常量 描述
ICMP 互联网控制消息协议，主要使用在网关和主机上，用来检查网络状况和报告错误信息
UDP 用户数据报文协议，它是一个无连接，不可靠的传输协议
TCP 传输控制协议，这是一个使用最多的可靠的公共协议，它能保证数据包能够到达接受者那儿，如果在传输过程中发生错误，那么它将重新发送出错数据包。
如果调用者不希望特别指定使用的协议，则置为0，使用默认的连接模式

 

二

int   bind(
        SOCKET   s,                                   
        const   struct   sockaddr   FAR   *name,   
        int   namelen                               
      );
          当创建了一个Socket以后，套接字数据结构中有一个默认的IP地址和默认的端口号。一个服务程序必须调用bind函数将套接字地址（包括主机地址和本地端口地址）与所创建的套接字号联系起来，即将名字赋予套接字。客户程序一般不必调用bind函数来为其Socket绑定IP地址和断口号。

参数描述：
    该函数的第一个参数指定待绑定的Socket描述符；第二个参数指定一个sockaddr结构，该结构是这样定义的：
            struct   sockaddr   { 
                u_short   sa_family; 
                char   sa_data[14]; 
            };
    sa_family指定地址族，对于TCP/IP协议族的套接字，给其置AF_INET。当对TCP/IP协议族的套接字进行绑定时，我们通常使用另一个地址结构：
            struct   sockaddr_in   {
                short     sin_family;
                u_short   sin_port;
                struct   in_addr   sin_addr;
                char       sin_zero[8];
            };
      其中sin_family置AF_INET；sin_port指明端口号；sin_addr结构体中只有一个唯一的字段s_addr，表示IP地址，该字段是一个整数，一般用函数inet_addr（）把字符串形式的IP地址转换成unsigned   long型的整数值后再置给s_addr。有的服务器是多宿主机，至少有两个网卡，那么运行在这样的服务器上的服务程序在为其Socket绑定IP地址时可以把htonl(INADDR_ANY)置给s_addr，这样做的好处是不论哪个网段上的客户程序都能与该服务程序通信；如果只给运行在多宿主机上的服务程序的Socket绑定一个固定的IP地址，那么就只有与该IP地址处于同一个网段上的客户程序才能与该服务程序通信。我们用0来填充 sin_zero数组，目的是让sockaddr_in结构的大小与sockaddr结构的大小一致。

返回值：如果没有错误发生，bind（）返回0，否则，返回致SOCKET_ERROR

 

三

int   listen(   SOCKET   s,   int   backlog   );

服务程序可以调用listen函数使其流套接字s处于监听状态。处于监听状态的流套接字s将维护一个客户连接请求队列，该队列最多容纳backlog个客户连接请求。

参数描述
参数    描述
s    标识一个已绑定、没有连接的套接字的描述符。
backlog    未处理连接队列的最大长度。

返回值：假如该函数执行成功，则返回0；如果执行失败，则返回SOCKET_ERROR。

 

四

SOCKET   accept(
        SOCKET   s, 
        struct   sockaddr   FAR   *addr,   
        int   FAR   *addrlen   
      );

服务程序调用accept函数从处于监听状态的流套接字s的客户连接请求队列中取出排在最前的一个客户请求，并且创建一个新的套接字来与客户套接字创建连接通道。

参数    描述
s    指定处于监听状态的流套接字
addr    返回新创建的套接字的地址结构
addrlen    返回新创建的套接字的地址结构的长度。

返回值：如果连接成功，就返回新创建的套接字的描述符，以后与客户套接字交换数据的是新创建的套接字；如果失败就返回INVALID_SOCKET。

 

 

五

      int   recv(
        SOCKET   s,         
        char   FAR   *buf,   
        int   len,           
        int   flags         
      );
      不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。

参数    描述
s    指定接收端套接字描述符；
buf    指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据；
len    指明buf的长度；
flags    一般置0。

这里只描述同步Socket的recv函数的执行流程。当应用程序调用recv函数时，recv先等待s的发送缓冲中的数据被协议传送完毕，如果协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR，如果s的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收缓冲区，如果s接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，只到协议把数据接收完毕。当协议把数据接收完毕，recv函数就把s的接收缓冲中的数据copy到 buf中（注意协议接收到的数据可能大于buf的长度，所以在这种情况下要调用几次recv函数才能把s的接收缓冲中的数据copy完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的），recv函数返回其实际copy的字节数。
注意：在Unix系统下，如果recv函数在等待协议接收数据时网络断开了，那么调用recv的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

返回值：如果没有错误发生，recv返回收到的字节数；如果recv在copy时出错，那么它返回 SOCKET_ERROR；如果recv函数在等待协议接收数据时网络中断了，那么它返回0。

 

 

六

int   send(
        SOCKET   s,                   
        const   char   FAR   *buf,   
        int   len,                   
        int   flags                   
      );
      不论是客户还是服务器应用程序都用send函数来向TCP连接的另一端发送数据。客户程序一般用send函数向服务器发送请求，而服务器则通常用send 函数来向客户程序发送应答。

参数    描述
s    指定发送端套接字描述符；
buf    指明一个存放应用程序要发送数据的缓冲区；
len    指明实际要发送的数据的字节数；
flags    一般置0。

返回值：如果send函数copy数据成功，就返回实际copy的字节数，如果 send在copy数据时出现错误，那么send就返回SOCKET_ERROR；如果send在等待协议传送数据时网络断开的话，那么send函数也返回SOCKET_ERROR。

 

 

七

int   connect(
        SOCKET   s,                                   
        const   struct   sockaddr   FAR   *name,   
        int   namelen                               
      );

客户程序调用connect函数来使客户Socket s与监听于name所指定的计算机的特定端口上的服务Socket进行连接。

参数    描述
s    用来表示发出连接请求的套接字的描述符
name    指向一个socket address结构的指针，该结构含有对等方的套接字的地址
namelen    name指向的socket address结构的字节数

返回值：如果连接成功，connect返回0；如果失败则返回SOCKET_ERROR。

 

 

八

    int   closesocket(
        SOCKET   s   
      );
closesocket函数用来关闭一个描述符为s套接字。当调用closesocket函数时，操作系统先检查套接字数据结构中的该字段的值，如果为1，就表明只有一个套接字描述符指向它，因此操作系统就先把s在套接字描述符表中对应的那条表项清除，并且释放s对应的套接字数据结构；如果该字段大于1，那么操作系统仅仅清除s在套接字描述符表中的对应表项，并且把s对应的套接字数据结构的引用次数减1。

参数    描述
s    待关闭的套接字描述符。

返回值：如果没有错误发生，closesocket返回0；否则，返回值SOCKET_ERROR