OpenRC

OpenRC は、通常 /sbin/init にありシステムが提供する init システムと互換性のある、Unix 系システムのための依存関係ベースの init システムです。

OpenRC は、ブート時に必要なサービスを正しい順序で開始し、システムの使用中はそれらを管理し、シャットダウン時にそれらを終了します。Gentoo リポジトリからインストールされたデーモンを管理でき、デーモンが起動するプロセスがある場合はそれらを監視でき、ブート時間を短縮するために可能であればプロセスを並列で開始することもできます。

Gentoo は OpenRC と systemd をいずれもサポートしていますが、それ以外の init システムを利用することもできます。

OpenRC は Gentoo のために開発されましたが、他の Linux ディストリビューションと BSD システムでも使えるように設計されています。Gentoo 上ではデフォルトでは、OpenRC は sysvinit によって呼び出されます。

Gentoo リポジトリ以外からインストールされたデーモン (例えば、ソースコードとしてダウンロードして手動でコンパイルされたソフトウェア) は、OpenRC とともに機能するように適応させる必要があるかもしれません (些細な変更で済む場合もあります)。

実装

OpenRC は伝統的な Unix 系システムに、大きな、根本的な変更を必要としません。OpenRC は他のシステムソフトウェアを部品として、モジュール化された柔軟なシステムの一部となるようそれらと統合します。高速で、軽量で、簡単に設定でき、高い適応性を持つように設計されています。OpenRC の依存は少なく、コアシステムコンポーネントへの基本的な依存のみです。

現代的な init システムとして、OpenRC は便利な機能を多数提供しています:

• cgroups サポート。
• プロセス監視。
• サービスの並列開始にも対応した、依存関係ベースの起動。
• 依存関係の自動的解決と順序付け。
• ハードウェアによって開始される init スクリプト。
• rc_ulimit 変数を通じた、サービスごとの ulimit と nice 値の設定。
• 複数のコンポーネントを開始する複雑な init スクリプト。
• 既存のインフラストラクチャに適応する、モジュール化されたアーキテクチャ。
• OpenRC は openrc-init という選択可能な自身の init システムを持っています。詳細は OpenRC/openrc-init を参照してください。
• OpenRC は選択可能な自身のプロセス監視機能を持っています。詳細は OpenRC/supervise-daemon を参照してください。

init システムについてのさらなる情報は init システムの比較の記事を参照してください。

インストール

OpenRC は通常手動でインストールする必要はなく、インストール時に OpenRC プロファイルの一部として提供されます。stage 3 tarball 中に存在し、システム更新を通じて保守されるでしょう。

USE フラグ

USE フラグが変更されたら、変更を反映するためにパッケージを再ビルドすることができます。OpenRC プロファイルでは、virtual/service-manager の依存として sys-apps/openrc が取り込まれるため、決して selected-packages 集合 (/var/lib/portage/world ファイル) に追加するべきではありません。--oneshot オプションを使うと、この集合に OpenRC を追加せずにすみます。

設定

ファイル

/etc/rc.conf

グローバルな OpenRC 設定ファイル。

OpenRC の設定について文書化した多数のコメントを含んでいます。

/etc/conf.d

個別の init スクリプトのための設定ファイルを格納します。

ログ

OpenRC はデフォルトでは何もログを出力しません。ブート中の OpenRC の出力をログとして出力するには、/etc/rc.conf 内の rc_logger オプションのコメントアウトを解除して設定してください。ログはデフォルトでは /var/log/rc.log に保存されるでしょう。

rc_logger="YES"
#rc_log_path="/var/log/rc.log"

ネットワーク管理

依存関係の振る舞い

rc_need="!net net.eth0"

#rc_depend_strict="YES"

依存を追加してください:

default ランレベル <---> nonetwork ランレベル <---> office ランレベル

ブート時に特定のランレベルを選択する

OpenRC はブート時に使われるカーネルコマンドラインを読み、softlevel パラメータが提供されていれば、そこで指定されたランレベルを開始します。softlevel パラメータが提供されていない場合は、default ランレベルが使用されます。

次の例では、default または nonetwork のどちらのランレベルにブートするかを選べる grub 設定を示しています:

title=Regular Start-up
 
kernel (hd0,0)/boot/kernel-3.7.10-gentoo-r1 root=/dev/sda3
 
title=Start without Networking
 
kernel (hd0,0)/boot/kernel-3.7.10-gentoo-r1 root=/dev/sda3 softlevel=nonetwork

