man/systemd-rc-local-generator.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!--
   5   SPDX-License-Identifier: LGPL-2.1+
   6
   7   Copyright 2017 Lennart Poettering
   8 -->
   9 <refentry id="systemd-rc-local-generator">
  10
  11   <refentryinfo>
  12     <title>systemd-rc-local-generator</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Developer</contrib>
  18         <firstname>Lennart</firstname>
  19         <surname>Poettering</surname>
  20         <email>lennart@poettering.net</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>systemd-rc-local-generator</refentrytitle>
  27     <manvolnum>8</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>systemd-rc-local-generator</refname>
  32     <refpurpose>Compatibility generator for starting <filename>/etc/rc.local</filename> and <filename>/usr/sbin/halt.local</filename> during boot and shutdown</refpurpose>
  33   </refnamediv>
  34
  35   <refsynopsisdiv>
  36     <para><filename>/usr/lib/systemd/system-generators/systemd-rc-local-generator</filename></para>
  37   </refsynopsisdiv>
  38
  39   <refsect1>
  40     <title>Description</title>
  41
  42     <para><filename>systemd-rc-local-generator</filename> is a generator that checks whether
  43     <filename>/etc/rc.local</filename> exists and is executable, and if it is pulls the
  44     <filename>rc-local.service</filename> unit into the boot process. This unit is responsible for running this script
  45     during late boot. Note that the script will be run with slightly different semantics than the original System V
  46     version, which was run "last" in the boot process, which is a concept that does not translate to systemd. The
  47     script is run after <filename>network.target</filename>, but in parallel with most other regular system
  48     services.</para>
  49
  50     <para><filename>systemd-rc-local-generator</filename> also checks whether <filename>/usr/sbin/halt.local</filename>
  51     exists and is executable, and if it is pulls the <filename>halt-local.service</filename> unit into the shutdown
  52     process. This unit is responsible for running this script during later shutdown.</para>
  53
  54     <para>Support for both <filename>/etc/rc.local</filename> and <filename>/usr/sbin/halt.local</filename> is provided
  55     for compatibility with specific System V systems only. However, it is strongly recommended to avoid making use of
  56     these scripts today, and instead provide proper unit files with appropriate dependencies for any scripts to run
  57     during the boot or shutdown processes.</para>
  58
  59     <para><filename>systemd-rc-local-generator</filename> implements
  60     <citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
  61   </refsect1>
  62
  63   <refsect1>
  64     <title>See Also</title>
  65     <para>
  66       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  67       <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  68     </para>
  69   </refsect1>
  70
  71 </refentry>