Linux开发(四)：网络编程API

Chiang木

已于 2022-03-07 17:47:32 修改

阅读量3.5k

点赞数 2

分类专栏： Linux 文章标签： linux 网络运维

于 2022-03-07 17:30:12 首次发布

本文链接：https://blog.csdn.net/Chiang2018/article/details/123331119

版权

Linux 专栏收录该内容

14 篇文章 9 订阅

订阅专栏

在这里插入图片描述

6、send()/sendto()/sendmsg()函数

7、recv()/recvfrom()/recvmsg()函数

3、通过IP地址获取网络号和主机号（IPv4）

4、字节顺序转换函数

5、通过套接字获取主机信息

三、示例

本文主要介绍Linux网络编程时，用到的各个API，不涉及协议相关知识！

一、网络编程API

我们知道正常的CS架构，包含以下内容：

在这里插入图片描述

下面依次介绍以上用到的各个API。

1、socket()函数

创建网络套接字。

#include<sys/types>
#include<sys/socket.h>
int socket(int domain, int type, int protocol);

函数参数：

domain：该socket要使用的地址协议簇，常用选项如下：

#define PF_LOCAL 1 /* 本地通信 ,即AF_LOCAL*/
#define PF_UNIX PF_LOCAL /* 本地通信 */
#define PF_FILE PF_LOCAL /* 本地通信 */
#define PF_INET 2 /* IPV4协议簇,即AF_INET */
#define PF_AX25 3 /* AX.25 */
#define PF_IPX 4 /* Novell网协议 */
#define PF_INET6 10 /* IPV6协议簇 */

type:指定socket套接字的类型，可以取以下值之一：

SOCK_STREAM (字节流套接字--TCP)
SOCK_DGRAM (数据报套接字---UDP)
SOCK_SEQPACKET (有序分组套接字)
SOCK_RAW (原始套接字)

protocol：传输协议类型，写0即可，由系统自行选择，可以取以下值之一，正常情况下：

IPPROTO_TCP (tcp传输协议)
IPPROTO_UDP （udp传输协议）
IPPROTO_SCTP （sctp传输协议）

返回值：

成功返回一个socket文件描述符，失败返回-1

2、bind()函数

将给定的网络地址及套接字绑定到指定的socket套接字上。

#include<sys/types>
#include<sys/socket.h>
int bind(int sockfd, const struct sockaddr* my_addr, socklen_t addrlen);

函数参数：

sockfd: socket套接字
my_addr: 一个指向strcut sockaddr的指针，根据socket不同的协议类型，其结构也不同，原始定义相对复杂，下面是我整理后的结构体定义，根据不同类型可以直接使用：
/* Structure describing a generic socket address.  */
struct sockaddr
{
 uint16 sa_family;           /* 通用数据*/
 char sa_data[14];           /* Address data.  */
};


/* IPv4*/
struct sockaddr_in
{
 uint16 sin_family;          /* 通用数据*/
 uint16 sin_port;            /* Port number.  */
 uint32 sin_addr.s_addr;     /* Internet address.  */
 unsigned char sin_zero[8];  /* Pad to size of `struct sockaddr'.  */
};

/* Ditto, for IPv6.  */
struct sockaddr_in6
{
 uint16 sin6_family;         /* 通用数据*/
 uint16 sin6_port;           /* Transport layer port # */
 uint32 sin6_flowinfo;       /* IPv6 flow information */
 uint8  sin6_addr[16];       /* IPv6 address */
 uint32 sin6_scope_id;       /* IPv6 scope-id */
};
addrlen： sizeof(struct sockaddr)的大小

返回值：

成功返回0，失败返回-1

3、listen()函数

将socket套接字变为监听套接字，准备接受客户端的连接。

//from /usr/include/sys/socket.h
#include<sys/types>
#include<sys/socket.h>
int listen(int socket,int num);

函数参数：

sockfd: socket套接字

num:内核监听队列的最大长度。监听队列的长度如果超过backlog，服务器将不受理新的客户连接

返回值：

执行成功返回0，失败返回-1

4、connect()函数

客户端主动发送连接请求给服务器。

//from /usr/include/sys/socket.h
#include<sys/types>
#include<sys/socket.h>
int connect(int socket,struct sockaddr* addr,sockelen_t len );

函数参数：

sockfd: socket套接字

addr:服务器地址信息

len:地址信息长度

返回值：

函数执行成功，则与地址为addr的服务器建立连接，并返回0，失败返回-1。

5、accept()函数

服务器阻塞等待客户端的连接。

//from /usr/include/sys/socket.h
#include<sys/types>
#include<sys/socket.h>
int accept(int socket,struct sockaddr* addr,sockelen_t len );

