systemctl - クラウドでオンライン

プログラム：

NAME

systemctl - systemd システムとサービス マネージャーを制御します。

SYNOPSIS

systemctl [オプション...] コマンド [名前...]

DESCRIPTION

systemctl 「systemd」システムの状態をイントロスペクトおよび制御するために使用される場合があります。
サービスマネージャ。 を参照してください。 systemd(1) 基本概念の紹介
このツールが管理する機能と。

OPTIONS

次のオプションが理解されます。

-t, --type =
引数は、次のような単位タイプのカンマ区切りのリストである必要があります。 サービス 　
ソケット.

引数の XNUMX つがユニット タイプである場合、ユニットをリストするときに、表示を特定のものに制限します。
ユニットの種類。 それ以外の場合は、すべてのタイプのユニットが表示されます。

特殊なケースとして、引数の XNUMX つが 助けます、許可される値のリストは次のようになります。
と印刷され、プログラムが終了します。

--state =
引数は、ユニットの LOAD、SUB、または ACTIVE 状態のカンマ区切りのリストである必要があります。
ユニットをリストする場合は、指定された状態にあるユニットのみを表示します。 使用 --state=失敗しました 〜へ
失敗したユニットのみを表示します。

特殊なケースとして、引数の XNUMX つが 助けます、許可される値のリストは次のようになります。
と印刷され、プログラムが終了します。

-p, --プロパティ=
ユニット/ジョブ/マネージャーのプロパティを表示する場合、 表示する コマンド、表示を次のように制限します
引数で指定されたプロパティ。 引数はコンマ区切りのリストにする必要があります。
「MainPID」などのプロパティ名。 特に指定しない限り、既知のプロパティはすべて表示されます。
複数回指定すると、指定した名前を持つすべてのプロパティが表示されます。 シェル
プロパティ名に対して補完が実装されています。

経営者自身にとっても、 systemctl 表示する 利用可能なすべてのプロパティが表示されます。 それらの
プロパティはに文書化されています systemd-system.confとします。

ユニットのプロパティはユニット タイプによって異なるため、任意のユニット (存在しないユニットも含めて) を表示します。
は、このタイプに関連するプロパティをリストする方法です。 同様に、ジョブを表示すると、
すべてのジョブに関連するプロパティをリストします。 ユニットのプロパティは次の場所に文書化されています。
systemd.unit(5)、各ユニットタイプのページ systemd.service（5）
systemd.ソケット（5）など

-a, - すべて
ユニットをリストするときは、状態に関係なく、ロードされたすべてのユニットを表示します。
非アクティブなユニット。 ユニット/ジョブ/マネージャーのプロパティを表示する場合は、すべてのプロパティを表示します
設定されているかどうかは関係ありません。

システムにインストールされているすべてのユニットをリストするには、 リスト-ユニット-ファイル 代わりにコマンド。

-r, -再帰的
ユニットをリストする場合は、ローカル コンテナのユニットも表示します。 ローカルコンテナの単位
接頭辞としてコンテナ名が付けられ、単一のコロン文字 (「:」) で区切られます。

- 逆行する
ユニット間の逆の依存関係を表示します。 リスト依存関係、つまりフォローします
型の依存関係 募集中=, 必須者=, 部分=, 境界線=の代わりに、 欲しいもの= 　
類似した。

- 後
自律的AI リスト依存関係、指定された単位より前に並べられた単位を表示します。 で
つまり、次のユニットを再帰的にリストします。 後= 依存。