追加のランレベルを追加する方法の説明については、以下の節をお読みください。

使い方

ランレベル

OpenRC は openrc、rc-update、そして rc-status コマンドを利用して制御と設定を行うことができます。

default ランレベルからサービスを削除します。以下の <service> は削除したいサービスの名前です:

一覧表示

ランレベルと、それらに割り当てられたサービス (init スクリプト) の一覧を表示するために、root 権限を使用する必要はありません。

利用可能なすべての init スクリプトと、それらのランレベル (どれかに追加されていれば) を表示するには、rc-update show -v を使用してください:

rc-update または rc-update show を実行すると、いずれかのランレベルに追加されている init スクリプトのみを表示するでしょう。

すべてのサービスの状態を確認するには、代わりに、rc-status コマンドを --servicelist (-s) オプション付きで使用することができます:

名前付きランレベル

OpenRC のランレベルは /etc/runlevels 内のディレクトリとして実装されています。追加のランレベル (以下では <runlevel> として示しています) は、次を使用して作成できます:

追加のランレベルは、代替のシステムスタートアッププロファイルを提供するのに便利です。

スタックされたランレベル

スタックされたランレベルは、ひとつまたは複数の他のランレベルの操作の継承を可能にするために使用されます。スタックされたランレベルを作成するために使用されるコマンドは rc-update -s です。ランレベルを他のランレベルに追加することで依存関係が作成され、対象のランレベルが開始または終了されたときに、それが依存するすべての (スタックされた) ランレベルにあるすべての init スクリプト (サービス) が開始または終了されるようになります。

ラップトップ上で場所に応じてネットワークサービスをまとめるために、スタックされたランレベルを使用する例が OpenRC/Stacked runlevel にあります。

Prefix

Gentoo Prefix は、Gentoo をあるオフセット (prefix とも呼ばれます) の中にインストールします。これを利用することで、ファイルシステム階層中の異なる場所に Gentoo をインストールすることができ、そのため、コンフリクトを回避することができます。オフセット配下にインストールされるということに加えて、Gentoo Prefix は非特権で実行されます。つまり、使用するのに root ユーザまたはその権限が必要ないということです。

オフセット ("prefix" の場所) を使用することで、多くの「主要でない」ユーザ層も、Gentoo Linux Portage ツリーのパッケージの大部分からメリットを享受することができるようになります。現時点で、次のシステムのユーザが Gentoo Prefix を成功裏に実行することができます: PPC および x86 上の Mac OS X、x86、x86_64 および ia64 上の Linux、Sparc、Sparc/64、x86 および x86_64 上の Solaris 10、x86 上の FreeBSD、PPC 上の AIX、x86 上 の Interix、x86 上の Windows (Interix の助けを借りて)、PARISC および ia64 上の HP-UX。

試してみるためのチュートリアルが、OpenRC/Prefix にあります。

ホットプラグ

OpenRC は udev からの新しいハードウェアイベントなど、外部イベントによってトリガーすることもできます。以下はホットプラグサービスについて設定ファイルに書いてある内容です:

# rc_hotplug controls which services we allow to be hotplugged.
# A hotplugged service is one started by a dynamic dev manager when a matching
# hardware device is found.
# Hotplugged services appear in the "hotplugged" runlevel.
# If rc_hotplug is set to any value, we compare the name of this service
# to every pattern in the value, from left to right, and we allow the
# service to be hotplugged if it matches a pattern, or if it matches no
# patterns. Patterns can include shell wildcards.
# To disable services from being hotplugged, prefix patterns with "!".
# If rc_hotplug is not set or is empty, all hotplugging is disabled.
# Example - rc_hotplug="net.wlan !net.*"
# This allows net.wlan and any service not matching net.* to be hotplugged.
# Example - rc_hotplug="!net.*"
# This allows services that do not match "net.*" to be hotplugged.

CGroups サポート

OpenRC バージョン 0.12 以降、cgroups のサポートを拡張しました。詳細については OpenRC/CGroups を参照してください。OpenRC 0.51 以降、unified cgroups (v2) はデフォルトで有効化されています。

Chroot サポート

rc_sys="prefix"
rc_controller_cgroups="NO"
rc_depend_strict="NO"
rc_need="!net !dev !udev-mount !sysfs !checkfs !fsck !netmount !logger !clock !modules"

サービスを開始しようとしたときに、システムが次のメッセージを報告してくるかもしれません:

* WARNING: <service> is already starting

