Creating Known WLANs

Known WLANs are profiles that store information about wireless networks that are known to your system. NCPs are able to automatically configure wireless interfaces based on configuration information that is supplied by each of the wireless networks to which the system is connected. For more information, see Description of a Known WLAN.

For information about the properties that you might specify when creating or modifying WLANs, see the netcfg(1M) man page.

How to Create a Known WLAN Interactively

1. Initiate the netcfg interactive session.

   $ netcfg
   netcfg>

2. Create the Known WLAN.

   The following example creates a Known WLAN that connects to a wireless network named ESSID. The Known WLAN must have the same name as the wireless network name or its ESSID:

   netcfg> create wlan mywifi
   Created wlan 'mywifi'.  Walking properties ...
   priority (0)> 100
   bssids>
   keyname> mywifi-key
   keyslot>
   security-mode [none|wep|wpa]> wpa
   netcfg:wlan:mywifi>

   Creating the WLAN automatically moves you into the profile scope for the WLAN and walks you through each of its properties.

   In this example, the following properties are specified for the mywifi Known WLAN:

   • The value of the priority property is changed from a default value of 0 to 100.

   • The keyname property is set to mywifi-key and specifies the name of the secure object for this wireless network. See Establishing Secure WiFi Communications for more information.

   • The security-mode property is set to wpa. This property specifies the type of encryption that is used by this wireless network.

   • The keyslot and bssid property values are left empty.

3. (Optional) Display the profile configuration.

   netcfg:wlan:mywifi> list
   known wlan:mywifi
   	priority 		100
   	keyname "mywifi-key"
   	security-mode    wpa
   netcfg:wlan:mywifi>

4. Verify that the profile configuration is correct.

   netcfg:wlan:mywifi> verify
   All properties verified

   The verify subcommand verifies the configuration and notifies you if any required values are missing.

5. Save the Known WLAN.

   netcfg:wlan:mywifi> commit
   Committed changes

   The commit subcommand verifies and saves the configuration.

   Alternatively, you can use the end subcommand to end the session, which also saves the profile configuration and moves the session to the global scope.

   netcfg:wlan:mywifi> end
   Committed changes
   netcfg>

6. Exit the interactive session.

   netcfg> exit