任意のことに注意してください 後= 依存関係は自動的にミラーリングされて、 前=
依存。 一時的な依存関係は明示的に指定できますが、作成されることもあります。
暗黙的に以下のユニットに対して 募集中= ターゲット (参照 systemd.ターゲット(5))、として
他のディレクティブの結果 (たとえば、 必要なマウント数=）。 明示的にも、
暗黙的に導入された依存関係は、 リスト依存関係.

- 前
自律的AI リスト依存関係、指定された単位の後に順序付けされた単位を示します。 で
つまり、次のユニットを再帰的にリストします。 前= 依存。

-l, - 満杯
ユニット名を省略したり、プロセス ツリー エントリ、ジャーナル出力を省略したり、ユニットを切り詰めたりしないでください。
の出力内の説明 status, リスト単位, ジョブのリスト, リストタイマー.

--show-types
ソケットを表示する場合は、ソケットの種類を表示します。

--ジョブモード=
新しいジョブをキューに入れるとき、このオプションは、すでにキューに入れられているジョブの処理方法を制御します。 それ
「失敗」、「置換」、「不可逆的に置換」、「分離」のいずれかを受け取ります。
「ignore-dependents」、「ignore-requirements」、または「flush」。 デフォルトは「置換」です。ただし、
時 隔離する 「分離」ジョブ モードを暗黙的に示すコマンドが使用されます。

「fail」が指定されており、要求された操作が保留中のジョブと競合する場合 (詳細
具体的には、すでに保留中の開始ジョブを停止ジョブに取り消すか、
その逆)、操作が失敗する原因となります。

「replace」(デフォルト) が指定されている場合、競合する保留中のジョブは置き換えられます。
必要に応じて。

「replace-irreversibly」が指定されている場合は、「replace」と同様に操作しますが、新しいマークも付けます。
取り返しのつかない仕事。 これにより、今後競合するトランザクションが置き換えられるのを防ぎます。
これらのジョブ (または、不可逆的なジョブがまだ保留中の状態でキューに入れられることもあります)。
取り消しできないジョブは、引き続き次のコマンドを使用してキャンセルできます。 キャンセル

「isolate」は開始操作にのみ有効で、他のすべてのユニットが停止されます。
指定したユニットの起動時。 このモードは、次の場合に常に使用されます。 隔離する command
使用されている。

「flush」を使用すると、新しいジョブがキューに入れられたときに、キューに入れられたすべてのジョブがキャンセルされます。

「ignore-dependency」が指定されている場合、このユニットのすべての依存関係が無視されます。
新しいジョブが作成され、操作はすぐに実行されます。 合格した場合、必要な単位はありません。
渡されたユニットは取り込まれ、順序付けの依存関係は考慮されません。 これは
これは主に管理者用のデバッグおよびレスキュー ツールであり、管理者は使用しないでください。
分野の様々なアプリケーションで使用されています。

「ignore-requirements」は「ignore-dependents」に似ていますが、
要件の依存関係は無視されますが、順序付けの依存関係はそのまま残ります。
光栄です。

- 不合格
の省略形 --ジョブモード=失敗します。

と一緒に使用する場合 kill コマンドでユニットが殺されていない場合、操作の結果は次のとおりです。
エラー。

-i, --ignore-inhibitors
システムのシャットダウンまたはスリープ状態が要求された場合、インヒビター ロックは無視されます。
アプリケーションは、特定の重要な操作を回避するためにインヒビター ロックを確立できます。
(CD 書き込みなど) は、システムのシャットダウンまたはスリープ状態によって中断されます。
どのユーザーもこれらのロックを取得でき、特権ユーザーはこれらのロックをオーバーライドできます。 もしあれば
ロックが取られると、シャットダウンおよびスリープ状態の要求は通常失敗します (
特権があるかどうか)、アクティブなロックのリストが出力されます。 ただし、
--ignore-inhibitors が指定されている場合、ロックは無視され印刷されません。
とにかく操作が試行されましたが、追加の権限が必要な可能性があります。

-q, - 静かな
さまざまなコマンドの結果やヒントの出力を抑制します。
切り詰められたログ行。 これは、出力されたコマンドの出力を抑制しません。
出力が唯一の結果です(例: 表示する）。 エラーは常に出力されます。

--ブロックなし
要求された操作が完了するまで同期的に待機しないでください。 そうでない場合
指定すると、ジョブは検証され、キューに入れられ、 systemctl ユニットが到着するまで待ちます
起動が完了しました。 この引数を渡すと、検証されてキューに入れられるだけです。

- ユーザー
発信元のユーザーのサービス マネージャーではなく、そのユーザーのサービス マネージャーに相談してください。
システム。

- システム
システムのサービスマネージャーに相談してください。 これは暗黙のデフォルトです。

--壁なし
停止、電源オフ、再起動の前にウォールメッセージを送信しないでください。

- グローバル
と一緒に使用する場合 enable 　 disable、グローバル ユーザー構成ディレクトリを操作します。
したがって、すべてのユーザーの今後のすべてのログインに対して、グローバルにユニット ファイルを有効または無効にします。

- リロード禁止
と一緒に使用する場合 enable 　 disable、後にデーモン設定を暗黙的にリロードしないでください。
変更を実行します。

--no-ask-パスワード
と一緒に使用する場合 start および関連コマンドを使用すると、パスワードの要求が無効になります。 背景
サービスでは、ロックを解除する場合などに、パスワードまたはパスフレーズ文字列の入力が必要になる場合があります。
システムハードディスクまたは暗号証明書。 このオプションが指定されていない限り、
コマンドはターミナルから呼び出されます。 systemctl 端末上でユーザーにクエリを実行します
必要な秘密のために。 この動作をオフにするには、このオプションを使用します。 この場合、
パスワードは他の手段（グラフィカルパスワードなど）で指定する必要があります。
エージェント)、サービスが失敗する可能性があります。 これにより、ユーザーへのクエリも無効になります
特権操作の認証。

--kill-who=
と一緒に使用する場合 kill、シグナルを送信するプロセスを選択します。 次のいずれかである必要があります メイン,
コントロール or を メインプロセスのみを強制終了するか、制御プロセスのみを強制終了するか、または
ユニットのすべてのプロセス。 ユニットのメインプロセスは、
それの生涯。 ユニットの制御プロセスは、管理者によって呼び出されるプロセスです。
それの状態変化を引き起こします。 たとえば、すべてのプロセスが開始されたのは、
ExecStartPre=, ExecStop= or ExecReload= サービスユニットの設定は制御されます
プロセス。 制御プロセスはユニットごとに一度に XNUMX つだけであることに注意してください。
状態変更を一度に実行します。 タイプのサービスの場合 タイプ=フォーク、 初期
マネージャーによって開始されたプロセス ExecStart = は制御プロセスですが、プロセスは
最終的にそのプロセスによって分岐されたプロセスは、ユニットのメイン プロセスとみなされます (
判断できます）。 これは、他のタイプのサービス ユニットの場合とは異なります。
マネージャーによってプロセスが分岐されました ExecStart = 常にメインプロセス自体になります。 あ
サービスユニットは、XNUMX または XNUMX つのメインプロセス、XNUMX または XNUMX つの制御プロセス、および
任意の数の追加プロセス。 すべてのユニット タイプがこれらのタイプのプロセスを管理するわけではありません
しかし。 たとえば、マウントユニットの場合、制御プロセスが定義されます（
の呼び出し / bin / mount 　 /bin/アンマウント) ですが、メインプロセスは定義されていません。 もし
省略、デフォルトは を.

-s, --信号=
と一緒に使用する場合 kill、選択したプロセスに送信するシグナルを選択します。 次のいずれかである必要があります
などのよく知られた信号指定子 シグターム, SIGINT or シグストップ。 省略した場合は、
デフォルトは シグターム.

-f, - 力
と一緒に使用する場合 enable、既存の競合するシンボリックリンクを上書きします。

と一緒に使用する場合 停止する, 電源オフ, リブート or ケクセック、選択した操作を実行します。
すべてのユニットをシャットダウンします。 ただし、すべてのプロセスが強制的に強制終了され、すべてのファイルが削除されます。
システムは読み取り専用でアンマウントまたは再マウントされます。 したがって、これは抜本的ではありますが、比較的
即時再起動を要求する安全なオプション。 もし - 力 これらに対して XNUMX 回指定されます
操作は、プロセスを終了したりせずにすぐに実行されます。
ファイル システムをアンマウントします。 警告: 指定中 - 力 これらのいずれかを XNUMX 回
操作によりデータが失われる可能性があります。

--メッセージ=
と一緒に使用する場合 停止する, 電源オフ, リブート or ケクセックを説明する短いメッセージを設定します。
手術の理由。 メッセージはデフォルトと一緒に記録されます。
シャットダウンメッセージ。

- 今
と一緒に使用する場合 enable、ユニットも開始されます。 と一緒に使用する場合 disable or mask,
ユニットも停止します。 開始または停止操作は、次の場合にのみ実行されます。
それぞれの有効化または無効化操作は成功しました。

--root =
と一緒に使用する場合 enable/disable/有効になっています (および関連コマンド)、代替ルートを使用する
ユニットファイルを探すときのパス。

- ランタイム
と一緒に使用する場合 enable, disable, edit、(および関連コマンド)、変更のみを行います
一時的に保存されるため、次回の再起動時に失われます。 これにより次のような効果が得られます
のサブディレクトリでは変更は行われません の/ etc しかし、 / run、同一のイミディエートを持つ
ただし、後者は再起動時に失われるため、変更も失われます。

同様に、 セットプロパティ、一時的にのみ変更を加えます。
次回の再起動時に失われます。

--プリセットモード=
「full」(デフォルト)、「enable-only」、「disable-only」のいずれかを受け取ります。 と一緒に使用すると、
プリセット or プリセットオール コマンド、ユニットを無効にするか有効にするかを制御します
事前に設定されたルールに従って、または有効のみ、または無効のみ。

-n, --lines =
と一緒に使用する場合 status、表示する仕訳帳明細行の数を制御します。
最近のもの。 正の整数の引数を受け取ります。 デフォルトは 10 です。

-o, --output =
と一緒に使用する場合 status、表示される仕訳エントリの書式設定を制御します。
利用可能な選択肢については、を参照してください。 journalctl(1)。 デフォルトは「ショート」です。

-- ファームウェアのセットアップ
と一緒に使用する場合 リブート コマンドで、システムのファームウェアにブートするよう指示します。
セットアップモード。 これは現在、一部の EFI システムでのみサポートされており、次の場合にのみサポートされていることに注意してください。
システムは EFI モードで起動されました。

- プレーン
と一緒に使用する場合 リスト依存関係, リスト単位 or リストマシン、出力は
ツリーではなくリストとして出力され、黒丸は省略されています。

-H, --host =
リモートで操作を実行します。 ホスト名、またはユーザー名とホスト名を指定します
「@」で区切って接続します。 ホスト名には、オプションで接尾辞を付けることができます
「：」で区切られたコンテナ名。これは、上の特定のコンテナに直接接続します。
指定されたホスト。 これはSSHを使用してリモートマシンマネージャーインスタンスと通信します。
コンテナ名は次のように列挙できます 機械制御 -H 主催者.

-M, --マシン=
ローカルコンテナ上で操作を実行します。 接続するコンテナ名を指定します。

-ポケットベルなし
出力をポケットベルにパイプしないでください。

-凡例なし
凡例、つまりヒントを含む列ヘッダーとフッターを印刷しないでください。

-h, - 助けて
短いヘルプテキストを出力して終了します。

- バージョン
短いバージョンの文字列を出力して終了します。

コマンド

次のコマンドが理解されます。

ユニット コマンド
リスト単位 [パターン...]
既知の単位をリストします (で指定された制限に従います) -t）。 XNUMX つ以上の場合 パターンs
が指定されている場合、それらのいずれかに一致する単位のみが表示されます。

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

リストソケット [パターン...]
リスニングアドレス順にソケットユニットをリストします。 XNUMX つ以上の場合 パターンが指定されており、
そのうちの XNUMX つに一致するソケット ユニットのみが表示されます。 次のような出力が生成されます

リッスンユニットが起動します
/dev/initctl systemd-initctl.socket systemd-initctl.service
...
[::]:22 sshd.socket sshd.service
kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service

5つのソケットがリストされています。

注: アドレスにはスペースが含まれる可能性があるため、この出力は次の用途には適していません。
プログラマティック消費。

オプションも参照してください --show-types, - すべて, --state =.

リストタイマー [パターン...]
次に経過する時間の順にタイマー ユニットをリストします。 XNUMX つ以上の場合 パターンsです
指定すると、それらのいずれかに一致する単位のみが表示されます。

オプションも参照してください - すべて 　 --state =.

start パターン...
コマンドラインで指定した XNUMX つ以上のユニットを開始 (アクティブ化) します。

グロブ パターンは、現在ロードされているユニットのプライマリ名のセットに対して動作することに注意してください。
アクティブではなく、障害状態でもないユニットは通常ロードされず、
どのパターンにも一致しません。 さらに、インスタンス化されたユニットの場合、
systemd は、インスタンスが開始されるまでインスタンス名を認識しないことがよくあります。
したがって、glob パターンを使用すると、 start 有用性は限られています。 また、二次的な
ユニットのエイリアス名は考慮されません。

stop パターン...
コマンドラインで指定した XNUMX つ以上のユニットを停止 (非アクティブ化) します。

リロード パターン...
コマンドラインにリストされているすべてのユニットに設定を再ロードするように要求します。 ご了承ください
これにより、ユニット構成ファイルではなく、サービス固有の構成が再ロードされます。
システムドの。 systemd にユニットの構成ファイルを再ロードさせたい場合は、
デーモン-リロード 指示。 言い換えると、Apache の例では、これは次のようになります。
apache.service systemd ユニットではなく、Web サーバーの Apache の httpd.conf をリロードします
ファイルにソフトウェアを指定する必要があります。

このコマンドを混同しないでください。 デーモン-リロード

再起動 パターン...
コマンドラインで指定した XNUMX つ以上のユニットを再起動します。 ユニットが動作していない場合
それでも、それらは始まるでしょう。

再起動を試みる パターン...
ユニットが実行中の場合は、コマンドラインで指定した XNUMX つ以上のユニットを再起動します。 これ
ユニットが実行されていない場合は何もしません。

リロードまたは再起動 パターン...
XNUMX つ以上のユニットがサポートされている場合はリロードします。 そうでない場合は、代わりに再起動してください。 もし
ユニットはまだ実行されていないため、開始されます。

リロードまたは再起動を試行 パターン...
XNUMX つ以上のユニットがサポートされている場合はリロードします。 そうでない場合は、代わりに再起動してください。 これにより、
ユニットが動作していない場合は何もありません。

隔離する NAME
コマンドラインで指定したユニットとその依存関係を起動し、その他すべてを停止します。
拡張子なしのユニット名を指定した場合は、拡張子「.target」が仮定されます。

これは、従来の init システムでのランレベルの変更に似ています。 の 隔離する
このコマンドは、新しいユニットで有効になっていないプロセスを直ちに停止します。
現在使用しているグラフィック環境や端末も含まれます。

これは次のユニットでのみ許可されることに注意してください。 許可分離= 有効になっています。 見る
systemd.unit詳細は（5）。

kill パターン...
ユニットの XNUMX つ以上のプロセスにシグナルを送信します。 使用 --kill-who= どれを選択するか
殺すためのプロセス。 使用 --信号= 送信する信号を選択します。

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

失敗しました パターン...
指定されたユニットのいずれかが「障害」状態にあるかどうかを確認します。 終了コードを返します
0 少なくとも XNUMX つが失敗した場合は、それ以外の場合は XNUMX 以外になります。 ない限り - 静かな 指定されている場合、これは
また、現在のユニットの状態を標準出力に出力します。

status [パターン... |PID...]]
XNUMX つ以上のユニットに関する簡潔な実行時ステータス情報を表示し、その後に最新のユニットを表示します。
ジャーナルからのログ データ。 単位が指定されていない場合は、システムのステータスを表示します。 組み合わせれば
　 - すべて、すべてのユニットのステータスも表示します (で指定された制限の対象となります)
-t）。 PID が渡された場合は、プロセスが属するユニットに関する情報を表示します。

