天天看點

hostapd_cli指令源碼分析

hostapd提供了控制指令hostapd_cli,使用方法可以檢視usage。

hostapd_cli指令源碼分析

源碼中的main函數:

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

    if (os_program_init())//不同操作體統平台下執行不同的環境初始化
        return -;

    for (;;) {   //執行getopt的選擇,h則顯示usage
        c = getopt(argc, argv, "a:BhG:i:p:P:s:v");
        if (c < )
            break;
        switch (c) {
        case 'a':
            action_file = optarg;
            break;
        case 'B':    //背景執行
            daemonize = ;
            break;
        case 'G':
            ping_interval = atoi(optarg);
            break;
        case 'h':
            usage();
            return ;
        case 'v':
            printf("%s\n", hostapd_cli_version);
            return ;
        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 -;
        }
    }

    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 -;

    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, ".") == 
                        ||
                        os_strcmp(dent->d_name, "..") == )
                        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 -;
        }

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

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

    if (daemonize && os_daemonize(pid_file) && eloop_sock_requeue())
        return -;
//以下是控制操作的核心
    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 ;
}
           

如果是互動狀态則,執行交換式的指令行操作

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, , 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 = ;
    cmd = hostapd_cli_commands;
    while (cmd->cmd) {
        if (strncasecmp(cmd->cmd, argv[], strlen(argv[])) == ) {
            match = cmd;
            if (os_strcasecmp(cmd->cmd, argv[]) == ) {
                /* we have an exact match */
                count = ;
                break;
            }
            count++;
        }
        cmd++;
    }

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

其中結構體

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相應操作的詳細執行過程。

繼續閱讀