手当たり次第に書くんだ

飽きっぽいのは本能

LPIC systemctl コマンド

NAME

systemctl コマンドは、Systemd システムおよびサービスマネージャーを制御します。

SYNOPSIS

systemctl [OPTIONS...] COMMAND [UNIT...]

DESCRIPTION

systemctl コマンドは、Systemd システムおよびサービスマネージャーの状態を調査および制御するために使用されます。このツールが管理する基本的な概念と機能については、systemd (1) を参照してください。

COMMANDS

コマンドは以下の通りです。

Unit Commands (Introspection and Modification)

list-units [PATTERN…]

Systemd が現在メモリに持っているユニットを一覧表示します。これには、直接参照されるか、依存関係を介して参照されるユニット、アプリケーションによってプログラム的に固定されたユニット、または過去にアクティブで失敗したユニットが含まれます。デフォルトでは、アクティブなユニット、保留中のジョブがあるユニット、または失敗したユニットのみが表示されます。これはオプション --all で変更できます。一つ以上の PATTERN が指定された場合、それに一致するユニットのみが表示されます。表示されるユニットは、オプション --type= および --state= で指定された場合にこれらのオプションで追加的にフィルタリングされます。

このコマンドはユニットのテンプレートを表示しない代わりに、ユニットテンプレートのインスタンスのみを表示します。インスタンス化されていないユニットテンプレートは実行不可能であり、そのためこのコマンドの出力には表示されません。具体的には、foo@.service のようなユニットテンプレートはリストに表示されませんが、foo@bar.service のようにインスタンス化されたユニットが表示されます。インストールされたユニットテンプレートファイルのリストを表示するには list-unit-files コマンドを使用してください。

systemctl list-units コマンドの出力例(一部抜粋)は以下の通りです。

myadmin@ubuntu:~$ systemctl list-units
  UNIT                                                                                                  LOAD   ACTIVE     SUB       DESCRIPTION                               >
  proc-sys-fs-binfmt_misc.automount                                                                     loaded active     running   Arbitrary Executable File Formats File Sys>
  dev-loop0.device                                                                                      loaded activating tentative /dev/loop0
  dev-loop13.device                                                                                     loaded activating tentative /dev/loop13
  dev-loop7.device                                                                                      loaded activating tentative /dev/loop7
  sys-devices-pci0000:00-0000:00:01.0-sound-card0-controlC0.device                                      loaded active     plugged   /sys/devices/pci0000:00/0000:00:01.0/sound>
  sys-devices-pci0000:00-0000:00:05.0-virtio1-net-enp0s5.device                                         loaded active     plugged   Virtio network device
  sys-devices-platform-PRL4010:00-ata1-host0-target0:0:0-0:0:0:0-block-sda-sda1.device                  loaded active     plugged   ubuntu-base-temp 1
  sys-devices-platform-PRL4010:00-ata1-host0-target0:0:0-0:0:0:0-block-sda-sda2.device                  loaded active     plugged   ubuntu-base-temp 2
  sys-devices-platform-PRL4010:00-ata1-host0-target0:0:0-0:0:0:0-block-sda-sda3.device                  loaded active     plugged   ubuntu-base-temp 3
  sys-devices-platform-PRL4010:00-ata1-host0-target0:0:0-0:0:0:0-block-sda.device                       loaded active     plugged   ubuntu-base-temp

LOAD   = Reflects whether the unit definition was properly loaded.
ACTIVE = The high-level unit activation state, i.e. generalization of SUB.
SUB    = The low-level unit activation state, values depend on unit type.
300 loaded units listed. Pass --all to see loaded but inactive units, too.
To show all installed unit files use 'systemctl list-unit-files'.

指定されたタイプのヘッダーと最後のユニットは、端末がサポートしている場合には下線が付けられます。マスクされたサービス、見つからないサービス、またはその他の理由で失敗したサービスの横には、色付きのドットが表示されます。

