There may be other unforeseen breakage primarily in the handbook portion of the wiki.
The Table Of Contents section of each "PC-BSD® Users Handbook" page may be the best workaround.
Recently a user wanted to be sure that Ethernet over USB worked, which leads to these:
- What drivers/kernel objects are loaded on the 'live' pseudo-install?
- A step by step to troubleshoot the 'live' pseudo-install such as to enable other features or devices.
- Internet connection sharing is not specifically named and does not seem to be described.
- How to setup a ether to wifi hotspot/sharing is also not mentioned.
Freebsd handbook 32.3.5 describes this configuration but its a reasonable expectation for a laptop to be able to share out its wifi while attached by ethernet cable.
This section should no longer be needed in 9.0 as both modules are included with the base system.
bwn(4) and bwi(4) Drivers
Due to licensing restrictions, the bwn and bwi drivers require that their firmware is compiled on the individual's computer. This means that Broadcom BCM43xx IEEE 802.11b/g wireless network adapters will not “just work” after installing PC-BSD.
To compile the firmware, you will need to install both the ports tree and source on your PC-BSD system. You can do so by going to Control Panel -> System Manager. After inputting the administrative password, click on the Tasks tab, seen in Figure 7.7p:
Figure 7.7p: Using System Manager to Install Ports and Source
In the "System Tasks - Advanced Users Only" section, click "Fetch System Source" if /usr/src does not currently exist on your system.
In the "System Tasks - Advanced Users Only" section, click "Fetch System Ports Tree" if /usr/ports does not currently exist on your system.
Both src and ports are large so it will take a few minutes for each fetch to finish. When the fetch is finished, compile the firmware using the instructions for the driver that you need. You will need to be the superuser in order to compile the firmware.
For the bwn driver:
cd /usr/ports/net/bwn-firmware-kmod && make install clean
This will create two kernel modules:
- bwn_v4_ucode module (used by most adapters)
- bwn_v4_lp_ucode (used by low power PHY adapters)
It's a good idea to test which module is used by your adapter, so type:
If that command just gives your prompt back without an error, that is the correct module. If you receive an error, try loading the low power module instead which should just give you your prompt back without an error:
Now carefully add the following two lines to /boot/loader.conf:
Note: replace bwn_v4_ucode_load="YES" with bwn_v4_lp_ucode_load="YES" if your adapter is a low power one.
For the bwi driver:
cd /usr/ports/net/bwi-firmware-kmod && make install clean
This will create the following kernel module:
To load the module:
And carefully add the following line to /boot/loader.conf so the module will automatically load whenever you boot: