| Newsgroups |
gmane.linux.lfs.book |
| Message-ID |
<176525647785.3415.9968502987300738335@rivendell.linuxfromscratch.org> |
This is an automated email from the git hooks/post-receive script.
git pushed a commit to branch openrc
in repository lfs.
The following commit(s) were added to refs/heads/openrc by this push:
new 1d503b659 Add missing files.
1d503b659 is described below
commit 1d503b659cc86608ac24c61088aef5b353f57c3d
Author: Zeckmathederg <[email protected]>
AuthorDate: Mon Dec 8 22:02:47 2025 -0700
Add missing files.
---
chapter08/openrc.xml | 325 +++++++++++++++++++++++++++++++++++++++++++
chapter10/kernel/openrc.toml | 23 +++
chapter10/kernel/openrc.xml | 45 ++++++
3 files changed, 393 insertions(+)
diff --git a/chapter08/openrc.xml b/chapter08/openrc.xml
new file mode 100644
index 000000000..86ad03c45
--- /dev/null
+++ b/chapter08/openrc.xml
@@ -0,0 +1,325 @@
+<?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>Compile the package:</para>
+
+<screen><userinput remap="make">mkdir build
+cd build
+
+meson setup --prefix=/usr --buildtype=release ..
+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">ninja install</userinput></screen>
+
+ <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
+
+for i in {poweroff,reboot}; do
+ ln -sv openrc-shutdown /sbin/$i
+done</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 (link to openrc-shutdown),
+ rc-service,
+ rc-sstat,
+ rc-update,
+ reboot (link to openrc-shutdown),
+ 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
+ serices
+ </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 demon 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>
diff --git a/chapter10/kernel/openrc.toml b/chapter10/kernel/openrc.toml
new file mode 100644
index 000000000..9a75bc9f2
--- /dev/null
+++ b/chapter10/kernel/openrc.toml
@@ -0,0 +1,23 @@
+WERROR=' '
+PSI='*'
+PSI_DEFAULT_DISABLED=' '
+IKHEADERS=' '
+CGROUPS='*'
+MEMCG='*'
+EXPERT=' '
+RELOCATABLE='*'
+RANDOMIZE_BASE='*'
+STACKPROTECTOR='*'
+STACKPROTECTOR_STRONG='*'
+UEVENT_HELPER=' '
+DEVTMPFS='*'
+DEVTMPFS_MOUNT='*'
+SYSFB_SIMPLEFB='*'
+DRM='*'
+DRM_PANIC='*'
+DRM_PANIC_SCREEN='kmsg'
+DRM_FBDEV_EMULATION='*'
+DRM_SIMPLEDRM='*'
+FRAMEBUFFER_CONSOLE='*'
+
+revision='openrc'
diff --git a/chapter10/kernel/openrc.xml b/chapter10/kernel/openrc.xml
new file mode 100644
index 000000000..c51837f90
--- /dev/null
+++ b/chapter10/kernel/openrc.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<!-- Automatically generated by kernel-config.py
+ DO NOT EDIT! -->
+<screen role="nodump" revision="openrc"><emphasis role='blue'>G</emphasis>eneral setup --->
+ [ ] <emphasis role='blue'>C</emphasis>ompile the kernel with warnings as errors [WERROR]
+ <emphasis role='blue'>C</emphasis>PU/Task time and stats accounting --->
+ [*] <emphasis role='blue'>P</emphasis>ressure stall information tracking [PSI]
+ [ ] <emphasis role='blue'>R</emphasis>equire boot parameter to enable pressure stall information tracking
+ ... [PSI_DEFAULT_DISABLED]
+ < > <emphasis role='blue'>E</emphasis>nable kernel headers through /sys/kernel/kheaders.tar.xz [IKHEADERS]
+ [*] <emphasis role='blue'>C</emphasis>ontrol Group support ---> [CGROUPS]
+ [*] M<emphasis role='blue'>e</emphasis>mory controller [MEMCG]
+ [ ] <emphasis role='blue'>C</emphasis>onfigure standard kernel features (expert users) ---> [EXPERT]
+
+<emphasis role='blue'>P</emphasis>rocessor type and features --->
+ [*] <emphasis role='blue'>B</emphasis>uild a relocatable kernel [RELOCATABLE]
+ [*] <emphasis role='blue'>R</emphasis>andomize the address of the kernel image (KASLR) [RANDOMIZE_BASE]
+
+<emphasis role='blue'>G</emphasis>eneral architecture-dependent options --->
+ [*] <emphasis role='blue'>S</emphasis>tack Protector buffer overflow detection [STACKPROTECTOR]
+ [*] <emphasis role='blue'>S</emphasis>trong Stack Protector [STACKPROTECTOR_STRONG]
+
+<emphasis role='blue'>D</emphasis>evice Drivers --->
+ <emphasis role='blue'>G</emphasis>eneric Driver Options --->
+ [ ] <emphasis role='blue'>S</emphasis>upport for uevent helper [UEVENT_HELPER]
+ [*] M<emphasis role='blue'>a</emphasis>intain a devtmpfs filesystem to mount at /dev [DEVTMPFS]
+ [*] <emphasis role='blue'>A</emphasis>utomount devtmpfs at /dev, after the kernel mounted the rootfs
+ ... [DEVTMPFS_MOUNT]
+ <emphasis role='blue'>F</emphasis>irmware Drivers --->
+ [*] M<emphasis role='blue'>a</emphasis>rk VGA/VBE/EFI FB as generic system framebuffer [SYSFB_SIMPLEFB]
+ <emphasis role='blue'>G</emphasis>raphics support --->
+ <*> <emphasis role='blue'>D</emphasis>irect Rendering Manager (XFree86 4.1.0 and higher DRI support) --->
+ ... [DRM]
+ [*] <emphasis role='blue'>D</emphasis>isplay a user-friendly message when a kernel panic occurs
+ ... [DRM_PANIC]
+ (kmsg) <emphasis role='blue'>P</emphasis>anic screen formatter [DRM_PANIC_SCREEN]
+ <emphasis role='blue'>S</emphasis>upported DRM clients --->
+ [*] <emphasis role='blue'>E</emphasis>nable legacy fbdev support for your modesetting driver
+ ... [DRM_FBDEV_EMULATION]
+ <emphasis role='blue'>D</emphasis>rivers for system framebuffers --->
+ <*> <emphasis role='blue'>S</emphasis>imple framebuffer driver [DRM_SIMPLEDRM]
+ <emphasis role='blue'>C</emphasis>onsole display driver support --->
+ [*] <emphasis role='blue'>F</emphasis>ramebuffer Console support [FRAMEBUFFER_CONSOLE]</screen>
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
--
http://lists.linuxfromscratch.org/sympa/info/lfs-book
Unsubscribe: See the above information page