hostapd_cli命令源码分析

hostapd提供了控制命令hostapd_cli，使用方法可以查看usage。

源码中的main函数：

int main(int argc, char *argv[])
{
    int warning_displayed = 0;
    int c;
    int daemonize = 0;

    if (os_program_init())//不同操作体统平台下执行不同的环境初始化
        return -1;

    for (;;) {   //执行getopt的选择，h则显示usage
        c = getopt(argc, argv, "a:BhG:i:p:P:s:v");
        if (c < 0)
            break;
        switch (c) {
        case 'a':
            action_file = optarg;
            break;
        case 'B':    //后台执行
            daemonize = 1;
            break;
        case 'G':
            ping_interval = atoi(optarg);
            break;
        case 'h':
            usage();
            return 0;
        case 'v':
            printf("%s\n", hostapd_cli_version);
            return 0;
        case 'i':    //选择控制的网络接口
            os_free(ctrl_ifname);
            ctrl_ifname = os_strdup(optarg);
            break;
        case 'p':
            ctrl_iface_dir = optarg;
            break;
        case 'P':
            pid_file = optarg;
            break;
        case 's':
            client_socket_dir = optarg;
            break;
        default:
            usage();
            return -1;
        }
    }

    interactive = (argc == optind) && (action_file == NULL);

    if (interactive) {
        printf("%s\n\n%s\n\n", hostapd_cli_version, cli_license);
    }

    if (eloop_init())//创建和初始化epoll
        return -1;

    for (;;) {
        if (ctrl_ifname == NULL) {
            struct dirent *dent;
            DIR *dir = opendir(ctrl_iface_dir);
            if (dir) {
                while ((dent = readdir(dir))) {
                    if (os_strcmp(dent->d_name, ".") == 0
                        ||
                        os_strcmp(dent->d_name, "..") == 0)
                        continue;
                    printf("Selected interface '%s'\n",
                           dent->d_name);
                    ctrl_ifname = os_strdup(dent->d_name);
                    break;
                }
                closedir(dir);
            }
        }
        ctrl_conn = hostapd_cli_open_connection(ctrl_ifname);//连接hostapd进程
        if (ctrl_conn) {
            if (warning_displayed)
                printf("Connection established.\n");
            break;
        }

        if (!interactive) {
            perror("Failed to connect to hostapd - "
                   "wpa_ctrl_open");
            return -1;
        }

        if (!warning_displayed) {
            printf("Could not connect to hostapd - re-trying\n");
            warning_displayed = 1;
        }
        os_sleep(1, 0);
        continue;
    }

    if (interactive || action_file) {
        if (wpa_ctrl_attach(ctrl_conn) == 0) {
            hostapd_cli_attached = 1;
            register_event_handler(ctrl_conn);
        } else {
            printf("Warning: Failed to attach to hostapd.\n");
            if (action_file)
                return -1;
        }
    }

    if (daemonize && os_daemonize(pid_file) && eloop_sock_requeue())
        return -1;
//以下是控制操作的核心
    if (interactive)
        hostapd_cli_interactive();
    else if (action_file)
        hostapd_cli_action(ctrl_conn);
    else
        wpa_request(ctrl_conn, argc - optind, &argv[optind]);

    unregister_event_handler(ctrl_conn);
    os_free(ctrl_ifname);
    eloop_destroy();
    hostapd_cli_cleanup();
    return 0;
}

如果是交互状态则，执行交换式的命令行操作hostapd_cli_interactive，执行是文件操作，则执行hostapd_cli_action 函数，其它情况，执行wpa_request 函数。

hostapd_cli_interactive 函数操作如下：

static void hostapd_cli_interactive(void)
{
    printf("\nInteractive mode\n\n");

    eloop_register_signal_terminate(hostapd_cli_eloop_terminate, NULL);
    edit_init(hostapd_cli_edit_cmd_cb, hostapd_cli_edit_eof_cb,
          hostapd_cli_edit_completion_cb, NULL, NULL, NULL);
    eloop_register_timeout(ping_interval, 0, hostapd_cli_ping, NULL, NULL);

    eloop_run();

    cli_txt_list_flush(&stations);
    edit_deinit(NULL, NULL);
    eloop_cancel_timeout(hostapd_cli_ping, NULL, NULL);
}

