<!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-restart</refentrytitle>

<manvolnum>1</manvolnum>

<refmiscinfo>IBM</refmiscinfo>

</refmeta>

<refnamediv>

<refname>lxc-restart</refname>

<refpurpose>

<!--

ファイルからのコンテナの再起動 (未実装)

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-restart</command>

<arg choice="opt">-f <replaceable>config_file</replaceable></arg>

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

<arg choice="req">--statefile=<replaceable>FILE</replaceable></arg>

<arg choice="req">--statefd=<replaceable>FD</replaceable></arg>

<arg choice="req">--name=<replaceable>NAME</replaceable></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

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

<para>

<!--

<command>lxc-restart</command> は <replaceable>FILE</replaceable> で指定したファイルから状態を読み取り，<replaceable>NAME</replaceable> で指定したコンテナ内のアプリケーションを再起動するコマンドです．

もし <option>--pause</option> が指定された場合，アプリケーションは再起動後に直前の実行状態で再開する前に停止します．

この実行状態の再開には <command>lxc-unfreeze</command> コマンドが必要になります．

</para>

</refsect1>

<refsect1>

<title><!-- Restart Options -->再起動オプション</title>

<variablelist>

<varlistentry>

<term><option>-S, --statefile=<replaceable>FILE</replaceable></option></term>

<listitem>

<para>

<!--

コンテナの状態を <replaceable>FILE</replaceable> で指定したファイルから読み取ります．

このオプションは，後の <option>--statefd</option> と同時に指定できません．

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><option>-d, --statefd=<replaceable>FD</replaceable></option></term>

<listitem>

<para>

<!--

コンテナの状態を <replaceable>FD</replaceable> で指定したファイル記述子から読み取ります．

このオプションは，前の <option>--statefile</option> と同時に指定できません．

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><option>-p</option></term>

<listitem>

<para>

<!--

再起動後にコンテナプロセスを一時停止します．

コンテナは lxc-unfreeze コマンドで再開するまでは停止しています．

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><option>-f, --rcfile=<replaceable>config_file</replaceable></option></term>

<listitem>

<para>

<!--

コンテナの仮想化および隔離機能を設定した設定ファイルを指定します．このパラメータは，<command>lxc-execute</command> コマンドや <command>lxc-start</command> コマンドで (起動時に) 指定されていた場合や，再起動後に設定を変更する場合に指定すべきです．後者の場合，再起動に必要なリソースが利用できない場合は失敗するでしょう．コンテナが <command>lxc-create</command> コマンドで作成され，設定されていた場合，このオプションは必要ありません．設定は自動的に見つけられるでしょう．

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-s <replaceable>KEY=VAL</replaceable></option>

</term>

<listitem>

<para>

<!--

設定変数 <replaceable>KEY</replaceable> の値を <replaceable>VAL</replaceable> に設定します．この設定は <replaceable>config_file</replaceable> で設定された値を上書きします．

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&commonoptions;

<refsect1>

<title><!-- Examples -->例</title>

<para>

<!--

円周率の小数点以下を計算する新しいコンテナ <literal>123</literal> を開始するために，

</para>

<programlisting>

lxc-execute -n 123 -- pi1 -d 500000

lxc-execute --name=123 -- pi1 -d 500000

</programlisting>

<para>

<!--

<emphasis>dump-death</emphasis> モードで同じコンテナのチェックポイントを作成するために，

</para>

<programlisting>

lxc-checkpoint -n 123 -S /share/123/chkpt1 -k

lxc-checkpoint --name=123 --statefile=/share/123/chkpt1 -k

</programlisting>

<para>

<!--

そして，異なる id で同じコンテナを再起動するために，

</para>

<programlisting>

lxc-restart -n 200 -S /share/123/chkpt1

lxc-restart --name=200 --statefile=/share/123/chkpt1

</programlisting>

</refsect1>

<refsect1>

<title><!-- Notes -->注意</title>

<para>

<!--

実際はこのコマンドは動作しません．この説明は将来的なチェックポイント/再起動の解決策となる CLI API を定義するのを助けるためのものです．

</para>

</refsect1>

&seealso;

<refsect1>

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

<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

</refsect1>

</refentry>