この関数は、人間が判読できる出力を生成することを目的としています。 探しているなら
コンピューターで解析可能な出力、使用 表示する その代わり。 デフォルトでは、この関数は 10 件のみを表示します
出力の行数を変更し、ターミナル ウィンドウに収まるように行を省略します。 これは可能です
で変更されました -行 　 - 満杯、 上記を参照。 加えて、 journalctl -ユニット=NAME or
journalctl --ユーザーユニット=NAME メッセージに対して同様のフィルターを使用します。
便利。

表示する [パターン... |採用情報...]
XNUMX つ以上のユニット、ジョブ、またはマネージャー自体のプロパティを表示します。 引数がない場合は、
指定すると、マネージャーのプロパティが表示されます。 ユニット名を指定した場合、
ユニットのプロパティが表示され、ジョブIDが指定されている場合はジョブのプロパティが表示されます。
示されています。 デフォルトでは、空のプロパティは抑制されます。 使用 - すべて それらも見せるために。 に
表示する特定のプロパティを選択して使用します --プロパティ=。 このコマンドの目的は、
コンピューターで解析可能な出力が必要な場合に常に使用されます。 使用 status あなたが探しているなら
人間が判読できる形式の出力。

cat パターン...
XNUMX つ以上のユニットのバッキング ファイルを表示します。 「フラグメント」と「ドロップイン」を出力します（ソース
ファイル) のユニット。 各ファイルの前には、ファイル名を含むコメントが付いています。