主要是调用了edit_init 函数，关联了hostapd_cli_edit_cmd_cb，hostapd_cli_edit_eof_cb，hostapd_cli_edit_completion_cb三个操作函数：

edit_init(hostapd_cli_edit_cmd_cb, hostapd_cli_edit_eof_cb,
      hostapd_cli_edit_completion_cb, NULL, NULL, NULL); 

最后的执行还是调用操作了wpa_request

static void wpa_request(struct wpa_ctrl *ctrl, int argc, char *argv[])
{
    const struct hostapd_cli_cmd *cmd, *match = NULL;
    int count;

    count = 0;
    cmd = hostapd_cli_commands;
    while (cmd->cmd) {
        if (strncasecmp(cmd->cmd, argv[0], strlen(argv[0])) == 0) {
            match = cmd;
            if (os_strcasecmp(cmd->cmd, argv[0]) == 0) {
                /* we have an exact match */
                count = 1;
                break;
            }
            count++;
        }
        cmd++;
    }

    if (count > 1) {
        printf("Ambiguous command '%s'; possible commands:", argv[0]);
        cmd = hostapd_cli_commands;
        while (cmd->cmd) {
            if (strncasecmp(cmd->cmd, argv[0], strlen(argv[0])) ==
                0) {
                printf(" %s", cmd->cmd);
            }
            cmd++;
        }
        printf("\n");
    } else if (count == 0) {
        printf("Unknown command '%s'\n", argv[0]);
    } else {
        match->handler(ctrl, argc - 1, &argv[1]);
    }
}

其中结构体hostapd_cli_cmd是对应命令行不同命令的操作项目集合：

struct hostapd_cli_cmd {
    const char *cmd;
    int (*handler)(struct wpa_ctrl *ctrl, int argc, char *argv[]);
    char ** (*completion)(const char *str, int pos);
    const char *usage;
} 

最后执行的是操作函数handler()和completion()

以下是最新稳定版hostapd提供的hostapd_cli操作条目和操作函数集合：

