unix网络编程——ioctl 函数的用法详解

墨蓝 2022-08-12 01:28 1237阅读 0赞

转载自：[unix网络编程——ioctl 函数的用法详解][unix_ioctl]

# [\[置顶\] unix网络编程——ioctl 函数的用法详解][unix_ioctl] #

分类： [2.2. 网络][2.2.] 2012-11-26 21:39  3833人阅读  [评论][Link 1](2)  收藏  [举报][Link 2]

目录[(?)][Link 3][\[+\]][Link 3]

# 1.介绍 #

Linux网络程序与内核交互的方法是通过ioctl来实现的，ioctl与网络协议栈进行交互，可得到网络接口的信息，网卡设备的映射属性和配置网络接口.并且还能够查看，修改，删除ARP高速缓存的信息，所以，我们有必要了解一下ioctl函数的具体实现.

# 2.函数说明 #

SYNOPSIS 
       \#include <sys/ioctl.h> 
 
       int ioctl(int d, int request, ...); 
 
DESCRIPTION 
       The  ioctl()  function  manipulates the underlying device parameters of 
       special files.  In particular, many operating characteristics of  char- 
       acter  special  files  (e.g., terminals) may be controlled with ioctl() 
       requests.  The argument d must be an open file descriptor. 
 
       The second argument is a  device-dependent  request  code.   The  third 
       argument  is  an  untyped  pointer  to memory.  It’s traditionally char 
       \*argp (from the days before void \* was valid C), and will be  so  named 
       for this discussion. 
 
       An  ioctl()  request  has  encoded  in it whether the argument is an in 
       parameter or out parameter, and the size of the argument argp in bytes. 
       Macros and defines used in specifying an ioctl() request are located in 
       the file <sys/ioctl.h>. 
 
RETURN VALUE 
       Usually, on success zero is returned.  A few ioctl() requests  use  the 
       return  value as an output parameter and return a non-negative value on 
       success.  On error, -1 is returned, and errno is set appropriately.

# 3.参数说明 #

<table> 
 <tbody> 
 <tr> 
 <td> 类别 </td> 
 <td> Request </td> 
 <td> 说明 </td> 
 <td> 数据类型 </td> 
 </tr> 
 <tr> 
 <td> 套 接 口 </td> 
 <td> SIOCATMARK SIOCSPGRP SIOCGPGRP </td> 
 <td> 是否位于带外标记 设置套接口的进程ID或进程组ID 获取套接口的进程ID或进程组ID </td> 
 <td> int int int </td> 
 </tr> 
 <tr> 
 <td> 文 件 </td> 
 <td> FIONBIN FIOASYNC FIONREAD FIOSETOWN FIOGETOWN </td> 
 <td> 设置/清除非阻塞I/O标志 设置/清除信号驱动异步I/O标志 获取接收缓存区中的字节数 设置文件的进程ID或进程组ID 获取文件的进程ID或进程组ID </td> 
 <td> int int int int int </td> 
 </tr> 
 <tr> 
 <td> 接 口 </td> 
 <td> SIOCGIFCONF SIOCSIFADDR SIOCGIFADDR SIOCSIFFLAGS SIOCGIFFLAGS SIOCSIFDSTADDR SIOCGIFDSTADDR SIOCGIFBRDADDR SIOCSIFBRDADDR SIOCGIFNETMASK SIOCSIFNETMASK SIOCGIFMETRIC SIOCSIFMETRIC SIOCGIFMTU SIOCxxx </td> 
 <td> 获取所有接口的清单 设置接口地址 获取接口地址 设置接口标志 获取接口标志 设置点到点地址 获取点到点地址 获取广播地址 设置广播地址 获取子网掩码 设置子网掩码 获取接口的测度 设置接口的测度 获取接口MTU （还有很多取决于系统的实现） </td> 
 <td> struct ifconf struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq struct ifreq </td> 
 </tr> 
 <tr> 
 <td> ARP </td> 
 <td> SIOCSARP SIOCGARP SIOCDARP </td> 
 <td> 创建/修改ARP表项 获取ARP表项 删除ARP表项 </td> 
 <td> struct arpreq struct arpreq struct arpreq </td> 
 </tr> 
 <tr> 
 <td> 路 由 </td> 
 <td> SIOCADDRT SIOCDELRT </td> 
 <td> 增加路径 删除路径 </td> 
 <td> struct rtentry struct rtentry </td> 
 </tr> 
 <tr> 
 <td> 流 </td> 
 <td> I_xxx </td> 
 <td>&nbsp;</td> 
 <td>&nbsp;</td> 
 </tr> 
 </tbody> 