セットプロパティ NAME 割り当て...
これがサポートされている場合は、実行時に指定されたユニット プロパティを設定します。 これにより、
リソース制御設定などの構成パラメータのプロパティを変更する
ランタイム。 すべてのプロパティが実行時に変更されるわけではありませんが、多くのリソース制御は
設定（主に systemd.リソース制御(5)) かもしれません。 変更が適用されます
ただし、次の場合を除き、即座に保存され、将来のブートに備えてディスクに保存されます。 - ランタイム が渡されます。
この場合、設定は次回再起動するまでのみ適用されます。 プロパティの構文
割り当ては、ユニット ファイルの割り当ての構文に厳密に従います。

例： systemctl セットプロパティ foob​​ar.service CPUシェア=777

指定したユニットが非アクティブであると思われる場合、変更はディスクにのみ保存されます。
前述したように、ユニットの起動時に有効になります。

このコマンドでは複数のプロパティを同時に変更できることに注意してください。
個別に設定するよりも望ましいです。 ユニットファイルの構成設定と同様に、
空のリストをリストパラメータに代入すると、リストがリセットされます。

助けます パターン... |PID...
利用可能な場合は、XNUMX つ以上のユニットのマニュアル ページを表示します。 PID が指定されている場合、マニュアル
プロセスが属するユニットのページが表示されます。

リセット失敗 [パターン...]
指定されたユニットの「失敗」状態をリセットするか、ユニット名が渡されない場合はリセットします。
すべてのユニットの状態。 ユニットが何らかの方法で失敗したとき（つまり、プロセスが終了したとき）
ゼロ以外のエラーコード、異常終了またはタイムアウト）の場合は、自動的に
「失敗」状態に入り、その終了コードとステータスが内省のために記録されます。
このコマンドでサービスが再起動またはリセットされるまで、管理者は管理者に代わってサービスを再起動する必要があります。

リスト依存関係 [NAME]
指定されたユニットに必要なユニットと必要なユニットを表示します。 これはユニットを再帰的にリストします
以下 必要なもの=, 必須=, からなる=, 欲しいもの=, バインド先= 依存関係。 いいえの場合
単位が指定されている場合は、default.target が暗黙的に指定されます。

デフォルトでは、ターゲットユニットのみが再帰的に展開されます。 いつ - すべて 合格しました、すべて
他のユニットも同様に再帰的に展開されます。

オプション - 逆行する, - 後, - 前 どの種類の依存関係を変更するために使用できますか
示されています。

ユニット File コマンド
リスト-ユニット-ファイル [パターン...]
インストールされているユニット ファイルとその有効化状態をリストします (レポートによる) 有効になっています） もし
1つ以上 パターンが指定されており、そのファイル名を持つユニットのみ (最後のコンポーネントのみ)
パスの) のいずれかに一致するものが表示されます。