static const struct hostapd_cli_cmd hostapd_cli_commands[] = {
    { "ping", hostapd_cli_cmd_ping, NULL,
      "= pings hostapd" },
    { "mib", hostapd_cli_cmd_mib, NULL,
      "= get MIB variables (dot1x, dot11, radius)" },
    { "relog", hostapd_cli_cmd_relog, NULL, NULL },
    { "status", hostapd_cli_cmd_status, NULL, NULL },
    { "sta", hostapd_cli_cmd_sta, NULL,
      "<addr> = get MIB variables for one station" },
    { "all_sta", hostapd_cli_cmd_all_sta, NULL,
       "= get MIB variables for all stations" },
    { "new_sta", hostapd_cli_cmd_new_sta, NULL,
      "<addr> = add a new station" },
    { "deauthenticate", hostapd_cli_cmd_deauthenticate,
      hostapd_complete_deauthenticate,
      "<addr> = deauthenticate a station" },
    { "disassociate", hostapd_cli_cmd_disassociate,
      hostapd_complete_disassociate,
      "<addr> = disassociate a station" },
#ifdef CONFIG_TAXONOMY
    { "signature", hostapd_cli_cmd_signature, NULL,
      "<addr> = get taxonomy signature for a station" },
#endif /* CONFIG_TAXONOMY */
#ifdef CONFIG_IEEE80211W
    { "sa_query", hostapd_cli_cmd_sa_query, NULL,
      "<addr> = send SA Query to a station" },
#endif /* CONFIG_IEEE80211W */
#ifdef CONFIG_WPS
    { "wps_pin", hostapd_cli_cmd_wps_pin, NULL,
      "<uuid> <pin> [timeout] [addr] = add WPS Enrollee PIN" },
    { "wps_check_pin", hostapd_cli_cmd_wps_check_pin, NULL,
      "<PIN> = verify PIN checksum" },
    { "wps_pbc", hostapd_cli_cmd_wps_pbc, NULL,
      "= indicate button pushed to initiate PBC" },
    { "wps_cancel", hostapd_cli_cmd_wps_cancel, NULL,
      "= cancel the pending WPS operation" },
#ifdef CONFIG_WPS_NFC
    { "wps_nfc_tag_read", hostapd_cli_cmd_wps_nfc_tag_read, NULL,
      "<hexdump> = report read NFC tag with WPS data" },
    { "wps_nfc_config_token", hostapd_cli_cmd_wps_nfc_config_token, NULL,
      "<WPS/NDEF> = build NFC configuration token" },
    { "wps_nfc_token", hostapd_cli_cmd_wps_nfc_token, NULL,
      "<WPS/NDEF/enable/disable> = manager NFC password token" },
    { "nfc_get_handover_sel", hostapd_cli_cmd_nfc_get_handover_sel, NULL,
      NULL },
#endif /* CONFIG_WPS_NFC */
    { "wps_ap_pin", hostapd_cli_cmd_wps_ap_pin, NULL,
      "<cmd> [params..] = enable/disable AP PIN" },
    { "wps_config", hostapd_cli_cmd_wps_config, NULL,
      "<SSID> <auth> <encr> <key> = configure AP" },
    { "wps_get_status", hostapd_cli_cmd_wps_get_status, NULL,
      "= show current WPS status" },
#endif /* CONFIG_WPS */
    { "disassoc_imminent", hostapd_cli_cmd_disassoc_imminent, NULL, NULL },
    { "ess_disassoc", hostapd_cli_cmd_ess_disassoc, NULL, NULL },
    { "bss_tm_req", hostapd_cli_cmd_bss_tm_req, NULL, NULL },
    { "get_config", hostapd_cli_cmd_get_config, NULL,
      "= show current configuration" },
    { "help", hostapd_cli_cmd_help, hostapd_cli_complete_help,
      "= show this usage help" },
    { "interface", hostapd_cli_cmd_interface, hostapd_complete_interface,
      "[ifname] = show interfaces/select interface" },
#ifdef CONFIG_FST
    { "fst", hostapd_cli_cmd_fst, NULL, NULL },
#endif /* CONFIG_FST */
    { "raw", hostapd_cli_cmd_raw, NULL, NULL },
    { "level", hostapd_cli_cmd_level, NULL,
      "<debug level> = change debug level" },
    { "license", hostapd_cli_cmd_license, NULL,
      "= show full hostapd_cli license" },
    { "quit", hostapd_cli_cmd_quit, NULL,
      "= exit hostapd_cli" },
    { "set", hostapd_cli_cmd_set, NULL, NULL },
    { "get", hostapd_cli_cmd_get, NULL, NULL },
    { "set_qos_map_set", hostapd_cli_cmd_set_qos_map_set, NULL, NULL },
    { "send_qos_map_conf", hostapd_cli_cmd_send_qos_map_conf, NULL, NULL },
    { "chan_switch", hostapd_cli_cmd_chan_switch, NULL, NULL },
    { "hs20_wnm_notif", hostapd_cli_cmd_hs20_wnm_notif, NULL, NULL },
    { "hs20_deauth_req", hostapd_cli_cmd_hs20_deauth_req, NULL, NULL },
    { "vendor", hostapd_cli_cmd_vendor, NULL, NULL },
    { "enable", hostapd_cli_cmd_enable, NULL, NULL },
    { "reload", hostapd_cli_cmd_reload, NULL, NULL },
    { "disable", hostapd_cli_cmd_disable, NULL, NULL },
    { "erp_flush", hostapd_cli_cmd_erp_flush, NULL, NULL },
    { "log_level", hostapd_cli_cmd_log_level, NULL, NULL },
    { "pmksa", hostapd_cli_cmd_pmksa, NULL, NULL },
    { "pmksa_flush", hostapd_cli_cmd_pmksa_flush, NULL, NULL },
    { "set_neighbor", hostapd_cli_cmd_set_neighbor, NULL, NULL },
    { "remove_neighbor", hostapd_cli_cmd_remove_neighbor, NULL, NULL },
    { "req_lci", hostapd_cli_cmd_req_lci, NULL, NULL },
    { "req_range", hostapd_cli_cmd_req_range, NULL, NULL },
    { "driver_flags", hostapd_cli_cmd_driver_flags, NULL, NULL },
    { NULL, NULL, NULL, NULL }
};

可以通过查找相应的调用执行函数了解hostapt_cli相应操作的详细执行过程。