Страница руководства - wpa_cli(8) (original) (raw)

НАЗВАНИЕ

wpa_cli - клиент WPA для командной строки

ОБЗОР

wpa_cli [ -p путь_к_сокетам_управления ] [ -i интерфейс ] [ -hvB ] [-a файл_действий ] [ -P PID_файл ] [ команда ... ]

ОБЩИЙ ОБЗОР

wpa_cli - текстовый интерфейс для общения с wpa_supplicant. Он используется для запроса текущего состояния, смены настроек, событий переключения и интерактивного ввода запросов пользователя.

wpa_cli может показать текущее состояние аутентификации, выбранный режим безопасности, MIB-ты dot11 и dot1x и так далее. В дополнение, он может настраивать некоторые переменные вроде параметров конечного автомата EAPoL и события-переключатели, например пересоединение, и вход/выход IEEE 802.1X. wpa_cli представляет интерфейс пользователя для запроса информации аутентификации, например, имени пользователя и пароля, если они не указаны в настройках. Это может пригодиться для реализации, например, для одноразовых паролей или аутентификации по картам, когда аутентификация основана на механизме запрос-ответ с использованием внешних устройства для получения ответа.

Управляющий интерфейс wpa_supplicant может быть настроен таким образом, что он будет доступен обычным пользователям (параметр ctrl_interface GROUP= в файле конфигурации). Это позволяет запускать wpa_cli под учётной записью обычного пользователя.

wpa_cli поддерживает два режима: интерактивный режим и режим командной строки. Оба режима обладают одинаковым набором команд и главное отличие интерактивного режима состоит в предоставлении доступа к незапрашиваемым сообщениям (сообщения о событиях, запросы имени пользователя/пароля).

Интерактивный режим запускается если wpa_cli запущен без команды в качестве параметра командной строки. В этом случае команды можно вводить в ответ на приглашение wpa_cli. В режиме командной строки те же самые команды указываются в качестве аргумента командной строки для wpa_cli.

ИНТЕРАКТИВНЫЙ ЗАПРОС ПАРАМЕТРОВ АУТЕНТИФИКАЦИИ

Когда wpa_supplicant нужны параметры аутентификации, такие как имя пользователя и пароль, которые не присутствуют в файле конфигурации, он отправляет запрос всем подключенным программам-оболочкам, например, wpa_cli в интерактивном режиме. wpa_cli отображает эти запросы с приставкой "CTRL-REQ-<тип>-<идентификатор>:<текст>". <тип> - это тип идентификации, одно из трёх значений: IDENTITY, PASSWORD, или OTP (one-time-password - одноразовый пароль). <идентификатор> - это уникальный идентификатор текущей сети. <текст> - это описание запроса. В случае запроса OTP, он включает вызов от сервера аутентификации.

Ответ на эти запросы могут быть заданы с помощью команд identity, password и otp. <идентификатор> нужно скопировать из подходящего запроса. Команды passwod и otp могут использоваться вне зависимости от того, что было запрошено - PASSWORD или OTP. Главное отличие между этими командами заключается в том, что значения указанные в passwod запоминаются до тех пор, пока работает wpa_supplicant, в то время как значения заданные с помощью otp используются только однажды и затем забываются, то есть, wpa_supplicant запрашивает у оболочки новое значение пароля при каждом использовании. Это может использоваться для реализации списков одноразовых паролей и аутентификации на основе идентификационных карт и брелоков.

Образец запроса пароля и подходящего ответа:

CTRL-REQ-PASSWORD-1:Password needed for SSID foobar

password 1 mysecretpassword

Образец запроса идентификационной карты типа вызов-ответ:

CTRL-REQ-OTP-2:Challenge 1235663 needed for SSID foobar

otp 2 9876

АРГУМЕНТЫ КОМАНД

-p путь

Изменить путь, где должен находиться управляющий сокет.

-i имя_интерфейса

Указать настраиваемый интерфейс. По умолчанию, выбирает первый интерфейс, найденный с помощью сокета управления по указанному пути.

-h Помощь. Показать справку по использованию.

-v Показать информацию о версии.

-B Работать в режиме демона в фоне.

-a файл

Работать в режиме демона, выполняя файл действий, основываясь на событиях от wpa_supplicant. Указанный файл будет выполнен с именем интерфейса, указанным в качестве первого аргумента, и словом "CONNECTED" или "DISCONNECTED" в качестве второго, в зависимости от события. Это может использоваться для выполнения служебных сетевых программ, необходимых для настройки интерфейса.Файлу доступны также три переменные окружения: WPA_CTRL_DIR, WPA_ID и WPA_ID_STR. WPA_CTRL_DIR содержит абсолютный путь к сокету управления интерфейсом. WPA_ID содержит уникальный идентификатор сети, назначенный активной сети, и WPA_ID_STR содержит значение опции id_str.