LOAD 列には、load の状態が表示されます。これは、loaded, not-found, bad-setting, error, masked のいずれかです。ACTIVE 列には、ユニットの一般的な状態が表示されます。これは、active, reloading, inactive, failed, activating, deactivating のいずれかです。SUB 列には、ユニットのタイプ固有の詳細な状態が表示されます。可能な値はユニットの種類によって異なります。LOAD, ACTIVE, SUB の状態のリストは一定ではなく、新しい Systemd のリリースでは値が追加または削除される場合があります。

次のコマンドを使用して、現在の可能な値のセットを表示することができます。

systemctl --state=help

これがデフォルトのコマンドです。

list-sockets [PATTERN…]

現在メモリに存在するソケットユニットを、リスニングアドレスで順にリストします。もし 1 つ以上のパターンが指定された場合、それに一致するソケットユニットのみが表示されます。

systemctl list-sockets コマンドの出力例(一部抜粋)は以下の通りです。

myadmin@ubuntu:~$ systemctl list-sockets
LISTEN                                    UNIT                             ACTIVATES                   
/dev/rfkill                               systemd-rfkill.socket            systemd-rfkill.service
/run/cloud-init/hook-hotplug-cmd          cloud-init-hotplugd.socket       cloud-init-hotplugd.service
/run/dbus/system_bus_socket               dbus.socket                      dbus.service
/run/dmeventd-client                      dm-event.socket                  dm-event.service
/run/dmeventd-server                      dm-event.socket                  dm-event.service
/run/docker.sock                          docker.socket                    docker.service
/run/initctl                              systemd-initctl.socket           systemd-initctl.service
[::]:111                                  rpcbind.socket                   rpcbind.service
[::]:111                                  rpcbind.socket                   rpcbind.service
[::]:9090                                 cockpit.socket                   cockpit.service
audit 1                                   systemd-journald-audit.socket    systemd-journald.service
kobject-uevent 1                          systemd-udevd-kernel.socket      systemd-udevd.service
route 1361                                systemd-networkd.socket          systemd-networkd.service

31 sockets listed.
Pass --all to see loaded but inactive sockets, too.

アドレスにはスペースが含まれる可能性があるため、この出力はプログラムでの使用に適していません。--show-types, --all, --state= も参照してください。

list-timers [PATTERN…]

現在の時間から次に起動するまでの時間で並べ替えられた、現在メモリに存在するタイマーユニットの一覧を表示します。もし 1 つ以上のパターンが指定された場合、それに一致するユニットのみが表示されます。

systemctl list-timers コマンドの出力例(一部抜粋)は以下の通りです。

myadmin@ubuntu:~$ systemctl list-timers
NEXT                        LEFT          LAST                        PASSED       UNIT                           ACTIVATES                       
Wed 2024-04-10 09:09:00 JST 9min left     Wed 2024-04-10 08:39:05 JST 20min ago    phpsessionclean.timer          phpsessionclean.service
Wed 2024-04-10 09:25:00 JST 25min left    Wed 2024-04-10 08:55:02 JST 4min 19s ago pmlogger_check.timer           pmlogger_check.service
Wed 2024-04-10 09:25:10 JST 25min left    Wed 2024-04-10 08:55:12 JST 4min 9s ago  pmlogger_farm_check.timer      pmlogger_farm_check.service
Wed 2024-04-10 09:28:00 JST 28min left    Wed 2024-04-10 08:58:03 JST 1min 18s ago pmie_check.timer               pmie_check.service
Wed 2024-04-10 09:28:10 JST 28min left    Wed 2024-04-10 08:58:13 JST 1min 7s ago  pmie_farm_check.timer          pmie_farm_check.service
Wed 2024-04-10 10:14:10 JST 1h 14min left Tue 2024-04-09 22:22:37 JST 10h ago      fwupd-refresh.timer            fwupd-refresh.service

19 timers listed.
Pass --all to see loaded but inactive timers, too.

list-timers のステータスは以下の通りです。

