summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2010-10-26 23:22:55 +0200
committerLennart Poettering <lennart@poettering.net>2010-10-26 23:22:55 +0200
commit248e6030e007b6ee7b31ada6e42053cb1ebfc80d (patch)
treef384c0a1367ae41c3176cd741e4f997d1e870b0f
parentcbe1bded5fb719faf374bf63d36a80c6d13d2b19 (diff)
man: be more explicit about the usefulness of --system
-rw-r--r--TODO2
-rw-r--r--man/systemd.xml14
2 files changed, 10 insertions, 6 deletions
diff --git a/TODO b/TODO
index c018ed23ea..f41dd3c896 100644
--- a/TODO
+++ b/TODO
@@ -1,5 +1,3 @@
-* man: clarify that --system works only for pid == 1
-
* oneshot services which do not remain: 'exited' instead of 'dead'?
it should be visible in 'systemctl' that they have been run
diff --git a/man/systemd.xml b/man/systemd.xml
index f0fea5d0fe..6aa4f70527 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -141,14 +141,20 @@
<listitem><para>Tell systemd to run a
system instance (resp. session
instance), even if the process ID is
- not 1 (resp. is 1), i.e. systemd is not
- (resp. is) run as init process.
+ not 1 (resp. is 1), i.e. systemd is
+ not (resp. is) run as init process.
Normally it should not be necessary to
pass these options, as systemd
automatically detects the mode it is
started in. These options are hence of
- little use except for
- debugging.</para></listitem>
+ little use except for debugging. Note
+ that it is not supported booting and
+ maintaining a full system with systemd
+ running in <option>--system</option>
+ mode, but PID not 1. In practice,
+ passing <option>--system</option> explicitly is
+ only useful in conjunction with
+ <option>--test</option>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--dump-core</option></term>