WPA::CLI - Provides a interface to wpa_cli.
Version 0.1.1
use WPA::CLI; my $foo = WPA::CLI->new(); ...
This initializes the object to be used for making use of wpa_cli.
It takes no arguements and returns undef upon failure.
This function gets the current status from wpa_cli.
This saves the current configuration. The user requesting this does not need write permissions to file being used
$return=$obj->set_network($networkID, $variable, $value)
This sets a variable for for a specific network ID.
The return of undef indicates a error with running wpa_cli, other wise it is a true or false for if it worked.
$return=$obj->get_network($networkID, $variable)
This gets a variable for for a specific network ID.
The return of undef indicates a error with running wpa_cli or a failure is returned. Otherwise it is what ever the variable was set to.
$return=$obj->pin($networkID, $value)
This sets the pin for a network.
The return of undef indicates a error with running wpa_cli or non-numeric network ID, other wise it is a true or false for if it worked.
$return=$obj->new_password($networkID, $value)
This sets a new password for a network.
$return=$obj->add_network()
This adds a network.
The returned value is the numeric ID of the new network. A return of UNDEF indicates some error.
$return=$obj->remove_network($networkID)
This sets a one-time-password a network.
$return=$obj->select_network($networkID)
This is the network ID to select, while disabling the others.
The return of undef indicates a error with running wpa_cli or a non-numeric network ID, other wise it is a true or false for if it worked.
$return=$obj->enable_network($networkID)
This enables a network ID.
$return=$obj->disable_network($networkID)
This disables a network ID.
$return=$obj->reconfigure($networkID)
This causes wpa_supplicant to reread it's configuration file.
$return=$obj->preauthenticate($BSSID)
Force preauthentication for a BSSID.
$return=$obj->disconnect()
Disconnect and wait for a reassosiate command.
%return=$obj->get_network($networkID, $variable)
This lists the configured networks.
The return of undef indicates a error with running wpa_cli or a failure is returned. Otherwise a hash is returned.
They keys for the hash are the network IDs. The value of each is another hash. It contians the SSID, BSSID, and flag. All keys are lower case.
$returned=$obj->run_TF_command($command, 0)
This runs a arbirary command in which the expected values are either 'FAIL' or 'OK'. This function is largely intended for internal use by this module.
It takes two arguement. The first is string containing the command and any arguements for it. The second is what to return on a unknown return.
UNDEF is returned upon with running wpa_cli. Other wise a per boolean value is returned set to the corresponding success of the command.
$returned=$obj->run_command($command)
This runs a arbirary command in which. This function is largely intended for internal use by this module.
It takes arguement, which is string containing the command and any arguements for it.
UNDEF is returned upon with running wpa_cli. Otherwise the return is the return from executed command.
This is a internal function.
This makes use of wpa_cli in a non-interactive form. This means that interface and otp are not usable.
Better documentation and etc shall be coming shortly. Publishing this and starting work on something that uses it in it's current form.
Zane C. Bowers-Hadley, <vvelox at vvelox.net>
<vvelox at vvelox.net>
Please report any bugs or feature requests to bug-wpa-cli at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WPA-CLI. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-wpa-cli at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc WPA::CLI
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WPA-CLI
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WPA-CLI
CPAN Ratings
http://cpanratings.perl.org/d/WPA-CLI
Search CPAN
http://search.cpan.org/dist/WPA-CLI
Copyright 2011 Zane C. Bowers-Hadley, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install WPA::CLI, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WPA::CLI
CPAN shell
perl -MCPAN -e shell install WPA::CLI
For more information on module installation, please visit the detailed CPAN module installation guide.