項目説明
NEXTタイマーが次に実行される予定の時間を表示します。
LEFT次にタイマーが実行されるまでの時間を表示します。
LASTタイマーが最後に実行された時間を表示します。
PASSEDタイマーが最後に実行されてから経過した時間を表示します。
UNITタイマーの名前を表示します。
ACTIVATESタイマーが実行されたときに起動されるサービスの名前を表示します。
list-timers のステータス

--all, --state= も参照してください。

is-active PATTERN…

指定されたユニットのいずれかがアクティブ(つまり実行中)かどうかを確認します。少なくとも 1 つがアクティブであれば終了コード 0 を返し、それ以外の場合は 0 以外の終了コードを返します。--quiet が指定されていない限り、現在のユニットの状態も標準出力に表示されます。

is-failed PATTERN…

指定されたユニットのいずれかが failed 状態にあるかどうかを確認します。少なくとも 1 つが失敗した場合、終了コード 0 を返し、それ以外の場合は 0 以外の終了コードを返します。--quiet が指定されていない限り、現在のユニットの状態も標準出力に表示されます。

status [PATTERN…|PID…]]

1 つ以上のユニットについての簡潔な実行時の状態情報を表示し、その後にジャーナルからの最新のログデータを表示します。ユニットが指定されていない場合、システムの状態を表示します。--all と組み合わせて使用すると、すべてのユニットの状態も表示します(-t で指定された制限に従います)。PID が渡された場合、そのプロセスが属するユニットに関する情報を表示します。

この機能は、人間が読みやすい出力を生成することを目的としています。コンピューターで解析可能な出力を探している場合は、代わりに show を使用してください。デフォルトでは、この機能は出力を 10 行しか表示せず、行を端末ウィンドウに収まるように省略します。これは、--lines, --full で変更できます。また、journalctl --unit=NAME, journalctl --user-unit=NAME は、メッセージに対して同様のフィルターを使用しており、より便利かもしれません。

Systemd は必要に応じて暗黙的にユニットをロードするため、ステータスを実行するだけでファイルを読み込もうとします。そのため、何かがすでにロードされているかどうかを判断するためにこのコマンドを使用することは役立ちません。操作が完了した後、理由がない場合はユニットがすぐにメモリからアンロードされる可能性もあります。

myadmin@ubuntu:~$ systemctl status postfix.service 
● postfix.service - Postfix Mail Transport Agent
     Loaded: loaded (/lib/systemd/system/postfix.service; enabled; vendor preset: enabled)
     Active: active (exited) since Mon 2024-03-11 14:27:12 JST; 4 weeks 1 day ago
       Docs: man:postfix(1)
   Main PID: 3733 (code=exited, status=0/SUCCESS)
        CPU: 423us

Mar 11 14:27:12 ubuntu systemd[1]: Reloading Postfix Mail Transport Agent...
Mar 11 14:27:12 ubuntu systemd[1]: Reloaded Postfix Mail Transport Agent.
Mar 11 14:27:12 ubuntu systemd[1]: Reloading Postfix Mail Transport Agent...

「●」は、サポートされている端末上で色を使ってユニットの状態を一目で要約します。色とともに、その形は状態によって異なります。inactive, maintenance の場合は「○」、active の場合は緑色の「●」、deactivating の場合は「○」、failed, error の場合は赤い「×」、reloading の場合は緑色の「↻」です。

出力の Loaded: 行では、ユニットがメモリにロードされている場合は loaded と表示されます。Loaded: の他の可能な値には、次のものがあります。error はロードに問題があった場合、not-found はこのユニットのためのユニットファイルが見つからなかった場合、bad-setting は重要なユニットファイル設定を解析できなかった場合、masked はユニットファイルがマスクされている場合です。この行はユニットファイルへのパスを表示するだけでなく、有効化状態も表示します。有効化されたコマンドは起動時に開始します。masked の定義を含む可能な有効化状態の完全な一覧については、is-enabled コマンドのドキュメントを参照してください。

