From 6bc0ca2f2858271feb36d58ae077bad24a996bed Mon Sep 17 00:00:00 2001 From: Matthias Schiffer Date: Fri, 25 Mar 2016 01:36:23 +0100 Subject: doc: add preliminary v18 release notes --- doc/source/releases/v18.rst | 73 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 doc/source/releases/v18.rst (limited to 'doc/source/releases/v18.rst') diff --git a/doc/source/releases/v18.rst b/doc/source/releases/v18.rst new file mode 100644 index 0000000..7683836 --- /dev/null +++ b/doc/source/releases/v18.rst @@ -0,0 +1,73 @@ +fastd v18 (in development) +========================== + +New features +~~~~~~~~~~~~ + +Multi-interface modes +--------------------- + +A single fastd instance can now manage multiple TUN/TAP interfaces. This allows to +use multiple peers and peer directories in TUN mode, creating one interface for each +peer. *on-up* and *on-down* scripts are run once for each interface. + +By default, all interfaces are created on startup or peer reload; the option +*interface persist* can be used to change this behaviour. + +In addition to the multi-peer TUN mode, it is also possible to make fastd create one +interface per peer in TAP mode now. This is enabled by the setting *mode multitap* +(the option for multi-interface TUN mode is just *mode tun*, as there is no TUN mode +which handles multiple peers on a single interface.) + +Multi-TAP mode is compatible with TAP mode, i.e. the peer may be configured in normal +TAP mode (and may use a fastd version without multi-TAP support. + +If explicit interface names are configured, these names must now be set for each peer, +which may either be done explicitly, or using :ref:`name patterns `. + +Peer-specific interfaces may also be configured with peer-specific MTUs. + +Interface cleanup on FreeBSD/OpenBSD +------------------------------------ + +FreeBSD and OpenBSD do not automatically destroy TUN/TAP interfaces. fastd will +now destroy the interfaces it creates on these systems on exit. + +Improved capability management +------------------------------ + +fastd will now automatically retain all POSIX capabilities it needs, so all options +should now work without full root privileges. + +The option *drop capabilities force* may be used to drop CAP_NET_ADMIN even when +fastd would normally retain it. + +More powerful peer groups +------------------------- + +All *on-\** options may now be overridden per peer group. + +In particular, the *on-verify* option may be moved into a peer group to determine +the peer group of unconfigured peers. This allows to set a peer limit for unconfigured +peers without globally limiting the peer count. + +Bugfixes +~~~~~~~~ + +* When linked with NaCl instead of libsodium, fastd would use SSE for salsa20/salsa2012 on x86 even after + determining that SSE is not availble. This led to crashes or transmission + failures on CPUs like the Geode. +* Fix crash on x86-64 systems when built with certain combinations of GCC version and + stack-protector compiler flags (observed on Fedora) +* fastd did reject configurations which contain neither static peers nor + peer directories, but a *on-verify* option +* The status socket is now removed correctly if fastd exits with an error message +* fastd did exit with regular exit code 0 instead of re-raising the termination signal after cleanup +* Fix in-tree compile on non-Linux systems + +Other changes +~~~~~~~~~~~~~ + +* Some error conditions that can't be recovered from will now cause fastd + to exit instead of just logging an error message. This allows service managers like systemd/procd + to restart fastd, so proper operation can be restored. -- cgit v1.2.3