|
Documentation Home for Devicescape Universal Wireless Platform | Package Guide
client_bridge package
Information on this package is covered here.
|
Package
|
Description
|
License
|
|
client_bridge
|
Devicescape client bridge module.
|
|
Summary
The client_bridge module extends a standard client (wpa_supplicant package) by providing the following additional features:
- Allows multiple wired devices to share a single wireless client connection.
- Handles DHCP proxy, so that each wired device can request its own IP address.
- Handles ARP proxy, so that devices in the main network can find devices "behind" the bridge.
Runtime and Start/Stop Options
Loading the module will enable it for all Linux bridges in the system.
Use the following commmands to control the client bridge on the target device.
|
Action
|
Command
|
|
Start
|
/etc/init.d/client_bridge start
|
|
Stop
|
/etc/init.d/client_bridge stop
|
|
Restart
|
/etc/init.d/client_bridge restart
|
The client bridge module has no initialization time configuration parameters, but it can be enabled or disabled from the /etc/default/wireless file. In that file, set CLIENT_BRIDGE to "yes" to enable the client bridge function, or "no" to disable it.
The client bridge profile package (ds-wireless-client-bridge) enables the client bridge module this way.
Build Options
The following table shows build time options for the client_bridge package. The build time options for the client bridge can only be changed by editing the client_bridge.h header file included in the source bundle. By default all options are disabled.
|
Option
|
Description
|
|
CONFIG_CB_USE_PRINTK
|
Enable warning/error messages
|
|
CONFIG_CB_SET_CLIENT_HA
|
Set the client hardware address field in DHCP discovery frames
|
|
CONFIG_CB_ADD_OPTION_61
|
Enable use of option 61 for identifying clients
Note: The option 61 approach to identifying different clients that are using the same MAC address does not work with many embedded DHCP servers (including the udhcpd daemon that is part of the Devicescape™ Universal Wireless Platform). It is recommended that this, and the CONFIG_CB_SET_CLIENT_HA option are left disabled.
|
Building the Package
See the Devicescape Developer Guide topic on "Building the Packages", see subtopic:
"Building a Kernel Module from a Source RPM"
Limitations
Currently it will affect all bridges in the system, whether that is desired or not.
It can only handle IP traffic plus DHCP and ARP. Other (non-IP) protocols will not be able to pass through the bridge correctly.
Licensing
GPL2 (GNU General Public License, v.2)
Related Packages
Required
bridge-utils package (see Quick View of All Packages)
ds-wireless-client-bridge package (see Quick View of All Packages)
wpa_supplicant package
Suggested
None
| 