</table>

# 4.相关数据结构 #

1. <h2><a name="t4"></a>(1)网络接口请求结构ifreq</h2>  
2. **struct** ifreq \{  
3. \#define IFHWADDRLEN 6 //6个字节的硬件地址，即MAC  
4.     **union** \{  
5.         **char** ifrn\_name\[IFNAMESIZ\]; //网络接口名称  
6.     \}ifr\_ifrn;  
7.     **union** \{  
8.         **struct** sockaddr ifru\_addr; //本地IP地址  
9.         **struct** sockaddr ifru\_dstaddr;//目标IP地址  
10.         **struct** sockaddr ifru\_broadaddr;//广播IP地址  
11.         **struct** sockaddr ifru\_netmask;//本地子网掩码地址  
12.         **struct** sockaddr ifru\_hwaddr;//本地MAC地址  
13.         **short** ifru\_flags;//网络接口标记  
14.         **int** ifru\_ivalue;//不同的请求含义不同  
15.         **struct** ifmap ifru\_map;//网卡地址映射  
16.         **int** ifru\_mtu;//最大传输单元  
17.         **char** ifru\_slave\[IFNAMSIZ\];//占位符  
18.         **char** ifru\_newname\[IFNAMSIZE\];//新名称  
19.         **void** \_\_user\* ifru\_data;//用户数据  
20.         **struct** if\_settings ifru\_settings;//设备协议设置  
21.     \}ifr\_ifru;  
22. \}  
23. \#define ifr\_name ifr\_ifrn.ifrn\_name;//接口名称  
24. \#define ifr\_hwaddr ifr\_ifru.ifru\_hwaddr;//MAC  
25. \#define ifr\_addr ifr\_ifru.ifru\_addr;//本地IP  
26. \#define ifr\_dstaddr ifr\_ifru.dstaddr;//目标IP  
27. \#define ifr\_broadaddr ifr\_ifru.broadaddr;//广播IP  
28. \#define ifr\_netmask ifr\_ifru.ifru\_netmask;//子网掩码  
29. \#define ifr\_flags ifr\_ifru.ifru\_flags;//标志  
30. \#define ifr\_metric ifr\_ifru.ifru\_ivalue;//接口侧度  
31. \#define ifr\_mtu ifr\_ifru.ifru\_mtu;//最大传输单元  
32. \#define ifr\_map ifr\_ifru.ifru\_map;//设备地址映射  
33. \#define ifr\_slave ifr\_ifru.ifru\_slave;//副设备  
34. \#define ifr\_data ifr\_ifru.ifru\_data;//接口使用  
35. \#define ifr\_ifrindex ifr\_ifru.ifru\_ivalue;//网络接口序号  
36. \#define ifr\_bandwidth ifr\_ifru.ifru\_ivalue;//连接带宽  
37. \#define ifr\_qlen ifr\_ifru.ifru\_ivalue;//传输单元长度  
38. \#define ifr\_newname ifr\_ifru.ifru\_newname;//新名称  
39. \#define ifr\_seeting ifr\_ifru.ifru\_settings;//设备协议设置  
40. 如果想获得网络接口的相关信息，就传入ifreq结构体.  
41.   
42. <h2><a name="t5"></a>(2)网卡设备属性ifmap</h2>  
43. **struct** ifmap \{ //网卡设备的映射属性  
44.     unsigned **long** mem\_start;//开始地址  
45.     unsigned **long** mem\_end;//结束地址  
46.     unsigned **short** base\_addr;//基地址  
47.     unsigned **char** irq;//中断号  
48.     unsigned **char** dma;//DMA  
49.     unsigned **char** port;//端口  
50. \}  
51.   
52. <h2><a name="t6"></a>(3)网络配置接口ifconf</h2>  
53. **struct** ifconf \{ //网络配置结构体是一种缓冲区  
54.     **int** ifc\_len;//缓冲区ifr\_buf的大小  
55.     **union** \{  
56.         char\_\_user \*ifcu\_buf; //绘冲区指针  
57.         **struct** ifreq\_\_user\* ifcu\_req;//指向ifreq指针  
58.     \}ifc\_ifcu;  
59. \};  
60. \#define ifc\_buf ifc\_ifcu.ifcu\_buf;//缓冲区地址  
61. \#define ifc\_req ifc\_ifcu.ifcu\_req;//ifc\_req地址  
62.   
63. <h2><a name="t7"></a>(4)ARP高速缓存操作arpreq</h2>  
64. /\*\*  
65.  ARP高速缓存操作，包含IP地址和硬件地址的映射表  
66.  操作ARP高速缓存的命令字 SIOCDARP,SIOCGARP,SIOCSARP分别是删除ARP高速缓存的一条记录，获得ARP高速缓存的一条记录和修改ARP高速缓存的一条记录  
67.  **struct** arpreq\{  
68.  **struct** sockaddr arp\_pa;//协议地址  
69.  **struct** sockaddr arp\_ha;//硬件地址  
70.  **int** arp\_flags;//标记  
71.  **struct** sockaddr arp\_netmask;//协议地址的子网掩码  
72.  **char** arp\_dev\[16\];//查询网络接口的名称  
73.  \}

