Christoph Biedl 269458bcc4 softflowd 1.1.0-2 4 months ago
..
patches f15d886ff8 Drop patch, applied upstream 2 years ago
source 004be564e3 Rework Debianisation 13 years ago
README.Debian 2b6ba99679 Reword README.Debian 2 years ago
changelog 269458bcc4 softflowd 1.1.0-2 4 months ago
control 0e066a5e54 Packaging cleanup 4 months ago
copyright 0585be613e Update copyright notices to 2024 10 months ago
default.conf 0a300a9ab3 Add support for multiple instances, and native systemd support 6 years ago
rules 30e7829109 Drop change-chroot-dir patch, can be handled using a configure option as well 6 years ago
softflowd-generator f1dad4da08 Reformat shell scripts 2 years ago
softflowd.docs 68f151764b No longer ship upstream's TODO file 6 years ago
softflowd.init f1dad4da08 Reformat shell scripts 2 years ago
softflowd.install 13f669e0b8 No longer install any files in /lib. Closes: #1073743 4 months ago
softflowd.maintscript 0a300a9ab3 Add support for multiple instances, and native systemd support 6 years ago
softflowd.service 0a300a9ab3 Add support for multiple instances, and native systemd support 6 years ago
softflowd.tmpfiles 0e066a5e54 Packaging cleanup 4 months ago
softflowd@.service 0a300a9ab3 Add support for multiple instances, and native systemd support 6 years ago
watch a2e2836451 Update watch file 2 years ago

README.Debian


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

The Debian packaging of softflowd supports handling of multiple
instances. One instance is already shipped as
`/etc/softflowd/default.conf`.

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. must not be a
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.
https://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.