Christoph Biedl bb9a8c4e04 softflowd 1.0.0-2 4 years ago
..
patches 7882323be5 Install programs in /usr/sbin. Closes: #935404 4 years ago
source 004be564e3 Rework Debianisation 13 years ago
README.Debian 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
changelog bb9a8c4e04 softflowd 1.0.0-2 4 years ago
control d926f652f4 Packaging maintenance 4 years ago
copyright 705107268b Packaging cleanup 5 years ago
default.conf 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
rules 30e7829109 Drop change-chroot-dir patch, can be handled using a configure option as well 5 years ago
softflowd-generator 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
softflowd.docs 68f151764b No longer ship upstream's TODO file 5 years ago
softflowd.init 65bf2a7316 Improve init script 5 years ago
softflowd.install 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
softflowd.maintscript 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
softflowd.service 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
softflowd.tmpfile f25053c3c7 Make /etc/protocols available inside the chroot 5 years ago
softflowd@.service 0a300a9ab3 Add support for multiple instances, and native systemd support 5 years ago
watch 08abc48645 Update watch file 4 years 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.