enable NAME...
コマンドでの指定に従って、XNUMX つ以上のユニット ファイルまたはユニット ファイル インスタンスを有効にします。
ライン。 これにより、「[Install]」セクションでエンコードされた多数のシンボリックリンクが作成されます。
ユニットファイル。 シンボリックリンクが作成された後、systemd 構成は次のようになります。
リロード（と同等の方法で） デーモン-リロード) 変更が確実に行われるようにするため、
すぐに考慮されます。 これは次のことを行うことに注意してください の効果もあります
有効になっているユニットのいずれかを開始します。 これが必要な場合は、次のいずれか - 今 でなければなりません
このコマンドと一緒に使用するか、追加の start コマンドを呼び出す必要があります
ユニット。 また、インスタンスを有効にする場合、シンボリックリンクの名前が同じになることにも注意してください。
インスタンスはインストール場所に作成されますが、それらはすべて同じものを指します
テンプレートユニットファイル。

このコマンドは、実行されたアクションを出力します。 この出力は、次のパラメータを渡すことで抑制される場合があります。
- 静かな.

この操作では、ユニットに対して推奨されたシンボリックリンクのみが作成されることに注意してください。 この間
コマンドは、ユニット構成ディレクトリを操作するための推奨される方法です。
管理者は、配置または削除することで手動で追加の変更を自由に行うことができます。
ディレクトリ内のシンボリックリンク。 これは、次のような構成を作成する場合に特に便利です。
推奨されているデフォルトのインストールから逸脱しています。 この場合、管理者は次のことを行う必要があります。
必ず呼び出すようにしてください デーモン-リロード 必要に応じて手動で変更を確実に行う
考慮に入れられます。

ユニットを有効にすることと、
start 指示。 ユニットの有効化と開始は直交しています。ユニットは、
開始され、有効化されずに開始されます。 有効にすると、ユニットを接続するだけです
さまざまな推奨場所 (たとえば、ユニットが自動的に起動されるようにする)
起動時、または特定の種類のハードウェアが接続されているとき）。 実際にスポーンを開始する
デーモンプロセス (サービスユニットの場合)、またはソケットをバインドする (ソケットの場合)
単位）など。

かどうかに応じて - システム, - ユーザー, - ランタイムまたは - グローバル 指定されている場合、これは
システムのユニットを、呼び出し側ユーザーのみ、このブートのみに対して有効にします。
システム、すべてのユーザーの今後のすべてのログイン、またはこのブートのみ。 注意してください。
最後のケースでは、systemd デーモン設定はリロードされません。

使い方 enable マスクされたユニットではエラーが発生します。

disable NAME...
XNUMX つ以上のユニットを無効にします。 これにより、指定されたユニット ファイルへのすべてのシンボリック リンクが、
ユニット構成ディレクトリを削除するため、によって行われた変更が元に戻されます。 enable。 注意
ただし、これによりユニットファイルへのすべてのシンボリックリンクが削除されます（つまり、マニュアルファイルを含む）
追加）、実際に作成されたものだけでなく、 enable。 この呼び出しは暗黙的にリロードします
ユニットの無効化が完了した後の systemd デーモン構成。 注記
このコマンドは、無効化されているユニットを暗黙的に停止しないことに注意してください。 これなら
どちらかが望ましい - 今 このコマンドと一緒に使用するか、追加のコマンドを使用する必要があります。
stop コマンドは後で実行する必要があります。

このコマンドは、実行されたアクションを出力します。 この出力は、次のパラメータを渡すことで抑制される場合があります。
- 静かな.

このコマンドは - システム, - ユーザー, - ランタイム 　 - グローバル と同じような方法で
enable.

再度有効にする NAME...
コマンド ラインでの指定に従って、XNUMX つ以上のユニット ファイルを再度有効にします。 これは
の組み合わせ disable 　 enable ユニットのシンボリックリンクをリセットするのに役立ちます。
ユニットファイルの「[Install]」セクションで設定されたデフォルトで有効になります。

プリセット NAME...
コマンドラインでの指定に従って、XNUMX つ以上のユニット ファイルをデフォルトにリセットします。
プリセットポリシーファイルで設定されます。 これは次と同じ効果があります disable or enable,
ユニットがプリセットファイルにどのようにリストされているかに応じて異なります。

　 --プリセットモード= ユニットを有効または無効にするか、またはのみを制御するかどうかを制御します。
有効、または無効のみ。

プリセットポリシーの形式の詳細については、を参照してください。 systemd.プリセット(5)。 多くのための
プリセットの概念については、を参照してください。 プリセット[1] 文書。

プリセットオール
インストールされているすべてのユニット ファイルを、プリセット ポリシー ファイルに設定されているデフォルトにリセットします。
（上記を参照）。

　 --プリセットモード= ユニットを有効または無効にするか、またはのみを制御するかどうかを制御します。
有効、または無効のみ。

