diff options
| author | Lennart Poettering <lennart@poettering.net> | 2010-07-10 00:49:00 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2010-07-10 00:49:00 +0200 |
| commit | 828f33e89bc2fa7ee9bc9f977c04d0e30336d848 (patch) | |
| tree | 41550cb67044872fd860d94c3ec1fb6a9fe93647 | |
| parent | 83bda35801aa3d7ed180ec374a4bcdfe9dc1a8e4 (diff) | |
man: update daemon man page a little
| -rw-r--r-- | fixme | 6 | ||||
| -rw-r--r-- | man/daemon.xml | 49 |
2 files changed, 46 insertions, 9 deletions
@@ -35,16 +35,14 @@ * selinux -* .socket should refuse start when .service is already up to avoid overwriting the socket - * introduce umount.target * pull in umount.target and shutdown.target from emergency.service (?) -* extend recommendations to depend on syslog.target via "After" - * Don't show Accepted/Connected for non-Accept sockets +* Show exit status auf auxiliary programs in systemctl status + External: * patch /etc/init.d/functions with: diff --git a/man/daemon.xml b/man/daemon.xml index b708bdcfba..fb22e6c616 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -678,7 +678,8 @@ <listitem><para>If your daemon registers a D-Bus name on the bus, make sure to use - <varname>Type=dbus</varname> if + <varname>Type=dbus</varname> in the + service file if possible.</para></listitem> <listitem><para>Make sure to set a @@ -703,16 +704,45 @@ operating system-independent.</para></listitem> + <listitem><para>Since not all syslog + implementations are socket-activatable + yet, it is recommended to place an + <varname>After=syslog.target</varname> + dependency in service files for + daemons that can log to + syslog. <filename>syslog.target</filename> + then either pulls in the syslog daemon + itself or simply the activation + socket. A <varname>Wants=</varname> or + even <varname>Requires=</varname> + dependency should generally not be + added, since it should be up to the + administrator whether he wants to + enable logging or not, and most syslog + clients work fine if no log daemon is + running.</para></listitem> + <listitem><para>Make sure to include - an <literal>[Install]</literal> section including - installation information for the unit - file. See + an <literal>[Install]</literal> + section including installation + information for the unit file. See <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details. To activate your service on boot make sure to add a <varname>WantedBy=multi-user.target</varname> or - <varname>WantedBy=graphical.target</varname> directive.</para></listitem> + <varname>WantedBy=graphical.target</varname> + directive. To activate your socket on + boot, make sure to add + <varname>WantedBy=sockets.target</varname>. Usually + you also want to make sure that when + your service is installed your socket + is installed too, hence add + <varname>Also=foo.socket</varname> in + your service file + <filename>foo.service</filename>, for + a hypothetical program + <filename>foo</filename>.</para></listitem> </orderedlist> </refsect2> @@ -800,6 +830,15 @@ if [ "$1" -eq 0 ]; then /usr/bin/systemd-install --realize disable foobar.service foobar.socket >/dev/null 2>&1 || : fi</programlisting> + <para>Depending on whether your service should + or should not be started/stopped/restarted + during package installation, deinstallation or + upgrade, a different argument to + <option>--realize=</option> may be + specified. See + <citerefentry><refentrytitle>systemd-install</refentrytitle><manvolnum>1</manvolnum></citerefentry> + for details.</para> + </refsect2> </refsect1> |