diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-01-12 19:03:32 +0100 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-01-12 19:12:15 +0100 |
| commit | d89cde0994745091cee920f2fd5bd090e35fefc7 (patch) | |
| tree | 7bceb8c7ccff3ce21bdedd3245deb63ba97bbb6c /docs | |
| parent | docs: say that dbus api is stable (but list various caveats) (diff) | |
| download | systemd-d89cde0994745091cee920f2fd5bd090e35fefc7.tar.xz systemd-d89cde0994745091cee920f2fd5bd090e35fefc7.zip | |
docs: say that various cli progs are independent of pid1
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/PORTABILITY_AND_STABILITY.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/PORTABILITY_AND_STABILITY.md b/docs/PORTABILITY_AND_STABILITY.md index ceb82dba3c..1a3b821181 100644 --- a/docs/PORTABILITY_AND_STABILITY.md +++ b/docs/PORTABILITY_AND_STABILITY.md @@ -128,3 +128,26 @@ If you decide to reimplement one of the APIs for which "Reimplementable independ This is not an attempt to comprehensively list all users of these APIs. We are just listing the most obvious/prominent ones which come to our mind. Of course, one last thing I can't make myself not ask you before we finish here, and before you start reimplementing these APIs in your distribution: are you sure it's time well spent if you work on reimplementing all this code instead of just spending it on adopting systemd on your distro as well? + +## Independent operation of systemd programs + +Some programs in the systemd suite are indended to operate independently of the +running init process (or even without an init process, for example when +creating system installation chroots). They can be safely called on systems with +a different init process or for example in package installation scriptlets. + +The following programs currently and in the future will support operation +without communicating with the `systemd` process: +`systemd-escape`, +`systemd-id128`, +`systemd-path`, +`systemd-tmpfiles`, +`systemd-sysctl`, +`systemd-sysusers`. + +Many other programs support operation without the system manager except when +the specific functionality requires such communication. For example +`journalctl` operates almost independently, but will query the boot id when +`--boot` option is used. `systemd-journal-remote`, `systemd-journal-upload`, +`systemd-journal-gatewayd`, `coredumpctl`, `busctl`, `systemctl --root` also +fall into this category. |