2020-09-15 18:56:32 +03:00
<?xml version='1.0'?>
2019-03-14 16:40:58 +03:00
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
2023-12-25 17:48:33 +03:00
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
2020-09-15 18:56:32 +03:00
<!ENTITY % entities SYSTEM "custom-entities.ent" >
%entities;
]>
2020-11-09 07:23:58 +03:00
<!-- SPDX - License - Identifier: LGPL - 2.1 - or - later -->
2020-09-15 18:56:32 +03:00
2020-08-20 18:41:19 +03:00
<refentry id= "systemd-rc-local-generator" conditional= 'HAVE_SYSV_COMPAT' >
2017-12-24 18:50:19 +03:00
<refentryinfo >
<title > systemd-rc-local-generator</title>
<productname > systemd</productname>
</refentryinfo>
<refmeta >
<refentrytitle > systemd-rc-local-generator</refentrytitle>
<manvolnum > 8</manvolnum>
</refmeta>
<refnamediv >
<refname > systemd-rc-local-generator</refname>
2021-03-12 10:53:32 +03:00
<refname > rc-local.service</refname>
<refpurpose > Compatibility generator and service to start <filename > &RC_LOCAL_PATH; </filename> during boot</refpurpose>
2017-12-24 18:50:19 +03:00
</refnamediv>
<refsynopsisdiv >
<para > <filename > /usr/lib/systemd/system-generators/systemd-rc-local-generator</filename> </para>
2021-03-12 10:53:32 +03:00
<para > <filename > rc-local.service</filename> </para>
2017-12-24 18:50:19 +03:00
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
2021-03-12 11:04:30 +03:00
<para > <command > systemd-rc-local-generator</command> is a generator that checks whether
<filename > &RC_LOCAL_PATH; </filename> exists and is executable, and if it is, pulls the
2020-09-15 18:56:32 +03:00
<filename > rc-local.service</filename> unit into the boot process. This unit is responsible for running
2021-03-12 11:04:30 +03:00
this script during late boot. The script is run after <filename > network.target</filename> , but in
parallel with most other regular system services.</para>
<para > Note that <filename > rc-local.service</filename> runs with slightly different semantics than the
original System V version, which was executed "last" in the boot process, which is a concept that does
not translate to systemd.</para>
<para > Also note that <filename > rc-local.service</filename> is ordered after
<filename > network.target</filename> , which does not mean that the network is functional, see
<citerefentry > <refentrytitle > systemd.special</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> .
If the script requires a configured network connection, it may be desirable to pull in and order it after
<filename > network-online.target</filename> with a drop-in:</para>
<programlisting > # /etc/systemd/system/rc-local.service.d/network.conf
[Unit]
Wants=network-online.target
After=network-online.target
</programlisting>
2020-09-15 18:56:32 +03:00
2024-05-17 15:31:16 +03:00
<para > Support for <filename > &RC_LOCAL_PATH; </filename> is provided for compatibility with specific
System V systems only. However, it is strongly recommended to avoid using this script today, and instead
2020-09-15 18:56:32 +03:00
provide proper unit files with appropriate dependencies for any scripts to run during the boot process.
2021-03-12 11:04:30 +03:00
Note that the path to the script is set at compile time and varies between distributions.</para>
2017-12-24 18:50:19 +03:00
<para > <filename > systemd-rc-local-generator</filename> implements
<citerefentry > <refentrytitle > systemd.generator</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> .</para>
</refsect1>
2024-05-17 15:31:16 +03:00
<refsect1 >
<title > Notes</title>
<para > On systems with SELinux, when creating the file, make sure to set the appropriate context, e.g.
with "<command > sudo restorecon -v &RC_LOCAL_PATH; </command> ".
</para>
</refsect1>
2017-12-24 18:50:19 +03:00
<refsect1 >
<title > See Also</title>
2023-12-22 21:09:32 +03:00
<para > <simplelist type= "inline" >
<member > <citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemctl</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> </member>
</simplelist> </para>
2017-12-24 18:50:19 +03:00
</refsect1>
</refentry>