ioctl详解

ioctl函数详细说明（网络）分类：应用编程2012-06-15 12:02 947人阅读评论(0) 收藏举报网络structcommandsocketinterface软件测试ioctl 函数本函数影响由fd 参数引用的一个打开的文件。

#include<unistd.h>int ioctl( int fd, int request, .../* void *arg */ );返回0 ：成功-1 ：出错第三个参数总是一个指针，但指针的类型依赖于request 参数。

我们可以把和网络相关的请求划分为6 类：套接口操作文件操作接口操作ARP 高速缓存操作路由表操作流系统下表列出了网络相关ioctl 请求的request 参数以及arg 地址必须指向的数据类型：类别Request 说明数据类型套接口SIOCATMARKSIOCSPGRPSIOCGPGRP是否位于带外标记设置套接口的进程ID 或进程组ID获取套接口的进程ID 或进程组IDintintint文件FIONBINFIOASYNCFIONREADFIOSETOWNFIOGETOWN设置/ 清除非阻塞I/O 标志设置/ 清除信号驱动异步I/O 标志获取接收缓存区中的字节数设置文件的进程ID 或进程组ID获取文件的进程ID 或进程组IDintintintintint接口SIOCGIFCONFSIOCSIFADDRSIOCGIFADDRSIOCSIFFLAGSSIOCGIFFLAGSSIOCSIFDSTADDRSIOCGIFDSTADDR获取所有接口的清单设置接口地址获取接口地址设置接口标志获取接口标志设置点到点地址获取点到点地址struct ifconfstruct ifreqstruct ifreqstruct ifreqstruct ifreqstruct ifreqstruct ifreqSIOCGIFBRDADDR SIOCSIFBRDADDR SIOCGIFNETMASK SIOCSIFNETMASK SIOCGIFMETRIC SIOCSIFMETRIC SIOCGIFMTU SIOCxxx 获取广播地址设置广播地址获取子网掩码设置子网掩码获取接口的测度设置接口的测度获取接口MTU（还有很多取决于系统的实现）struct ifreqstruct ifreqstruct ifreqstruct ifreqstruct ifreqstruct ifreqstruct ifreqARP SIOCSARPSIOCGARPSIOCDARP创建/ 修改ARP 表项获取ARP 表项删除ARP 表项struct arpreqstruct arpreqstruct arpreq路由SIOCADDRTSIOCDELRT增加路径删除路径struct rtentrystruct rtentry流I_xxx套接口操作：明确用于套接口操作的ioctl 请求有三个, 它们都要求ioctl 的第三个参数是指向某个整数的一个指针。

SIOCATMARK: 如果本套接口的的度指针当前位于带外标记，那就通过由第三个参数指向的整数返回一个非0 值；否则返回一个0 值。

POSIX 以函数sockatmark 替换本请求。

SIOCGPGRP ：通过第三个参数指向的整数返回本套接口的进程ID 或进程组ID ，该ID 指定针对本套接口的SIGIO 或SIGURG 信号的接收进程。

本请求和fcntl 的F_GETOWN 命令等效，POSIX 标准化的是fcntl 函数。

SIOCSPGRP ：把本套接口的进程ID 或者进程组ID 设置成第三个参数指向的整数，该ID 指定针对本套接口的SIGIO 或SIGURG 信号的接收进程，本请求和fcntl 的F_SETOWN 命令等效，POSIX 标准化的是fcntl 操作。

文件操作：以下5 个请求都要求ioctl 的第三个参数指向一个整数。

FIONBIO ：根据ioctl 的第三个参数指向一个0 或非0 值分别清除或设置本套接口的非阻塞标志。

本请求和O_NONBLOCK 文件状态标志等效，而该标志通过fcntl 的F_SETFL 命令清除或设置。

FIOASYNC ：根据iocl 的第三个参数指向一个0 值或非0 值分别清除或设置针对本套接口的信号驱动异步I/O 标志，它决定是否收取针对本套接口的异步I/O 信号（SIGIO ）。

本请求和O_ASYNC 文件状态标志等效，而该标志可以通过fcntl 的F_SETFL 命令清除或设置。

FIONREAD ：通过由ioctl 的第三个参数指向的整数返回当前在本套接口接收缓冲区中的字节数。

本特性同样适用于文件，管道和终端。

FIOSETOWN ：对于套接口和SIOCSPGRP 等效。

FIOGETOWN ：对于套接口和SIOCGPGRP 等效。

