man/systemd-rc-local-generator.xml

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