Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
DEPRECATED Tool to automatically scan for and configure wireless networks on OpenBSD
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
WIRELESS(8) System Manager's Manual WIRELESS(8) NAME wireless - scan for and configure wireless networks SYNOPSIS wireless [file] DESCRIPTION wireless scans for and configures wireless networks on OpenBSD. It uses ifconfig(8) to do most of the heavy lifting and basically just interprets and applies scan results. wireless is deprecated since OpenBSD 6.4. Use the -join option of ifconfig(8) instead to configure auto-joined wireless networks. USAGE Just run wireless once to scan for known wireless LANs and configure the earliest network in the configuration file, for example: $ wireless ... wait a bit for scanning and configuration ... $ dhclient iwn0 The result of the scan can also be written to a file. The format of the file is described in CONFIGURATION STATEMENTS below. If necessary (see the CONFIGURATION OVERVIEW section below), wireless will notify wpa_supplicant(8) of the newly established connection by calling wpa_cli reassoc CONFIGURATION OVERVIEW This is an example configuration file: device iwn0 dump /var/db/wireless/aps verbose open freifunk.paderborn.net 802.1x eduroam wpa "home network" thisismypassword There are three kinds of networks, open, wpa and 802.1x. All of these get an SSID as their first parameter. wpa gets the password or hex key as the second parameter. SSIDs and passwords which contain spaces can be enclosed in single or double quotes. Regular string quoting rules apply: wpa "Hello\"foo" 'I\'m a password!' You can include files with the include statement: include /home/user/.wireless.conf Macros can be set and used like this: mypw = "foobar! 1234#$" hexkey = 0x092876e79594ae7beda40dd150d17fa215e51f22cb990f9ec640a267c96fbedf wpa nw1 $mypw wpa nw2 $hexkey The priority of a network depends on the order of networks in the configuration file. The earlier a network appears, the higher is its priority. If an SSID is visible multiple times (such as in campus networks), the access point with the strongest RSSI is chosen. CONFIGURATION STATEMENTS This section outlines the available configuration statements. debug | verbose Enables debugging or verbose mode. See DIAGNOSTICS below for details. Both debug and verbose can be specified at the same time. device name Use name as the device to configure. dump path Dump a list of configured networks to path. It contains one line for each access point with the following information: BSSID RSSI encrypted? known? SSID.. There is no default path, which means that if no dump statement is given, the list of networks is not written out. include path Includes the file path at the point where the include statement appears in the file. open nwid Defines an unencrypted network. wpa nwid password|hexkey Defines a WPA2 network. 802.1x nwid Defines a WPA2 network that uses IEEE 802.1x as the key management scheme. This requires using wpa_supplicant(8) to handle the actual key management. FILES /etc/wireless.conf configuration file DIAGNOSTICS If the keyword verbose is given in the configuration file, the name of the network that is being configured will be printed to the standard error stream. The keyword debug enables behaviour that helps debugging. Its meaning will change without prior notice, so it should not be used outside of development. SEE ALSO ifconfig(8), wpa_passphrase(8), wpa_supplicant(8) AUTHORS o Gregor Best <email@example.com> o jggimi (pledging) o spedru (improvements to the wpa_supplicant(8) interface) o Klemens Nanni <firstname.lastname@example.org> (improvements to the manpage) OpenBSD 6.4 October 31, 2018 OpenBSD 6.4