これは次のコマンドを実行することで修復できるかもしれません:

ユーザサービス

残留

systemd の文脈でいう残留とは、あるユーザー用のユーザーセッションが確実に存在しているようにするための仕組みです。セッションはシステム起動時に作成され、その後このセッションは、そのユーザーのログインやログアウトにかかわらず、シャットダウンまで持続することが保証されます。したがって、このユーザーとして実行されるサービスはシステムの起動時間全体にわたって保持されます。残留自体はセッションデーモン(systemd の場合は logind)で実装されていますが、OpenRC ベースのシステムで同じような結果を実現する方法もあります。

sys-auth/elogind にも PAM ベースの自動起動で動作する --enable-linger <user> オプションがありますが、同じ効果を実現する OpenRC のユーザーごとのセッション を有効にすることをおすすめします。

サービスを起動時に開始する (残留)

ユーザーサービスをあるユーザー(ユーザー名を <user> とします)について有効にするには、/etc/init.d/user へのシンボリックリンクを /etc/init.d/user.<name> (訳註: /etc/init.d/user.<user> の誤りか。)に作成します。このサービスは OpenRC ユーザーセッションを開始し、そのセッションがユーザーについて有効化されているすべてのサービスを処理します。

あるサービスをユーザーに対して有効にするには:

有効にするサービスは /etc/user/init.d に存在している必要があります。OpenRC のすべてのコマンド (rc-update、rc-service、rc-status など)には、システムセッションではなく OpenRC ユーザーセッションに対して動作させるための --user (-U) フラグがあります。

サービスをログイン時に開始する (残存なし)