Active: 行はアクティブな状態を示します。値は通常、active か inactive です。アクティブは、ユニットのタイプに応じて開始されたり、バインドされたり、挿入されたりすることを意味します。ユニットは状態を変更する過程にある場合、activating や deactivating という状態を報告することもあります。特別な failed 状態は、サービスがクラッシュしたり、エラーコードで終了したり、タイムアウトしたりするなどの方法で失敗した場合に入ります。失敗した状態が入力されると、原因が後で参照するためにログに記録されます。

show [PATTERN…|JOB…]

1 つ以上のユニット、ジョブ、またはマネージャー自体のプロパティを表示します。引数が指定されていない場合、マネージャーのプロパティが表示されます。ユニット名が指定されている場合、ユニットのプロパティが表示され、ジョブ ID が指定されている場合は、ジョブのプロパティが表示されます。デフォルトでは、空のプロパティは抑制されます。それらも表示するには、--all を使用してください。特定のプロパティを選択して表示するには、--property= を使用します。このコマンドは、コンピューターで解析可能な出力が必要な場合に使用されることを意図しています。フォーマットされた人間が読みやすい出力を求める場合は、status を使用してください。

systemctl show によって表示される多くのプロパティは、システムおよびサービスマネージャーおよびそのユニットファイルの設定に直接マップされます。このコマンドによって表示されるプロパティは、一般に、元の構成設定のより低レベルで正規化されたバージョンであり、構成に加えてランタイム状態も公開されます。たとえば、サービスユニットの場合、サービスの現在のメインプロセス識別子が MainPID として表示されます(これはランタイム状態です)、および時間設定は常に …USec サフィックスで終わるプロパティとして公開されます。対応する構成オプションが …Sec で終わる場合でも、マイクロ秒がシステムおよびサービスマネージャー内部で使用される正規化された時間単位であるためです。

これらのプロパティの詳細については、これらのプロパティをバックアップする D-Bus インターフェイスのドキュメントを参照してください。org.freedesktop.systemd1 (5) を参照してください。

cat PATTERN…

1 つ以上のユニットのバッキングファイルを表示します。ユニットの「フラグメント」と「ドロップイン」(ソースファイル)を表示します。各ファイルの前に、ファイル名が含まれたコメントが表示されます。注意点として、これはディスク上のバッキングファイルの内容を表示しており、daemon-reload コマンドが発行されていない場合、ディスク上のユニットファイルが更新されている場合には、これらのユニットに関するシステムマネージャーの理解と一致しないかもしれません。

help PATTERN…|PID…

1 つ以上のユニットのマニュアルページを表示します。PID が指定された場合、プロセスが属するユニットのマニュアルページが表示されます。

list-dependencies [UNIT…]

指定されたユニットによって必要とされるユニットと希望されるユニットを表示します。これは Requires=, Requisite=, ConsistsOf=, Wants=, BindsTo= の依存関係に従ってユニットを再帰的にリストします。ユニットが指定されていない場合、default.target が暗黙的に意味されます。

デフォルトでは、ターゲットユニットのみが再帰的に展開されます。--all が渡されると、他のすべてのユニットも再帰的に展開されます。

オプションの --reverse, --after, --before を使用すると、表示される依存関係のタイプを変更できます。

このコマンドは、サービスマネージャーによって現在メモリに読み込まれているユニットのみをリストアップします。特に、このコマンドは特定のユニットのすべての逆依存関係の包括的なリストを取得するために適していません。なぜなら、現在読み込まれていないユニットによって宣言された依存関係をリストアップしないからです。

start PATTERN…

コマンドラインで指定された 1 つ以上のユニットを起動(アクティブ化)します。

ユニットのグロブパターンは、現在メモリに読み込まれているユニットの名前に展開されます。アクティブではなく、失敗していないユニットは通常メモリに読み込まれていないため、どのパターンにも一致しません。また、インスタンス化されたユニットの場合、インスタンスが開始されるまで Systemd はインスタンス名を認識していないことがよくあります。したがって、start コマンドでグロブパターンを使用することの有用性は限られています。さらに、ユニットのセカンダリエイリアス名は考慮されません。

