diff options
| author | Lennart Poettering <lennart@poettering.net> | 2010-08-06 11:59:37 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2010-08-06 11:59:37 +0200 |
| commit | 6908d3842a3b69b90106646a16f51a6b089026bd (patch) | |
| tree | 51c646f8e2400baa0fd38fa587f65e55b2eae568 | |
| parent | ee6cb28869d94f25a79f2c7cd29f1574c590036c (diff) | |
man: document %triggerin usage
| -rw-r--r-- | man/daemon.xml | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/man/daemon.xml b/man/daemon.xml index 30d39d7be1..007ec95b97 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -828,6 +828,10 @@ endif</programlisting> if [ $1 -eq 1 ]; then # Enable (but don't start) the units by default /bin/systemctl enable foobar.service foobar.socket >/dev/null 2>&1 || : + + # Alternatively, just call /bin/systemctl daemon-reload here, + # if the daemon should not be enabled by default on package + # installation fi %preun @@ -853,6 +857,29 @@ fi</programlisting> <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry> for details.</para> + <para>To facilitate upgrades from a package + version that shipped only SysV init scripts to + a package version that ships both a SysV init + script and a native systemd service file, use + a fragment like the following:</para> + + <programlisting>%triggerin -- foobar < 0.47.11-1 +if /sbin/chkconfig foobar ; then + /bin/systemctl enable foobar.service foobar.socket >/dev/null 2>&1 || : +fi</programlisting> + + <para>Where 0.47.11-1 is the first package + version that includes the native unit + file. This fragment will ensure that the first + time the unit file is installed it will be + enabled if and only if the SysV init script is + enabled, thus making sure that the the enable + status is not changed. Note that + <command>chkconfig</command> is a command + specific Fedora which can be used to check + whether a SysV init script is enabled. Other + operating systems will have to use different + commands here.</para> </refsect2> </refsect1> |