1
0
mirror of https://github.com/systemd/systemd.git synced 2024-11-06 16:59:03 +03:00
The systemd System and Service Manager
Go to file
Michal Schmidt 3a11183858 service: handle services with racy daemonization gracefully
There are a lot of forking daemons that do not exactly follow the
initialization steps as described in daemon(7). It is common that they
do not bother waiting in the parent process for the child to write the
PID file before exiting. The daemons' developers often do not perceive
this as a bug and they're unwilling to change.

Currently systemd warns about the missing PID file and falls back to
guessing the main PID. Being not quite deterministic, the guess can be
wrong with bad consequences. If the guessing is disabled, determinism is
achieved at the cost of losing the ability of noticing when the main
process of the service dies.

As long as it does not negatively affect properly written services,
systemd should strive for compatibility even with services with racy
daemonization. It is possible to provide determinism _and_ main process
supervision to them.

If the PID file is not there, rather than guessing and considering the
service running immediately after getting the SIGCHLD from the ExecStart
(or ExecStartPost) process, we can keep the service in the activating
state for a bit longer. We can use inotify to wait for the PID file to
appear. Only when it finally does appear and we read a valid PID from
it, we'll move the service to the running state. If the PID file never
appears, the usual timeout kicks in and the service fails.
2011-12-03 21:50:27 +01:00
m4 git: hide more files from git 2011-07-14 23:52:16 +02:00
man path: add PathModified (= PathChanged + IN_MODIFY) 2011-12-03 13:58:21 +01:00
po l10n: Reword the polish translation a bit 2011-10-11 03:13:40 +02:00
src service: handle services with racy daemonization gracefully 2011-12-03 21:50:27 +01:00
test1 exec: replace OOMAdjust= by OOMScoreAdjust= to follow new kernel interface 2010-08-31 01:33:43 +02:00
test2 test: update test-engine.c to work again 2010-06-03 03:01:29 +02:00
tmpfiles.d tmpfiles: Move /tmp and /var/tmp to a separate tmpfiles.d file to ease overrides via /etc 2011-08-24 20:39:33 +02:00
units rc-local: order after network.target 2011-12-02 11:32:52 +01:00
.dir-locals.el Keep emacs configuration in one configuration file. 2011-03-08 01:53:46 +01:00
.gitignore stdout-bridge: rename logger to stdout-syslog-bridge to make it more descriptive 2011-08-30 22:42:49 +02:00
.mailmap git: add .mailmap 2011-05-19 14:06:02 +02:00
autogen.sh libsystemd-daemon: support installation in --with-rootlibdir 2011-07-15 01:31:06 +02:00
CODING_STYLE Spelling Corrections 2011-02-28 22:47:38 +01:00
configure.ac Merge remote-tracking branch 'zbigniew/systemadm_changes' 2011-11-02 14:08:49 +01:00
DISTRO_PORTING main: replace --running-as= by --session and --system do mimic related tools and D-Bus 2010-07-13 18:57:58 +02:00
introspect.awk build-sys: allow cross-compilation 2010-11-23 22:38:55 +01:00
libsystemd-daemon.pc.in libs: add symbol versioning for the benefit of RPM 2011-07-14 23:49:37 +02:00
libsystemd-login.pc.in logind: introduce libsystemd-login.so as fast path to access logind data 2011-07-14 22:51:28 +02:00
LICENSE license: add GPLv2+ license blurbs everwhere 2010-02-03 13:03:47 +01:00
Makefile.am add a generator to pull rc-local.service in 2011-12-02 11:29:48 +01:00
README README: explain dependency on cgroups 2011-11-01 13:52:46 +01:00
systemd.pc.in logind: introduce libsystemd-login.so as fast path to access logind data 2011-07-14 22:51:28 +02:00
TODO update TODO 2011-11-03 19:55:36 +01:00

systemd System and Session Manager

DETAILS:
        http://0pointer.de/blog/projects/systemd.html

WEB SITE:
        http://www.freedesktop.org/wiki/Software/systemd

GIT:
        git://anongit.freedesktop.org/systemd
        ssh://git.freedesktop.org/git/systemd

GITWEB:
        http://cgit.freedesktop.org/systemd/

MAILING LIST:
        http://lists.freedesktop.org/mailman/listinfo/systemd-devel
        http://lists.freedesktop.org/mailman/listinfo/systemd-commits

IRC:
        #systemd on irc.freenode.org

BUG REPORTS:
        https://bugs.freedesktop.org/enter_bug.cgi?product=systemd

AUTHOR:
        Lennart Poettering with major support from Kay Sievers

LICENSE:
        GPLv2+ for all code, except sd-daemon.[ch] which is MIT

REQUIREMENTS:
        Linux kernel >= 2.6.39
                with devtmpfs
                with cgroups (but it's OK to disable all controllers)
                optional but strongly recommended: autofs4, ipv6
        libudev >= 172
        dbus >= 1.4.0
        libcap
        gtk+ >= 2.20 (optional)
        PAM >= 1.1.2 (optional)
        libcryptsetup (optional)
        libaudit (optional)
        libselinux (optional)
        tcpwrappers (optional)
        libnotify (optional)

        When you build from git you need the following additional dependencies:

        vala >= 0.10
        docbook-xsl
        xsltproc
        automake
        autoconf
        libtool
        gperf
        make, gcc, and similar tools

        During runtime you need the following dependencies:

        util-linux > v2.18 (requires fsck -l, agetty -s)
        sulogin (from sysvinit-tools, optional but recommended)
        plymouth (optional)
        dracut (optional)

        When systemd-hostnamed is used it is strongly recommended to
        install nss-myhostname to ensure that in a world of
        dynamically changing hostnames the hostname stays resolveable
        under all circumstances. In fact, systemd-hostnamed will warn
        if nss-myhostname is not installed. Packagers are encouraged to
        add a dependency on nss-myhostname to the package that
        includes systemd-hostnamed.

        Note that D-Bus can link against libsystemd-login.so, which
        results in a cyclic build dependency. To accomodate for this
        please build D-Bus without systemd first, then build systemd,
        then rebuild D-Bus with systemd support.

WARNINGS:
        systemd will warn you during boot if /etc/mtab is not a
        symlink to /proc/mounts. Please ensure that /etc/mtab is a
        proper symlink.

        systemd will warn you during boot if /usr is on a different
        file system than /. While in systemd itself very little will
        break if /usr is on a separate partition many of its
        dependencies very likely will break sooner or later in one
        form or another. For example udev rules tend to refer to
        binaries in /usr, binaries that link to libraries in /usr or
        binaries that refer to data files in /usr. Since these
        breakages are not always directly visible systemd will warn
        about this, since this kind of file system setup is not really
        supported anymore by the basic set of Linux OS components.

        For more information on this issue consult
        http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken

ENGINEERING AND CONSULTING SERVICES:
        ProFUSION <http://profusion.mobi> offers professional
        engineering and consulting services for systemd for embedded
        and other use. Please contact Gustavo Barbieri
        <barbieri@profusion.mobi> for more information.

        Disclaimer: This notice is not a recommendation or official
        endorsement. However, ProFUSION's upstream work has been very
        beneficial for the systemd project.