doc/ja/lxc-checkpoint.sgml.in

   1 <!--
   2
   3 lxc: linux Container library
   4
   5 (C) Copyright IBM Corp. 2007, 2008
   6
   7 Authors:
   8 Daniel Lezcano <daniel.lezcano at free.fr>
   9
  10 This library is free software; you can redistribute it and/or
  11 modify it under the terms of the GNU Lesser General Public
  12 License as published by the Free Software Foundation; either
  13 version 2.1 of the License, or (at your option) any later version.
  14
  15 This library is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18 Lesser General Public License for more details.
  19
  20 You should have received a copy of the GNU Lesser General Public
  21 License along with this library; if not, write to the Free Software
  22 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  23
  24 Translated into Japanese
  25 by KATOH Yasufumi <karma at jazz.email.ne.jp>
  26
  27 -->
  28
  29 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  30
  31 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
  32 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
  33 ]>
  34
  35 <refentry>
  36
  37   <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
  38
  39   <refmeta>
  40     <refentrytitle>lxc-checkpoint</refentrytitle>
  41     <manvolnum>1</manvolnum>
  42     <refmiscinfo>IBM</refmiscinfo>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>lxc-checkpoint</refname>
  47
  48     <refpurpose>
  49       <!--
  50       checkpoint a running container (not implemented yet)
  51       -->
  52       実行中のコンテナのチェックポイントを作成する (未実装)
  53     </refpurpose>
  54   </refnamediv>
  55
  56   <refsynopsisdiv>
  57     <cmdsynopsis>
  58       <command>lxc-checkpoint</command>
  59       <arg choice="req">--statefile=<replaceable>FILE</replaceable></arg>
  60       <arg choice="req">--statefd=<replaceable>FD</replaceable></arg>
  61       <arg choice="req">--name=<replaceable>NAME</replaceable></arg>
  62       <arg><option>-k</option>|<option>-p</option></arg>
  63     </cmdsynopsis>
  64   </refsynopsisdiv>
  65
  66   <refsect1>
  67     <title>Description</title>
  68
  69     <para>
  70       <!--
  71       <command>lxc-checkpoint</command> is a command
  72       to checkpoint the specified container
  73       <replaceable>NAME</replaceable> and dumps its state into the file
  74       <replaceable>FILE</replaceable>. If the
  75       option <option>&#045;&#045;kill</option> is specified, the application
  76       running in the container will terminate after the checkpoint
  77       just before resuming its execution. If the
  78       option <option>&#045;&#045;pause</option> is specified, the application
  79       will be stopped after the checkpoint just before resuming
  80       execution. The command <command>lxc-unfreeze</command> will
  81       resume its execution.
  82       -->
  83       <command>lxc-checkpoint</command> は，<replaceable>NAME</replaceable> 指定したコンテナのチェックポイントを作成し，その状態を <replaceable>FILE</replaceable> で指定したファイルにダンプします．<option>--kill</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に終了します．<option>--pause</option> が指定された場合，チェックポイントの取得後，コンテナ内で実行されているアプリケーションは，実行が再開する直前に休止します．<command>lxc-unfreeze</command> コマンドで，実行を再開させます．
  84     </para>
  85
  86   </refsect1>
  87
  88   <refsect1>
  89     <title><!-- Checkpoint Options -->チェックポイントのオプション</title>
  90
  91     <variablelist>
  92
  93       <varlistentry>
  94         <term><option>-S, --statefile=<replaceable>FILE</replaceable></option></term>
  95         <listitem>
  96           <para>
  97             <!--
  98             write the state of the container in this
  99             <replaceable>FILE</replaceable>.
 100             This option is exclusive with <option>&#045;&#045;statefd</option> below.
 101             -->
 102             コンテナの実行状態を <replaceable>FILE</replaceable> に書き込みます．このオプションは以下の <option>--statefd</option> と同時に指定できません．
 103           </para>
 104         </listitem>
 105       </varlistentry>
 106
 107       <varlistentry>
 108         <term><option>-d, --statefd=<replaceable>FD</replaceable></option></term>
 109         <listitem>
 110           <para>
 111             <!--
 112             write the state of the container in this
 113             <replaceable>FD</replaceable> file descriptor.
 114             This option is exclusive with above <option>&#045;&#045;statefile</option>.
 115             -->
 116             コンテナの実行状態を指定した <replaceable>FD</replaceable> ファイルディスクリプタに書き込みます．このオプションは前述の <option>--statefile</option> と同時に指定出来ません．
 117           </para>
 118         </listitem>
 119       </varlistentry>
 120
 121       <varlistentry>
 122         <term><option>-k,--kill</option></term>
 123         <listitem>
 124           <para>
 125             <!--
 126             Kill container processes after checkpoint. the processes are sent
 127             a <literal>SIGKILL</literal> signal.
 128             -->
 129             チェックポイントを取得した後，コンテナプロセスを kill します．プロセスには <literal>SIGKILL</literal> シグナルが送られます．
 130           </para>
 131           <para>
 132             <!--
 133             This option is mutually exclusive with the following
 134             <option>&#045;&#045;pause</option> option.
 135             -->
 136             このオプションは以下の <option>--pause</option> オプションと同時に指定することはできません．
 137           </para>
 138         </listitem>
 139       </varlistentry>
 140
 141       <varlistentry>
 142         <term><option>-p,--pause</option></term>
 143         <listitem>
 144           <para>
 145             <!--
 146             Pause container processes after checkpoint. The container
 147             will be stopped until you resume it. This option is
 148             mutually exclusive with previously mentionned
 149             <option>&#045;&#045;kill</option> option.
 150             -->
 151             チェックポイントを取得した後，コンテナプロセスを休止させます．コンテナを再開させるまで止まったままとなります．このオプションは前述の <option>--kill</option> オプションと同時に指定することはできません．
 152           </para>
 153         </listitem>
 154       </varlistentry>
 155
 156     </variablelist>
 157
 158   </refsect1>
 159
 160   &commonoptions;
 161
 162   <refsect1>
 163     <title><!-- Examples -->例</title>
 164     <para>
 165       <!--
 166       To start a new container <literal>123</literal> computing decimals of pi
 167       -->
 168       円周率の小数点以下を計算する新しいコンテナを起動させるために，以下を実行します．
 169     </para>
 170     <programlisting>
 171       lxc-execute -n 123 -- pi1 -d 500000
 172       lxc-execute --name=123 -- pi1 -d 500000
 173     </programlisting>
 174
 175     <para>
 176       <!--
 177       to checkpoint the same container in <emphasis>dump-death</emphasis>
 178       mode
 179       -->
 180       <emphasis>ダンプ後終了する</emphasis>モードで，そのコンテナのチェックポイントを取得します．
 181     </para>
 182     <programlisting>
 183       lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
 184       lxc-checkpoint --name=123 -S /share/123/chkpt1 -k
 185     </programlisting>
 186
 187     <para>
 188       <!--
 189       to checkpoint the same container and <emphasis>pause</emphasis> it
 190       -->
 191       同じコンテナのチェックポイントを取得し，<emphasis>休止</emphasis>させます．
 192     </para>
 193     <programlisting>
 194       lxc-checkpoint -n 123 -S /share/123/chkpt1 -p
 195       lxc-checkpoint --name=123 -S /share/123/chkpt1 -p
 196     </programlisting>
 197
 198   </refsect1>
 199
 200   <refsect1>
 201     <title><!-- Notes -->注意</title>
 202     <!--
 203     <para>Actually, this command does not operate. Its description
 204     helps to define a CLI api for future Checkpoint / Restart
 205     solution</para>
 206     -->
 207     実際はこのコマンドは動作しません．この説明は将来的なチェックポイント/再起動機能の解決策となる CLI API を定義するのを助けるためのものです．
 208   </refsect1>
 209
 210   &seealso;
 211
 212   <refsect1>
 213     <title><!-- Author -->作者</title>
 214     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 215   </refsect1>
 216
 217 </refentry>
 218
 219 <!-- Keep this comment at the end of the file
 220 Local variables:
 221 mode: sgml
 222 sgml-omittag:t
 223 sgml-shorttag:t
 224 sgml-minimize-attributes:nil
 225 sgml-always-quote-attributes:t
 226 sgml-indent-step:2
 227 sgml-indent-data:t
 228 sgml-parent-document:nil
 229 sgml-default-dtd-file:nil
 230 sgml-exposed-tags:nil
 231 sgml-local-catalogs:nil
 232 sgml-local-ecat-files:nil
 233 End:
 234 -->