Incorporate `hostapd`.

The inclusion of `hostapd` [1] brings a lot of related changes
because the build process have to extended to take the challenge.

- Convert `wpa_passthru` to a more a generic services, called
  `uds_passthru` to deal with the control socket forwarding.
  It can also log the `socat` errors properly.
- Make the `Makefile` more parametric therefore the virtual disk
  image can be customized better.
- Default configurations are now moved fully to the guest's side.
- Tweak the packages to be more flexible.
- Document everything.

[1] https://w1.fi/hostapd/

1 files changed, 35 insertions, 0 deletions

diff --git a/etc/hostapd/appliance/interfaces.conf.sample b/etc/hostapd/appliance/interfaces.conf.sample
new file mode 100644
index 0000000..d346368
--- /dev/null
+++ b/etc/hostapd/appliance/interfaces.conf.sample
@@ -0,0 +1,35 @@
+# This is an iface stanza for interfaces(5) with relatively sane
+# defaults.  Consult http://manpages.org/etc-network-interfaces/5 for
+# more.
+#
+# The `eth0` networking interface represents the virtual Ethernet card
+# of the guest, which is shared with the host.  The `gateway` IP
+# address should match with the address as it was configured on the
+# host, and `address` is the guest's own address.  In addition to
+# this, it is recommended to setup a NAT between `wifibox0` and the
+# interface that faces towards the Internet.  This can be done with
+# the help of pf(4) for example.  Here is sample configuration, see
+# pf.conf(5) for more information.
+#
+#     wlan_if="wifibox0"
+#     lan_if="em0"
+#     virt_net="10.0.0.0/24"
+#
+#     scrub all
+#     nat on $lan_if from $virt_net to any -> $lan_if
+#     pass log all
+#
+# Change these values as desired, they are here only for inspiration.
+
+iface eth0 inet static
+  gateway 10.0.0.1
+  address 10.0.0.2/24
+
+# The `wlan0` networking interface is associated with the wireless
+# networking card as it is exposed by the driver.  By this default
+# configuration, the corresponding IP address is statically set to
+# make it the gateway for the wireless network, see the contents of
+# udhcp.conf for the rest.
+
+iface wlan0 inet static
+  address 192.168.0.1/24