about summary refs log tree commit diff
path: root/contrib/README
diff options
context:
space:
mode:
authorAlexander Barton <alex@barton.de>2013-02-04 21:46:20 +0100
committerAlexander Barton <alex@barton.de>2013-02-04 21:52:27 +0100
commit8ab097afb743061c6c9b865bdb401ba51285c347 (patch)
tree8b0691d84cc2a49eeee7c30285f623fa6abf252a /contrib/README
parent84e24afd2f6607a2345c4df2b2f9ad81e9dd4bbc (diff)
downloadngircd-8ab097afb743061c6c9b865bdb401ba51285c347.tar.gz
ngircd-8ab097afb743061c6c9b865bdb401ba51285c347.zip
Implement support for systemd(8) "socket activation"
This patch enables ngIRCd to work with listening sockets already
initialized and passed-in by systemd(8) and hereby to support on-demand
"socket activation".

systemd(8) uses two environment variables to pass information about the
sockets to ngIRCd, LISTEN_PID and LISTEN_FDS, and this mechanism only
kicks in when both variables are set. In all other cases, and therefore
in most installations out there, nothing changes at all.

Please note:
If socket activation is in effect, ngIRCd will not initialize any (other)
soeckets on its own! All sockets must be configured in the systemd(8)
socket unit configuration file in this case, see ./contrib/ngircd.socket
for example.

Probably it would be interesting to match passed-in sockets to configured
listening sockets and to initialize all the remaining ones not already
set up by systemd(8), but this is kept back for an other patch ...

See
 - <http://0pointer.de/blog/projects/socket-activation.html>
 - <http://0pointer.de/blog/projects/socket-activation2.html>
 - <http://www.freedesktop.org/software/systemd/man/systemd.socket.html>
Diffstat (limited to 'contrib/README')
-rw-r--r--contrib/README3
1 files changed, 3 insertions, 0 deletions
diff --git a/contrib/README b/contrib/README
index f3730a4e..2d639e66 100644
--- a/contrib/README
+++ b/contrib/README
@@ -30,6 +30,9 @@ ngircd-redhat.init
 ngircd.service
  - systemd(8) service unit configuration file.
 
+ngircd.socket
+ - systemd(8) socket unit configuration file for "socket activation".
+
 ngircd.spec
  - RPM "spec" file.