-P файл

Задать расположение файла с идентификатором процесса.

команда

Запустить команду. Доступные команды перечислены в следующем разделе.

-p путь
	Изменить путь, где должен находиться управляющий сокет.
-i имя_интерфейса
	Указать настраиваемый интерфейс. По умолчанию, выбирает первый интерфейс, найденный с помощью сокета управления по указанному пути.
-h	Помощь. Показать справку по использованию.
-v	Показать информацию о версии.
-B	Работать в режиме демона в фоне.
-a файл
	Работать в режиме демона, выполняя файл действий, основываясь на событиях от wpa_supplicant. Указанный файл будет выполнен с именем интерфейса, указанным в качестве первого аргумента, и словом "CONNECTED" или "DISCONNECTED" в качестве второго, в зависимости от события. Это может использоваться для выполнения служебных сетевых программ, необходимых для настройки интерфейса.Файлу доступны также три переменные окружения: WPA_CTRL_DIR, WPA_ID и WPA_ID_STR. WPA_CTRL_DIR содержит абсолютный путь к сокету управления интерфейсом. WPA_ID содержит уникальный идентификатор сети, назначенный активной сети, и WPA_ID_STR содержит значение опции id_str.
-P файл
	Задать расположение файла с идентификатором процесса.
команда
	Запустить команду. Доступные команды перечислены в следующем разделе.

КОМАНДЫ

Доступны следующие команды:

status Получить текущее состояние WPA/EAPOL/EAP

mib Получить переменные MIB (dot1x, dot11)

help Вывести краткую справку по использованию

interface [имя_интерфейса]

Показать интерфейсы или выбрать интерфейс

level

Изменить уровень отладки

license

Показать полную лицензию wpa_cli

logoff IEEE 802.1X состояние машины при выходе EAPoL

logon IEEE 802.1X состояние машины при входе EAPoL

set Задать переменные (показать список переменных при запуске без аргументов)

pmksa Показать кэш PMKSA

reassociate

Принудительная переассоциация

reconfigure

Заставить wpa_supplicant перечитать его файл конфигурации

preauthenticate

Принудительная пред-аутентификация

identity <идентификатор_сети> <идентификатор>

Настроить идентификацию на SSID

password <идентификатор_сети> <пароль>

Настроить пароль для SSID

pin <идентификатор сети> <идентификационный_номер>

Настроить идентификационный номер для SSID

otp <идентификатор сети> <пароль>

Настроить одноразовый пароль для SSID

bssid <идентификатор сети>

Настроить предпочитаемый BSSID для SSID

list_networks

Перечислить настроенные сети

terminate

Завершить wpa_supplicant

quit Выйти из wpa_cli

status	Получить текущее состояние WPA/EAPOL/EAP
mib	Получить переменные MIB (dot1x, dot11)
help	Вывести краткую справку по использованию
interface [имя_интерфейса]
	Показать интерфейсы или выбрать интерфейс
level
	Изменить уровень отладки
license
	Показать полную лицензию wpa_cli
logoff	IEEE 802.1X состояние машины при выходе EAPoL
logon	IEEE 802.1X состояние машины при входе EAPoL
set	Задать переменные (показать список переменных при запуске без аргументов)
pmksa	Показать кэш PMKSA
reassociate
	Принудительная переассоциация
reconfigure
	Заставить wpa_supplicant перечитать его файл конфигурации
preauthenticate
	Принудительная пред-аутентификация
identity <идентификатор_сети> <идентификатор>
	Настроить идентификацию на SSID
password <идентификатор_сети> <пароль>
	Настроить пароль для SSID
pin <идентификатор сети> <идентификационный_номер>
	Настроить идентификационный номер для SSID
otp <идентификатор сети> <пароль>
	Настроить одноразовый пароль для SSID
bssid <идентификатор сети>
	Настроить предпочитаемый BSSID для SSID
list_networks
	Перечислить настроенные сети
terminate
	Завершить wpa_supplicant
quit	Выйти из wpa_cli

СМОТРИ ТАКЖЕ

wpa_supplicant(8)

ПРАВА

wpa_supplicant Copyright © 2003-2007, Джуни Мэлайнен (Jouni Malinen) <j@w1.fi> и вкладчики. Все права защищены.

Эта программа распространяется под двумя лицензиями: GPL версии 2 и лицензией BSD. Любая из лицензий может использоваться на ваш выбор.

АВТОРЫ ПЕРЕВОДА

Перевод выполнен на сайте коллективных переводов http://translated.by. Авторы перевода Олег Безначев aka saturn721, Владимир Ступин <wheelof@gmail.com>.

WPA_CLI (8)	02 декабря 2008

Перейти в начало страницы | Раздел 8 | Главный указатель.
Сгенерировано manServer 1.07 из /home/stupin/man/man8/wpa_cli.8.gz с использованием макросов man.