doc/ja/lxc-execute.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-execute</refentrytitle>
  41     <manvolnum>1</manvolnum>
  42   </refmeta>
  43
  44   <refnamediv>
  45     <refname>lxc-execute</refname>
  46
  47     <refpurpose>
  48       <!--
  49       run an application inside a container.
  50       -->
  51       コンテナ内でアプリケーションを実行する．
  52     </refpurpose>
  53   </refnamediv>
  54
  55   <refsynopsisdiv>
  56     <cmdsynopsis>
  57       <command>lxc-execute</command>
  58       <arg choice="req">-n <replaceable>name</replaceable></arg>
  59       <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
  60       <arg choice="opt">-s KEY=VAL</arg>
  61       <arg choice="opt">-- <replaceable>command</replaceable></arg>
  62     </cmdsynopsis>
  63   </refsynopsisdiv>
  64
  65   <refsect1>
  66     <title><!-- Description -->説明</title>
  67
  68     <para>
  69       <!--
  70       <command>lxc-execute</command> runs the specified
  71       <replaceable>command</replaceable> inside the container
  72       specified by <replaceable>name</replaceable>.
  73       -->
  74       <command>lxc-execute</command> は特定の <replaceable>command</replaceable> を，<replaceable>name</replaceable> で指定したコンテナ内で実行します．
  75     </para>
  76     <para>
  77       <!--
  78       It will setup the container
  79       according to the configuration previously defined with the
  80       lxc-create command or with the configuration file parameter.
  81       If no configuration is
  82       defined, the default isolation is used.
  83       -->
  84       このコマンドは，lxc-create コマンドであらかじめ定義した設定，もしくはパラメータとして与えた設定ファイルを元にコンテナをセットアップします．もし設定が定義されていない場合，デフォルトの隔離を使用します．
  85     </para>
  86     <para>
  87       <!--
  88       This command is mainly used when you want to quickly launch an
  89       application in an isolated environment.
  90       -->
  91       このコマンドは主に，素早く単一のアプリケーションを隔離された環境で動作させたい時に使います．
  92     </para>
  93     <para>
  94       <!--
  95       <command>lxc-execute</command> command will run the
  96       specified command into the container via an intermediate
  97       process, <command>lxc-init</command>.
  98       This lxc-init after launching  the specified command,
  99       will wait for its end and all other reparented processes.
 100       (that allows to support daemons in the container).
 101       In other words, in the
 102       container, <command>lxc-init</command> has the pid 1 and the
 103       first process of the application has the pid 2.
 104       -->
 105       <command>lxc-execute</command> は，<command>lxc-init</command> を間にはさんで，コンテナ内で特定のコマンドを実行します．lxc-init は，指定されたコマンドが実行された後は，そのコマンドの終了と，そのコマンドから生成された全てのプロセスの終了を待ちます (これにより，コンテナ内でデーモンのサポートが可能になります)．言いかえると，コンテナ内では <command>lxc-init</command> が pid 1 となり，アプリケーションの最初のプロセスの pid が 2 となります．
 106      </para>
 107      <para>
 108        <!--
 109       The above <command>lxc-init</command> is designed to forward received
 110       signals to the started command.
 111       So <command>lxc-kill</command> (1) sent signal is received
 112       by the user specified command (pid 2 in the container).
 113        -->
 114        前述の <command>lxc-init</command> は，受け取ったシグナルを開始したコマンドに送るように設計されています．なので，<command>lxc-kill</command> (1) が送ったシグナルは，ユーザが指定したコマンド (コンテナ内の pid 2 のプロセス) が受けとります．
 115      </para>
 116   </refsect1>
 117
 118   <refsect1>
 119     <title><!-- Options -->オプション</title>
 120     <variablelist>
 121
 122       <varlistentry>
 123         <term>
 124           <option>-f, --rcfile <replaceable>config_file</replaceable></option>
 125         </term>
 126         <listitem>
 127           <para>
 128             <!--
 129             Specify the configuration file to configure the virtualization
 130             and isolation functionalities for the container.
 131             -->
 132             コンテナに設定したい仮想化および隔離機能の設定を行う設定ファイルを指定します．
 133           </para>
 134           <para>
 135             <!--
 136            This configuration file if present will be used even if there is
 137            already a configuration file present in the previously created
 138            container (via lxc-create).
 139             -->
 140             もしコンテナ作成前に (lxc-create によって) あらかじめ設定ファイルが指定されている場合であっても，指定した設定ファイルが使われます．
 141           </para>
 142         </listitem>
 143       </varlistentry>
 144       <varlistentry>
 145         <term>
 146           <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
 147         </term>
 148         <listitem>
 149           <para>
 150             <!--
 151             Assign value <replaceable>VAL</replaceable> to configuration
 152             variable <replaceable>KEY</replaceable>. This overrides any
 153             assignment done in <replaceable>config_file</replaceable>.
 154             -->
 155             設定変数 <replaceable>KEY</replaceable> の値を <replaceable>VAL</replaceable> に設定します．この設定は <replaceable>config_file</replaceable> で設定された値を上書きします．
 156           </para>
 157         </listitem>
 158       </varlistentry>
 159       <varlistentry>
 160         <term><option>--</option></term>
 161         <listitem>
 162           <para>
 163             <!--
 164             Signal the end of options and disables further option
 165             processing. Any arguments after the &#045;&#045; are treated as
 166             arguments.
 167             -->
 168             オプション指定の最後の印で，それ以上のオプションの処理を止めます．-- の後の引数は実行するコマンドとその引数として扱われます．
 169           </para>
 170           <para>
 171             <!--
 172             This option is useful when you want to execute, with the
 173             command <command>lxc-execute</command>, a command line
 174             with its own options.
 175             -->
 176             このオプションは，<command>lxc-execute</command> で実行するコマンドが，コマンドラインオプションを持つ場合に役に立ちます．
 177           </para>
 178         </listitem>
 179       </varlistentry>
 180
 181     </variablelist>
 182
 183   </refsect1>
 184
 185   &commonoptions;
 186
 187   <refsect1>
 188     <title><!-- Diagnostic -->診断</title>
 189
 190     <variablelist>
 191
 192       <varlistentry>
 193         <term>The container is busy</term>
 194         <listitem>
 195           <para>
 196             <!--
 197             The specified container is already running an
 198             application. You should stop it before reuse this
 199             container or create a new one.
 200             -->
 201             指定したコンテナが既にアプリケーションを実行中の場合．コンテナを再使用したり，新しく作成する前にコンテナを止める必要があります．
 202           </para>
 203         </listitem>
 204       </varlistentry>
 205
 206     </variablelist>
 207
 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 -->