オプション --all を使用すると、他の読み込まれたユニットによって参照されている非アクティブなユニットにも操作を行います。ただし、前述の段落で説明したように、これはすべてのユニットに対して操作するのとは異なります。そのため、このようなリストは定義が曖昧です。それでも、すべてのユニットが特定の読み込まれたターゲットによって引き込まれることがわかっている場合、systemctl start --all GLOB は便利です。

stop PATTERN…

コマンドラインで指定された 1 つ以上のユニットを停止(非アクティブ化)します。

このコマンドは、ユニットが存在しない場合やユニットの停止が禁止されている場合には失敗します。また、ユニットを停止するために構成されたコマンド(たとえば ExecStop=)のいずれかが失敗した場合でも、マネージャーはユニットを強制的に終了させるため、コマンド自体は失敗しません。

reload PATTERN…

指定されたすべてのユニットに設定の再読み込みを求めます。このコマンドは、サービス固有の設定を再読み込みしますが、Systemd のユニット構成ファイルを再読み込みしません。ユニットの構成ファイルを再読み込みするには、daemon-reload コマンドを使用してください。つまり、Apache の例では、これにより Apache の httpd.conf が再読み込まれますが、apache.service の Systemd ユニットファイルは再読み込まれません。

このコマンドは、daemon-reload コマンドと混同されるべきではありません。

restart PATTERN…

指定されたすべてのユニットを停止してから再起動します。ユニットがまだ実行されていない場合、起動されます。

このコマンドでユニットを再起動すると、再起動前にユニットのすべてのリソースが必ずしもフラッシュされるわけではありません。たとえば、サービスごとのファイルディスクリプターの保存施設(systemd.service (5) の FileDescriptorStoreMax= を参照)は、ユニットにジョブが保留中である限り、保持され、ユニットが完全に停止し、もうジョブが保留中でなくなるときにのみクリアされます。ファイルディスクリプターの保存施設も再起動中にフラッシュされることが意図されている場合は、明示的に systemctl stop コマンドを実行してから systemctl start を実行する必要があります。

try-restart PATTERN…

指定された 1 つ以上のパターンに一致するユニットが実行中の場合、それらを停止してから再起動します。ユニットが実行されていない場合は何もしません。

reload-or-restart PATTERN…

指定された 1 つ以上のパターンに一致するユニットがそれをサポートしている場合、それらを再読み込みします。サポートされていない場合は、代わりに停止してから再起動します。ユニットがまだ実行されていない場合、それらは開始されます。

try-reload-or-restart PATTERN…

指定された 1 つ以上のパターンに一致するユニットがサポートされている場合、それらを再読み込みします。サポートされていない場合は、代わりに停止してから再起動します。ユニットが実行されていない場合は何もしません。

isolate UNIT

コマンドラインで指定されたユニットとその依存関係を開始し、他のすべてのユニットを停止します。ただし、IgnoreOnIsolate=yes が設定されている場合を除きます。拡張子のないユニット名が指定された場合、.target の拡張子が付加されます。

このコマンドは危険であり、新しいターゲットで有効になっていないプロセスが直ちに停止されるため、現在使用しているグラフィカル環境や端末を含む可能性があります。

AllowIsolate= が有効になっているユニットでのみ許可されることに注意してください。

kill PATTERN…

指定したユニットの 1 つ以上のプロセスにシグナルを送信します。--kill-who= を使用してどのプロセスを終了するかを選択します。--signal= を使用して送信するシグナルを選択します。

clean PATTERN…

指定したユニットの構成、状態、キャッシュ、ログ、またはランタイムデータを削除します。--what= を使用して削除するリソースの種類を選択します。サービスユニットの場合、これにより、ConfigurationDirectory=, StateDirectory=, CacheDirectory=, LogsDirectory= および RuntimeDirectory= で構成されたディレクトリが削除されます。タイマーユニットの場合、Persistent= が使用されていて --what=state が選択されている場合、永続的なタイムスタンプデータがクリアされます。このコマンドは、これらの設定のいずれかを使用しているユニットにのみ適用されます。--what= が指定されていない場合、キャッシュとランタイムデータの両方が削除されます。これらの 2 種類のデータは、ユニットの次の呼び出しで一般的に冗長で再現可能です。