# 5. 相关代码例子 #

1. <pre name="code" **class**="cpp">\#include <sys/types.h>  
2. \#include <stdio.h>  
3. \#include <stdlib.h>  
4. \#include <unistd.h>  
5. \#include <sys/ioctl.h>  
6. \#include <sys/socket.h>  
7. \#include <netdb.h>  
8. \#include <string.h>  
9. \#include <fcntl.h>  
10. \#include <net/if.h>  
11. \#include <string.h>  
12.   
13. **int** main(**int** argc, **char**\*argv\[\]) \{  
14.     **int** s,sv6;  
15.     **int** err;  
16.     s = socket(AF\_INET, SOCK\_DGRAM, 0);  
17.     **if** (s < 0) \{  
18.         perror("socket error");  
19.         **return** -1;  
20.     \}  
21.   
22. //传入网络接口序号，获得网络接口的名称  
23.     **struct** ifreq ifr;  
24.     **int** ia = **sizeof**( **struct** ifreq );  
25.     ia = **sizeof**(**struct** sockaddr);  
26.    ia = 1;   err = 0;  
27.     bzero(&ifr, **sizeof**(**struct** ifreq));  
28.     **while** (err != -1) \{  
29.   
30.         ifr.ifr\_ifindex = ia++; //获得第2个网络接口的名称  
31.         err = ioctl(s, SIOCGIFNAME, &ifr);  
32.         **if** (-1 == err) \{  
33.             perror("index error");  
34.         \} **else** \{ //10111111 11111111 11101101 11101000  
35.             **char** ipbuf\[255\];  
36.             inet\_ntop(AF\_INET,  
37.                     &((**struct** sockaddr\_in\*) &(ifr.ifr\_ifru.ifru\_addr))->sin\_addr,  
38.                     ipbuf, **sizeof**(ipbuf));  
39.             printf("the %dst interface is:%s \\t addr:%s\\n", ifr.ifr\_ifindex,  
40.                     ifr.ifr\_name, ipbuf);  
41.         \}  
42.     \}  
43. //传入网络接口名称，获得标志  
44.     bzero(&ifr,**sizeof**(**struct** ifreq));  
45.     memcpy(ifr.ifr\_name, "eth0", 5);  
46.     err = ioctl(s, SIOCGIFFLAGS, &ifr);  
47.     **if** (!err) \{  
48.         printf("SIOCGIFFLAGS:%d\\n", ifr.ifr\_flags);  
49.     \}  
50.   
51. //获得MTU和MAC  
52.     bzero(&ifr,**sizeof**(**struct** ifreq));  
53.     memcpy(ifr.ifr\_name, "eth0", 5);  
54.     err = ioctl(s, SIOCGIFMTU, &ifr);  
55.     **if** (err!=-1) \{  
56.         printf("SIOCGIFMTU:%d\\n", ifr.ifr\_mtu);  
57.     \}**else**  
58.         perror("ioctl:");  
59. //获得MAC地址  
60.     bzero(&ifr,**sizeof**(**struct** ifreq));  
61.     memcpy(ifr.ifr\_name, "eth0", 5);  
62.  //   ifr.ifr\_ifindex = 1;  
63.     err = ioctl(s, SIOCGIFHWADDR, &ifr);  
64.     **if** (-1!=err) \{  
65.         unsigned **char**\* hw = ifr.ifr\_ifru.ifru\_hwaddr.sa\_data;  
66.         printf("SIOCGIFHWADDR:%02x:%02x:%02x:%02x:%02x:%02x\\n", hw\[0\], hw\[1\],  
67.                 hw\[2\], hw\[3\], hw\[4\], hw\[5\]);  
68.     \}**else**  
69.         perror("ioctl:");  
70. //获得网卡映射参数 命令字SIOCGIFMAP  
71.   
72.     err = ioctl(s, SIOCGIFMAP, &ifr);  
73.     **if** (!err) \{  
74.         printf(  
75.                 "SIOCGIFMAP,mem\_start:%d,mem\_end:%d,base\_addr:%d,ifr\_map:%d,dma:%d,port:%d\\n",  
76.                 ifr.ifr\_map.mem\_start, ifr.ifr\_map.mem\_end,  
77.                 ifr.ifr\_map.base\_addr, ifr.ifr\_map.irq, ifr.ifr\_map.dma,  
78.                 ifr.ifr\_map.port);  
79.     \}  
80. //获得网卡序号  
81.     err = ioctl(s, SIOCGIFINDEX, &ifr);  
82.     **if** (!err) \{  
83.         printf("SIOCGIFINDEX:%d\\n", ifr.ifr\_ifindex);  
84.     \}  
85. //获取发送队列的长度  
86.     err = ioctl(s, SIOCGIFTXQLEN, &ifr);  
87.     **if** (!err) \{  
88.         printf("SIOCGIFTXQLEN:%d\\n", ifr.ifr\_qlen);  
89.     \}  
90. //获取网络接口IP  
91.     bzero(&ifr,**sizeof**(**struct** ifreq));  
92.     memcpy(ifr.ifr\_name, "eth0", 5);  
93.  //   ifr.ifr\_ifru.ifru\_ivalue = 2;  
94.     **struct** sockaddr\_in \*sin = (**struct** sockaddr\_in\*) &ifr.ifr\_addr; //保存的是二进制IP  
95.     **char** ip\[16\]; //字符数组，存放字符串  
96.     memset(ip, 0, 16);  
97.     err = ioctl(s, SIOCGIFADDR, &ifr);  
98.     **if** (!err) \{  
99.         inet\_ntop(AF\_INET, &sin->sin\_addr.s\_addr, ip, 16); //转换的字符串保存到ip数组中，第二个参数是要转换的二进制IP指针，第三个参数是转换完成存放IP的缓冲区，最后一个参数是缓冲区的长度  
100.         printf("SIOCGIFADDR:%s\\n", ip);  
101.     \}  
102.   
103. //查询目标IP地址  
104.   
105.     err = ioctl(s, SIOCGIFDSTADDR, &ifr);  
106.     **if** (!err) \{  
107.         inet\_ntop(AF\_INET, &sin->sin\_addr.s\_addr, ip, 16);  
108.         printf("SIOCGIFDSTADDR:%s\\n", ip);  
109.     \}  
110. //查询子网掩码  
111.     bzero(&ifr,**sizeof**(**struct** ifreq));  
112.     memcpy(ifr.ifr\_name, "eth0", 5);  
113.     err = ioctl(s, SIOCGIFNETMASK, &ifr);  
114.     **if** (!err) \{  
115.         inet\_ntop(AF\_INET, &sin->sin\_addr.s\_addr, ip, 16);  
116.         printf("SIOCGIFNETMASK:%s\\n", ip);  
117.     \}  
118. /\* 
119. //设置IP地址，设置网络接口 
120.     inet\_pton(AF\_INET, "222.27.253.108", &sin->sin\_addr.s\_addr); //将字符串IP转换成二进制 
121.     err = ioctl(s, SIOCSIFADDR, &ifr); //发送设置本机ip地址请求命令 
122.     if (!err) \{  
123.         printf("check IP-----"); 
124.         memset(&ifr, 0, sizeof(ifr)); 
125.         memcpy(ifr.ifr\_name, "eth0", 5); 
126.         ioctl(s, SIOCGIFADDR, &ifr); 
127.         inet\_ntop(AF\_INET, &sin->sin\_addr.s\_addr, ip, 16); 
128.         printf("%s\\n", ip); 
129.     \}\*/  
130. //得到接口的广播地址  
131.     memset(&ifr, 0, **sizeof**(ifr));  
132.     memcpy(ifr.ifr\_name, "eth0", 5);  
133.     ioctl(s, SIOCGIFBRDADDR, &ifr);  
134.     **struct** sockaddr\_in \*broadcast = (**struct** sockaddr\_in\*) &ifr.ifr\_broadaddr;  
135. //转换成字符串  
136.     inet\_ntop(AF\_INET, &broadcast->sin\_addr.s\_addr, ip, 16); //inet\_ntop将二进制IP转换成点分十进制的字符串  
137.     printf("BROADCAST IP:%s\\n", ip);  
138.     close(s);  
139. \}  
140. </pre>   
141. <pre></pre>  
142.   
143. <h1><a name="t9"></a>6.内核主要函数调用框架</h1>  
144.   
145. 内核实现ioctl()函数的是sys\_ioctl(),在内核中主要调用框架图如下,它清晰地给我们展示ioctl的控制传递框架,我们接下来的内容将根据此图向大家做详细的解释：  
146. <img src="https://img-my.csdn.net/uploads/201211/26/1353937655\_1774.jpg" alt="">   
147.   
148.   
149.   
150. <h1><a name="t10"></a>7.小结</h1>  
151.       本文介绍了ioctrl 主要的用法，当然它还有很多用法，以后会继续追加的，该如函数的用法，主要就是其对应的request列表的用法，即是该函数的第二个参数的用法  
152.   
153.   
154. 参考： UNIX 网络编程  
155. <a href="http://blog.163.com/jlz\_325/blog/static/19174000920126893245653/">http://blog.163.com/jlz\_325/blog/**static**/19174000920126893245653/</a>  
156. <a href="http://www.linuxidc.com/Linux/2007-12/9680.htm">http://www.linuxidc.com/Linux/2007-12/9680.htm</a>   
157.   
158. <a href="http://linux.chinaunix.net/techdoc/develop/2007/09/05/967137.shtml">http://linux.chinaunix.net/techdoc/develop/2007/09/05/967137.shtml</a>   
159.   
160.   
161.

[unix_ioctl]: http://blog.csdn.net/ashlingr/article/details/8227603
[2.2.]: http://blog.csdn.net/rao_warrior/article/category/1290059
[Link 1]: http://blog.csdn.net/ashlingr/article/details/8227603#comments
[Link 2]: http://blog.csdn.net/ashlingr/article/details/8227603#report
[Link 3]: http://blog.csdn.net/ashlingr/article/details/8227603#