<!DOCTYPE refentry PUBLIC @docdtd@ [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-autostart</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-autostart</refname>

<refpurpose>

<!--

自動起動の設定がされたコンテナの開始/停止/kill

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-autostart</command>

<arg choice="opt">-k</arg>

<arg choice="opt">-L</arg>

<arg choice="opt">-r</arg>

<arg choice="opt">-s</arg>

<arg choice="opt">-a</arg>

<arg choice="opt">-A</arg>

<arg choice="opt">-g <replaceable>groups</replaceable></arg>

<arg choice="opt">-t <replaceable>timeout</replaceable></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title><!-- Description -->説明</title>

<para>

<!--

<command>lxc-autostart</command> は lxc.start.auto が設定されたコンテナの処理を行います。

ユーザがコンテナの開始、シャットダウン、kill、再起動を、設定した時間間隔で、設定した順番で行えるようにします。

lxc.group でのフィルタリングによって、もしくは定義された全てのコンテナを実行します。

何の動作も行わず、対象のコンテナ (とコンテナに設定された起動待機時間) のリストを表示するリストモードを外部ツールから使用することも可能です。

</para>

<para>

<!--

<optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> オプションは実行する動作を指定します。何も指定しない場合は、コンテナを起動します。

<optional>-a</optional>, <optional>-g</optional> は、どのコンテナを対象にするかを指定するのに使います。デフォルトでは、lxc.group が指定されていないコンテナにだけが対象となります。

<optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンもしくはリブートを待つ最大時間を指定します。

</para>

</refsect1>

<refsect1>

<title><!-- Options -->オプション</title>

<variablelist>

<varlistentry>

<term>

<option>-r,--reboot </option>

</term>

<listitem>

<para>

<!--

コンテナのリブートを要求します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-s,--shutdown </option>

</term>

<listitem>

<para>

<!--

クリーンなシャットダウンを要求します。もし、<optional>-t timeout</optional> が 0 より大きい場合で、コンテナがこの時間内にシャットダウンしない場合は、コンテナは <optional>-k kill</optional> オプションを指定した時のように kill されます。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-k,--kill </option>

</term>

<listitem>

<para>

<!--

コンテナのクリーンなシャットダウンを要求するのではなく、明確にコンテナの全てのタスクを kill します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-L,--list </option>

</term>

<listitem>

<para>

<!--

実際の動作は行わず、コンテナ名と次のコンテナを開始するまでの間隔の表示だけを行います。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>

</term>

<listitem>

<para>

<!--

コンテナの強制停止まで TIMEOUT 秒待ちます。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-g,--group <replaceable>GROUP</replaceable></option>

</term>

<listitem>

<para>

<!--

対象にするコンテナのグループのカンマ区切りのリスト (デフォルトでは lxc.group 指定のないコンテナ、つまり NULL グループが対象になります)。

このオプションは複数回指定することができ、オプションは連結されます。NULL もしくは空のグループは、NULL グループを処理すべき場所に指定された先頭のカンマ、末尾のカンマ、途中に現れる 2 つ続きのカンマ、空のオプション引数で指定することができます。

グループはコマンドラインで指定された順番に処理されます。-g オプションの複数回の呼び出しはカンマ区切りのリストと自由に混ぜることができ、指定した順番に連結されます。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-a,--all</option>

</term>

<listitem>

<para>

<!--

lxc.group の指定を無視して、自動起動が設定されているコンテナを全て選択します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-A,--ignore-auto</option>

</term>

<listitem>

<para>

<!--

lxc.start.auto で設定されているフラグを無視します。-a と組み合わせることにより、システム上の全てのコンテナを選択します。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title><!-- Autostart and System Boot -->自動起動とシステムブート</title>

<para>

<!--

<command>lxc-autostart</command> コマンドは、LXC システムサービスがホストシステムのブートおよびシャットダウン時に実行するように有効化されているとき、LXC システムサービスの一部として使用されます。

このコマンドはホストシステムのブート時に、どのコンテナをどういう順番で、それぞれのコンテナの起動間隔をどれくらい開けるかを選択するのに使います。

</para>

<para>

<!--

コンテナはいくつでもグループに属することができ、全く属さないことも可能です。特別なグループが 2 つ存在します。1 つは NULL グループです。これはどのグループにも属さないコンテナです。もう 1 つは "onboot" グループです。

</para>

<para>

<!--

LXC サービスが有効になった状態でシステムがブートすると、最初に "onboot" グループのメンバーである lxc.start.auto == 1 が設定されたコンテナを起動しようとします。起動は lxc.start.order の順に起動します。

lxc.start.delay が指定されている場合、現在対象となっているコンテナに初期化の時間を与え、ホストシステムの負荷を低減するために、次のコンテナを開始させるまでに遅延時間を与えます。

"onboot" グループのメンバーが開始した後、LXC システムは lxc.start.auto == 1 が設定された、どのグループのメンバーでもない (NULL グループの) コンテナのブートを onboot グループのコンテナと同様に開始します。

</para>

</refsect1>

<refsect1>

<title><!-- Startup Group Examples -->スタートアップグループの例</title>

<variablelist>

<varlistentry>

<term>

<option>-g "onboot,"</option>

</term>

<listitem>

<para>

<!--

まず最初に "onboot" グループの処理を開始し、その後 NULL グループの処理を開始します。

</para>

<para>

<!--

これは以下と等価です: <option>-g onboot -g ""</option>

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-g "dns,web,,onboot"</option>

</term>

<listitem>

<para>

<!--

まず最初に "dns" グループの処理を開始し、2 番目に "web" グループ、その後 NULL グループ、"onboot" グループの順に処理を開始します。

</para>

<para>

<!--

これは以下と等価です: <option>-g dns,web -g ,onboot</option> もしくは <option>-g dns -g web -g "" -g onboot</option>

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title><!-- Author -->作者</title>

<para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>

</refsect1>

</refentry>