有効になっています NAME...
指定されたユニット ファイルのいずれかが有効かどうかを確認します ( enable）。 戻り値
少なくとも 0 つが有効な場合は終了コード XNUMX、それ以外の場合は XNUMX 以外の終了コード。 現在の値を出力します
ステータスを有効にします (表を参照)。 この出力を抑制するには、次を使用します - 静かな.

表 1. 有効になっています 出力
┌─────────┬──────────┬─── ───┐
│お名前 │ 詳細説明 │ 出口 CPコード │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│"enabled" │ .wants/ 経由で有効化、│ │
--------------------------------------------------------┤ .requires/ またはエイリアス │ │
│"enabled-runtime" │ シンボリックリンク (永続的に │ 0 │
││ / etc / systemd / system /、または │ │
│ │ 一時的に │ │
││ / run / systemd / system /）。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│「リンク済み」 │ を通じて利用可能 │ │
--------------------------------------------------------┤ への XNUMX つ以上のシンボリックリンク │ │
│"linked-runtime" │ ユニットファイル │ │
│ │ (永久に │ │
││ / etc / systemd / system / または │ │
│ │ 一時的に │ > 0 │
││ / run / systemd / system /）、│ │
│ │ ユニットなのに │ │
│ │ ファイルが存在する可能性があります │ │
│ │ ユニットファイル外 │ │
│ │ 検索パス。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│「マスク」│完全に無効化されているため、│ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┤
│"masked-runtime" │ は失敗します (永続的に │ > 0 │
│ │ で / etc / systemd / system / ││
│ │ または一時的に │ │
│ │ /run/systemd/systemd/)。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│"static" │ ユニットファイルはありません │ 0 │
│ │ 有効になっていますが、│ │ はありません
│ │ を可能にするための規定 │ │
│ │ 「[インストール]」内の │ │
│ │ セクション。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│"indirect" │ ユニットファイル自体は │ 0 │
│ │ 有効になっていませんが、有効になっています │ │
│ │ 空ではない また= ││
│ │ での設定 │ │
│ │ 「[インストール]」セクション、│ │
│ │ 他のユニットファイルのリスト │ │
│ │ それが有効になる可能性があります。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│"無効" │ ユニットファイルがありません │ > 0 │
│ │ 有効ですが、│ │ が含まれています
│ │ 「[インストール]」セクションに │ │
│ │ 設置 │ │
│ │ 指示。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┤
│"bad" │ ユニットファイルが無効、または │ > 0 │
│ │ 別のエラーが発生しました。 │ │
│ │ ご注意ください 有効になっています ││
│ │ 実際には戻りません │ │
│ │ この状態ですが、 │ │ を印刷します。
│ │ 代わりにエラーメッセージが表示されます。 │ │
│ │ ただし、ユニットファイル │ │
│ │ によって印刷されたリスト │ │
││ リスト-ユニット-ファイル かもしれない │ │
│ │ 見せてください。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ───┘

mask NAME...
コマンドラインでの指定に従って、XNUMX つ以上のユニット ファイルをマスクします。 これにより、これらがリンクされます
ユニットを /dev/null に変更すると、起動できなくなります。 これはより強力なバージョンです
disable、有効化を含むユニットのあらゆる種類のアクティベーションが禁止されるため、
そして手動アクティベーション。 このオプションは注意して使用してください。 これは、 - ランタイム オプション
システムを次回再起動するまで一時的にマスクするだけです。 の - 今 オプションはすることができます
ユニットも確実に停止するために使用されます。

unmask NAME...
コマンド ラインでの指定に従って、XNUMX つ以上のユニット ファイルのマスクを解除します。 これにより、
の効果 mask.

ファイル名...
ユニット ファイル検索パスにないユニット ファイルをユニット ファイル検索にリンクする
パス。 これには、ユニット ファイルへの絶対パスが必要です。 この効果は元に戻すことができます
　 disable。 このコマンドの効果は、ユニット ファイルが利用可能になることです。 start
およびその他のコマンドですが、ユニット検索パスに直接インストールされません。

追加希望 TARGET NAME..., 追加要件 TARGET NAME...
指定された依存関係にそれぞれ「Wants=」または「Requires=」を追加します。 TARGET の
XNUMX つ以上のユニット。

このコマンドは - システム, - ユーザー, - ランタイム 　 - グローバル 同様の方法で
enable.

edit NAME...
ドロップイン スニペットまたは置換ファイル全体を編集する場合は、 - 満杯 を指定すると拡張されます
または、指定された単位をオーバーライドします。

かどうかに応じて - システム （デフォルト）、 - ユーザーまたは - グローバル 指定されている場合、これは
コマンドは、システムまたは呼び出し用のユニットごとにドロップイン ファイルを作成します。
ユーザー、またはすべてのユーザーのすべての Futures ログインに対して。 次に、エディター (「環境」を参照)
以下のセクション) は、実際のファイルに書き込まれる一時ファイルに対して呼び出されます。
エディタが正常に終了した場合の場所。

If - 満杯 が指定されている場合、ドロップインを作成する代わりに元のユニットがコピーされます。
ファイル。

If - ランタイム を指定すると、変更は一時的に行われます / run そして彼らは
次回の再起動時には失われます。

終了時に一時ファイルが空の場合、関連ユニットの変更は行われません。
キャンセル。

ユニットが編集された後、systemd 構成が再ロードされます (次のような方法で)。
に相当 デーモン-リロード).

このコマンドを使用してユニットをリモートで編集することはできないことに注意してください。
にあるユニットを一時的に編集します の/ etc、/run よりも優先されるためです。

デフォルトを取得
ブート先のデフォルトのターゲットを返します。 ターゲットユニット名を返します。
default.target はエイリアス (シンボリックリンク) されています。

デフォルト設定 NAME
ブート先のデフォルトのターゲットを設定します。 これにより、default.target エイリアスが次のように設定 (シンボリックリンク) されます。
指定されたターゲットユニット。

エスプレッソマシン コマンド
リストマシン [パターン...]
ホストと実行中のすべてのローカル コンテナをその状態とともに一覧表示します。 XNUMX つ以上の場合
パターンが指定されている場合、それらのいずれかに一致するコンテナのみが表示されます。

Job コマンド
ジョブのリスト [パターン...]
進行中のジョブをリストします。 XNUMX つ以上の場合 パターンが指定されている場合は、次のジョブのみが指定されます
それらのいずれかに一致する単位が表示されます。

キャンセル 採用情報...
コマンドラインで数値ジョブ ID で指定された XNUMX つ以上のジョブをキャンセルします。 いいえの場合
ジョブ ID が指定されている場合は、保留中のジョブをすべてキャンセルします。

環境 コマンド
ショー環境
systemd マネージャー環境ブロックをダンプします。 環境ブロックがダンプされます
シェルスクリプトへのソースに適した単純な形式です。 この環境
ブロックは、マネージャーが生成するすべてのプロセスに渡されます。

セット環境 変数=値...
コマンドでの指定に従って、XNUMX つ以上の systemd マネージャー環境変数を設定します。
ライン。

環境の設定解除 変数...
XNUMX つ以上の systemd マネージャー環境変数の設定を解除します。 変数名だけの場合は、
指定すると、その値に関係なく削除されます。 変数と値が
を指定すると、変数は指定された値を持つ場合にのみ削除されます。

インポート環境 [変数...]
クライアントに設定されている XNUMX つ以上の環境変数をすべて systemd にインポートします。
マネージャー環境ブロック。 引数が渡されない場合、環境ブロック全体が
輸入された。 それ以外の場合は、XNUMX つ以上の環境変数名のリストを次のようにする必要があります。
渡されると、そのクライアント側の値がマネージャーの環境にインポートされます。
ブロック。

マネージャー ライフサイクル コマンド
デーモン-リロード
systemd マネージャー構成をリロードします。 これにより、すべてのジェネレーターが再実行されます (「
systemd.generator(7))、すべてのユニット ファイルを再ロードし、依存関係ツリー全体を再作成します。
デーモンがリロードされている間、すべてのソケット systemd がユーザーに代わってリッスンします。
構成はアクセス可能なままになります。

このコマンドを混同しないでください。 リロード

デーモン再実行
systemdマネージャーを再実行します。 これにより、マネージャーの状態がシリアル化され、
状態を再度処理して逆シリアル化します。 このコマンドは次の場合を除いてほとんど役に立ちません。
デバッグとパッケージのアップグレード。 場合によっては、重量級として役立つかもしれません
デーモン-リロード。 デーモンが再実行されている間、systemd はすべてのソケットをリッスンします。
ユーザー設定に代わってアクセス可能な状態が維持されます。

システム コマンド
システムが実行中です
システムが動作しているかどうかを確認します。 これは、次の場合に成功 (終了コード 0) を返します。
システムは完全に稼働しており、特に起動、シャットダウン、メンテナンス中ではない
モードであり、失敗したサービスはありません。 それ以外の場合は失敗が返されます (終了コードがゼロ以外)。
さらに、現在の状態が短い文字列で標準出力に出力されます。を参照してください。
下の表。 使用 - 静かな この出力を抑制するには、

表 2. システムが実行中です 出力
┌─────────┬───────────┬─── ────┐
│お名前 │ 詳細説明 │ 出口 CPコード │
§───────┼───────────┼─── ──┤
│初期化する │ 初期起動、前 │ > 0 │
│ │ Basic.target に到達しました │ │
│ │ または メンテナンス 状態 │ │
│ │入りました。 │ │
§───────┼───────────┼─── ──┤
│起動 │ 遅い起動、前 │ > 0 │
│ │ ジョブキューがアイドル状態になります │ │
│ │ 初めて、または │ │
│ │ 救いの一つ │ │
│ │ 目標は達成されました。 │ │
§───────┼───────────┼─── ──┤
│ランニング │ システムは完全です │ 0 │
│ │ 動作中です。 │ │
§───────┼───────────┼─── ──┤
│劣化した │ システムは │ > 0 │
│ │ 動作可能ですが、XNUMX つまたは │ │
│ │ さらに多くのユニットが失敗しました。 │ │
§───────┼───────────┼─── ──┤
│メンテナンス │ 救助または緊急事態 │ > 0 │
│ │ ターゲットはアクティブです。 │ │
§───────┼───────────┼─── ──┤
│停止 │ 管理人は閉店しています │ > 0 │
│ │ ダウン。 │ │
§───────┼───────────┼─── ──┤
│オンライン │ 管理人はいません │ > 0 │
│ │ 走っています。 具体的には、│ │
│ │ これは運営です │ │
│ │ 互換性がない場合の状態 │ │
│ │ プログラムは次のように実行されています │ │
│ │ システム管理者 (PID 1)。 │ │
§───────┼───────────┼─── ──┤
│未知の │ 動作状態 │ > 0 │
│ │ 特定できませんでした、│ │
│ │ リソース不足のため │ │
│ │ または別のエラーの原因。 │ │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ──┘

デフォルト
デフォルトモードに入ります。 これはほぼ次と同等です 隔離する デフォルトのターゲット.

レスキュー用機材
レスキューモードに入ります。 これはほぼ次と同等です 隔離する レスキュー.ターゲット、印刷物も
すべてのユーザーへのウォールメッセージ。

緊急事態
緊急モードに入ります。 これはほぼ次と同等です 隔離する 緊急目標、 だけでなく
すべてのユーザーにウォール メッセージを印刷します。

停止する
システムをシャットダウンして停止します。 これはほぼ次と同等です start 停止ターゲット
--job-mode=replace-irreversibleだけでなく、すべてのユーザーにウォール メッセージを出力します。 もし
と組み合わせること - 力、実行中のすべてのサービスのシャットダウンはスキップされますが、
プロセスが強制終了され、すべてのファイル システムがアンマウントまたは読み取り専用でマウントされます。
その直後にシステムが停止します。 もし - 力 XNUMX 回指定された場合、演算は
プロセスを終了したりファイルをアンマウントしたりすることなく、ただちに実行されます。
システム。 これにより、データが失われる可能性があります。

電源オフ
システムをシャットダウンして電源を切ります。 これはほぼ次と同等です start パワーオフ.ターゲット
--job-mode=replace-irreversibleだけでなく、すべてのユーザーにウォール メッセージを出力します。 もし
と組み合わせること - 力、実行中のすべてのサービスのシャットダウンはスキップされますが、
プロセスが強制終了され、すべてのファイル システムがアンマウントまたは読み取り専用でマウントされます。
その直後に電源が切れます。 もし - 力 XNUMX 回指定された場合、演算は
プロセスを終了したりファイルをアンマウントしたりすることなく、ただちに実行されます。
システム。 これにより、データが失われる可能性があります。

リブート [argは]
システムをシャットダウンして再起動します。 これはほぼ次と同等です start 再起動.ターゲット
--job-mode=replace-irreversibleだけでなく、すべてのユーザーにウォール メッセージを出力します。 もし
と組み合わせること - 力、実行中のすべてのサービスのシャットダウンはスキップされますが、
プロセスが強制終了され、すべてのファイル システムがアンマウントまたは読み取り専用でマウントされます。
すぐに再起動します。 もし - 力 が XNUMX 回指定された場合、操作は次のようになります。
プロセスを終了したり、ファイル システムをアンマウントしたりすることなく、ただちに実行されます。
これにより、データが失われる可能性があります。

オプションの引数の場合 argは が与えられた場合、それはオプションの引数として渡されます。
　 リブート(2) システムコール。 値はアーキテクチャとファームウェアに固有です。 として
たとえば、「recovery」はシステム回復をトリガーするために使用され、「fota」は使用される可能性があります。
「無線によるファームウェア」アップデートをトリガーします。

ケクセック
kexec 経由でシステムをシャットダウンし、再起動します。 これはほぼ次と同等です start
kexec.target --job-mode=replace-irreversibleだけでなく、全員へのウォールメッセージも出力します
ユーザー。 と組み合わせると - 力、実行中のすべてのサービスのシャットダウンはスキップされますが、
すべてのプロセスが強制終了され、すべてのファイル システムがアンマウントまたは読み取り専用でマウントされます。
すぐに再起動します。

終了する [EXIT_CODE]
systemd マネージャーに終了するように依頼してください。 これはユーザー サービス マネージャーに対してのみサポートされます
(つまり、 - ユーザー オプション) またはコンテナ内で、以下と同等です
電源オフ さもないと。

systemd マネージャーは、オプションの引数が指定されている場合、ゼロ以外の終了コードで終了できます。
EXIT_CODE 与えられます。

スイッチルート ROOT [INIT]
別のルート ディレクトリに切り替えて、その下で新しいシステム マネージャー プロセスを実行します。
それ。 これは初期 RAM ディスク (「initrd」) での使用を目的としており、移行されます。
initrd のシステム マネージャー プロセス (別名「init」プロセス) からメイン システムへ
マネージャープロセス。 この呼び出しは XNUMX つの引数を取ります。XNUMX つはディレクトリになるディレクトリです。
新しいルート ディレクトリと、その下にある実行する新しいシステム マネージャー バイナリへのパス
PID 1 として。後者が省略されるか空の文字列の場合、systemd バイナリは
自動的に検索され、init として使用されます。 システム管理者パスを省略した場合
または空の文字列に等しい場合、initrd のシステム マネージャ プロセスの状態は次のようになります。
メイン システム マネージャーに渡され、後でその状態を内省できるようになります。
initrd ブートに関係するサービス。

サスペンド
システムを一時停止します。 これにより、特別な stop.target ターゲットのアクティブ化がトリガーされます。

冬眠する
システムを休止状態にします。 これにより、特別な hibernate.target のアクティブ化がトリガーされます。
ターゲット。

ハイブリッドスリープ
システムを休止状態にしてサスペンドします。 これにより、特別な機能が発動します。
ハイブリッドスリープ.ターゲットターゲット。

構文
上記のユニット コマンドは、単一のユニット名 ( NAME）、または
複数台仕様（指定 パターン...)。 最初のケースでは、ユニット名
接尾辞の有無にかかわらず指定する必要があります。 サフィックスを指定しない場合（ユニット名は
「省略形」)、systemctl は適切なサフィックス (デフォルトでは「.service」) を追加します。
特定のユニット タイプでのみ動作するコマンドの場合のタイプ固有のサフィックス。 のために
例、

