《网络编程 — 常用API介绍》

#include <sys/types.h>
#include <sys/socket.h>

int socket(int domain, int type, int protocol);
第一个参数domain：指定协议族

• AF_UNIX: 文件系统套接字（通过UNIX和linux文件系统实现的本地套接字）
• AF_INET: UNIX网络套接字（用于通过包括因特网在内的TCP/IP网络进行通信的程序）
• AF_ISO:　　　　　 ISO标准协议
• AF_NS: 施乐系统网络系统协议
• AF_IPX: Novell IPX协议
• AF_APPLETALK: Appletalk DDS

第二个参数type:指定这个套接字的通信类型

• SOCK_STREAM：是一个有序、可靠、面向连接的双向字节流，与管道类似。所以数据收发之前需要连接。
• SOCK_DGRAM：固定长度的、无连接的、不可靠的报文传递。
• SOCK_RAW：IP协议的数据报接口（在posix.1中为可选）
• SOCK_SEQPACKET：固定长度的、有序的、可靠的、面向连接的报文传递

第三个参数protocol：指定使用的协议，设置为0表示使用默认协议。
　　例如：在AF_INET通信域中，套接字类型SOCK_STREAM的默认协议是传输控制协议（TCP）。而如果套接字类型SOCK_DGRAM的默认协议是UDP。
　　也可以指定参数：

• IPPROTO_TCP：传输控制协议
• IPPROTO_UDP：用户数据报协议
• IPPROTO_IP：IPv4网际协议
• IPPROTO_IPV6：IPv6网际协议
• IPPROTO_ICMP：因特网控制报文协议
• IPPROTO_RAM：原始IP数据包协议

 返回值：

　　成功返回套接字文件描述符，失败返回-1

#include <stdio.h>
#include <stdlib.h>
/**
 * 联合类型的变量类型，用于测试字节序
 * 成员value的高低端字节可以由成员byte按字节访问
 *
 * */
typedef union{
    unsigned short int value;
    unsigned char byte[2];
}to;

int main(int argc, char *argv[])
{
    to typeorder;
    typeorder.value = 0xabcd;

    if(typeorder.byte[0] == 0xcd&& typeorder.byte[1] == 0xab){
        printf("Low endian byte order"
                "byte[0]:0x%x,byte[1]:0x%x
",
                typeorder.byte[0],
                typeorder.byte[1]);
    }else if(typeorder.byte[0] == 0xab&& typeorder.byte[1] == 0xcd){
        printf("High endian byte order"
                "byte[0]:0x%x,byte[1]:0x%x
",
                typeorder.byte[0],
                typeorder.byte[1]);
    }
    return 0;
}

uint32_t htonl(uint32_t hostint32);

uint16_t htons(uint16_t hostint16);

uint32_t ntohl(uint32_t netint32);

uint16_t ntohs(uint16_t netint16)

struct sockaddr{                    /* 套接字地址结构 */
    sa_family_t sun_family;         /* 协议族 */
    char            sa_data[14];    /* 协议族数据 */
}；            
typedef unsigned short sa_family_t；   /* 16位 */

struct sockaddr_in{
   short int                 sin_family;    /* 协议族，以太网一般位AF_INET */
　 unsigned short int        sin_port;      /* 16位的端口号，网络字节序 */
　 struct in_addr           sin_addr;       /* IP地址32位 */
   char                    sin_zero[8];    /* 保留 */
};

#include <sys/socket.h>
#include <sys/types.h>

int bind(int socket, const struct sockaddr *address, size_t address_len);

• 第一个参数socket：由socket()函数创建得到得套接字描述符
• 第二个参数address：我们指定要绑定的域、IP地址和端口的sockaddr结构体
• 第三个参数address_len：sockaddr结构体的长度。通常使用sizeof(struct sockaddr)

返回值：0表示绑定成功，-1表示绑定失败。可以通过error查看错误值

#include <sys/socket.h>
#include <sys/types.h>

int listen(int socket, int backlog);
第二个参数backlog：等待处理的进入连接的个数最多不能超过这个数字
返回值： 成功：0； 失败：-1；

#include <sys/socket.h>
#include <sys/types.h>

int accept(int socket, struct sockaddr *address, size_t *address_len);
　　参数：当accept()函数返回的时候，会将客户端的信息存储在参数address中。参数address_len表示第二个参数所指内容的长度，可以使用sizeof(struct sockaddr_in)来获得。
　　需要注意的是：在accept中address_len参数是一个指针而不是结构，accept()函数将这个指针传给TCP/IP协议栈。
　　返回值：成功返回新的描述符用于和客户端进行通信。失败返回-1。

#include <sys/socket.h>
int connect(int socket, const struct sockaddr *address, size_t address_len);
参数：
　　第一个参数：建立套接字的时候返回的描述符
　　第二个参数：一个指向数据结构sockaddr的指针，其中包括客户端需要连接的服务器的目的端口和ip地址，以及协议类型。
　　第三个参数：表示第二个参数内容的大小，可以使用sizeof(struct sockaddr)获得，与bind函数不同，这个参数是一个整形的变量而不是指针。
返回值： 成功：0； 失败：-1

int size 
char data[1024];
size = write(socket, data, 1024);    //将缓冲区data的数据全部写入套接字描述符socket中，返回值为成功写入的数据长度。
　　注意：如果用tcp，socket是accept函数返回的套接字描述符。

#include <sys/types.h>
#include <sys/socket.h>

ssize_t send(int s, const void *buf, size_t len, int flags);
参数：
　　和recv的参数基本一致。
返回值：成功发送的字节数。发生错误的返回-1，可以查看errno获取错误码。

#include <sys/uio.h>
ssize_t writev(int fd, const srtuct iovec *vector, int count);

struct iovec{
　　void *iov_base;　　　　/* 向量的缓冲区地址 */
　　size_t iov_len;　　　　/* 向量缓冲区的大小，以字节为单位 */
};

作用：
　　向套接字描述符s中写入在向量vector中保存的count块数据。
返回值：成功返回发送的字节数。错误返回-1，可以查看errno获取错误码。

int size;
char data[1024];
size = read(socket, data, 1024);    //从套接字描述符socket中读取1024个字节，放入缓冲区data中，返回值是成功读取的数据大小

#include <sys/types.h>
#include <sys/socket.h>

ssize_t recv(int s, void *buf, size_t len, int flags);
参数：
　　s：由socket函数得到得套接字描述符。
　　buf：从套接字s中接收数据放在缓冲区buf中。
　　len：buf的长度
　　flag：用于设置接收数据的方式
返回值：
　　错误返回-1，可以查看errno。成功返回接收的字节数。

#include <sys/uio.h>
ssize_t readv(int s, const struct iovec *vector, int count);

struct iovec{
　　void *iov_base;　　　　　　/* 向量的缓冲区地址 */
　　size_t iov_len;　　　　　　/* 向量缓冲区的大小，以字节为单位 */
};

作用：
　　从套接字描述符s中读取count块数据放在缓冲区向量vector中。
返回值：成功接收到的字节数。错误返回-1，查看errno获取错误码。

#include <sys/socket.h>

int shutdown(int socket, int how);
参数：
　　第一个参数是要切换通信的套接字描述符。
　　第二个参数表示切断的方式。
　　SHUT_RD:值为0，表示切断读。
　　SHUT_WR:值为1，表示切断写。
　　SHUT_RDWR:值为2，表示切换读写。
返回值：成功返回0，失败返回-1

或者
close(socket);