1分钟部署网站📞AI智能客服,大模型训练自有数据,简单好用,有效降低客服成本 广告
wpa_supplicant_init_iface内容非常多,我们将通过逐步展示代码段的方法,分五部分介 绍。 **wpa_supplicant.c::wpa_supplicant_init_iface代码段一** ~~~ static int wpa_supplicant_init_iface(struct wpa_supplicant *wpa_s, struct wpa_interface *iface) { const char *ifname, *driver; struct wpa_driver_capa capa; if (iface->confname) { ......// CONFIG_BACKEND_FILE处理,此宏指明WPAS使用的配置项信息来源于文件 // Android定义了它 wpa_s->conf = wpa_config_read(wpa_s->confname); } ...... ~~~ 由上述代码可知,init_iface初始化的第一个工作是解析运行时配置文件。其中,wpa_s->confname的值为"/data/misc/wifi/wpa_supplicant.conf",解析函数是wpa_config_read。 1. wpa_supplicant_init_iface分析之一 这个函数本身没有特别之处,仅是把配置文件中的信息转换成对应的数据结构。 **config_file.c::wpa_config_read** ~~~ struct wpa_config * wpa_config_read(const char *name) { FILE *f; char buf[256], *pos; int errors = 0, line = 0; struct wpa_ssid *ssid, *tail = NULL, *head = NULL; struct wpa_config *config; // 配置文件在代码中对应的数据结构 int id = 0; config = wpa_config_alloc_empty(NULL, NULL); ...... f = fopen(name, "r"); ...... while (wpa_config_get_line(buf, sizeof(buf), f, &line, &pos)) { if (os_strcmp(pos, "network={") == 0) { // 读取配置文件中的network项,并将其转化成一个wpa_ssid类型的对象 ssid = wpa_config_read_network(f, &line, id++); ...... // 根据图4-10所示,wpa_ssid通过next成员变量构成了一个单向链表 if (head == NULL) { head = tail = ssid;} else { tail->next = ssid; tail = ssid;} // network项属于配置文件的一部分,故wpa_ssid对象也包含在wpa_config对象中 if (wpa_config_add_prio_network(config, ssid)) {......} ......// CONFIG_NO_CONFIG_BLOBS,blob是配置文件中的一个字段,用于存储有些身 // 份认证算法需要用的证书之类的信息。本例没有使用blob配置项 // 解析其他项 } else if (wpa_config_process_global(config, pos, line) < 0) {......} } fclose(f); config->ssid = head; ...... return config; } ~~~ wpa_config和wpa_ssid这两个数据结构都是配置文件中的信息在代码中的反映。读者可查看wpa_supplicant.conf配置模板文件来了解各个配置项的含义。 上述代码中,wpa_config_process_global的实现有一些特别,它通过宏的方式来定义解析项及对应的解析函数。由于解析函数最终结果就是设置wpa_config中对应项的值,故本章不讨论其细节,感兴趣的读者不妨自行阅读它们。 2. wpa_supplicant_init_iface分析之二 wpa_supplicant_init_iface函数代码段二如下所示。 **wpa_supplicant.c::wpa_supplicant_init_iface代码段二** ~~~ ......// 接wpa_supplicant_init_iface代码段一 if (os_strlen(iface->ifname) >= sizeof(wpa_s->ifname)) {......} // 将wpa_interface中的ifname复制到wpa_supplicant的ifname变量中 os_strlcpy(wpa_s->ifname, iface->ifname, sizeof(wpa_s->ifname)); ...... // 下面这两个函数和EAPOL状态机相关,我们将在4.4节介绍 eapol_sm_notify_portEnabled(wpa_s->eapol, FALSE); eapol_sm_notify_portValid(wpa_s->eapol, FALSE); driver = iface->driver; next_driver: if (wpa_supplicant_set_driver(wpa_s, driver) < 0) return -1; ~~~ wpa_supplicant_set_driver将根据driver wrapper名(本例是"nl80211")找到wpa_driver数组中nl80211指定的driver wrapper对象wpa_driver_nl80211_ops,然后调用其global_init函数。直接来看global_init函数的实现。 **提示** global_init函数将返回全局driver wrapper上下文信息,它保存在wpa_global的drv_priv数组中。 **(1)global_init函数分析** global_init是wpa_driver_ops结构体中的一个类型为函数指针的成员变量。nl80211对应的 driver wrapper将其设置为nl80211_global_init,代码如下所示。 **driver_nl80211.c::nl80211_global_init** ~~~ static void * nl80211_global_init(void) { struct nl80211_global *global; struct netlink_config *cfg; global = os_zalloc(sizeof(*global)); global->ioctl_sock = -1; dl_list_init(&global->interfaces); global->if_add_ifindex = -1; cfg = os_zalloc(sizeof(*cfg)); ...... cfg->ctx = global; /* 下面这三条语句用于创建netlink socket来接收来自内核的网卡状态变化事件(如UP、DORMANT、 REMOVED),然后通过eloop_register_read_sock注册一个netlink_recv函数用于处理接收 到的socket消息。 netlink_recv函数内部将根据消息的类别来调用newlink_cb和dellink_cb以处理网卡状态变 化事件。这两个回调函数处理比较简单,读者可在阅读完本章后再自行研究它们。 */ cfg->newlink_cb = wpa_driver_nl80211_event_rtm_newlink; cfg->dellink_cb = wpa_driver_nl80211_event_rtm_dellink; global->netlink = netlink_init(cfg); // 将加入netlink中AF_NETLINK协议中的RTMGRP_LINK组播组 ...... // nl80211利用netlink机制和wlan driver交互 if (wpa_driver_nl80211_init_nl_global(global) < 0) ......// 错误处理 global->ioctl_sock = socket(PF_INET, SOCK_DGRAM, 0); ...... return global; } ~~~ 上面代码涉及一个比较重要的数据结构,即代表nl80211 driver wrapper全局上下文信息的nl80211_global,其结构如图4-12所示。 :-: ![](https://box.kancloud.cn/a9e9e197b5aa9367f25db60cc5060b2b_961x351.jpg) 图4-12 nl80211_global结构体 需要注意的是nl80211_global包含两个nl_handle对象。nl_handle的真实类型就是libnl定义的nl_socket。其中,nl用于发送netlink消息,nl_event用于接收netlink消息。 这两个nl_handle对象的初始化由wpa_driver_nl80211_init_nl_global函数完成,马上来看它。 **(2)wpa_driver_nl80211_init_nl_global函数分析** wpa_driver_nl80211_init_nl_global是global_init的核心函数,其代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_init_nl_global** ~~~ static int wpa_driver_nl80211_init_nl_global(struct nl80211_global *global) { // 此函数利用了第3章中介绍的API int ret; // 创建一个netlink回调对象 global->nl_cb = nl_cb_alloc(NL_CB_DEFAULT); /* nl_create_handle返回值的类型为nl_handle*,而nl_handle在driver_nl802.11c中 就是nl_socket(代码中的定义:#define nl_handle nl_sock)。 nl_create_handle内部调用genl_connect连接到内核对应的模块。注意,该函数最后的字符串参数 (如此处的"nl")仅用于输出调试信息。 */ global->nl = nl_create_handle(global->nl_cb, "nl"); /* 向netenlink中的"nl"模块查询"nl80211"模块的编号。注意,genl_ctrl_resolve函数本 来由libnl2定义,但driver_nl80211.c通过 #define genl_ctrl_resolve android_genl_ctrl_resolve 宏将其指向android_genl_ctrl_resolve。该函数内部通过发送查询消息来获取"nl80211" 模块的family值。请读者自行阅读android_genl_ctrl_resolve函数。 */ global->nl80211_id = genl_ctrl_resolve(global->nl, "nl80211"); ...... // 创建另外一个nl_sock对象,其用途是接收netlink消息 global->nl_event = nl_create_handle (global->nl_cb, "event"); ...... /* 下面这几个函数的作用如下。 nl_get_multicast_id:先从nl80211模块中获得对应的组播组编号,如"scan"、"mlme"以及 "regulatory"组播组的编号。 nl_socket_add_membership:加入某个组播组。这样,当某个组播有消息发送时,nl_event就能收到了。 */ ret = nl_get_multicast_id(global, "nl80211", "scan"); ret = nl_socket_add_membership(global->nl_event, ret); ret = nl_get_multicast_id(global, "nl80211", "mlme"); ret = nl_socket_add_membership(global->nl_event, ret); ret = nl_get_multicast_id(global, "nl80211", "regulatory"); ret = nl_socket_add_membership(global->nl_event, ret); nl_cb_set(global->nl_cb, NL_CB_SEQ_CHECK, NL_CB_CUSTOM, no_seq_check, NULL);// 设置序列号检查函数为no_seq_check nl_cb_set(global->nl_cb, NL_CB_VALID, NL_CB_CUSTOM, process_global_event, global);// 设置netlink消息回调处理函数 /* 将nl_event对应的socket注册到eloop中,回调函数为wpa_driver_nl80211_event_receive, 该函数内部将调用nl_recv_msg,而nl_recv_msg又会调用process_global_event。所以,我们只 要关注process_global_event就可以了。 */ eloop_register_read_sock(nl_socket_get_fd(global->nl_event), wpa_driver_nl80211_event_receive, global->nl_cb, global->nl_event); return 0; ...... } ~~~ wpa_driver_nl80211_init_nl_global内容比较多,此处总结一下其工作内容。 * 创建了两个nl_handle对象,分别是global->nl和gobal->event。nl_handle内部定义一个socket句柄。所以,两个nl_handle等同于两个socket句柄。global->event用于接收netlink消息。nl80211定义了几个组播组,此处选择加入其中的"scan"、"mlme"和"regulatory"三个组播组,它们分别对应于扫描信息、mlme信息及管制信息。wlan driver内部会往这三个组播发送相关的消息。这样,global->event就能收到它们。 * 接着将global->event对应的socket注册到eloop读事件队列中。如此,内核发送的netlink消息就能被wpa_driver_nl80211_event_receive处理。wpa_driver_nl80211_event_receive内部将调用libnl API中的nl_recv_msg来接收消息,而它又会触发最重要的process_global_event函数被调用。 * global->nl用来向wlan driver发送netlink消息。根据第3章对genlmsg的介绍,其内部有一个变量用于指明family,而nl80211对应的family编号则保存在global->nl80211_id中。 提示 根据笔者的心得,读者大可不必对libnl等进行深入细致的源码分析。对WPAS的来说,仅了解libnl2 API的用法即可。 3. wpa_supplicant_init_iface分析之三 介绍完wpa_supplicant_set_driver后,现在回到wpa_supplicant_init_iface,继续看第三段代码。 **wpa_supplicant.c::wpa_supplicant_init_iface代码段三** ~~~ ......// 接wpa_supplicant_set_driver代码段 // 又是一个关键函数 wpa_s->drv_priv = wpa_drv_init(wpa_s, wpa_s->ifname); ...... // 设置driver参数,本例没有使用这一项功能 if (wpa_drv_set_param(wpa_s, wpa_s->conf->driver_param) &lt; 0) {...... } // 从driver中获取网卡名 ifname = wpa_drv_get_ifname(wpa_s); if (ifname && os_strcmp(ifname, wpa_s->ifname) != 0) { // 如果不一致则替换配置文件中设置的网卡设备名 os_strlcpy(wpa_s->ifname, ifname, sizeof(wpa_s->ifname)); } ~~~ 上一节初始化driver wrapper的全局上下文信息后(通过调用global_init来完成),接着要处理的就是单个driver wrapper了。该工作由wpa_drv_init函数完成。其内部将调用driver wrapper的init2函数(注意,如果driver wrapper定义了init2函数,init2将唯一被调用,否则将调用其定义的init函数)。 直接来看driver_nl80211实现的init2函数,其代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_init** ~~~ static void * wpa_driver_nl80211_init(void *ctx, const char *ifname, void *global_priv) { struct wpa_driver_nl80211_data *drv; struct rfkill_config *rcfg; struct i802_bss *bss; ...... drv = os_zalloc(sizeof(*drv)); ...... drv->global = global_priv; drv->ctx = ctx; // ctx的真正类型是wpa_supplicant bss = &drv->first_bss; bss->drv = drv; os_strlcpy(bss->ifname, ifname, sizeof(bss->ifname)); drv->monitor_ifidx = -1; drv->monitor_sock = -1; drv->eapol_tx_sock = -1; // ap_scan_as_station变量和hostapd有关 drv->ap_scan_as_station = NL80211_IFTYPE_UNSPECIFIED; // ①下面两个关键函数见后文解释 if (wpa_driver_nl80211_init_nl(drv)) {......} if (nl80211_init_bss(bss)) goto failed; /* 下面这个函数将读取/sys/class/net/wlan0/phy80211/name文件的内容,并将其保存到 wpa_driver_nl80211_data->phyname变量中。该文件存储了Wi-Fi物理设备的名称,如phy0等。 它由wifi wlan注册时动态生成,所以其值有可能变化。 注意,/sys/class/net/wlan0中的wlan0为无线网络设备名,它由wpa_supplicant -i参数指明。 */ nl80211_get_phy_name(drv); rcfg = os_zalloc(sizeof(*rcfg)); rcfg->ctx = drv; os_strlcpy(rcfg->ifname, ifname, sizeof(rcfg->ifname)); // 和rfkill相关,见下文解释 rcfg->blocked_cb = wpa_driver_nl80211_rfkill_blocked; rcfg->unblocked_cb = wpa_driver_nl80211_rfkill_unblocked; drv->rfkill = rfkill_init(rcfg); ...... // 关键函数② if (wpa_driver_nl80211_finish_drv_init(drv)) goto failed; // 见下文关于PF_PACKET的解释 drv->eapol_tx_sock = socket(PF_PACKET, SOCK_DGRAM, 0); if (drv->data_tx_status) { ......} if (drv->global) { // 把自己加到nl80211_global中的interfaces链表中去 dl_list_add(&drv->global->interfaces, &drv->list); drv->in_interface_list = 1; } return bss; // wpa_driver_nl80211_init返回的是一个i802_bss结构体对象 ...... } ~~~ 上述代码包含的知识点较多,涉及rfkill以及PF_PACKET背景知识,以及三个关键函数, wpa_driver_nl80211_init_nl、nl80211_init_bss和wpa_driver_nl80211_finish_drv_init。 **(1)rfkill背景知识** rfkill代表radio frequency(RF)connector kill switch support,它是Kernel中的一个子系统(subsystem)。其功能是控制系统中射频设备的电源(包括Wi-Fi、GPS、BlueTooth、FM等设备。注意,这些设备驱动只有把自己注册到rfkill子系统中后,rfkill才能对它们起作用)的工作以避免浪费电力。rfkill有软硬两种方式来禁止(block)RF设备。 * hard block:不能通过软件来重新启用RF设备。据观察,Android手机还没有hard block功能。不过笔者猜测某些笔记本有这个功能。例如,笔者的Dell笔记本上有一个特殊的开关,一旦把它关上,Wi-Fi模块就不能工作①。 * soft block:可以用软件来重新启用RF设备。 rfkill对用户空间提供了相应的控制接口,主要是通过/dev/rfkill设备文件来完成相关操作。我们通过wpa_driver_nl80211_init中调用的一个名为rfkill_init的函数来认识如何使用rfkill。该函数代码如下所示。 **rfkill.c::rfkill_init** ~~~ struct rfkill_data * rfkill_init(struct rfkill_config *cfg) { /* rfkill_data 是WPAS自定义的一个数据结构,主要用于设置两个回调函数用于处理block 和unblock的情况。 由上面一段代码可知,这两个回调函数分别是wpa_driver_nl80211_rfkill_blocked和 wpa_driver_nl80211_rfkill_unblocked。 */ struct rfkill_data *rfkill; struct rfkill_event event; // rfkill_event代表rfkill事件 ssize_t len; rfkill = os_zalloc(sizeof(*rfkill)); rfkill->cfg = cfg; // O_RDONLY标志表示driver_nl80211只读取rfkill事件,而不会去操作rfkill模块 rfkill->fd = open("/dev/rfkill", O_RDONLY); ...... // 设置I/O操作为非阻塞式 if (fcntl(rfkill->fd, F_SETFL, O_NONBLOCK) < 0) {......} for (;;) {// 读者知道为什么这里是一个for无限循环吗? // 读取/dev/rfkill中已有的事件信息。rfkill事件信息保存在rfkill_event结构体中 len = read(rfkill->fd, &event, sizeof(event)); if (len &lt; 0) { if (errno == EAGAIN) break; // 无数据可读,则跳出循环 break; // 其他错误也跳出循环 } ...... /* rfkill_event的op变量代表rfkill事件的类型,目前可取值有RFKILL_OP_ADD(代表一 个设备添加到了rfkill子系统)、RFKILL_OP_DEL等。 rfkill_event的type变量代表该rfkill事件所对应设备的类型。目前可取值有RFKILL_ TYPE_WLAN(无线网卡设备)、RFKILL_TYPE_BLUETOOTH(蓝牙设备)等。 */ if (event.op != RFKILL_OP_ADD || event.type != RFKILL_TYPE_WLAN) continue; if (event.hard) { // 表示是否为hard block rfkill->blocked = 1; } else if (event.soft) { // 表示是否为soft block rfkill->blocked = 1; } // 如果hard和soft均未被设置,则表示该设备属于unblock状态,即设备允许被使用 } // 为eloop注册一个读事件,一旦rfkill有新的事件到来,则eloop会触发rfkill_receive函数被调用 eloop_register_read_sock(rfkill->fd, rfkill_receive, rfkill, NULL); return rfkill; ......// 错误处理 } ~~~ 从上述代码可知,WPAS只是监控rfkill设备以获取发生在其上的rfkill_event,而它并不操作rfkill以关闭或启用无线设备。 **提示** 关于rfkill更多的信息请阅读参考资料[16][17]。 **(2)PF_PACKET背景知识** PF_PACKET有时也被称为AF_PACKET,是socket域(domain)中的一种,用于直接在OSI/RM的数据链路层(Data Link Layer)上收发数据。所以,通过AF_PACKET,用户空间可直接实现在物理层之上的协议,如EAP和EAPOL等。 **提醒** 由3.3.1节可知,DLL层还可细分为LLC子层和MAC子层。 下面将通过一些具体代码段来展示PF_PAKCET的使用。 **AF_PACKET用法示例** ~~~ /* socket函数的第二个参数叫socket_type。AP_PACKET中可以使用SOCK_DGRAM和SOCK_RAW,二者 略有区别,主要体现在如何处理物理层地址信息上。使用AP_PACKET时,需要为数据包设置物理层地址, 它由结构体struct sockaddr_ll来表达。当socket_type设置为: SOCK_RAM:用户接收到的数据包也将包含物理层地址,并且发送数据时,驱动将使用用户指定的物理层 地址来填充数据包。 SOCK_DGRAM:它比SOCK_RAW要高级一点。用户接收的数据包将不包括物理层地址信息,而用户发送时 指定的物理层地址也仅是一个参考,kernel会根据实际情况来填充一个更为合适的物理层地址。 另外,程序可以通过bind函数指定接收某个网卡设备上的数据包。 */ int fd = socket(PF_PACKET, SOCK_DGRAM,htons(ETH_P_EAPOL)); // 最后一个参数代表EAPOL协议类型 struct sockaddr_ll ll; // sockaddr_ll结构体代表地址信息 memset(&ll, 0, sizeof(ll)); ll.sll_family = PF_PACKET; // 该变量必须被设置成AF_PACKET ll.sll_ifindex = ifindex; // 网络设备的索引号 ll.sll_protocol = htons(ETH_P_EAPOL); bind(fd, (struct sockaddr *) &ll, sizeof(ll));// 绑定到指定的网络设备 ......// 其他处理 // 发送数据 struct sockaddr_ll ll2;// 目标地址 memset(&ll2, 0, sizeof(ll2)); ll.sll_family = AF_PACKET; ll.sll_ifindex = ifindex ll.sll_protocol = htons(ETH_P_EAPOL); // 帧类型,此处代表EAPOL帧 ll.sll_halen = ETH_ALEN; // 目标MAC地址长度 memcpy(ll.sll_addr, dst_addr, ETH_ALEN);// sll_addr用于表示目标物理层地址(即MAC地址) // 发送EAPOL帧 ret = sendto(fd, buf, len, 0, (struct sockaddr *) &ll2,sizeof(ll2)); ...... // 接收数据 struct sockaddr_ll ll3; socklen_t fromlen; memset(&ll3, 0, sizeof(ll3)); fromlen = sizeof(ll3); int res = recvfrom(fd, buf, sizeof(buf), 0, (struct sockaddr *) &ll3, &fromlen); ~~~ 关于PF_PACKET更为详细的信息,请读者通过man 7 packet查询Linux手册。接着来看wpa_driver_nl80211_init中的三个重要函数,首先是wpa_driver_nl80211_init_nl和nl80211_init_bss。 **(3)wpa_driver_nl80211_init_nl与nl80211_init_bss函数分析** 这两个函数都使用了libnl创建了回调对象,代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_init_nl** ~~~ /* socket函数的第二个参数叫socket_type。AP_PACKET中可以使用SOCK_DGRAM和SOCK_RAW,二者 略有区别,主要体现在如何处理物理层地址信息上。使用AP_PACKET时,需要为数据包设置物理层地址, 它由结构体struct sockaddr_ll来表达。当socket_type设置为: SOCK_RAM:用户接收到的数据包也将包含物理层地址,并且发送数据时,驱动将使用用户指定的物理层 地址来填充数据包。 SOCK_DGRAM:它比SOCK_RAW要高级一点。用户接收的数据包将不包括物理层地址信息,而用户发送时 指定的物理层地址也仅是一个参考,kernel会根据实际情况来填充一个更为合适的物理层地址。 另外,程序可以通过bind函数指定接收某个网卡设备上的数据包。 */ int fd = socket(PF_PACKET, SOCK_DGRAM,htons(ETH_P_EAPOL)); // 最后一个参数代表EAPOL协议类型 struct sockaddr_ll ll; // sockaddr_ll结构体代表地址信息 memset(&ll, 0, sizeof(ll)); ll.sll_family = PF_PACKET; // 该变量必须被设置成AF_PACKET ll.sll_ifindex = ifindex; // 网络设备的索引号 ll.sll_protocol = htons(ETH_P_EAPOL); bind(fd, (struct sockaddr *) &ll, sizeof(ll));// 绑定到指定的网络设备 ......// 其他处理 // 发送数据 struct sockaddr_ll ll2;// 目标地址 memset(&ll2, 0, sizeof(ll2)); ll.sll_family = AF_PACKET; ll.sll_ifindex = ifindex ll.sll_protocol = htons(ETH_P_EAPOL); // 帧类型,此处代表EAPOL帧 ll.sll_halen = ETH_ALEN; // 目标MAC地址长度 memcpy(ll.sll_addr, dst_addr, ETH_ALEN);// sll_addr用于表示目标物理层地址(即MAC地址) // 发送EAPOL帧 ret = sendto(fd, buf, len, 0, (struct sockaddr *) &ll2,sizeof(ll2)); ...... // 接收数据 struct sockaddr_ll ll3; socklen_t fromlen; memset(&ll3, 0, sizeof(ll3)); fromlen = sizeof(ll3); int res = recvfrom(fd, buf, sizeof(buf), 0, (struct sockaddr *) &ll3, &fromlen);static int wpa_driver_nl80211_init_nl(struct wpa_driver_nl80211_data *drv) { drv->nl_cb = nl_cb_alloc(NL_CB_DEFAULT); ...... nl_cb_set(drv->nl_cb, NL_CB_SEQ_CHECK, NL_CB_CUSTOM,no_seq_check, NULL); nl_cb_set(drv->nl_cb, NL_CB_VALID, NL_CB_CUSTOM, process_drv_event, drv); return 0; } static int nl80211_init_bss(struct i802_bss *bss) { bss->nl_cb = nl_cb_alloc(NL_CB_DEFAULT); ...... nl_cb_set(bss->nl_cb, NL_CB_SEQ_CHECK, NL_CB_CUSTOM,no_seq_check, NULL); nl_cb_set(bss->nl_cb, NL_CB_VALID, NL_CB_CUSTOM, process_bss_event, bss); return 0; } ~~~ 不过,它们仅创建了nl_cb对象,却并未创建nl_handle(即没有创建nl socket)。没有和socket绑定,这些回调对象就不可能真正被用上。它们什么时候用呢?此处先提前介绍一下使用它们的代码。 **driver_nl80211.c::nl80211_alloc_mgmt_handle** ~~~ static int nl80211_alloc_mgmt_handle(struct i802_bss *bss) { struct wpa_driver_nl80211_data *drv = bss->drv; if (bss->nl_mgmt) {....../*重复注册*/return -1; } bss->nl_mgmt = nl_create_handle(drv->nl_cb, "mgmt"); // 注意该函数的第一个参数 eloop_register_read_sock(nl_socket_get_fd(bss->nl_mgmt), wpa_driver_nl80211_event_receive, bss->nl_cb, bss->nl_mgmt); return 0; } static void wpa_driver_nl80211_event_receive(int sock, void *eloop_ctx, void *handle) { struct nl_cb *cb = eloop_ctx; nl_recvmsgs(handle, cb); // cb是bss->nl_cb } ~~~ 注意,上述代码有一个非常奇怪的地方。bss->nl_mgmt创建时使用了drv->nl_cb对象,该回调对象由wpa_driver_nl80211_init_nl创建,其对应的回调函数是process_drv_event。nl_create_handle返回的实际上是一个nl_socket对象,其内部有一个s_cb变量指向nl_create_handle的第一个参数(本例中即是drv->nl_cb)。注册到eloop模块中的 wpa_driver_nl80211_event_receive函数,在处理回调的时候却使用了bss->nl_cb,该回调对象对应的是process_bss_event函数。 也就是说,上述函数一共使用了两个回调对象,一个是drv->nl_cb,另外一个是bss->nl_cb。什么时候调用drv->nl_cb,什么时候调用bss->nl_cb呢? 根据笔者对比Android中libnl2和libnl2官方代码的结果,nl_recvmsgs将使用指定的nl_cb对象进行回调(即它的第二个参数,本例中的bss->nl_cb),而nl_recvmsgs_default将使用nl_socket中s_cb指定的回调对象(即本例中的drv->nl_cb)。不过,Android的libnl2并没有nl_recvmsgs_default函数。所以,drv->nl_cb实际上永远不会被用到。 **注意** 综合4.3.4节对wpa_driver_nl80211_init_nl_global的分析,WPAS中实际上真正使用到的回调对象就是两个:一个是bss->nl_cb,对应的回调函数是process_bss_event,另一个是global->nl_cb,对应的回调函数是process_global_event。 另外,作为练习,请通过以下命令查看上一节提到的与drv->nl_cb和bss->nl_cb使用有关的信息。 **git blame src/drivers/driver_nl80211.c|grep process_drv_event** **git show d6c9aab8** **(4)wpa_driver_nl80211_finish_drv_init函数分析** wpa_driver_nl80211_init中的最后一个关键函数代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_finish_drv_init** ~~~ static int wpa_driver_nl80211_finish_drv_init(struct wpa_driver_nl80211_data *drv) { struct i802_bss *bss = &drv->first_bss; int send_rfkill_event = 0; drv->ifindex = if_nametoindex(bss->ifname);// 获取网卡设备的索引,属于netdevice编程范畴 drv->first_bss.ifindex = drv->ifindex; #ifndef HOSTAPD // hostapd是另外一个程序,本书不讨论 if (drv->ifindex != drv->global->if_add_ifindex && /* ①设置接口类型为NL80211_IFTYPE_STATION,见下文解释。注意,这个函数内容非常丰富, 其中包含很多和P2P相关的信息。本章暂时不考虑它。另外,此函数内部会调用到上一节提到的 nl80211_alloc_mgmt_handle。 */ wpa_driver_nl80211_set_mode(bss, NL80211_IFTYPE_STATION) < 0) {......} /* linux_set_iface_flags通过ioctl方式启动ifname对应的网卡设备。 该函数使用了netdevice API,请读者回顾表2-2。 其使用的参数为SIOCSIFFLAGS和IFF_UP。 */ if (linux_set_iface_flags(drv->global->ioctl_sock, bss->ifname, 1)) { // 注意,如果linux_set_iface_flags返回非0值(即启动设备失败) // 要判断是不是rfkill禁止了该设备 if (rfkill_is_blocked(drv->rfkill)) { ......// 如果是因为rfkill原因导致设备被禁止,则需要通知wpa_supplicant drv->if_disabled = 1;// 设置if_disabled为1,表示该设备被rfkill禁止了 send_rfkill_event = 1; // 该值表示需要设置WPAS的状态 } else {......} } // ②设置Wi-Fi设备工作状态为,IF_OPER_DORMANT,见下文解释 netlink_send_oper_ifla(drv->global->netlink, drv->ifindex,1, IF_OPER_DORMANT); #endif /* HOSTAPD */ // ③获取Wi-Fi设备的capability,见下文解释 if (wpa_driver_nl80211_capa(drv)) return -1; // 通过ioctl方式获取指定网卡的MAC地址,也属于netdeivce编程范畴,回顾表2-2 if (linux_get_ifhwaddr(drv->global->ioctl_sock, bss->ifname,bss->addr)) return -1; if (send_rfkill_event) { /* 添加一个超时任务,超时时间为0秒。超时处理函数为wpa_driver_nl80211_send_rfkill,该 函数内部将设置wpa_states为WPA_INTERFACE_DISABLED。 可参考4.3.3节了解WPA_INTER FACE_DISABLED状态。 */ eloop_register_timeout(0, 0, wpa_driver_nl80211_send_rfkill,drv, drv->ctx); } return 0; } ~~~ wpa_driver_nl80211_finish_drv_init代码不长,但内容却比较丰富,先简单总结一下其工作流程。 * 1)调用wpa_driver_nl80211_set_mode函数设置Wi-Fi设备类型为NL80211_IFTYPE_STATION。下文将详细介绍Wi-Fi设备类型的知识。 * 2)调用linux_set_iface_flags通过netdevice API启用该Wi-Fi设备。如果失败,则需要判断该设备是否被rfkill block。 * 3)调用netlink_send_oper_ifla函数设置网卡的工作状态(Interface Operational Status,IfOperStatus)为IF_OPER_DORMANT。关于IfOperStatus详情见下文解释。 * 4)调用wpa_driver_nl80211_capa获取Wi-Fi设备的处理能力(capability)。详情见下文解释。 * 5)最后,调用linux_get_ifhwaddr获取Wi-Fi设备的MAC地址,并判断是否需要设置超时函数wpa_driver_nl80211_send_rfkill。 上述内容中有两个背景知识(设备类型以及工作状态)和一个重要函数wpa_driver_nl80211_capa。此处先来认识设备类型。 一般而言,一块网络接口设备只有一个MAC地址,但现在许多设备都支持多个所谓的虚拟设备(Virtual Interface),每一个虚拟设备都对应有一个虚拟MAC地址。例如,图4-13所示为Wi-Fi P2P中一种名为并发设备(Concurrent Device)的示意图。 :-: ![](https://box.kancloud.cn/0ab49850ea9f9819ae29a2abf05cb8dc_1088x615.jpg) 图4-13 P2P Concurrent设备 图4-13中,位于中间的Wi-Fi设备一方面以P2P Device的身份和左下角的另一个P2P Device相连,另一方面又以STA的身份和右边的AP相连。P2P Device和STA的工作方式不尽相同,怎么实现这种并发设备呢?解决方法就是通过这种虚拟设备的方式,使P2P Device和STA分别使用不同的Virtual Interface和Virtual MAC。 **提示** 目前,市面上许多Android手机打开Wi-Fi P2P功能后就必须关闭STA功能,而笔者的Note 2就能做到P2P和STA同时工作。 NL80211定义了多种Virtual Interface类型,如下所示。 ~~~ enum nl80211_iftype { NL80211_IFTYPE_UNSPECIFIED, NL80211_IFTYPE_ADHOC, // IBSS类型 NL80211_IFTYPE_STATION, // 基础结构型网络中的STA NL80211_IFTYPE_AP, // 基础结构型网络中的AP NL80211_IFTYPE_AP_VLAN, // 和VLAN有关,本书不讨论 NL80211_IFTYPE_WDS, // 无线桥接。本书不讨论 NL80211_IFTYPE_MONITOR, // 可接收无线网络所有的数据包,它提供类似AirPcap这样的功能 NL80211_IFTYPE_MESH_POINT, // Mesh网络节点,本书不讨论 NL80211_IFTYPE_P2P_CLIENT, // P2P相关,见后续章节 NL80211_IFTYPE_P2P_GO, // P2P相关,见后续章节 NUM_NL80211_IFTYPES, NL80211_IFTYPE_MAX = NUM_NL80211_IFTYPES - 1 }; ~~~ 下面来看接口设备的工作状态IfOperStatus,其定义来自RFC2863。 **if.h** ~~~ enum { IF_OPER_UNKNOWN, // 未知状态 // 下面这个状态表示因为系统缺乏该接口设备所依赖的模块(一般是硬件模块)而导致接口设备不能工作 IF_OPER_NOTPRESENT, // IF_OPER_DOWN, // 接口不能工作 /* 相比DOWN状态,LOWERLAEYDOWN指出了接口设备不能工作的原因是其所依赖的更低一层的设备不 能正常工作。 */ IF_OPER_LOWERLAYERDOWN, IF_OPER_TESTING, // 接口处于测试状态中 /* 接口处于休眠或暂停(pending)状态中。这种状态表示接口设备在等待某个事情的发生(例如上层 有数据要发送,则会将DORMANT状态设置为UP状态)。 */ IF_OPER_DORMANT, IF_OPER_UP, // 接口可工作 }; ~~~ 关于IfOperStatus,请读者阅读参考资料[18]。 最后,看关键函数wpa_driver_nl80211_capa,其功能是用于获取无线网络设备的capability。代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_capa** ~~~ static int wpa_driver_nl80211_capa(struct wpa_driver_nl80211_data *drv) { struct wiphy_info_data info; // 发送netlink命令NL80211_CMD_GET_WIPHY来获取Wi-Fi设备的信息。下文将单独用一节来介绍此函数 if (wpa_driver_nl80211_get_info(drv, &info)) return -1; drv->has_capability = 1; /* drv->capa变量的类型是struct wpa_driver_capa,用于表示设备的capability,这些capa如下。 key_mgmt:该设备支持的密钥管理类型。默认支持WPA、WPA-PSK、WPA2和WPA2-PSK。 enc:支持的加密算法类型。默认支持WEP40、WEP104、TKIP和CCMP。 auth:支持的身份验证类型:默认支持Open System、Shared和LEAP。 */ drv->capa.key_mgmt = WPA_DRIVER_CAPA_KEY_MGMT_WPA | WPA_DRIVER_CAPA_KEY_MGMT_WPA_PSK | WPA_DRIVER_CAPA_KEY_MGMT_WPA2 | WPA_DRIVER_CAPA_KEY_MGMT_WPA2_PSK; drv->capa.enc = WPA_DRIVER_CAPA_ENC_WEP40 | WPA_DRIVER_CAPA_ENC_WEP104 | WPA_DRIVER_CAPA_ENC_TKIP | WPA_DRIVER_CAPA_ENC_CCMP; drv->capa.auth = WPA_DRIVER_AUTH_OPEN | WPA_DRIVER_AUTH_SHARED | WPA_DRIVER_AUTH_LEAP; /* WPA_DRIVER_FLAGS_SANE_ERROR_CODES选项主要针对associate操作。当关联操作失败后, 如果driver支持该选项,则表明driver能处理失败之后的各种收尾工作(key、timeout等工作)。 否则,WPAS需要自己处理这些事情。 */ drv->capa.flags |= WPA_DRIVER_FLAGS_SANE_ERROR_CODES; /* WPA_DRIVER_FLAGS_SET_KEYS_AFTER_ASSOC_DONE标志标明association成功后,Kernel driver需要设置WEP key。这个标志出现的原因是由于Kernel API发生了变动,使得只能在关联 成功后才能设置key。 */ drv->capa.flags |= WPA_DRIVER_FLAGS_SET_KEYS_AFTER_ASSOC_DONE; /* 下面这两个标志表示Kernel中的driver是否能反馈EAPOL数据帧发送情况以及Deauthentication/ Disassociation帧发送情况(TX Report)。 */ drv->capa.flags |= WPA_DRIVER_FLAGS_EAPOL_TX_STATUS; drv->capa.flags |= WPA_DRIVER_FLAGS_DEAUTH_TX_STATUS; /* 以下几个选项都和设备做AP使用有关,也就是和hostapd相关。此处简单介绍一下它们。 device_ap_sme表示AP集成了SME。读者还记得SME吗?3.3.6节曾介绍过。 */ drv->device_ap_sme = info.device_ap_sme; /* poll_command_supported:hostapd需要判断STA是否还活跃,即心跳检测。检测方法是发送 null数据帧(即不带任何数据的无线MAC数据帧),如果STA还活跃的话,一定会回复ACK给AP(读 者还记得CSMA/CA机制吗?)。发送null数据帧的工作可以由Kernel driver完成,也可以由 hostapd来完成。如果Kernel driver支持poll_command_supported,hostapd只要发送 netlink命令NL80211_CMD_PROBE_CLIENT给Kernel驱动,所有工作就由Kernel驱动完成。 否则,hostapd需要自己构造一个null数据帧,然后再发送出去。 */ drv->poll_command_supported = info.poll_command_supported; /* 和WPA_DRIVER_FLAGS_EAPOL_TX_STATUS有关。如果wlan驱动支持的话,EAPOL帧TX Report将通知给用户空间的driver wrapper,即此处的driver_nl80211。 */ drv->data_tx_status = info.data_tx_status; /* use_monitor也和AP心跳检测STA有关。如果Kernel driver不支持poll_command_ supported的话,hostapd可通过创建一个NL80211_IFTYPE_MONITOR类型的接口设备用于监控 STA的活跃情况。 */ drv->use_monitor = !info.poll_command_supported; if (drv->device_ap_sme && drv->use_monitor) { // monitor_supported表示kernel driver是否支持创建NL80211_IFTYPE_MONITOR类 // 型的接口设备 if (!info.monitor_supported) drv->use_monitor = 0; } /* 经过测试,Galaxy Note 2机器中上述变量取值情况如下。 device_ap_sme为1,poll_command_supported为0,data_tx_status为0,use_monitor为1, capa.flags取值情况见下文。 */ if (!drv->use_monitor && !info.data_tx_status) drv->capa.flags &= ~WPA_DRIVER_FLAGS_EAPOL_TX_STATUS; return 0; } ~~~ Galaxy Note 2手机中得到的flags为0x2c0c0,它是如下几个选项的组合。 ~~~ #define WPA_DRIVER_FLAGS_AP 0x00000040 #define WPA_DRIVER_FLAGS_SET_KEYS_AFTER_ASSOC_DONE 0x00000080 #define WPA_DRIVER_FLAGS_SANE_ERROR_CODES 0x00004000 #define WPA_DRIVER_FLAGS_OFFCHANNEL_TX 0x00008000 #define WPA_DRIVER_FLAGS_DEAUTH_TX_STATUS 0x00020000 ~~~ 上述wpa_driver_nl80211_capa函数中,先调用wpa_driver_nl80211_get_info函数,从wlandriver获取设备信息,然后wpa_driver_nl80211_capa再做一些处理。 此处向读者展示一下wpa_driver_nl80211_get_info的内容,请读者关注其中和nl80211用法有关的部分。 **提醒** WPAS中类似wpa_driver_nl80211_get_info的函数还有很多,仅以wpa_driver_nl80211_get_info为代表进行介绍。 (5)wpa_driver_nl80211_get_info函数分析 wpa_driver_nl80211_get_info代码如下所示。 **driver_nl80211.c::wpa_driver_nl80211_get_info** ~~~ static int wpa_driver_nl80211_get_info(struct wpa_driver_nl80211_data *drv,struct wiphy_info_data *info) { struct nl_msg *msg; os_memset(info, 0, sizeof(*info)); info->capa = &drv->capa; msg = nlmsg_alloc(); ...... // 构造一个NL80211_CMD_GET_WIPHY命令以获取设备信息 nl80211_cmd(drv, msg, 0, NL80211_CMD_GET_WIPHY); // NL80211_CMD_GET_WIPHY命令需要携带ifindex参数以指明要查询哪个设备 NLA_PUT_U32(msg, NL80211_ATTR_IFINDEX, drv->first_bss.ifindex); // 发送命令并等待回复,回复消息将由wiphy_info_handler函数处理 if (send_and_recv_msgs(drv, msg, wiphy_info_handler, info) == 0) return 0; ...... } ~~~ 在driver_nl80211.c中,wpa_driver_nl80211_get_info函数非常具有典型性。当driverwrapper和wlan driver通信时,需要构造一个nl_msg消息,然后往其中填写对应的参数。发送该消息时,如果需要等待driver的回复,还可以设置一个回复消息处理函数用于解析接收到的回复消息。 上述代码中,wiphy_info_handler就是这个回调函数。其内容非常长。不过,绝大部分代码都是在解析netlink消息。因此,我们仅看其中与接口类型解析相关的代码片段即可窥斑见豹。 **driver_nl80211.c::wiphy_info_handler** ~~~ static int wiphy_info_handler(struct nl_msg *msg, void *arg) { struct nlattr *tb[NL80211_ATTR_MAX + 1]; struct genlmsghdr *gnlh = nlmsg_data(nlmsg_hdr(msg)); struct wiphy_info_data *info = arg; ...... struct wpa_driver_capa *capa = info->capa; static struct nla_policy ......// 其他信息解析 if (tb[NL80211_ATTR_SUPPORTED_IFTYPES]) { struct nlattr *nl_mode; int i; nla_for_each_nested(nl_mode, // 遍历netlink attribute信息 tb[NL80211_ATTR_SUPPORTED_IFTYPES], i) { switch (nla_type(nl_mode)) { case NL80211_IFTYPE_AP:// wlan driver支持设置接口类型为AP capa->flags |= WPA_DRIVER_FLAGS_AP; // Galaxy Note 2支持此项 break; ...... case NL80211_IFTYPE_MONITOR: info->monitor_supported = 1; break; } } } ......// 其他信息解析 return NL_SKIP; } ~~~ 关于driver_nl80211.c中nl80211使用最典型的wpa_driver_nl80211_get_info即介绍到此,读者可阅读nl80211头文件来了解NL80211_CMD_GET_WIPHY和NL80211_ATTR_SUPPORTED_IFTYPES相关的信息,其注释非常详尽。另外,读者可阅读参考 资料[19]以了解更多和nl80211命令相关的知识。 通过上面内容可知,wpa_supplicant_init_iface代码段三中最主要的函数是wpa_drv_init,下面总结它的相关知识。 **(6)wpa_drv_init相关知识总结** 本节对wpa_drv_init函数进行了详细分析,其中涉及的两个重要数据结构如图4-14所示。 :-: ![](https://box.kancloud.cn/b7093c925e1b25bd6ccbd0ae87fb11b1_1342x465.jpg) 图4-14 wpa_driver_nl80211_data和i802_bss结构体 图4-14中: * wpa_driver_nl80211_data通过first_bss成员包含一个i802_bss结构体对象,而i802_bss内部通过next指针构成一个单向链表。 * wpa_driver_nl80211_init最后返回的是一个i802_bss对象,它就是driver wrapper上下文信息。i802_bss通过drv变量指向一个wpa_driver_nl80211_data对象。 **提醒** 根据前文的分析,global_init函数返回的是全局driver wrapper上下文信息。对于nl80211 driver wrapper来说,这个全局上下文信息就是一个nl80211_global对象。 图4-15所示为wpa_drv_init中一些重要函数的调用流程。 :-: ![](https://box.kancloud.cn/f20f788d045370e392827e0ad3751d69_937x664.jpg) 图4-15 wpa_drv_init流程 图4-15所示函数较多,内容也比较丰富,请读者注意其中涉及的背景知识。 4. wpa_supplicant_init_iface分析之四 继续来看wpa_supplicant_init_iface函数,这次要分析的代码片段如下所示。 **wpa_supplicant.c::wpa_supplicant_init_iface代码段四** ~~~ ......// 接wpa_drv_init // ①初始化wpa上下文信息。见下文解释 if (wpa_supplicant_init_wpa(wpa_s) < 0) return -1; // 设置wpa_s->wpa指向一个wpa_sm对象,下面这两个函数用于设置wpa_sm中的一些成员变量 wpa_sm_set_ifname(wpa_s->wpa, wpa_s->ifname, wpa_s->bridge_ifname[0] ? wpa_s->bridge_ifname : NULL); wpa_sm_set_fast_reauth(wpa_s->wpa, wpa_s->conf->fast_reauth); /* 如果运行时配置文件(即wpa_supplicant.conf)设置了dot11RSNAConfigPMKLifetime、 dot11RSNAConfigPMKReauthThreshold和dot11RSNAConfigSATimeout,则使用配置文件中的值 来替换wpa_sm中的默认值。下文将详细介绍这个三个变量的含义。 */ if (wpa_s->conf->dot11RSNAConfigPMKLifetime && wpa_sm_set_param(wpa_s->wpa, RSNA_PMK_LIFETIME, wpa_s->conf->dot11RSNAConfigPMKLifetime)) {......} ......// 处理dot11RSNAConfigPMKReauthThreshold和dot11RSNAConfigSATimeout // ②获取Wi-Fi设备的hardware特性 wpa_s->hw.modes = wpa_drv_get_hw_feature_data(wpa_s,&wpa_s->hw.num_modes, &wpa_s->hw.flags); // wpa_drv_get_capa函数已经见识过了,但这里出现了上一节没有介绍的新成员 if (wpa_drv_get_capa(wpa_s, &capa) == 0) { // ③capability信息,见下文解释 wpa_s->drv_capa_known = 1; // 笔者的Note 2中,capa.flags的值为0x2c0c0 wpa_s->drv_flags = capa.flags; wpa_s->probe_resp_offloads = capa.probe_resp_offloads; wpa_s->max_scan_ssids = capa.max_scan_ssids; wpa_s->max_sched_scan_ssids = capa.max_sched_scan_ssids; wpa_s->sched_scan_supported = capa.sched_scan_supported; wpa_s->max_match_sets = capa.max_match_sets; wpa_s->max_remain_on_chan = capa.max_remain_on_chan; wpa_s->max_stations = capa.max_stations; } if (wpa_s->max_remain_on_chan == 0) wpa_s->max_remain_on_chan = 1000; ~~~ 上述代码片段共有三个关键点,分别如下。 * wpa_supplicant_init_wpa函数用于初始化wpa_sm相关的资源。 * wpa_drv_get_hw_feature_data函数用于获取hw特性。其中一些变量涉及较深的背景知识。 * wpa_drv_get_capa是获取driver的capability。这个函数在上一节已经介绍过了,但本节出现了一些新的capability信息。 **(1)wpa_supplicant_init_wpa函数分析** wpa_supplicant_init_wpa函数代码并不复杂,主要完成以下两件事情。 * 创建一个wpa_sm_ctx对象并填充其中的函数指针成员。 * 初始化wpa_sm状态机。 代码如下所示。 **wpas_glue.c::wpa_supplicant_init_wpa** ~~~ int wpa_supplicant_init_wpa(struct wpa_supplicant *wpa_s) { #ifndef CONFIG_NO_WPA struct wpa_sm_ctx *ctx; ctx = os_zalloc(sizeof(*ctx)); ...... ctx->ctx = wpa_s; ctx->msg_ctx = wpa_s; ctx->set_state = _wpa_supplicant_set_state; ......// 其他成员变量设置 wpa_s->wpa = wpa_sm_init(ctx); #endif /* CONFIG_NO_WPA */ return 0; } ~~~ wpa_sm_init的代码如下所示。 **wpa.c::wpa_sm_init** ~~~ struct wpa_sm * wpa_sm_init(struct wpa_sm_ctx *ctx) { struct wpa_sm *sm; sm = os_zalloc(sizeof(*sm)); dl_list_init(&sm->pmksa_candidates); sm->renew_snonce = 1; sm->ctx = ctx; // 下面这三个MIB相关成员变量的解释见下文 sm->dot11RSNAConfigPMKLifetime = 43200; sm->dot11RSNAConfigPMKReauthThreshold = 70; sm->dot11RSNAConfigSATimeout = 60; // 创建PMKSA缓存,用于存储PMKSA sm->pmksa = pmksa_cache_init(wpa_sm_pmksa_free_cb, sm, sm); ...... return sm; } ~~~ 上述两段代码中涉及的函数指针暂且先略过,先介绍其中的几个重要数据结构,它们如图4-16所示。 :-: ![](https://box.kancloud.cn/6af12989b18df44ec1727e667748bf43_1300x681.jpg) 图4-16 wpa_sm_ctx和wpa_sm等结构体 图4-16显示了四个重要数据结构的内容。 * struct wpa_sm_ctx定义一些函数指针。这些函数的作用留待后续用到时再介绍。 * struct wpa_sm结构体名为状态机(SM代表State Machine),但和WPAS中其他状态机比起来,它更像是一个存储状态的上下文信息。该结构体内部通过eapol变量指向一个struct eapol_sm对象。4.4节将详细分析eapol_sm。 * struct rsn_pmksa_cache、struct rsn_pmksa_cache_entry与PMKSA缓存有关。每一个rsn_pmksa_cache_entry代表一个PMKSA条目。注意,rsn_pmksa_cache_entry中有一个名为aa的数组,其存储的是Authenticator的Address。一般情况下它和AP的bssid相同。 PMKSA还和几个MIB选项有关,它们被定义成wpa_sm中的同名成员变量(数据类型都是unsigned in),分别如下。 * **dot11RSNAConfigPMKLifetime**:表示每一个PMKSA条目的有效时间(单位为秒),默认是43200秒。过了有效时间后,需要重新计算PMKSA。 * **dot11RSNAConfigPMKReauthThreshold**:用于指明PMKSA条目有效时间过去百分之多少后,需要重新进行身份认证。默认是70%。 * **dot11RSNAConfigSATimeout**:指明supplicant和Authenticator双方进行身份验证的最长时间。默认是60秒。在此时间内没有完成身份验证,则认为验证失败。 * **dot11RSNA4WayHandshakeFailures**:用于保存4-Way Handshake失败的次数。 下面来看代码中的第二个关键函数wpa_drv_get_hw_feature_data及相关的背景知识。 **(2)wpa_drv_get_hw_feature_data函数分析** 该函数内部将通过wpa_driver_ops结构体中的get_hw_feature_data指针调用driver_nl80211实现的wpa_driver_nl80211_get_hw_feature_data函数以获取wifi hw特性。此处不讨论其函数实现,而是看看hw特性都有哪些内容。hw特性由数据结构hostapd_hw_modes来表达,如图4-17所示。 :-: ![](https://box.kancloud.cn/d5025e61400e3fe66b47b24574f506b0_1275x565.jpg) 图4-17 hostapd_hw_modes数据结构 wpa_drv_get_hw_feature_data返回的是一个hostapd_hw_modes数组,其内容已经在图4-17中标记出来。这里展示一个实例,图4-18所示为修改WPAS后打印的Note 2 hw特性的一部分。 :-: ![](https://box.kancloud.cn/fb8c24b6245b2e7f182b490dd107558f_1093x633.jpg) 图4-18 Note 2 dump信息 图4-18所示为hostapd_hw_modes数组中第三个元素的信息,它展示了硬件中和802.11b相关的特性。共13个信道,以及每个信道的中心频率以及最大功率,支持四种传输速率。 现在来看最后一个关键点。 (3)capability信息及含义 wpa_supplicant_init_wpa代码片段最后还显示了一些capability信息,它们的含义如下。 * **probe_resp_offloads**:当设备做AP使用时(即运行hostapd),它需要发送Probe Response帧以回复其他STA的Probe Request帧。Probe Response帧(或者AP发送的Beacon帧)的内容需要hostapd来填充。这个变量用于指明哪些vendor specific的内容将由Wi-Fi驱动或者硬件去填充。目前NL80211.h通过枚举类型nl80211_probe_resp_offload_support_attr来定义所能支持的协议,包括WPSv1、WPSv2、P2P和802.11u。 * **max_scan_ssids**:一个Probe Request要么指定wildcard ssid以扫描周围所有的无线网络,要么指定某个ssid以扫描特定无线网络。为了方便wpa_supplicant的使用,driver新增了一个功能,使得上层可通过一次scan请求来扫描多个不同ssid的无线网络。注意,此功能只是方便了WPAS内部的使用。由于规范定义的Probe Request帧只能携带一个ssid参数。所以,上层即使想一次scan多个ssid,硬件实际上还是要为每一个ssid发送一个Probe Request帧。 * **max_sched_scan_ssids和sched_scan_supported**:与计划扫描有关。max_sched_scan_ssids和max_scan_ssids作用类似,是方便wpa_supplicant同时扫描多个ssid而设置的。 * **max_match_sets**:使用计划扫描时,可以给驱动指定一个ssid过滤列表。只有扫描结果符合ssid过滤列表的那些无线网络才会通知wpa_supplicant以开展后续处理。由于该过滤功能可由Wi-Fi硬件来完成,所以它可以节省一部分电力(即无须软件去执行过滤功能)。 * **max_remain_on_chan**:该变量和off-channel transmition功能有关。该功能使得Wi-Fi硬件能在某个特定信道(channel)上保持awake状态一定时间用于传输某些MAC帧(例如管理帧中的一种名为Action的帧)。该功能叫off-channel的原因是,STA实际上在另一个信道(此channel叫on-channel)上和AP保持连接。举一个简单的例子,假设STA和所关联的AP工作在2.4GHz第6频段。在某些时候,STA会转移到2.4GHz其他频段以接收或处理其他STA(P2P的情况)或AP发送的MAC帧。上述例子中,6频段就是on-channel,而其他频段则是off-channel。max_remain_on_chan变量用于指明STA在off-channel中工作的最长时间,以毫秒为单位。为什么要限制off-channel时间呢?还是以上述例子为例,STA和AP工作在第6频段,二者数据传输也是在第6频段。当STA转移到其他频段时,它将无法接收第6频段所发送的数据。如max_remain_on_chan时间过长,用户将发现数据传输率大幅降低②。 * **max_stations**:当手机做AP使用时(即无线网络接口设备的类型为NL80211_IFTYPE_AP),该变量表示最多支持多少个STA与之关联。 下面接着分析wpa_supplicant_init_iface如下所示最后一部分代码。 5. wpa_supplicant_init_iface分析之五 wpa_supplicant_init_iface最后一段代码如下所示。 **wpa_supplicant.c::wpa_supplicant_init_iface代码段五** ~~~ // ①初始化driver wrapper模块最后一部分内容 if (wpa_supplicant_driver_init(wpa_s) < 0) return -1; ......// TDLS相关,本书不讨论 ......// 设置country // 初始化WPS相关模块,本章不讨论 if (wpas_wps_init(wpa_s)) return -1; // ②初始化EAPOL模块。这部分内容4.4节介绍 if (wpa_supplicant_init_eapol(wpa_s) < 0) return -1; wpa_sm_set_eapol(wpa_s->wpa, wpa_s->eapol); // ③初始化ctrl i/f模块 wpa_s->ctrl_iface = wpa_supplicant_ctrl_iface_init(wpa_s); ...... wpa_s->gas = gas_query_init(wpa_s); // GAS相关,本书不讨论 #ifdef CONFIG_P2P if (wpas_p2p_init(wpa_s->global, wpa_s) < 0) {......// P2P模块初始化,见第7章分析} #endif /* CONFIG_P2P */ // ④bss相关,详情见下文 if (wpa_bss_init(wpa_s) < 0) return -1; return 0;// wpa_supplicant_init_iface终于成功返回 ~~~ 上述代码包括四个关键函数,其中第二个关键点和EAPOL模块相关,其内容4.4节再介绍。 **(1)wpa_supplicant_driver_init函数分析** 先来看第一个关键函数wpa_supplicant_driver_init,代码如下所示。 **wpa_supplicant.c::wpa_supplicant_driver_init** ~~~ int wpa_supplicant_driver_init(struct wpa_supplicant *wpa_s) { static int interface_count = 0; // 关键函数,见下文代码分析 if (wpa_supplicant_update_mac_addr(wpa_s) < 0) return -1; if (wpa_s->bridge_ifname[0]) {...... // 桥接相关内容,本书不讨论 } // 清除driver中保存的key相关的信息 wpa_clear_keys(wpa_s, NULL); // 设置TKIP countermeasure值为0 wpa_drv_set_countermeasures(wpa_s, 0); // 清空drive wrapper及driver中保存的pmkid信息。 wpa_drv_flush_pmkid(wpa_s); // 设置wpa_supplicant结构体中的一些变量的初值 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN; wpa_s->prev_scan_wildcard = 0; // 判断wpa_conf中是否有使能的网络 if (wpa_supplicant_enabled_networks(wpa_s->conf)) { ......// 当前配置文件中没有使能任何一个网络,故此段代码略去 } else // 设置状态为WPA_INACTIVE。该函数比较简单,请读者自行阅读 wpa_supplicant_set_state(wpa_s, WPA_INACTIVE); return 0; } ~~~ 上述代码中唯一需要介绍的就是wpa_supplicant_update_mac_addr,因为它和图4-1中的l2_packet模块初始化有关,其代码如下所示。 **wpa_supplicant.c::wpa_supplicant_update_mac_addr** ~~~ int wpa_supplicant_update_mac_addr(struct wpa_supplicant *wpa_s) { if (wpa_s->driver->send_eapol) { ......// nl80211 driver wrapper没有定义该函数 } else if (!(wpa_s->drv_flags & WPA_DRIVER_FLAGS_P2P_DEDICATED_INTERFACE)) { // WPA_DRIVER_FLAGS_P2P_DEDICATED_INTERFACE和P2P有关,本例不支持该参数 l2_packet_deinit(wpa_s->l2); // 先释放之前创建的l2_packet模块 // 初始化l2_packet wpa_s->l2 = l2_packet_init(wpa_s->ifname, wpa_drv_get_mac_addr(wpa_s), // 获取接口的MAC地址 ETH_P_EAPOL, // 收到的EAPOL及EAP帧将由此函数负责处理 wpa_supplicant_rx_eapol, wpa_s, 0); ...... } else { ......} // 将l2_packet_data中的own_addr内容复制到wpa_supplicant的own_addr成员变量 if (wpa_s->l2 && l2_packet_get_own_addr(wpa_s->l2, wpa_s->own_addr)) {......} // 再把wpa_supplicant的own_addr复制到wpa_sm中的own_addr中 wpa_sm_set_own_addr(wpa_s->wpa, wpa_s->own_addr); ...... return 0; } ~~~ l2_packet_init内部就是创建一个PF_PACKET域的socket。注意,l2_packet_init最后一个参数为0,这样,socket的类型将是SOCK_DGRAM。l2_packet_init返回值类型为l2_packet_data,其成员如图4-19所示。 :-: ![](https://box.kancloud.cn/45e4d934c4ba194d996e9c91b94383c1_1068x525.jpg) 图4-19 l2_packet_data成员 l2_packet_init通过eloop_register_read_sock函数为图4-19中的socket句柄fd注册一个读事件回调函数l2_packet_receive,而该函数将接收socket数据,然后回调rx_callback。该函数对于4-Way Handshake非常重要,后文将详细介绍此处设置的回调函数(wpa_supplicant_rx_eapol)。 下面来看第三个关键函数wpa_supplicant_ctrl_iface_init。 **(2)wpa_supplicant_ctrl_iface_init函数分析** 该函数内部将创建一个unix域socket,然后向eloop注册一个读事件处理函数。Android平台对此函数进行了定制,主要是利用图4-3中init配置文件中wpa_supplicant的socket选项。init在fork出一个wpa_supplicant子进程时将创建一个socket,并通过环境变量传给wpa_supplicant子进程。 **提示** 对socket选项感兴趣的读者可阅读《深入理解Android:卷Ⅰ》3.2.3节“启动Zygote”。 **ctrl_iface_unix.c::wpa_supplicant_ctrl_iface_init** ~~~ wpa_supplicant_ctrl_iface_init(struct wpa_supplicant *wpa_s) { struct ctrl_iface_priv *priv; struct sockaddr_un addr; ...... priv = os_zalloc(sizeof(*priv)); dl_list_init(&priv->ctrl_dst); priv->wpa_s = wpa_s; priv->sock = -1; buf = os_strdup(wpa_s->conf->ctrl_interface); ...... #ifdef ANDROID // Android平台定义了此编译宏 // addr.sun_patch的值为wpa_wlan0。该值和图4-5中socket选项指定的值一样 os_snprintf(addr.sun_path, sizeof(addr.sun_path), "wpa_%s", wpa_s->conf->ctrl_interface); priv->sock = android_get_control_socket(addr.sun_path);// 获取socket句柄 if (priv->sock >= 0) goto havesock; // 直接跳转 #endif /* ANDROID */ ...... havesock: #endif /* ANDROID */ // 客户端发送命令都由wpa_supplicant_ctrl_iface_receive处理 eloop_register_read_sock(priv->sock, wpa_supplicant_ctrl_iface_receive, wpa_s, priv); // 读者还记得4.3.2节wpa_supplicant_init分析中提到的消息全局回调函数吗 wpa_msg_register_cb(wpa_supplicant_ctrl_iface_msg_cb); os_free(buf); return priv; } ~~~ 上述代码中,客户端发送的命令将由wpa_supplicant_ctrl_iface_receive函数处理。 提示 后文分析线路二中用户发送的WPAS命令时,就将直接分析此函数。 **(3)wpa_bss_init函数分析** 最后来看wpa_bss_init函数。 **bss.c::wpa_bss_init** ~~~ int wpa_bss_init(struct wpa_supplicant *wpa_s) { // bss和bss_id是wpa_supplicant结构体中的成员变量,它们通过链表的方式来保存wpa_bss信息 dl_list_init(&wpa_s->bss); dl_list_init(&wpa_s->bss_id); // 注册一个超时任务,超时时间为WPA_BSS_EXPIRATION_PERIOD,值为10秒 eloop_register_timeout(WPA_BSS_EXPIRATION_PERIOD, 0,wpa_bss_timeout, wpa_s, NULL); return 0; } ~~~ wpa_supplicant注册了一个定时任务用于定时更新其保存的wpa_bss信息,一旦某个无线网络在一定时间内没有更新或使用,则需要从链表中把它去掉。 超时任务的函数代码如下。 **bss.c::wpa_bss_timeout** ~~~ static void wpa_bss_timeout(void *eloop_ctx, void *timeout_ctx) { struct wpa_supplicant *wpa_s = eloop_ctx; // bss_expiration_age默认是1800秒 // 下面这个函数将更新wpa_bss链表以删除一些无用的wpa_bss对象 wpa_bss_flush_by_age(wpa_s, wpa_s->conf->bss_expiration_age); eloop_register_timeout(WPA_BSS_EXPIRATION_PERIOD, 0,wpa_bss_timeout, wpa_s, NULL); } ~~~ 6. wpa_supplicant_add_iface流程总结 看到这里,读者一定会感慨,线路一走下来比较艰难。其中所调用函数之多、每个变量背后含义之丰富都是初学者要面临的挑战。在此,通过图4-20展示wpa_supplicant_add_iface中所涉及的几个重要函数的调用流程。 :-: ![](https://box.kancloud.cn/a8dcdf9952cb2309bb7fe24ed5764af1_1191x1677.jpg) 图4-20 wpa_supplicant_add_iface重要流程 图4-20中的第8个函数调用wpa_driver_nl80211_init的内容在图4-15中。请读者结合这两个图来学习调用流程。 即使用了如此之多的笔墨,wpa_supplicant_init初始化所涉及的内容依然不能全部覆盖到。下一节介绍非常重要的两个模块:EAP和EAPOL。 ① 注意,此结论为笔者根据笔记本的表现形式进行的猜测。如有读者知道其工作原理不妨与大家分享。 ② max_remain_on_chan的官方解释可参考nl80211关于 NL80211_CMD_REMAIN_ON_CHANNEL的定义,其原文是"Request to remain awake on the specified channel for the specified amount of time.This can be used to do off-channel operations like transmit aPublic Action frame and wait for aresponse while being associated to an AP on another channel"。请了解该功能的读者和大家分享相关知识。