LSB は Linux Standard Base の略です。
LSB は、複数の Linux ディストリビューション間の違いを減らし、それによって異なるディストリビューション間の移植に伴うコストを削減するために、Linux Foundation によって開始されました。 init スクリプトは、標準化されるスクリプトの 1 つです。
この記事では、LSBInit 標準に準拠した Init スクリプトの作成方法について説明します。
Init スクリプトは、ソフトウェア|サービスの開始|停止に使用されます。たとえば、postgresql ソフトウェアを使用している場合、「start|stop|restart|reload|force-reload|status」に使用できる「/etc/init.d/postgresql」という名前の Init スクリプトがあります。
LSB 準拠の init スクリプトは次のことを行う必要があります:
- 少なくとも「開始、停止、再起動、強制リロード、ステータス」を提供
- 適切な終了コードを返す
- 実行時の依存関係を文書化する
オプションで、「log_success_msg」、「log_failure_msg」などの init.d 関数を使用して、メッセージをログに記録できます。
LSB は、/lib/lsb/init-functions にあるデフォルトの関数セットを提供します。 Init スクリプトでこれらの関数を利用できます。デフォルトでは、すべての Init プロセスはプロセスの pid を /var/run/ ディレクトリの下のファイルに記録します。これは、Init スクリプトがプロセスのステータスを見つけるのに役立ちます。
それでは、Init スクリプトを書き始めましょう。最初に、次のようなヘッダーを Init スクリプトに追加する必要があります。
### BEGIN INIT INFO # Provides: my_daemon # Required-Start: postgresql networking # Required-Stop: postgresql networking # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: This is a test daemon # Description: This is a test daemon # This provides example about how to # write a Init script. ### END INIT INFO
提供 この Init スクリプトによって提供される機能を指定します。名前は一意である必要があります。
必須開始 このサービスを開始する前に開始する必要がある機能のセットを指定します。この場合、my_daemon を開始する前に postgresql とネットワークを開始する必要があります。ここで「postgresql」には、「Provides:postgresql」という別の Init スクリプトがあることに注意してください。これにより、依存関係に基づく起動が保証されます。この依存関係に基づいて、「inserv」コマンドまたは「update-rc.d」は、適切なシーケンス番号を持つランレベル ディレクトリにエントリを配置します。たとえば、エントリは次のようになります
/etc/rc2.d/S12postgresql /etc/rc2.d/S03networking /etc/rc2.d/S13my_daemon
これは、ネットワークが最初に開始され、次に postgresql、my_daemon が開始されることを示しています。
ランレベルの詳細については、Linux ブート プロセスのステージ 6 (ランレベル) を参照してください。
必須停留所 この機能を停止した後にのみ停止する必要がある機能のリストを指定します。ここでは、my_daemon が停止した後でのみ、postgresql とネットワーク機能が停止します。
デフォルト開始 デフォルトストップ サービスを開始または停止する実行レベルを定義します。
簡単な説明 と説明 提供される施設に関する説明を提供するために使用されます。説明は複数行にまたがることができますが、簡単な説明は 1 行に制限されています。
実際の Init スクリプトを見てみましょう。
### BEGIN INIT INFO # Provides: my_daemon # Required-Start: postgresql networking # Required-Stop: postgresql networking # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: This is a test daemon # Description: This is a test daemon # This provides example about how to # write a Init script. ### END INIT INFO # Using the lsb functions to perform the operations. . /lib/lsb/init-functions # Process name ( For display ) NAME=my-daemon # Daemon name, where is the actual executable DAEMON=/home/user1/my_daemon # pid file for the daemon PIDFILE=/var/run/my_daemon.pid # If the daemon is not there, then exit. test -x $DAEMON || exit 5 case $1 in start) # Checked the PID file exists and check the actual status of process if [ -e $PIDFILE ]; then status_of_proc -p $PIDFILE $DAEMON "$NAME process" && status="0" || status="$?" # If the status is SUCCESS then don't need to start again. if [ $status = "0" ]; then exit # Exit fi fi # Start the daemon. log_daemon_msg "Starting the process" "$NAME" # Start the daemon with the help of start-stop-daemon # Log the message appropriately if start-stop-daemon --start --quiet --oknodo --pidfile $PIDFILE --exec $DAEMON ; then log_end_msg 0 else log_end_msg 1 fi ;; stop) # Stop the daemon. if [ -e $PIDFILE ]; then status_of_proc -p $PIDFILE $DAEMON "Stoppping the $NAME process" && status="0" || status="$?" if [ "$status" = 0 ]; then start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE /bin/rm -rf $PIDFILE fi else log_daemon_msg "$NAME process is not running" log_end_msg 0 fi ;; restart) # Restart the daemon. $0 stop && sleep 2 && $0 start ;; status) # Check the status of the process. if [ -e $PIDFILE ]; then status_of_proc -p $PIDFILE $DAEMON "$NAME process" && exit 0 || exit $? else log_daemon_msg "$NAME Process is not running" log_end_msg 0 fi ;; reload) # Reload the process. Basically sending some signal to a daemon to reload # it configurations. if [ -e $PIDFILE ]; then start-stop-daemon --stop --signal USR1 --quiet --pidfile $PIDFILE --name $NAME log_success_msg "$NAME process reloaded successfully" else log_failure_msg "$PIDFILE does not exists" fi ;; *) # For invalid arguments, print the usage message. echo "Usage: $0 {start|stop|restart|reload|status}" exit 2 ;; esac
上記のスクリプトは基本的に、LSBInit スクリプトを記述するためのテンプレートを提供します。 DAEMON、PIDFILE、NAME 変数、およびヘッダーを変更して、このスクリプトを独自のプログラムに適合させることができます。
LSB が提供する関数の詳細については、InitScript 関数を参照してください
Init スクリプトが完了したら、スクリプトを自動的に開始または停止させるために、次のコマンドを実行します。これにより、指定されたランレベルに適切な「S」および「K」エントリが追加されます。これにより、依存関係を考慮して適切なシーケンス番号も追加されます。
update-rc.d filename defaults