4.5.1　ADD_NETWORK命令处理

4.5.1　ADD_NETWORK命令处理

[—>ctrl_iface.c：：wpa_supplicant_ctrl_iface_process]

char * wpa_supplicant_ctrl_iface_process(struct wpa_supplicant *wpa_s,char *buf, 
                size_t *resp_len)
{
    char *reply;
    const int reply_size = 4096;
    int ctrl_rsp = 0;
    int reply_len;
    ......
    reply = os_malloc(reply_size);
   .....
    // 开始命令处理
    ......
    else if (os_strcmp(buf, "ADD_NETWORK") == 0) {
        reply_len = wpa_supplicant_ctrl_iface_add_network( wpa_s, reply, reply_size);
    }else if
    ......// 其他命令处理
 
    if (reply_len < 0) {// 命令处理出错
        os_memcpy(reply, "FAIL\n", 5);
        reply_len = 5;
    }
    ......
    *resp_len = reply_len;
    return reply;
}

ADD_NETWORK的真正处理在wpa_supplicant_ctrl_iface_add_network函数中，其代码如下所示。

[—>ctrl_iface.c：：wpa_supplicant_ctrl_iface_add_network]

static int wpa_supplicant_ctrl_iface_add_network(struct wpa_supplicant *wpa_s,
               char *buf, size_t buflen)
{
    struct wpa_ssid *ssid;
    int ret;
    /* 
    wpa_config_add_network返回一个wpa_ssid对象，读者还记得它吗？wpa_ssid是无线网络
    配置项在WPAS中的反映（请参考4.3.3节wpa_ssid结构体介绍）。wpa_config_add_network
   内部就是分配一个wpa_ssid对象，然后将其保存到一个链表中。注意，wpa_config是wpa_supplicant.
   conf在代码中的代表。所以，此处添加的无线网络信息将会保存到配置文件中，以备下次使用。
   */
    ssid = wpa_config_add_network(wpa_s->conf);
   ......
    wpas_notify_network_added(wpa_s, ssid);
    ssid->disabled = 1; // disabled为1表示该无线网络未启用，需要通过ENABLE_NETWORK来
    启动它
    // 设置该无线网络的默认配置项
    wpa_config_set_network_defaults(ssid);
    // 返回该网络的编号（由wpa_ssid的id变量表示。它在wpa_config_add_network函数中被赋值）
    ret = os_snprintf(buf, buflen, "%d\n", ssid->id);
    ......
    return ret;
}

上述代码比较简单，就是分配一个wpa_ssid对象，然后设置它的一些默认属性。整个函数返回该wpa_ssid对象的id，即它在链表中的顺序。

wpa_ssid的默认属性对后续流程有一些影响，默认属性都是什么呢？来看看wpa_config_set_network_defaults函数，代码如下所示。

[—>config.c：：wpa_config_set_network_defaults]

void wpa_config_set_network_defaults(struct wpa_ssid *ssid)
{
   // 设置proto、pairwise_cipher、group_cipher以及key_mgmt的信息，读者还记得这些变量的含义吗
   // 请参考4.3.3节安全相关成员变量及背景知识介绍
    ssid->proto = DEFAULT_PROTO;
    ssid->pairwise_cipher = DEFAULT_PAIRWISE;
    ssid->group_cipher = DEFAULT_GROUP;
    ssid->key_mgmt = DEFAULT_KEY_MGMT;
#ifdef IEEE8021X_EAPOL
    ssid->eapol_flags = DEFAULT_EAPOL_FLAGS;            // EAP相关变量，见下文解释
    ssid->eap_workaround = DEFAULT_EAP_WORKAROUND;
    ssid->eap.fragment_size = DEFAULT_FRAGMENT_SIZE;
#endif /* IEEE8021X_EAPOL */
#ifdef CONFIG_HT_OVERRIDES
    ......// 和802.11n有关，本书不涉及
#endif /* CONFIG_HT_OVERRIDES */
}

上述代码中出现了三个和EAPOL相关的变量，此处简单介绍一下。

（1）eapol_flags

它和动态WEP key有关。只适用于非WPA安全环境中，可取值有三个，分别如下。

1：代码中定义为BIT（0），表示需要为单播数据传输使用动态WEP Key，对应宏为

EAPOL_FLAG_REQUIRE_KEY_UNICAST。

2：代码中定义为BIT（1），表示需要为组播数据传输使用动态WEP Key，对应宏为

EAPOL_FLAG_REQUIRE_KEY_BROADCAST。

3：单播和组播都使用动态WEP Key，对应宏为DEFAULT_EAPOL_FLAGS。

（2）eap_workaround

身份认证方法多种多样，而有些AS（Authenticator服务器）并不严格遵守规范。该变量表示碰到这种情况时，WPAS是否可以采取“绕”（workaround本意是“变通”）过去的方式来对待这些AS。由于这种不严格的情况非常普遍，所以该值默认是1。

（3）fragment_size

该变量和EAPOL消息分片大小有关。默认的DEFAULT_FRAGMENT_SIZE大小为1398，表示EAPOL消息只要不超过这个大小，就不用对其进行分片。

"ADD_NETWORK"命令比较简单，它最终将返回给客户端对应的无线网络配置的编号。在本例中，它是0。

下面来看客户端通过"SET_NETWORK"为该无线网络配置项设置参数的处理过程。

4.5.1 ADD_NETWORK命令处理