mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2026-05-18 20:30:26 -04:00
15b4d41619
By default, the OpenRC installation will reinstall the configuration files for the base services. There are several reasons why this wouldn't be desirable. For existance, after an OpenRC upgrade, there's a new error before login, but agetty now clears the screen with a login prompt when it previously didn't clear the screen because of the altered configuration. That's just one example. The reason for the bin and sbin nonsense is that an OpenRC installation wants to install /sbin and /bin, but cp doesn't want to overwrite them as they are symlinks, not directories, and some binaries will be busy, preventing overwriting. Thus, the instructions balloon up even more. If anyone has suggestions on how to make the instructions both shorter and understandable, please let me know.
382 lines
11 KiB
XML
382 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
%general-entities;
|
|
]>
|
|
|
|
<sect1 id="ch-system-openrc" role="wrap" revision="openrc">
|
|
<?dbhtml filename="openrc.html"?>
|
|
|
|
<sect1info condition="script">
|
|
<productname>openrc</productname>
|
|
<productnumber>&openrc-version;</productnumber>
|
|
<address>&openrc-url;</address>
|
|
</sect1info>
|
|
|
|
<title>OpenRC-&openrc-version;</title>
|
|
|
|
<indexterm zone="ch-system-openrc">
|
|
<primary sortas="a-OpenRC">OpenRC</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title/>
|
|
|
|
<para>The OpenRC package contains programs for controlling the startup,
|
|
running, and shutdown of the system.</para>
|
|
|
|
<segmentedlist>
|
|
<segtitle>&buildtime;</segtitle>
|
|
<segtitle>&diskspace;</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>&openrc-fin-sbu;</seg>
|
|
<seg>&openrc-fin-du;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of OpenRC</title>
|
|
|
|
<para>Fix a script to allow a normal installation:</para>
|
|
|
|
<screen><userinput remap="pre">sed -i '/set -u/d' tools/meson_final.sh</userinput></screen>
|
|
|
|
<para>Prepare OpenRC for compilation:</para>
|
|
|
|
<screen><userinput remap="configure">mkdir build
|
|
cd build
|
|
|
|
meson setup --prefix=/usr \
|
|
--buildtype=release \
|
|
-D pam=false ..</userinput></screen>
|
|
|
|
<variablelist>
|
|
<title>The meaning of the configure options:</title>
|
|
|
|
<varlistentry>
|
|
<term><parameter>-D pam=false</parameter></term>
|
|
<listitem>
|
|
<para>This disables needing Linux-PAM for the build, since it is not
|
|
installed yet.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Compile the package:</para>
|
|
|
|
<screen><userinput remap="make">ninja</userinput></screen>
|
|
|
|
<para>To run the tests, issue:</para>
|
|
|
|
<screen><userinput remap="test">ninja test</userinput></screen>
|
|
|
|
<para>Install the package:</para>
|
|
|
|
<screen><userinput remap="install">DESTDIR=$PWD/DESTDIR ninja install
|
|
|
|
mv -v DESTDIR/{s,}bin/rc-update
|
|
mv -v DESTDIR/{s,}bin DESTDIR/usr
|
|
install -vDm755 DESTDIR/usr/bin/* -t /usr/bin/
|
|
install -vDm755 DESTDIR/usr/sbin/* -t /usr/sbin/
|
|
rm -rf DESTDIR/usr/{s,}bin
|
|
|
|
for conf in DESTDIR/etc/conf.d/*; do
|
|
if [ ! -e /etc/conf.d/$(basename $conf) ]; then
|
|
install -vDm644 $conf -t /etc/conf.d/
|
|
fi
|
|
rm -f $conf
|
|
done
|
|
|
|
cp -vR DESTDIR/* /
|
|
rm -rf DESTDIR</userinput></screen>
|
|
|
|
<note><para>
|
|
OpenRC by default reinstalls the configuration files for the base
|
|
services, meaning that if you have configured a service like
|
|
<literal>agetty</literal>, a normal installation would have reset the
|
|
configuration to the default. The above ensures that doesn't happen when
|
|
applicable. The <command>rc-update</command> under some circumstances is
|
|
meant to be ran as a normal user as well, so it should be in <filename
|
|
class="directory">/usr/bin</filename>.
|
|
</para></note>
|
|
|
|
<para>OpenRC provides <application>init</application> and other programs of
|
|
its own. However, the shorthands for them aren't created. Create the
|
|
symlinks:</para>
|
|
|
|
<screen><userinput>for i in {init,shutdown}; do
|
|
ln -sv openrc-$i /sbin/$i
|
|
done
|
|
|
|
cat > /sbin/poweroff << "EOF"
|
|
<literal>#!/bin/sh
|
|
/sbin/shutdown --poweroff now</literal>
|
|
EOF
|
|
|
|
cat > /sbin/reboot << "EOF"
|
|
<literal>#!/bin/sh
|
|
/sbin/shutdown --reboot now</literal>
|
|
EOF
|
|
|
|
chmod 755 /sbin/poweroff /sbin/reboot</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="contents-openrc" role="content">
|
|
<title>Contents of OpenRC</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed programs</segtitle>
|
|
<segtitle>Installed libraries</segtitle>
|
|
<segtitle>Installed directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
rc-status,
|
|
init (link to openrc-init),
|
|
openrc,
|
|
openrc-init,
|
|
openrc-run,
|
|
openrc-shutdown,
|
|
poweroff,
|
|
rc-service,
|
|
rc-sstat,
|
|
rc-update,
|
|
reboot,
|
|
shutdown (link to openrc-shutdown),
|
|
start-stop-daemon, and
|
|
supervise-daemon
|
|
</seg>
|
|
<seg>
|
|
libeinfo.so and
|
|
librc.so
|
|
</seg>
|
|
<seg>
|
|
/etc/conf.d,
|
|
/etc/init.d,
|
|
/etc/local.d,
|
|
/etc/runlevels,
|
|
/etc/sysctl.d,
|
|
/usr/libexec/rc, and
|
|
/usr/share/openrc
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="rc-status">
|
|
<term><command>rc-status</command></term>
|
|
<listitem>
|
|
<para>
|
|
Gives the status of a service
|
|
</para>
|
|
<indexterm zone="ch-system-openrc rc-status">
|
|
<primary sortas="b-rc-status">rc-status</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="init">
|
|
<term><command>init</command></term>
|
|
<listitem>
|
|
<para>
|
|
Is the first process to be started when the kernel has initialized
|
|
the hardware; it takes over the boot process and starts all the
|
|
services; symlink to <command>openrc-init</command>
|
|
</para>
|
|
<indexterm zone="ch-system-openrc init">
|
|
<primary sortas="b-init">init</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="openrc">
|
|
<term><command>openrc</command></term>
|
|
<listitem>
|
|
<para>
|
|
starts and stops services on a given runlevel
|
|
</para>
|
|
<indexterm zone="ch-system-openrc openrc">
|
|
<primary sortas="b-openrc">openrc</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="openrc-init">
|
|
<term><command>openrc-init</command></term>
|
|
<listitem>
|
|
<para>
|
|
Gets called from <command>init</command> and starts every service
|
|
as needed
|
|
</para>
|
|
<indexterm zone="ch-system-openrc openrc-init">
|
|
<primary sortas="b-openrc-init">openrc-init</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="openrc-run">
|
|
<term><command>openrc-run</command></term>
|
|
<listitem>
|
|
<para>
|
|
Allows using shell commands in a service file
|
|
</para>
|
|
<indexterm zone="ch-system-openrc openrc-run">
|
|
<primary sortas="b-openrc-run">openrc-run</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="openrc-shutdown">
|
|
<term><command>openrc-shutdown</command></term>
|
|
<listitem>
|
|
<para>
|
|
Brings the system down in a secure way, signaling all processes and
|
|
notifying all logged-in users
|
|
</para>
|
|
<indexterm zone="ch-system-openrc openrc-shutdown">
|
|
<primary sortas="b-openrc-shutdown">openrc-shutdown</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="poweroff">
|
|
<term><command>poweroff</command></term>
|
|
<listitem>
|
|
<para>
|
|
Calls <command>openrc-shutdown</command> with
|
|
<parameter>--poweroff</parameter>, stopping all services and
|
|
processes before shutting down the system
|
|
</para>
|
|
<indexterm zone="ch-system-openrc poweroff">
|
|
<primary sortas="b-poweroff">poweroff</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="rc-service">
|
|
<term><command>rc-service</command></term>
|
|
<listitem>
|
|
<para>
|
|
Runs a given service after locating it
|
|
</para>
|
|
<indexterm zone="ch-system-openrc rc-service">
|
|
<primary sortas="b-rc-service">rc-service</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="rc-sstat">
|
|
<term><command>rc-sstat</command></term>
|
|
<listitem>
|
|
<para>
|
|
Gives the status of the most crucial services, followed by normal
|
|
services
|
|
</para>
|
|
<indexterm zone="ch-system-openrc rc-sstat">
|
|
<primary sortas="b-rc-sstat">rc-sstat</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="rc-update">
|
|
<term><command>rc-update</command></term>
|
|
<listitem>
|
|
<para>
|
|
Adds and removes services on a runlevel
|
|
</para>
|
|
<indexterm zone="ch-system-openrc rc-update">
|
|
<primary sortas="b-rc-update">rc-update</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="reboot">
|
|
<term><command>reboot</command></term>
|
|
<listitem>
|
|
<para>
|
|
Calls <command>openrc-shutdown</command> with
|
|
<parameter>--reboot</parameter>, stopping all services and
|
|
processes before telling the system to reboot
|
|
</para>
|
|
<indexterm zone="ch-system-openrc reboot">
|
|
<primary sortas="b-reboot">reboot</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="shutdown">
|
|
<term><command>shutdown</command></term>
|
|
<listitem>
|
|
<para>
|
|
Is a symlink to <command>openrc-shutdown</command>
|
|
</para>
|
|
<indexterm zone="ch-system-openrc shutdown">
|
|
<primary sortas="b-shutdown">shutdown</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="start-stop-daemon">
|
|
<term><command>start-stop-daemon</command></term>
|
|
<listitem>
|
|
<para>
|
|
Starts or stops a daemon in a service file
|
|
</para>
|
|
<indexterm zone="ch-system-openrc start-stop-daemon">
|
|
<primary sortas="b-start-stop-daemon">start-stop-daemon</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="supervise-daemon">
|
|
<term><command>supervise-daemon</command></term>
|
|
<listitem>
|
|
<para>
|
|
Supervises a daemon in a service file
|
|
</para>
|
|
<indexterm zone="ch-system-openrc supervise-daemon">
|
|
<primary sortas="b-supervise-daemon">supervise-daemon</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libeinfo">
|
|
<term><filename class="libraryfile">libeinfo</filename></term>
|
|
<listitem>
|
|
<para>
|
|
Contains functions for outputting colored messages
|
|
</para>
|
|
<indexterm zone="ch-system-openrc libeinfo">
|
|
<primary sortas="c-libeinfo">libeinfo</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="librc">
|
|
<term><filename class="libraryfile">librc</filename></term>
|
|
<listitem>
|
|
<para>
|
|
Provides the core OpenRC functions
|
|
</para>
|
|
<indexterm zone="ch-system-openrc librc">
|
|
<primary sortas="c-librc">librc</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|