<!--
-lxc: linux Container library
-
-(C) Copyright IBM Corp. 2007, 2008
+(C) Copyright Canonical Ltd. 2014
Authors:
-Daniel Lezcano <daniel.lezcano at free.fr>
+Tycho Andersen <tycho.andersen@canonical.com>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
<refmeta>
<refentrytitle>lxc-checkpoint</refentrytitle>
<manvolnum>1</manvolnum>
- <refmiscinfo>IBM</refmiscinfo>
</refmeta>
<refnamediv>
<refpurpose>
<!--
- checkpoint a running container (not implemented yet)
+ checkpoint a container
-->
- 実行中のコンテナのチェックポイントの作成 (未実装)
+ コンテナのチェックポイントとリストア
</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>
+ <arg choice="req">-n <replaceable>name</replaceable></arg>
+ <arg choice="req">-D <replaceable>PATH</replaceable></arg>
+ <arg choice="opt">-r</arg>
+ <arg choice="opt">-s</arg>
+ <arg choice="opt">-v</arg>
+ <arg choice="opt">-d</arg>
+ <arg choice="opt">-F</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
- <title>Description</title>
-
+ <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> checkpoints and restores containers.
-->
- <command>lxc-checkpoint</command> は，<replaceable>NAME</replaceable> 指定したコンテナのチェックポイントを作成し，その状態を <replaceable>FILE</replaceable> で指定したファイルにダンプします．<option>--kill</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に終了します．<option>--pause</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に休止します．<command>lxc-unfreeze</command> コマンドで，実行を再開させます．
+ <command>lxc-checkpoint</command> はコンテナのチェックポイント処理による状態保存とリストアを行います。
</para>
-
</refsect1>
<refsect1>
- <title><!-- Checkpoint Options -->チェックポイントのオプション</title>
-
+ <title><!-- Options -->オプション</title>
<variablelist>
<varlistentry>
- <term><option>-S, --statefile=<replaceable>FILE</replaceable></option></term>
- <listitem>
- <para>
+ <term>
+ <option>-r, --restore</option>
+ </term>
+ <listitem>
+ <para>
<!--
- write the state of the container in this
- <replaceable>FILE</replaceable>.
- This option is exclusive with <option>--statefd</option> below.
+ Restore the checkpoint for the container, instead of dumping it.
+ This option is incompatible with <option>-s</option>.
-->
- コンテナの実行状態を <replaceable>FILE</replaceable> に書き込みます．このオプションは以下の <option>--statefd</option> と同時に指定できません．
- </para>
- </listitem>
+ コンテナの状態を保存するのでなく、チェックポイントからのリストアを行います。
+ </para>
+ </listitem>
</varlistentry>
<varlistentry>
- <term><option>-d, --statefd=<replaceable>FD</replaceable></option></term>
- <listitem>
- <para>
+ <term>
+ <option>-D <replaceable>PATH</replaceable>, --checkpoint-dir=<replaceable>PATH</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>.
+ The directory to dump the checkpoint metadata.
-->
- ã\82³ã\83³ã\83\86ã\83\8aã\81®å®\9fè¡\8cç\8a¶æ\85\8bã\82\92æ\8c\87å®\9aã\81\97ã\81\9f <replaceable>FD</replaceable> ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\81«æ\9b¸ã\81\8dè¾¼ã\81¿ã\81¾ã\81\99ï¼\8eã\81\93ã\81®ã\82ªã\83\97ã\82·ã\83§ã\83³ã\81¯å\89\8dè¿°ã\81® <option>--statefile</option> ã\81¨å\90\8cæ\99\82ã\81«æ\8c\87å®\9aå\87ºæ\9d¥ã\81¾ã\81\9bã\82\93ï¼\8e
- </para>
- </listitem>
+ ã\83\81ã\82§ã\83\83ã\82¯ã\83\9dã\82¤ã\83³ã\83\88ã\81®ã\83¡ã\82¿ã\83\87ã\83¼ã\82¿ã\82\92ä¿\9då\98ã\81\99ã\82\8bã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\82\92æ\8c\87å®\9aã\81\97ã\81¾ã\81\99ã\80\82
+ </para>
+ </listitem>
</varlistentry>
<varlistentry>
- <term><option>-k,--kill</option></term>
- <listitem>
- <para>
+ <term>
+ <option>-s, --stop</option>
+ </term>
+ <listitem>
+ <para>
<!--
- Kill container processes after checkpoint. the processes are sent
- a <literal>SIGKILL</literal> signal.
+ Optionally stop the container after dumping. This option is
+ incompatible with <option>-r</option>.
-->
- チェックポイントを取得した後，コンテナプロセスを kill します．プロセスには <literal>SIGKILL</literal> シグナルが送られます．
- </para>
- <para>
+ コンテナの状態を保存した後にコンテナを停止します。このオプションは <option>-r</option> と同時に指定できません。
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>-v, --verbose</option>
+ </term>
+ <listitem>
+ <para>
<!--
- This option is mutually exclusive with the following
- <option>--pause</option> option.
+ Enable verbose criu logging.
-->
- このオプションは以下の <option>--pause</option> オプションと同時に指定することはできません．
- </para>
- </listitem>
+ CRIU のログ出力を冗長モードにします。
+ </para>
+ </listitem>
</varlistentry>
<varlistentry>
- <term><option>-p,--pause</option></term>
- <listitem>
- <para>
+ <term>
+ <option>-d, --daemon</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.
+ Restore the container in the background (this is the default).
+ Only available when providing <option>-r</option>.
-->
- ã\83\81ã\82§ã\83\83ã\82¯ã\83\9dã\82¤ã\83³ã\83\88ã\82\92å\8f\96å¾\97ã\81\97ã\81\9få¾\8cï¼\8cã\82³ã\83³ã\83\86ã\83\8aã\83\97ã\83ã\82»ã\82¹ã\82\92ä¼\91æ¢ã\81\95ã\81\9bã\81¾ã\81\99ï¼\8eã\82³ã\83³ã\83\86ã\83\8aã\82\92å\86\8dé\96\8bã\81\95ã\81\9bã\82\8bã\81¾ã\81§æ¢ã\81¾ã\81£ã\81\9fã\81¾ã\81¾ã\81¨ã\81ªã\82\8aã\81¾ã\81\99ï¼\8eã\81\93ã\81®ã\82ªã\83\97ã\82·ã\83§ã\83³ã\81¯å\89\8dè¿°ã\81® <option>--kill</option> ã\82ªã\83\97ã\82·ã\83§ã\83³ã\81¨å\90\8cæ\99\82ã\81«æ\8c\87å®\9aã\81\99ã\82\8bã\81\93ã\81¨ã\81¯ã\81§ã\81\8dã\81¾ã\81\9bã\82\93ï¼\8e
- </para>
- </listitem>
+ ã\82³ã\83³ã\83\86ã\83\8aã\82\92ã\83\90ã\83\83ã\82¯ã\82°ã\83©ã\82¦ã\83³ã\83\89ã\81§èµ·å\8b\95ã\81\97ã\81\9fç\8a¶æ\85\8bã\81§ã\83ªã\82¹ã\83\88ã\82¢ã\81\97ã\81¾ã\81\99 (ã\81\93ã\82\8cã\81\8cã\83\87ã\83\95ã\82©ã\83«ã\83\88ã\81§ã\81\99)ã\80\82<option>-r</option> ã\82\92æ\8c\87å®\9aã\81\97ã\81\9fã\81¨ã\81\8dã\81 ã\81\91使ç\94¨ã\81§ã\81\8dã\81¾ã\81\99ã\80\82
+ </para>
+ </listitem>
</varlistentry>
- </variablelist>
+ <varlistentry>
+ <term>
+ <option>-F, --foreground</option>
+ </term>
+ <listitem>
+ <para>
+ <!--
+ Restore the container in the foreground. Only available when
+ providing <option>-r</option>.
+ -->
+ コンテナなフォアグラウンドで起動した状態でリストアします。<option>-r</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>
- lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
- lxc-checkpoint --name=123 -S /share/123/chkpt1 -k
- </programlisting>
+ <variablelist>
- <para>
- <!--
- to checkpoint the same container and <emphasis>pause</emphasis> it
- -->
- 同じコンテナのチェックポイントを取得し，<emphasis>休止</emphasis>させます．
- </para>
- <programlisting>
- lxc-checkpoint -n 123 -S /share/123/chkpt1 -p
- lxc-checkpoint --name=123 -S /share/123/chkpt1 -p
- </programlisting>
+ <varlistentry>
+ <term>lxc-checkpoint -n foo -D /tmp/checkpoint</term>
+ <listitem>
+ <para>
+ <!--
+ Checkpoint the container foo into the directory /tmp/checkpoint.
+ -->
+ foo という名前のコンテナのチェックポイント処理を実行し、データを /tmp/checkpoint に保存します。
+ </para>
+ </listitem>
+ </varlistentry>
- </refsect1>
+ <varlistentry>
+ <term>lxc-checkpoint -r -n foo -D /tmp/checkpoint</term>
+ <listitem>
+ <para>
+ <!--
+ Restore the checkpoint from the directory /tmp/checkpoint.
+ -->
+ /tmp/checkpoint に保存されたチェックポイントデータからリストアを行います。
+ </para>
+ </listitem>
+ </varlistentry>
- <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 を定義するのを助けるためのものです．
+ </variablelist>
</refsect1>
&seealso;
<refsect1>
<title><!-- Author -->作者</title>
- <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
+ <para>Tycho Andersen <email>tycho.andersen@canonical.com</email></para>
</refsect1>
-
</refentry>
<!-- Keep this comment at the end of the file
projects / mirror_lxc.git / blobdiff