]>
Commit | Line | Data |
---|---|---|
57da8c32 KY |
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>--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>--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>--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>--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>--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>--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 | --> |