函数参数：

sockfd: 已经绑定服务器端口地址信息的socket套接字

addr:用来存储接受到的客户端的端口和地址

len:客户端地址信息的长度

返回值：

成功则返回一个新的socket套接字，从而使原套接字继续等待其他客户端的连接，服务器通过读写该socket来与对应的客户端通信，失败则返回-1。

6、send()/sendto()/sendmsg()函数

向另一个套接字传递消息，其中send 只能用在面向连接(SOCK_STREAM)类型的socket上，而 sendto 和 sendmsg 可用于任何情况下。

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

int send(int sockfd, const void *msg, size_t len, int flags);
int sendto(int sockfd, const void *msg, size_t len, int flags, const struct sockaddr *to, socklen_t tolen);
int sendmsg(int sockfd, const struct msghdr * mhdr, int flags);

函数参数：

sockfd: 用于传输数据的socket描述符

msg: 待发送的数据缓冲区

len: 数据缓冲区长度

mhdr：是msghdr结构体类型的指针, msghdr结构体的定义如下:
struct msghdr
{
    void* msg_name;  /*socket地址*/
    socklen_t msg_namelen;  //socket地址的长度
    struct iovec* msg_iov;  //分散的内存块,见后文
    int msg_iovlen;            //分散内存块的数量
    void* msg_control;        //指向辅助数据的起始位置
    socklen_t msg_controllen;    //辅助数据的大小
    int msg_flags;                //复制函数中的nags参数,并在调用过程中更新
};

struct iovec
{
	void *iov_base;		//内存起始地址
	size_t iov_len;		//这块内存的长度
}
flags：为数据收发提供了额外的控制，它可以取表所示选项中的一个或几个的逻辑或：

to: 指向存放接收端的地址信息，当socketfd的类型为面向连接(SOCK_STREAM)类型时，该值必须为NULL，否则将报错

tolen:地址信息长度，当socketfd的类型为面向连接(SOCK_STREAM)类型时，该值必须为0，否则将报错

返回值：

成功时，返回实际发送的字符数，失败返回 -1

7、recv()/recvfrom()/recvmsg()函数

从指定套接字接收消息，其中recv()只能用在面向连接(SOCK_STREAM)类型的socket上，而 sendto 和 sendmsg 可用于任何情况下。

#include <sys/types.h>
#include <sys/socket.h>
ssize_t recv(int sockfd, void *buf, size_t len, int flags);
ssize_t recvfrom(int sockfd, void *buf, size_t len, int flags,struct sockaddr *from, socklen_t *fromlen);
ssize_t recvmsg(int sockfd, struct msghdr *mhdr, int flags);

函数参数：

sockfd: 用于传输数据的socket描述符

msg: 用于存储接收到的数据缓冲区

len: 数据缓冲区长度

mhdr：是msghdr结构体类型的指针, msghdr结构体的定义如下:
struct msghdr
{
    void* msg_name;  /*socket地址*/
    socklen_t msg_namelen;  //socket地址的长度
    struct iovec* msg_iov;  //分散的内存块,见后文
    int msg_iovlen;            //分散内存块的数量
    void* msg_control;        //指向辅助数据的起始位置
    socklen_t msg_controllen;    //辅助数据的大小
    int msg_flags;                //复制函数中的nags参数,并在调用过程中更新
};

struct iovec
{
	void *iov_base;		//内存起始地址
	size_t iov_len;		//这块内存的长度
}
flags：为数据收发提供了额外的控制，它可以取表所示选项中的一个或几个的逻辑或：

返回值：

这些调用返回接收到的字节数，如果发生错误，则返回 -1。当对端执行了有序关闭时，返回值将为 0。

8、close()函数

关闭某socket套接字，不过close函数并非总是立即关闭一个连接，而是将fd的引用计数减1。只有当fd的引用计数为0时，才真正关闭连接。多进程程序中，一次fork系统调用默认将使父进程中打开的socket引用计数加1，因此我们必须在父进程和子进程中都对该socket执行close调用才能将连接关闭

#include<unistd.h>

int close(int fd);

函数参数：

fd: 待关闭的socket

返回值：

成功返回0，失败返回-1

9、shutdown()函数

立即关闭网络套接字

#include<unistd.h>
int shutdown(int socket,int how);

函数参数：

fd: 待关闭的socket

how: 可根据参数how指定关闭套接字的某一端：

how = 0：关闭socket的读端，即往socket写数据使正常的。
how = 1：关闭socket的写端，即往socket读数据使正常的。
how = 2：读写通道均关闭，同close()。

返回值：

成功返回0，失败返回-1