Christoph Biedl b1144d72cd softflowd 1.0.0-1 2 days ago
..
patches e11833c79b Drop patches cherry-picked from upstream 2 days ago
source 004be564e3 Rework Debianisation 8 years ago
README.Debian 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
changelog b1144d72cd softflowd 1.0.0-1 2 days ago
control d926f652f4 Packaging maintenance 2 days ago
copyright 705107268b Packaging cleanup 11 months ago
default.conf 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
rules 30e7829109 Drop change-chroot-dir patch, can be handled using a configure option as well 11 months ago
softflowd-generator 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
softflowd.docs 68f151764b No longer ship upstream's TODO file 11 months ago
softflowd.init 65bf2a7316 Improve init script 10 months ago
softflowd.install 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
softflowd.maintscript 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
softflowd.service 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
softflowd.tmpfile f25053c3c7 Make /etc/protocols available inside the chroot 11 months ago
softflowd@.service 0a300a9ab3 Add support for multiple instances, and native systemd support 11 months ago
watch 08abc48645 Update watch file 4 days 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.