OpenRC セッションはユーザーがログインしている間だけ有効になります (#lingering を参照してください)。ユーザーがログアウトすると、セッションは終了します。

PAM ベースの自動起動

pam_openrc.so によってログイン時に openrc を開始することができます。これは /etc/pam.d/system-login から読み込まれ、ユーザーのログインに対して多重化された /etc/init.d/user スクリプトを動的に開始し、これによって openrc-user デーモンが起動されます。

openrc-user はそのユーザーのもう1つの pam セッションを開きます。このセッションは、pam_openrc を使用している他のすべてのセッションが有効な間残存し続けます。これは、新しいセッション用の pam スタックとして /etc/pam.d/openrc-user を読み込み、次にユーザーのログインシェルに -c 引数を付けて呼び出すことでユーザー用の default ランレベルを起動し、さらに存在しない場合は ${XDG_CONFIG_HOME}/rc/runlevels/default を作成します。

PAM ベースの自動起動を活用するには、ログインの過程で pam モジュールかシェルの rc ファイルによって XDG_RUNTIME_DIR が設定される必要があります。

#!/bin/sh
if[-z"$DBUS_SESSION_BUS_ADDRESS"];then
exportDBUS_SESSION_BUS_ADDRESS="unix:path=${XDG_RUNTIME_DIR:-"/run/user/$(id-u)"}/bus"
fi

echo'Hidden=true'>>/etc/xdg/autostart/pipewire.desktop

rc_logger="YES"
rc_log_path="<location>/rc.log"

システム統合

systemd との互換性

logind

構成によっては systemd-logind が必要な場合があります。Elogind は OpenRC とともに実行できるスタンドアローンの logind として、適切な代替になり得るでしょう。

tmpfiles.d

systemd は一時ファイルを管理するための特別な tmpfiles.d ファイル命名法を使用しています。sys-apps/systemd-utils[tmpfiles] は、OpenRC システムのためにスタンドアローンで同機能を提供します。

いずれも /sys または /proc 内の、再起動すると消えるエントリを管理するために使用できます。

udev と mdev

udev と mdev は、Gentoo で /dev を管理するために使用できるシステムです。かつては eudev も利用可能でしたが、今は削除されています。OpenRC 向けの udev は sys-apps/systemd-utils[udev] パッケージを介して利用可能ですが、Gentoo 上の OpenRC はどちらとの組み合わせでも機能するはずです。

古い Gentoo のインストールでは、メインの virtual/udev プロバイダとして udev を使用していました。これは bug #575718 によって eudev に変更されましたが、bug #807193 で udev に戻されました。しかしながら、rc サービスはどちらでも /etc/init.d/udev です。

組み込みシステムなどでの mdev の使用可能性については、mdev を参照してください。

BusyBox 統合

注意: この節は、実際に OpenRC で BusyBox を使う方法についての情報を欠いています。

現時点で、多数の BusyBox アプレットが OpenRC と互換性が無いことに注意してください。詳細は bug #529086 を参照してください。OpenRC を BusyBox とともに使用するには、セットアップのためにいくぶんかの作業が必要になるかもしれないことに警戒してください。BusyBox は組み込み用途により適しています。前の節の mdev に関する部分を参照してください。

完全な BusyBox を OpenRC のためのシェルとして使用することによって、BusyBox を OpenRC によって必要とされるユーザ空間ユーティリティ (init、シェル、awk、およびその他の POSIX ツール) のほとんどを置き換えるために使用できます [1]。通常なら fork/exec を発生させる呼び出しが回避され、全体のスピードが向上します。

Gentoo によって提供される SysV-init /etc/inittab ファイルは、BusyBox init と互換性がありません。以下は BusyBox と互換性のある inittab の例です:

::sysinit:/sbin/openrc sysinit
::wait:/sbin/openrc boot
::wait:/sbin/openrc

BusyBox は、acpid や dhcp/dhcpcd などのサードパーティソフトウェアを置き換えるために使用できる、多数のアプレットを提供します。

using BusyBox with OpenRC にある OpenRC のドキュメンテーションを参照してください。

トラブルシューティング

クラッシュしたサービスを再起動する

OpenRC は、ステートフルな init スクリプトと自動再起動を提供するために、サービスの状態をランレベルで設定された状態に戻すことができます。

クラッシュしたサービスを default ランレベルから再起動するには、openrc を実行してください: クラッシュしたサービスは開始され、手動で実行されたサービスは停止されるでしょう。手動で開始したサービスの実行を継続させるには、openrc --no-stop か、短い形式の openrc -n を実行してください。

デフォルトでは、openrc はクラッシュしたサービスを再開 (restart) ではなく、開始 (start) させるでしょう。 これは /etc/rc.conf 内の rc_crashed_stop (デフォルト: NO) と rc_crashed_start (デフォルト: YES) オプションで制御できます。

クラッシュしたサービスを手動で回復する

 * status: crashed

 * WARNING: docker has already been started

 * Caching service dependencies ... [ ok ]
 * Stopping docker ...
 * Failed to stop docker [ !! ]
 * ERROR: docker failed to stop

この状況を打開するには、サービスを zap してください:

関連項目

• OpenRC/CGroups — OpenRC includes support for cgroups.
• OpenRC/openrc-init — OpenRC's own init system
• OpenRC/Prefix — The following guideline applies to a Gentoo Prefix on RHEL-5.6 amd64 and on Debian 6.0 amd64, for other setups it should be similar.
• OpenRC/Stacked runlevel — a tutorial for setting up complicated networking with the help of stacked runlevel.
• OpenRC/supervise-daemon — OpenRC's daemon supervisor
• OpenRC/Users — an (incomplete) list of distributions and operating systems using OpenRC.
• /etc/local.d — /etc/local.d/ can contain small programs or light scripts to be run when the local service is started or stopped.
• Gentoo AMD64 ハンドブック - Init スクリプトシステム
• メインの OpenRC 設定ファイルである /etc/rc.conf は、OpenRC の設定について文書化した多数のコメントを含んでいます。

外部資料

OpenRC ドキュメンテーション

OpenRC は OpenRC 開発者によって保守されている、自身の有用なドキュメンテーションを持っています。Gentoo はデフォルトでは OpenRC のすべての機能を利用していないことに注意してください:

• README
• User Guide
• OpenRC init process guide - OpenRC の自身の init システム を使用する方法 (Gentoo のデフォルトでは使用していません)。
• agetty guide - OpenRC で agetty サービスを構成する (Gentoo のデフォルトでは、tty は sysvinit によって生成されます)。
• Using runit with OpenRC
• Using S6 with OpenRC
• Using supervise-daemon - 追加のプロセス監視。
• Using BusyBox with OpenRC
• Service script writing guide - 開発者またはパッケージ作成者向け。
• NEWS - 各リリースについての重要な情報。
• HISTORY - OpenRC が生まれた歴史。

Man pages

• openrc(8) - Stops and starts services for the specified runlevel.
• openrc-run(8) - Interpreter used to process OpenRC service scripts.
• rc-service(8) - Locate and run an OpenRC service with the given arguments.
• rc-status(8) - Show status info about runlevels.
• rc-update(8) - Add and remove services to and from a runlevel.

• Stale
• Todo articles
• OpenRC
• Logging