freeze PATTERN…

指定された 1 つ以上のユニットを cgroup フリーザーを使用して凍結します。ユニットを凍結すると、そのユニットに対応する cgroup 内に含まれるすべてのプロセスが中断されます。中断されると、そのユニットのプロセスは CPU で実行される予定になりません。このコマンドは、統合された cgroup 階層を使用しているシステムでのみサポートされています。ユニットは、例えばユニットが停止される前に、ユニットに対してジョブが実行される直前に自動的に解凍されます。

thaw PATTERN…

コマンドラインで指定された 1 つ以上のユニットを解凍(フリーズ解除)します。これは、freeze コマンドの逆の操作であり、ユニットの cgroup 内のプロセスの実行を再開します。

set-property UNIT PROPERTY=VALUE…

サポートされている場合に実行時に指定したユニットのプロパティを設定します。これにより、実行時にリソース制御設定などの構成パラメータのプロパティを変更できます。すべてのプロパティを実行時に変更できるわけではありませんが、多くのリソース制御設定が変更可能です。変更は即座に適用され、将来の起動時にディスクに保存されます。ただし、--runtime が渡された場合は、設定は次の再起動までのみ適用されます。プロパティの割り当ての構文は、ユニットファイルでの割り当ての構文に密接に従います。

systemctl set-property foobar.service CPUWeight=200

指定されたユニットが非アクティブである場合、変更は以前に説明したようにディスクにのみ保存され、したがってユニットが開始されるときに有効になります。

このコマンドは複数のプロパティを同時に変更することを可能にし、個別に設定するよりも好ましいです。

systemctl set-property foobar.service CPUWeight=200 MemoryMax=2G IPAccounting=yes

ユニットファイルの構成設定と同様に、空の設定を割り当てると通常、プロパティがデフォルトにリセットされます。

systemctl set-property avahi-daemon.service IPAddressDeny=

bind UNIT PATH [PATH]

ホストから指定されたユニットのマウント名前空間にファイルまたはディレクトリをバインドマウントします。最初のパス引数は、ホスト上のソースファイルまたはディレクトリであり、2 番目のパス引数は、ユニットのマウント名前空間内の宛先ファイルまたはディレクトリです。後者が省略された場合、ユニットのマウント名前空間内の宛先パスは、ホスト上のソースパスと同じになります。--read-only スイッチと組み合わせると、読み取り専用のバインドマウントが作成されます。--mkdir スイッチと組み合わせると、マウントが適用される前に宛先パスが最初に作成されます。

現在、このオプションは、マウント名前空間内で実行されるユニットにのみサポートされています。このコマンドは、ディレクトリ、通常のファイル、デバイスノード、AF_UNIX ソケットノード、および FIFO をバインドマウントすることをサポートしています。バインドマウントは一時的であり、現在のユニットプロセスが存在するとすぐに元に戻されます。ここで言及されている名前空間は、バインドマウントが追加される名前空間であり、メインのサービスプロセスが実行されます。他の ExecReload=, ExecStartPre= などで実行されるプロセスは、異なる名前空間で実行されます。

mount-image UNIT IMAGE [PATH [PARTITION_NAME:MOUNT_OPTIONS]]

ホストから指定されたユニットのマウント名前空間にイメージをマウントします。最初のパス引数は、ホスト上のソースイメージであり、2 番目のパス引数は、ユニットのマウント名前空間内の宛先ディレクトリです。次の引数は、コロンで区切られたパーティション名と、そのパーティションのマウントオプションのカンマ区切りのリストのタプルとして解釈されます。形式は サービスの MountImages= 設定と同じです。--read-only スイッチと組み合わせると、読み取り専用のマウントが作成されます。--mkdir スイッチと組み合わせると、マウントが適用される前に宛先パスが最初に作成されます。

