genode/repos/os/src/server/nic_bridge
Josef Söntgen dd47129bef nic session: link-state change handling
A Nic::Session client can install a signal handler that is used to
propagate changes of the link-state by calling 'link_state_sigh()'.
The actual link state is queried via 'link_state()'.

The nic-driver interface now provides a Driver_notification callback,
which is used to forward link-state changes from the driver to the
Nic::Session_component.

The following drivers now provide real link state: dde_ipxe, nic_bridge,
and usb_drv. Currently, OpenVPN, Linux nic_drv, and lan9118 do not
support link state and always report link up.

Fixes #1327
2015-03-27 11:53:13 +01:00
..
README Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
address_node.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
avl_safe.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
component.cc nic session: link-state change handling 2015-03-27 11:53:13 +01:00
component.h nic session: link-state change handling 2015-03-27 11:53:13 +01:00
env.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
env.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
list_safe.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
mac.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
mac.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
main.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
nic.cc nic session: link-state change handling 2015-03-27 11:53:13 +01:00
nic.h nic session: link-state change handling 2015-03-27 11:53:13 +01:00
packet_handler.cc nic session: link-state change handling 2015-03-27 11:53:13 +01:00
packet_handler.h nic session: link-state change handling 2015-03-27 11:53:13 +01:00
target.mk Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
vlan.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00

README

The NIC bridge provides multiple sessions of the 'Nic' service while using a
single 'Nic' session for forwarding requests. It implements a flavour of the
Proxy-ARP protocol (rfc1027). That means it allocates a virtual MAC address for
each client. Whenever a client sends a packet, NIC bridge changes the sender's
MAC address to the one it memorized for the client. Moreover, it monitors DHCP
packets, and tracks the IP addresses assigned to each of its clients. Whenever
ARP packets come from the outside, NIC bridge will answer them with the
corresponding MAC address.

By adding a 'mac' attribute to the 'nic_bridge' config node: one can define the
first MAC address from which the NIC bridge will allocate MACs for its clients.
For example:
! <config mac="02:02:02:02:02:00"/>
Note that the least relevant byte will be ignored. NIC bridge will use it for
enumerating its clients, starting from 0.

Normally, NIC bridge is expected to be used in scenarios where an DHCP server
is available. However, there are situations where the use of static IPs for
virtual NICs is useful. For example, when using the NIC bridge to create a
virtual network between the lighttpd web server and the Arora web browser, both
running as Genode processes without real network connectivity.

The static IP can be configured per client of the NIC bridge using a '<policy>'
node of the configuration. For example, the following policy assigns a static
address to a client with the session label "lighttpd".
!<start name="nic_bridge">
!  ...
!  <config>
!    <policy label="lighttpd" ip_addr="10.0.2.55"/>
!  </config>
!</start>

Of course, the client needs to configure its TCP/IP stack to use the assigned
IP address. This can be done via configuration arguments examined by the
'lwip_nic_dhcp' libc plugin. For the given example, the configuration for the
lighttpd process would look as follows.
!<start name="lighttpd">
!  <config>
!    <interface ip_addr="10.0.2.55"
!               netmask="255.255.255.0"
!               gateway="10.0.2.1"/>
!  </config>
!</start>