lxc-checkpoint.sgml.in revision 57da8c32f85c0255efa61ee32e260068afdaa565
<!--
lxc: linux Container library
(C) Copyright IBM Corp. 2007, 2008
Authors:
Daniel Lezcano <daniel.lezcano at free.fr>
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Translated into Japanese
by KATOH Yasufumi <karma at jazz.email.ne.jp>
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!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-checkpoint</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>IBM</refmiscinfo>
</refmeta>
<refnamediv>
<refname>lxc-checkpoint</refname>
<refpurpose>
<!--
checkpoint a running container (not implemented yet)
-->
実行中のコンテナのチェックポイントを作成する (未実装)
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>lxc-checkpoint</command>
<arg choice="req">--statefile=<replaceable>FILE</replaceable></arg>
<arg choice="req">--statefd=<replaceable>FD</replaceable></arg>
<arg choice="req">--name=<replaceable>NAME</replaceable></arg>
<arg><option>-k</option>|<option>-p</option></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
<!--
<command>lxc-checkpoint</command> is a command
to checkpoint the specified container
<replaceable>NAME</replaceable> and dumps its state into the file
<replaceable>FILE</replaceable>. If the
option <option>--kill</option> is specified, the application
running in the container will terminate after the checkpoint
just before resuming its execution. If the
option <option>--pause</option> is specified, the application
will be stopped after the checkpoint just before resuming
execution. The command <command>lxc-unfreeze</command> will
resume its execution.
-->
<command>lxc-checkpoint</command> は，<replaceable>NAME</replaceable> 指定したコンテナのチェックポイントを作成し，その状態を <replaceable>FILE</replaceable> で指定したファイルにダンプします．<option>--kill</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に終了します．<option>--pause</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に休止します．<command>lxc-unfreeze</command> コマンドで，実行を再開させます．
</para>
</refsect1>
<refsect1>
<title><!-- Checkpoint Options -->チェックポイントのオプション</title>
<variablelist>
<varlistentry>
<term><option>-S, --statefile=<replaceable>FILE</replaceable></option></term>
<listitem>
<para>
<!--
write the state of the container in this
<replaceable>FILE</replaceable>.
This option is exclusive with <option>--statefd</option> below.
-->
コンテナの実行状態を <replaceable>FILE</replaceable> に書き込みます．このオプションは以下の <option>--statefd</option> と同時に指定できません．
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-d, --statefd=<replaceable>FD</replaceable></option></term>
<listitem>
<para>
<!--
write the state of the container in this
<replaceable>FD</replaceable> file descriptor.
This option is exclusive with above <option>--statefile</option>.
-->
コンテナの実行状態を指定した <replaceable>FD</replaceable> ファイルディスクリプタに書き込みます．このオプションは前述の <option>--statefile</option> と同時に指定出来ません．
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-k,--kill</option></term>
<listitem>
<para>
<!--
Kill container processes after checkpoint. the processes are sent
a <literal>SIGKILL</literal> signal.
-->
チェックポイントを取得した後，コンテナプロセスを kill します．プロセスには <literal>SIGKILL</literal> シグナルが送られます．
</para>
<para>
<!--
This option is mutually exclusive with the following
<option>--pause</option> option.
-->
このオプションは以下の <option>--pause</option> オプションと同時に指定することはできません．
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-p,--pause</option></term>
<listitem>
<para>
<!--
Pause container processes after checkpoint. The container
will be stopped until you resume it. This option is
mutually exclusive with previously mentionned
<option>--kill</option> option.
-->
チェックポイントを取得した後，コンテナプロセスを休止させます．コンテナを再開させるまで止まったままとなります．このオプションは前述の <option>--kill</option> オプションと同時に指定することはできません．
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
&commonoptions;
<refsect1>
<title><!-- Examples -->例</title>
<para>
<!--
To start a new container <literal>123</literal> computing decimals of pi
-->
円周率の小数点以下を計算する新しいコンテナを起動させるために，以下を実行します．
</para>
<programlisting>
lxc-execute -n 123 -- pi1 -d 500000
lxc-execute --name=123 -- pi1 -d 500000
</programlisting>
<para>
<!--
to checkpoint the same container in <emphasis>dump-death</emphasis>
mode
-->
<emphasis>ダンプ後終了する</emphasis>モードで，そのコンテナのチェックポイントを取得します．
</para>
<programlisting>
</programlisting>
<para>
<!--
to checkpoint the same container and <emphasis>pause</emphasis> it
-->
同じコンテナのチェックポイントを取得し，<emphasis>休止</emphasis>させます．
</para>
<programlisting>
</programlisting>
</refsect1>
<refsect1>
<title><!-- Notes -->注意</title>
<!--
<para>Actually, this command does not operate. Its description
helps to define a CLI api for future Checkpoint / Restart
solution</para>
-->
実際はこのコマンドは動作しません．この説明は将来的なチェックポイント/再起動機能の解決策となる CLI API を定義するのを助けるためのものです．
</refsect1>
&seealso;
<refsect1>
<title><!-- Author -->作者</title>
<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->