現在、このオプションは、マウント名前空間内で実行されるユニットにのみサポートされています。ここで言及されている名前空間は、イメージマウントが追加される名前空間であり、メインのサービスプロセスが実行される名前空間です。他の ExecReload=, ExecStartPre= などで実行されるプロセスは、異なる名前空間で実行されます。

systemctl mount-image foo.service /tmp/img.raw /var/lib/image root:ro,nosuid
systemctl mount-image --mkdir bar.service /tmp/img.raw /var/lib/baz/img

service-log-level SERVICE [LEVEL]

指定したサービスの現在のログレベルを表示します。LEVEL 引数が指定されていない場合、サービスによって報告された現在のログレベルが表示されます。

オプションの引数 LEVEL が指定されている場合、サービスの現在のログレベルを LEVEL に変更します。ログレベルは通常の syslog ログレベルである必要があります。つまり、0 から 7 の値、または emerg, alert, crit, err, warning, notice, info, debug のいずれかの文字列です。

サービスは、適切な BusName=destination プロパティを持ち、一般的な org.freedesktop.LogControl1 (5) インターフェイスを実装している必要があります。systemctl は、D-Bus 名 destination に対して org.freedesktop.LogControl1.LogLevel インターフェイスにアクセスするために一般的な D-Bus プロトコルを使用します。

service-log-target SERVICE [TARGET]

指定したサービスの現在のログターゲットを表示します。TARGET 引数が指定されていない場合、サービスによって報告された現在のログターゲットが表示されます。

オプションの引数 TARGET が指定されている場合、サービスの現在のログターゲットを TARGET に変更します。ログターゲットは、以下の文字列のいずれかである必要があります。

  • console: サービスの標準エラーストリームへのログ出力
  • kmsg: カーネルログバッファへのログ出力
  • journal: ネイティブジャーナルプロトコルを使用して systemd-journald.service (8) にログ出力
  • syslog: クラシックな syslog ソケット /dev/log へのログ出力
  • null: 何もログ出力しない
  • auto: 自動的に決定される選択肢。通常は、サービスが対話的に呼び出される場合は console に相当し、それ以外の場合は journal または syslog に相当

ほとんどのサービスにとって、ログターゲットのほんの一部が意味をなします。特に、ほとんどの「通常の」サービスでは、console, journal, null のみを実装すべきです。それ以外のものは、適切なログが確立される前の非常に初期のブート時にアクティブな低レベルのサービスにのみ適しています。

サービスは適切な BusName=destination プロパティを持ち、また一般的な org.freedesktop.LogControl1 (5) インターフェイスを実装している必要があります。systemctl は、D-Bus 名 destination に対して org.freedesktop.LogControl1.LogLevel インターフェイスにアクセスするために一般的な D-Bus プロトコルを使用します。

reset-failed [PATTERN…]

指定したユニットの failed 状態をリセットします。ユニット名が指定されていない場合は、すべてのユニットの状態をリセットします。ユニットがある方法で失敗すると(プロセスがゼロ以外のエラーコードで終了し、異常終了したりタイムアウトしたりした場合など)、自動的に failed 状態に入り、サービスが停止、再起動されるか、またはこのコマンドでリセットされるまで。その終了コードとステータスが管理者によって調査のために記録されます。

ユニットの failed 状態をリセットするだけでなく、さまざまなユニットごとのプロパティもリセットされます。すべてのユニットタイプの起動率制限カウンターがゼロにリセットされます。サービスユニットの再起動カウンターも同様にリセットされます。したがって、ユニットの起動制限が達成され、ユニットが再び起動を拒否する場合は、このコマンドを使用して再び起動可能にします。

Unit File Commands

list-unit-files [PATTERN…]

システムにインストールされているユニットファイルと、is-enabled で報告される有効状態の組み合わせをリストします。1 つ以上のパターンが指定されている場合、そのいずれかに一致するユニットファイルのみが表示されます。ユニットファイルのシステムパスに一致するパターンはサポートされていません。

このコマンドは、list-units とは異なり、明示的にインスタンス化されたユニットに加えて、テンプレートユニットもリストします。

LPIC systemctl コマンド

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)

トップへ戻る