Document non-determinism for binding systemd sockets

[twisted-trac]

	@jml reported
Trac ID	trac#8146
Type	enhancement
Created	2015-12-18 12:33:42Z

The systemd documentation says:

If multiple socket units activate the same service, the order of the file descriptors passed to its main process is undefined.

(see http://www.freedesktop.org/software/systemd/man/sd_listen_fds.html)

This means that if a Twisted process uses multiple systemd endpoints, it cannot be sure that the right sockets are bound to the right services.

We should document this limitation in Twisted.

c.f. https://clusterhq.atlassian.net/browse/FLOC-3712.

Searchable metadata

trac-id__8146 8146
type__enhancement enhancement
reporter__jml jml
priority__low low
milestone__None None
branch__ 
branch_author__ 
status__new new
resolution__None None
component__core core
keywords__documentation documentation
time__1450442022165513 1450442022165513
changetime__1450442022165513 1450442022165513
version__None None
owner__None None