# systemctl sshd を起動します

　

# systemctl sshd.service を開始します

は同等です。

# systemctl はデフォルトを分離します

　

# systemctl は、default.target を分離します

デバイス ノードへの (絶対) パスは自動的にデバイス単位に変換されることに注意してください。
名前、およびマウントユニット名へのその他の (絶対) パス。

# systemctl ステータス /dev/sda
# systemctl ステータス /ホーム

は以下と同等です:

# systemctl ステータス dev-sda.device
# systemctl ステータス home.mount

XNUMX 番目のケースでは、シェル スタイルのグロブがすべてのプライマリ名と照合されます。
現在ロードされているユニット。 リテラル単位名は、サフィックスの有無にかかわらず、次のように扱われます。
最初のケースでは。 これは、リテラルのユニット名が常に XNUMX つのユニットを正確に参照することを意味します。
ただし、グロブはゼロ単位と一致する可能性があり、これはエラーとはみなされません。

グロブパターンの使用 fnmatch(3) したがって、通常のシェルスタイルのグロビングルールが使用され、「*」、「?」、
「[]」を使用することもできます。 見る 地球詳細については (7) を参照してください。 パターンは、
現在ロードされているユニットのプライマリ名、および何も一致しないパターンは、
黙ってスキップした。 例えば：

