File: README.md

package info (click to toggle)
sasa 0.4-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 168 kB
  • sloc: ansic: 400; sh: 191; python: 36; makefile: 34
file content (58 lines) | stat: -rw-r--r-- 2,165 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# standalone socket-activate (sasa) #

This project provides a standalone C implementation of systemd-style
socket-activation for use on Unix-based systems that don't have systemd
installed.

It uses the simple [`sd_listen_fds` environment variable and file
descriptor
convention](https://manpages.debian.org/unstable/systemd/sd_listen_fds.3.en.html)
introduced by
[systemd](https://www.freedesktop.org/wiki/Software/systemd/), without
using any code or dependencies from systemd.

See the [socket-activate manpage](./socket-activate.md) for more information.


## Code and Issues ##

The source code is available at
https://git.devuan.org/leepen/standalone-socket-activate where bug reports can
be made and pull requests are welcome.

## Dependencies ##

 - make
 - C compiler [tested with gcc]
 - pandoc [for manpage only]
 - diff, python3, netcat (openbsd) [for [tests](./tests) only]

## Similar work ##

[systemd](https://www.freedesktop.org/wiki/Software/systemd/) offers
`systemd-socket-activate`, but that code is only for testing and has a few
drawbacks that hopefully this project avoids:

 - The systemd project itself doesn't build on non-Linux systems.
 
 - `systemd-socket-activate` doesn't allow for multiple sockets of
   different types.

## Authors ##

This implementation of `socket-activate` is written by Mark Hindley
<mark@hindley.org.uk> based on an initial C implementation by Peter Pentchev
<roam@ringlet.net>. The [original Python 3
implementation](https://gitlab.com/dkg/socket-activate) was written by Daniel
Kahn Gillmor <dkg@fifthhorseman.net>.

It is licensed under the [GPL version 3 or
later](https://www.gnu.org/licenses/gpl.html)

## References ##

 * [systemd Socket Activation, part 1](http://0pointer.de/blog/projects/socket-activation.html)
 * [systemd Socket Activation, part 2](http://0pointer.de/blog/projects/socket-activation2.html)
 * [Debian bug report asking for non-systemd socket activation](https://bugs.debian.org/922082)
 * [systemd-socket-activate documentation](https://manpages.debian.org/unstable/systemd/systemd-socket-activate.1.en.html)
 * [Python 3 implementation](https://gitlab.com/dkg/socket-activate)