Christoph Biedl be620a04b6 softflowd 0.9.9-5 3 months ago
..
patches 6ed0c3d4b6 Cherry-pick most upstream commits since the last release 5 months ago
source 004be564e3 Rework Debianisation 8 years ago
README.Debian 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
changelog be620a04b6 softflowd 0.9.9-5 3 months ago
compat 705107268b Packaging cleanup 5 months ago
control f25053c3c7 Make /etc/protocols available inside the chroot 5 months ago
copyright 705107268b Packaging cleanup 5 months ago
default.conf 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
rules 30e7829109 Drop change-chroot-dir patch, can be handled using a configure option as well 5 months ago
softflowd-generator 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
softflowd.docs 68f151764b No longer ship upstream's TODO file 5 months ago
softflowd.init 65bf2a7316 Improve init script 4 months ago
softflowd.install 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
softflowd.maintscript 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
softflowd.preinst 42bed11024 Don't migrate legacy config if it wasn't modified. Closes: #910214 3 months ago
softflowd.service 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
softflowd.tmpfile f25053c3c7 Make /etc/protocols available inside the chroot 5 months ago
softflowd@.service 0a300a9ab3 Add support for multiple instances, and native systemd support 5 months ago
watch 08fb0bc87c Update watch file 5 months ago

README.Debian


Multiple softflowd instances
============================

Starting with version 0.9.9-4, the Debian packaging of softflowd
supports handling of multiple instances. One instance is already
shipped as `/etc/softflowd/default.conf` (which is a re-used
`/etc/default/softflowd` when upgrading from an older version).

To add more instances, create a file `/etc/softflowd/.conf`
where `` should be constructed using the "Portable Filename
Character Set"[1] and must not start with a dot (i.e. hidden file).

The file is a POSIX shell fragment and defines two variables:

* interface: The interface to listen on, or `all`
Without an interface definition, the instance will be ignored.
* options: Additional options to pass to softflowd.

On systemd, the file is read as a key/value store, for details see
`EnvironmentFile=` systemd.exec(5).

On SysV init, the file is run as a shell script.


The pidfile will be stored at `/run/softflowd/.pid`[2], do not
attempt to override that. The control socket for softflowctl is at
`/run/softflowd/.ctl`. You still may override these using the
`-c` options in the options= string, last match wins.

The softflowctl program will query the "default" instance by default.


To add a new instance:

Create an according configuration file first.

On systemd, run `systemctl daemon-reload`, then
`systemctl start softflowd@.service`.

On SysV init, run `serivce softflowd start `.


[1] Upper and lower case characters, digits, dot, underscore, dash.
For pure visual reasons, the dash should be avoided on systemd as
it's escaped in the service name.
http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_282
[2] On SysV init systems: `/var/run/softflowd/.pid`, likewise
for the control socket.