systemd-rc-local-generator(8) — Linux manual page
SYSTEMD-...ENERATOR(8) systemd-rc-local-generator SYSTEMD-...ENERATOR(8)
NAME
systemd-rc-local-generator, rc-local.service - Compatibility
generator and service to start /etc/rc.local during boot
SYNOPSIS
/usr/lib/systemd/system-generators/systemd-rc-local-generator
rc-local.service
DESCRIPTION
systemd-rc-local-generator is a generator that checks whether
/etc/rc.local exists and is executable, and if it is, pulls the
rc-local.service unit into the boot process. This unit is
responsible for running this script during late boot. The script
is run after network.target, but in parallel with most other
regular system services.
Note that rc-local.service 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.
Also note that rc-local.service is ordered after network.target,
which does not mean that the network is functional, see
systemd.special(7). If the script requires a configured network
connection, it may be desirable to pull in and order it after
network-online.target with a drop-in:
# /etc/systemd/system/rc-local.service.d/network.conf
[Unit]
Wants=network-online.target
After=network-online.target
Support for /etc/rc.local is provided for compatibility with
specific System V systems only. However, it is strongly
recommended to avoid using this script today, and instead provide
proper unit files with appropriate dependencies for any scripts
to run during the boot process. Note that the path to the script
is set at compile time and varies between distributions.
systemd-rc-local-generator implements systemd.generator(7).
NOTES
On systems with SELinux, when creating the file, make sure to set
the appropriate context, e.g. with "sudo restorecon -v
/etc/rc.local".
SEE ALSO
systemd(1), systemctl(1)
COLOPHON
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have
a bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2024-06-14. (At that
time, the date of the most recent commit that was found in the
repository was 2024-06-13.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 257~devel SYSTEMD-...ENERATOR(8)
Pages that refer to this page: systemd.directives(7), systemd.generator(7), systemd.index(7)