doc/ja/lxc-start.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-start</refentrytitle>
  41     <manvolnum>1</manvolnum>
  42   </refmeta>
  43
  44   <refnamediv>
  45     <refname>lxc-start</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-start</command>
  58       <arg choice="req">-n <replaceable>name</replaceable></arg>
  59       <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
  60       <arg choice="opt">-c <replaceable>console_device</replaceable></arg>
  61       <arg choice="opt">-L <replaceable>console_logfile</replaceable></arg>
  62       <arg choice="opt">-d</arg>
  63       <arg choice="opt">-F</arg>
  64       <arg choice="opt">-p <replaceable>pid_file</replaceable></arg>
  65       <arg choice="opt">-s KEY=VAL</arg>
  66       <arg choice="opt">-C</arg>
  67       <arg choice="opt">--share-[net|ipc|uts] <replaceable>name|pid</replaceable></arg>
  68       <arg choice="opt">command</arg>
  69     </cmdsynopsis>
  70   </refsynopsisdiv>
  71
  72   <refsect1>
  73     <title><!-- Description -->説明</title>
  74
  75     <para>
  76       <!--
  77       <command>lxc-start</command> runs the specified
  78       <replaceable>command</replaceable> inside the container
  79       specified by <replaceable>name</replaceable>.
  80       -->
  81       <command>lxc-start</command> は <replaceable>command</replaceable> で指定されたコマンドを、<replaceable>name</replaceable> で指定されたコンテナ内で実行します。
  82     </para>
  83     <para>
  84       <!--
  85       It will setup the container
  86       according to the configuration previously defined with the
  87       lxc-create command or with the configuration file parameter.
  88       If no configuration is
  89       defined, the default isolation is used.
  90       -->
  91       このコマンドは、lxc-create コマンドもしくは設定ファイルのパラメータであらかじめ定義された設定に従ってコンテナをセットアップします。
  92       もし設定が定義されていない場合は、デフォルトの隔離状態を使用します。
  93     </para>
  94     <para>
  95       <!--
  96       If no command is specified, <command>lxc-start</command> will
  97       use the command defined in lxc.init.cmd or if not set, the default
  98       <command>"/sbin/init"</command> command to run a system
  99       container.
 100       -->
 101       もし command が指定されない場合は、<command>lxc-start</command> はシステムコンテナを実行するためのコマンドとして、lxc.init.cmd で設定されたコマンドを使用します。
 102       もし lxc.init.cmd が設定されていない場合は、デフォルトで <command>"/sbin/init"</command> を使用します。
 103     </para>
 104
 105   </refsect1>
 106
 107   <refsect1>
 108
 109     <title><!-- Options -->オプション</title>
 110
 111     <variablelist>
 112
 113       <varlistentry>
 114         <term>
 115           <option>-d, --daemon</option>
 116         </term>
 117         <listitem>
 118           <para>
 119             <!--
 120             Run the container as a daemon. As the container has no
 121             more tty, if an error occurs nothing will be displayed,
 122             the log file can be used to check the error.
 123             -->
 124             コンテナをデーモンとして実行します。
 125             コンテナはそれ以上の tty を持ちませんので、もしエラーが起きても何も表示されません。
 126             エラーのチェックにはログファイルを使用することができます。(これがデフォルトのモードです)
 127           </para>
 128         </listitem>
 129       </varlistentry>
 130
 131       <varlistentry>
 132         <term>
 133           <option>-F, --foreground</option>
 134         </term>
 135         <listitem>
 136           <para>
 137             <!--
 138             Run the container in the foreground. In this mode, the container
 139             console will be attached to the current tty and signals will be routed
 140             directly to the container.
 141             -->
 142             コンテナをフォアグラウンドで実行します。このモードでは、コンテナコンソールは現在使用中の tty に割り当てられ、シグナルはコンテナに直接送られます。
 143           </para>
 144         </listitem>
 145       </varlistentry>
 146
 147       <varlistentry>
 148         <term>
 149           <option>-p, --pidfile <replaceable>pid_file</replaceable></option>
 150         </term>
 151         <listitem>
 152           <para>
 153             <!--
 154             Create a file with the process id.
 155             -->
 156             プロセス ID を含むファイルを作製します。
 157           </para>
 158         </listitem>
 159       </varlistentry>
 160
 161       <varlistentry>
 162         <term>
 163           <option>-f, --rcfile <replaceable>config_file</replaceable></option>
 164         </term>
 165         <listitem>
 166           <para>
 167             <!--
 168             Specify the configuration file to configure the virtualization
 169             and isolation functionalities for the container.
 170             -->
 171             コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。
 172           </para>
 173           <para>
 174             <!--
 175            This configuration file if present will be used even if there is
 176            already a configuration file present in the previously created
 177            container (via lxc-create).
 178            -->
 179             (lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプションが指定された場合は、指定した設定ファイルが使用されます。
 180           </para>
 181         </listitem>
 182       </varlistentry>
 183
 184       <varlistentry>
 185         <term>
 186           <option>-c,
 187           --console <replaceable>console_device</replaceable></option>
 188         </term>
 189         <listitem>
 190           <para>
 191             <!--
 192             Specify a device to use for the container's console, for example
 193             /dev/tty8. If this option is not specified the current terminal
 194             will be used unless <option>-d</option> is specified.
 195             -->
 196             コンテナのコンソールに使用するデバイスを指定します。例えば /dev/tty8 のように指定します。
 197             このオプションが指定されない時は、<option>-d</option> が指定されない限りは、現在のターミナルを使用します。
 198           </para>
 199         </listitem>
 200       </varlistentry>
 201
 202       <varlistentry>
 203         <term>
 204           <option>-L,
 205           --console-log <replaceable>console_logfile</replaceable></option>
 206         </term>
 207         <listitem>
 208           <para>
 209             <!--
 210             Specify a file to log the container's console output to.
 211             -->
 212             コンテナのコンソール出力のログを出力するファイルを指定します。
 213           </para>
 214         </listitem>
 215       </varlistentry>
 216
 217       <varlistentry>
 218         <term>
 219           <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
 220         </term>
 221         <listitem>
 222           <para>
 223             <!--
 224             Assign value <replaceable>VAL</replaceable> to configuration
 225             variable <replaceable>KEY</replaceable>. This overrides any
 226             assignment done in <replaceable>config_file</replaceable>.
 227             -->
 228             設定変数 <replaceable>KEY</replaceable> に対する設定値として <replaceable>VAL</replaceable> を設定します。
 229             この設定は、<replaceable>config_file</replaceable> で既に設定されている値も上書きします。
 230           </para>
 231         </listitem>
 232       </varlistentry>
 233
 234       <varlistentry>
 235         <term>
 236           <option>-C,
 237           --close-all-fds</option>
 238         </term>
 239         <listitem>
 240           <para>
 241             <!--
 242           If any file descriptors are inherited, close them.  If this option
 243           is not specified, then <command>lxc-start</command> will exit with
 244           failure instead. Note: <replaceable>&#045;&#045;daemon</replaceable> implies
 245           <replaceable>&#045;&#045;close-all-fds</replaceable>.
 246           -->
 247             継承しているファイルディスクリプタが存在する場合、それをクローズします。
 248             このオプションが指定されない場合、<command>lxc-start</command> の実行は失敗して終了します。
 249             注意: <replaceable>--daemon</replaceable> オプションは、<replaceable>--close-all-fds</replaceable> オプションを指定しなくても指定している場合と同様の動きをします。
 250           </para>
 251         </listitem>
 252       </varlistentry>
 253
 254       <varlistentry>
 255         <term>
 256           <option>--share-net <replaceable>name|pid</replaceable></option>
 257         </term>
 258         <listitem>
 259           <para>
 260             <!--
 261             Inherit a network namespace from
 262             a <replaceable>name</replaceable> container or
 263             a <replaceable>pid</replaceable>. The network namespace
 264             will continue to be managed by the original owner. The
 265             network configuration of the starting container is ignored
 266             and the up/down scripts won't be executed.
 267             -->
 268             名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナとネットワーク名前空間を共有します。
 269             ネットワーク名前空間は引き続き元の所有者が管理します。
 270             開始するコンテナのネットワーク設定は無視され、up/down のスクリプトは実行されません。
 271           </para>
 272         </listitem>
 273       </varlistentry>
 274
 275       <varlistentry>
 276         <term>
 277           <option>--share-ipc <replaceable>name|pid</replaceable></option>
 278         </term>
 279         <listitem>
 280           <para>
 281             <!--
 282             Inherit an IPC namespace from
 283             a <replaceable>name</replaceable> container or
 284             a <replaceable>pid</replaceable>.
 285             -->
 286             名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと IPC 名前空間を共有します。
 287           </para>
 288         </listitem>
 289       </varlistentry>
 290
 291       <varlistentry>
 292         <term>
 293           <option>--share-uts <replaceable>name|pid</replaceable></option>
 294         </term>
 295         <listitem>
 296           <para>
 297             <!--
 298             Inherit a UTS namespace from
 299             a <replaceable>name</replaceable> container or
 300             a <replaceable>pid</replaceable>. The starting LXC will
 301             not set the hostname, but the container OS may do it
 302             anyway.
 303             -->
 304             名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと UTS 名前空間を共有します。
 305             LXC は開始するときににはホスト名を設定しませんが、コンテナ内の OS が何らかの方法でホスト名を設定するかもしれません。
 306           </para>
 307         </listitem>
 308       </varlistentry>
 309
 310     </variablelist>
 311
 312   </refsect1>
 313
 314   &commonoptions;
 315
 316   <refsect1>
 317     <title><!-- Diagnostic -->診断</title>
 318
 319     <variablelist>
 320
 321       <varlistentry>
 322         <term>The container is busy</term>
 323         <listitem>
 324           <para>
 325             <!--
 326             The specified container is already running an
 327             application. You should stop it before reuse this
 328             container or create a new one.
 329             -->
 330             指定したコンテナは既に実行済みです。
 331             このコンテナを使用する前に既に起動しているコンテナを停止するか、新しいものを作成する必要があります。
 332           </para>
 333         </listitem>
 334       </varlistentry>
 335
 336     </variablelist>
 337
 338   </refsect1>
 339
 340   &seealso;
 341
 342   <refsect1>
 343     <title><!-- Author -->作者</title>
 344     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 345   </refsect1>
 346
 347 </refentry>
 348
 349 <!-- Keep this comment at the end of the file
 350 Local variables:
 351 mode: sgml
 352 sgml-omittag:t
 353 sgml-shorttag:t
 354 sgml-minimize-attributes:nil
 355 sgml-always-quote-attributes:t
 356 sgml-indent-step:2
 357 sgml-indent-data:t
 358 sgml-parent-document:nil
 359 sgml-default-dtd-file:nil
 360 sgml-exposed-tags:nil
 361 sgml-local-catalogs:nil
 362 sgml-local-ecat-files:nil
 363 End:
 364 -->