doc/ja/lxc-stop.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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  23
  24 Translated into Japanese
  25 by KATOH Yasufumi <karma at jazz.email.ne.jp>
  26
  27 -->
  28
  29 <!DOCTYPE refentry PUBLIC @docdtd@ [
  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-stop</refentrytitle>
  41     <manvolnum>1</manvolnum>
  42   </refmeta>
  43
  44   <refnamediv>
  45     <refname>lxc-stop</refname>
  46
  47     <refpurpose>
  48       <!--
  49       stop the application running inside a container
  50       -->
  51       コンテナ内で動作しているアプリケーションの停止
  52     </refpurpose>
  53   </refnamediv>
  54
  55   <refsynopsisdiv>
  56     <cmdsynopsis>
  57       <command>lxc-stop</command>
  58       <arg choice="req">-n <replaceable>name</replaceable></arg>
  59       <arg choice="opt">-W</arg>
  60       <arg choice="opt">-r</arg>
  61       <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
  62       <arg choice="opt">-k</arg>
  63       <arg choice="opt">--nokill</arg>
  64       <arg choice="opt">--nolock</arg>
  65     </cmdsynopsis>
  66   </refsynopsisdiv>
  67
  68   <refsect1>
  69     <title><!-- Description -->説明</title>
  70
  71     <para>
  72       <!--
  73       <command>lxc-stop</command> reboots, cleanly shuts down, or kills
  74       all the processes inside the container.  By default, it will
  75       request a clean shutdown of the container by sending
  76       <command>lxc.signal.halt</command> (defaults to SIGPWR) to
  77       the container's init process, waiting up to 60 seconds for the container
  78       to exit, and then returning. If the container fails to cleanly exit in
  79       60 seconds, it will be sent the <command>lxc.signal.stop</command>
  80       (defaults to SIGKILL) to force it to shut down. A request to reboot will
  81       send the <command>lxc.signal.reboot</command> (defaults to SIGINT) to the
  82       container's init process.
  83       -->
  84       <command>lxc-stop</command> は、リブート、クリーンシャットダウン、コンテナ内の全てのプロセスの kill のどれかを行います。
  85       デフォルトでは、コンテナのクリーンなシャットダウンを <command>lxc.signal.halt</command> (デフォルトでは SIGPWR) をコンテナの init プロセスに送ることでリクエストし、コンテナの終了を 60 秒待ち、return します。
  86       コンテナが 60 秒の間にクリーンに終了するのに失敗した場合、<command>lxc.signal.stop</command> (デフォルトは SIGKILL です) を送り、強制的にシャットダウンします。
  87       リブートのリクエストは <command>lxc.signal.reboot</command> に設定されたシグナルをコンテナの init プロセスに送ります (デフォルトは SIGINT です)。
  88     </para>
  89
  90     <para>
  91       <!--
  92       The <optional>-W</optional>, <optional>-r</optional>,
  93       <optional>-k</optional> and <optional>\-\-nokill</optional>
  94       options specify the action to perform.
  95       <optional>-W</optional> indicates that after performing the specified
  96       action, <command>lxc-stop</command> should immediately exit, while
  97       <optional>-t TIMEOUT</optional> specifies the maximum amount of time
  98       to wait for the container to complete the shutdown or reboot.
  99       -->
 100       <optional>-W</optional>, <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional>, <optional>--nokill</optional> オプションは実行する際のアクションを指定します。
 101       <optional>-W</optional> は、指定したアクションの後に、<command>lxc-stop</command> は速やかに終了します。
 102       一方、<optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンやリブートするのを待つ時間の最大値を設定します。
 103     </para>
 104
 105   </refsect1>
 106
 107   <refsect1>
 108     <title><!-- Options -->オプション</title>
 109     <variablelist>
 110
 111     <varlistentry>
 112         <term>
 113           <option>-r,--reboot </option>
 114         </term>
 115         <listitem>
 116           <para>
 117             <!--
 118             Request a reboot of the container.
 119             -->
 120             コンテナのリブートをリクエストします。
 121           </para>
 122         </listitem>
 123         </varlistentry>
 124
 125     <varlistentry>
 126         <term>
 127           <option>-k,--kill </option>
 128         </term>
 129         <listitem>
 130           <para>
 131             <!--
 132         Rather than requesting a clean shutdown of the container, explicitly
 133         kill all tasks in the container.  This is the legacy
 134         <command>lxc-stop</command> behavior.
 135         -->
 136            コンテナのクリーンシャットダウンをリクエストするのでなく、明確にコンテナ内の全てのタスクを kill します。
 137             これは、以前の <command>lxc-stop</command> の動作です。
 138           </para>
 139         </listitem>
 140     </varlistentry>
 141
 142     <varlistentry>
 143         <term>
 144           <option>--nokill</option>
 145         </term>
 146         <listitem>
 147           <para>
 148             <!--
 149             Only request a clean shutdown, do not kill the container tasks if the
 150                 clean shutdown fails.
 151               -->
 152             クリーンなシャットダウンのみをリクエストします。
 153             クリーンなシャットダウンに失敗した場合でも、コンテナのタスクを kill しません。
 154           </para>
 155         </listitem>
 156         </varlistentry>
 157
 158     <varlistentry>
 159         <term>
 160           <option>--nolock </option>
 161         </term>
 162         <listitem>
 163           <para>
 164             <!--
 165         This option avoids the use of any of the API lxc locking, and should
 166         only be used if <command>lxc-stop</command> is hanging due to a bad
 167         system state.
 168               -->
 169             このオプションはいかなる場合でも API の lxc のロックの使用を回避します。
 170             システム状態が不良な場合に lxc-stop の応答がない状態の場合のみ使用すべきです。
 171           </para>
 172         </listitem>
 173     </varlistentry>
 174
 175     <varlistentry>
 176         <term>
 177           <option>-W,--nowait </option>
 178         </term>
 179         <listitem>
 180           <para>
 181             <!--
 182             Simply perform the requestion action (reboot, shutdown, or hard
 183                 kill) and exit.
 184               -->
 185             リクエストされたアクション (reboot, shutdown, 強制的な kill) を実行するだけで (すぐに) 終了 (exit) します。
 186           </para>
 187         </listitem>
 188         </varlistentry>
 189
 190     <varlistentry>
 191         <term>
 192           <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
 193         </term>
 194         <listitem>
 195           <para>
 196             <!--
 197             Wait TIMEOUT seconds before hard-stopping the container.
 198               -->
 199             コンテナの強制停止まで TIMEOUT 秒待ちます。
 200           </para>
 201         </listitem>
 202         </varlistentry>
 203
 204   </variablelist>
 205   </refsect1>
 206
 207   <refsect1>
 208     <title><!-- Exit value -->終了ステータス</title>
 209
 210     <variablelist>
 211
 212       <varlistentry>
 213         <term>0</term>
 214         <listitem>
 215           <para>
 216             <!--
 217             The container was successfully stopped.
 218             -->
 219             コンテナの停止が成功しました。
 220           </para>
 221         </listitem>
 222       </varlistentry>
 223
 224       <varlistentry>
 225         <term>1</term>
 226         <listitem>
 227           <para>
 228             <!--
 229             An error occurred while stopping the container.
 230             -->
 231             コンテナの停止中にエラーが発生しました。
 232           </para>
 233         </listitem>
 234       </varlistentry>
 235
 236       <varlistentry>
 237         <term>2</term>
 238         <listitem>
 239           <para>
 240             <!--
 241             The specified container exists but was not running.
 242             -->
 243             指定のコンテナは存在しますが、実行中ではありません。
 244           </para>
 245         </listitem>
 246       </varlistentry>
 247
 248     </variablelist>
 249
 250   </refsect1>
 251   <refsect1>
 252     <title><!-- Diagnostic -->診断</title>
 253
 254     <variablelist>
 255
 256       <varlistentry>
 257         <term>The container was not found</term>
 258         <listitem>
 259           <para>
 260             <!--
 261             The specified container was not created before with
 262             the <command>lxc-create</command> command.
 263             -->
 264             指定したコンテナが <command>lxc-create</command> で作成されておらず存在しません。
 265           </para>
 266         </listitem>
 267       </varlistentry>
 268
 269     </variablelist>
 270
 271   </refsect1>
 272
 273   &seealso;
 274
 275   <refsect1>
 276     <title><!-- Author -->作者</title>
 277     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 278   </refsect1>
 279
 280 </refentry>
 281
 282 <!-- Keep this comment at the end of the file
 283 Local variables:
 284 mode: sgml
 285 sgml-omittag:t
 286 sgml-shorttag:t
 287 sgml-minimize-attributes:nil
 288 sgml-always-quote-attributes:t
 289 sgml-indent-step:2
 290 sgml-indent-data:t
 291 sgml-parent-document:nil
 292 sgml-default-dtd-file:nil
 293 sgml-exposed-tags:nil
 294 sgml-local-catalogs:nil
 295 sgml-local-ecat-files:nil
 296 End:
 297 -->