# systemctl sshd@*.service を停止します

全てを止めるだろう [メール保護] インスタンス。 ユニットのエイリアス名と、
ロードされていないものは、glob 展開の対象として考慮されません。

ユニットファイルコマンドの場合、指定された NAME ユニットファイルの名前にする必要があります(おそらく
省略形、上記を参照)、またはユニット ファイルへの絶対パス:

# systemctl foo.service を有効にする

or

# systemctl リンク /path/to/foo.service

EXIT ステータス

成功すると0が返され、それ以外の場合はゼロ以外の失敗コードが返されます。

ENVIRONMENT

$SYSTEMD_EDITOR
ユニットを編集するときに使用するエディター。 オーバーライド $編集者 　 $ VISUAL。 どちらでもない場合
$SYSTEMD_EDITOR また $編集者 また $ VISUAL 存在するか、空の文字列に設定されている場合
または、その実行が失敗した場合、systemctl はこの中でよく知られているエディターを実行しようとします。
注文： エディタ（1） ドワーフ（1） 活力（1） viとします。

$ SYSTEMD_PAGER
使用するポケットベル -ポケットベルなし 与えられていません。 オーバーライド $ PAGER。 これを空に設定する
文字列または値「cat」は渡すのと同じです -ポケットベルなし.

$ SYSTEMD_LESS
に渡されたデフォルトオプションを上書きします less （「FRSXMK」）。

onworks.net サービスを使用してオンラインで systemctl を使用する