接口配置：得到系统中所有接口由SIOCGIFCONF 请求完成，该请求使用ifconf 结构，ifconf 又使用ifreq结构，如下所示：Struct ifconf{int ifc_len; // 缓冲区的大小union{caddr_t ifcu_buf; // input from user->kernelstruct ifreq *ifcu_req; // return of structures returned}ifc_ifcu;};#define ifc_buf ifc_ifcu.ifcu_buf //buffer address#define ifc_req ifc_ifcu.ifcu_req //array of structures returned#define IFNAMSIZ 16struct ifreq{char ifr_name[IFNAMSIZ]; // interface name, e.g., “le0”union{struct sockaddr ifru_addr;struct sockaddr ifru_dstaddr;struct sockaddr ifru_broadaddr;short ifru_flags; int ifru_metric; caddr_t ifru_data; }ifr_ifru; };#define ifr_addr ifr_ifru.ifru_addr // address#define ifr_dstaddr ifr_ifru.ifru_dstaddr // otner end of p-to-p link #define ifr_broadaddr ifr_ifru.ifru_broadaddr // broadcast address #define ifr_flags ifr_ifru.ifru_flags // flags #define ifr_metric ifr_ifru.ifru_metric // metric#define ifr_data ifr_ifru.ifru_data // for use by interface再调用ioctl 前我们必须先分撇一个缓冲区和一个ifconf 结构，然后才初始化后者。

如下图 展示了一个ifconf 结构的初始化结构，其中缓冲区的大小为1024 ，ioctl 的第三个参数指向 这样一个ifconf 结构。

1024---------------------> 缓存假设内核返回2 个ifreq 结构，ioctl 返回时通过同一个ifconf 结构缓冲区填入了那2 个ifreq 结构，ifconf 结构的ifc_len 成员也被更新，以反映存放在缓冲区中的信息量 一般来讲ioctl 在用户程序中的调用是： ioctl (int fd,int command, (char*)argstruct)ioctl 调用与网络编程有关（本文只讨论这一点），文件描述符fd 实际上是由socket()系统调用返回的。

参数command 的取值由/usr/include/linux/sockios.h 所规定。

这些command 的由于功能的不同，可分为以下几个小类： • 改变路由表 (例如 SIOCADDRT, SIOCDELRT),• 读/更新 ARP/RARP 缓存(如：SIOCDARP, SIOCSRARP),• 一般的与网络接口有关的(例如 SIOCGIFNAME, SIOCSIFADDR 等等)在 Gooodies 目录下有很多样例程序展示了如何使用ioctl 。

当你看这些程序时，注意参数argstruct 是与参数command 相关的。

例如，与 路由表相关的ioctl 使用rtentry 这种结构，rtentry 定义在/usr/include/linux/route.h （参见例子 adddefault.c ）。

与ARP 有关的ioctl 调用使用arpreq 结构，arpreq 定义在/usr/include/linux /if_arp.h （参见例子arpread.c ）ifc_len Ifc_buf与网络接口有关的ioctl调用使用的command参数通常看起来像SIOCxIFyyyy的形式，这里x要么是S（设定set，写write），要么是G（得到get，读read）。

在getifinfo.c程序中就使用了这种形式的command参数来读IP地址，硬件地址，广播地址和得到与网络接口有关的一些标志（flag）。

在这些ioctl调用中，第三个参数是ifreq结构，它在/usr/include/linux/if.h中定义。

在某些情况下，ioctrl调用可能会使用到在sockios.h之外的新的定义。

实例：程序1：检测接口的.net_addr,netmask,broad_addr程序2：检查接口的物理连接是否正常程序3：更简单一点测试物理连接程序4：调节音量***************************程序1****************************************#include <s td io.h>#include <string.h>#include <stdlib.h>#include <errno.h>#include <unistd.h>#include <sys/types.h>#include <sys/socket.h>#include <netinet/in.h>#include <arpa/inet.h>#include <sys/ioctl.h>#include <net/if.h>static void usage(){printf("usage : ipconfig interface \n");exit(0);}int main(int argc,char **argv){struct sockaddr_in *addr;struct ifreq ifr;char *name,*address;int sockfd;if(argc != 2)usage();elsename = argv[1];sockfd = socket(AF_INET,SOCK_DGRAM,0); strncpy(ifr.ifr_name,name,IFNAMSIZ-1);if(ioctl(sockfd,SIOCGIFADDR,&ifr) == -1)perror("ioctl error"),exit(1);addr = (struct sockaddr_in *)&(ifr.ifr_addr); address = inet_ntoa(addr->sin_addr);printf("inet addr: %s ",address);if(ioctl(sockfd,SIOCGIFBRDADDR,&ifr) == -1) perror("ioctl error"),exit(1);addr = (struct sockaddr_in *)&ifr.ifr_broadaddr; address = inet_ntoa(addr->sin_addr);printf("broad addr: %s ",address);if(ioctl(sockfd,SIOCGIFNETMASK,&ifr) == -1) perror("ioctl error"),exit(1);addr = (struct sockaddr_in *)&ifr.ifr_addr; address = inet_ntoa(addr->sin_addr);printf("inet mask: %s ",address);printf("\n");exit(0);}******************************** 程序2***************************************************** #include <stdio.h>#include <string.h>#include <errno.h>#include <fcntl.h>#include <getopt.h>#include <sys/socket.h>#include <sys/ioctl.h>#include <net/if.h>#include <stdlib.h>#include <unistd.h>typedef unsigned short u16;typedef unsigned int u32;typedef unsigned char u8;#include <linux/ethtool.h>#include <linux/sockios.h>int detect_mii(int skfd, char *ifname){struct ifreq ifr;u16 *data, mii_val;unsigned phy_id;/* Get the vitals from the interface. */strncpy(ifr.ifr_name, ifname, IFNAMSIZ);if (ioctl(skfd, SIOCG MI IPHY, &ifr) < 0){fprintf(stderr, "SIOCGMIIPHY on %s failed: %s\n", ifname,strerror(errno));(void) close(skfd);return 2;}data = (u16 *)(&ifr.ifr_data);phy_id = data[0];data[1] = 1;if (ioctl(skfd, SIOCGMIIREG, &ifr) < 0){fprintf(stderr, "SIOCGMIIREG on %s failed: %s\n", ifr.ifr_name,strerror(errno));return 2;}mii_val = data[3];return(((mii_val & 0x0016) == 0x0004) ? 0 : 1);}int detect_ethtool(int skfd, char *ifname){struct ifreq ifr;struct ethtool_value edata;memset(&ifr, 0, sizeof(ifr));edata.cmd = ETHTOOL_GLINK;strncpy(ifr.ifr_name, ifname, sizeof(ifr.ifr_name)-1);ifr.ifr_data = (char *) &edata;if (ioctl(skfd, SIOCETHTOOL, &ifr) == -1){printf("ETHTOOL_GLINK failed: %s\n", strerror(errno));return 2;}return (edata.data ? 0 : 1);}int main(int argc, char **argv){int skfd = -1;char *ifname;int retval;if( argv[1] )ifname = argv[1];elseifname = "eth0";/* Open a socket. */if (( skfd = socket( AF_INET, SOCK_DGRAM, 0 ) ) < 0 ) {printf("socket error\n");exit(-1);}retval = detect_ethtool(skfd, ifname);if (retval == 2)retval = detect_mii(skfd, ifname);close(skfd);if (retval == 2)printf("Could not determine status\n");if (retval == 1)printf("Link down\n");if (retval == 0)printf("Link up\n");return retval;}*******************************程序3***************************************************** #include <stdio.h>#include <stdlib.h>#include <string.h>#include <errno.h>#include <net/if.h>#include <linux/sockios.h>#include <sys/ioctl.h>#define LINKTEST_GLINK 0x0000000astruct linktest_value {unsigned int cmd;unsigned int data;};staticvoidusage(const char * pname){fprintf(stderr, "usage: %s <device>\n", pname);fprintf(stderr, "returns: \n");fprintf(stderr, "\t 0: link detected\n");fprintf(stderr, "\t%d: %s\n", ENODEV, strerror(ENODEV));fprintf(stderr, "\t%d: %s\n", ENONET, strerror(ENONET));fprintf(stderr, "\t%d: %s\n", EOPNOTSUPP, strerror(EOPNOTSUPP));exit(EXIT_FAILURE);}staticintlinktest(const char * devname){struct ifreq ifr;struct linktest_value edata;int fd;/* setup our control structures. */memset(&ifr, 0, sizeof(ifr));strcpy(ifr.ifr_name, devname);/* open control socket. */fd=socket(AF_INET, SOCK_DGRAM, 0);if(fd < 0 ) {return -ECOMM;}errno=0;edata.cmd = LINKTEST_GLINK;ifr.ifr_data = (caddr_t)&edata;if(!ioctl(fd, SIOCETHTOOL, &ifr)) {if(edata.data) {fprintf(stdout, "link detected on %s\n", devname);return 0;} else {errno=ENONET;}}perror("linktest");return errno;}intmain(int argc, char *argv[]){if(argc != 2) {usage(argv[0]);}return linktest(argv[1]);}*************************************程序4********************************************************* #include <sys/types.h>#include <sys/stat.h>#include <fcntl.h>#include <sys/ioctl.h>#include <sys/soundcard.h>#include <stdio.h>#include <unistd.h>#include <math.h>#include <string.h>#include <stdlib.h>#define BASE_VALUE 257int main(int argc,char *argv[]){int mixer_fd=0;char *names[SOUND_MIXER_NRDEVICES]=SOUND_DEVICE_LABELS;int value,i;printf("\nusage:%s dev_no.[0..24] value[0..100]\n\n",argv[0]);printf("eg. %s 0 100\n",argv[0]);printf(" will change the volume to MAX volume.\n\n");printf("The dev_no. are as below:\n");for (i=0;i<SOUND_MIXER_NRDEVICES;i++){if (i%3==0) printf("\n");printf("%s:%d\t\t",names[i],i);}printf("\n\n");if (argc<3)exit(1);if ((mixer_fd = open("/dev/mixer",O_RDWR))){printf("Mixer opened successfully,working...\n");value=BASE_VALUE*atoi(argv[2]);if (ioctl(mixer_fd,MIXER_WRITE(atoi(argv[1])),&value)==0)printf("successfully.....");else printf("unsuccessfully.....");printf("done.\n");}elseprintf("can't open /dev/mixer error....\n");exit(0);}。