lxc-start.sgml.in revision 22c36623bbbe6de7b9fd15f40d7428257bfd8d74
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainenlxc: linux Container library
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen(C) Copyright IBM Corp. 2007, 2008
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenDaniel Lezcano <daniel.lezcano at free.fr>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenThis library is free software; you can redistribute it and/or
e015e2f7e7f48874495f9df8b0dd192b7ffcb5ccTimo Sirainenmodify it under the terms of the GNU Lesser General Public
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenLicense as published by the Free Software Foundation; either
fcfb528483369975066c6adf1c55c16e6fb6e91fTimo Sirainenversion 2.1 of the License, or (at your option) any later version.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenThis library is distributed in the hope that it will be useful,
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainenbut WITHOUT ANY WARRANTY; without even the implied warranty of
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo SirainenLesser General Public License for more details.
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo SirainenYou should have received a copy of the GNU Lesser General Public
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo SirainenLicense along with this library; if not, write to the Free Software
fcfb528483369975066c6adf1c55c16e6fb6e91fTimo SirainenFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo SirainenTranslated into Japanese
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainenby KATOH Yasufumi <karma at jazz.email.ne.jp>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
fcfb528483369975066c6adf1c55c16e6fb6e91fTimo Sirainen<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
fcfb528483369975066c6adf1c55c16e6fb6e91fTimo Sirainen <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen run an application inside a container.
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen コンテナ内でのアプリケーションの実行
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen </refpurpose>
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen </refnamediv>
fd2f5fbc1f07aa93e2214a28cdf02437fb7d06c8Timo Sirainen <refsynopsisdiv>
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen <cmdsynopsis>
fd2f5fbc1f07aa93e2214a28cdf02437fb7d06c8Timo Sirainen <arg choice="req">-n <replaceable>name</replaceable></arg>
fd2f5fbc1f07aa93e2214a28cdf02437fb7d06c8Timo Sirainen <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen <arg choice="opt">-c <replaceable>console_device</replaceable></arg>
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen <arg choice="opt">-L <replaceable>console_logfile</replaceable></arg>
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen <arg choice="opt">-p <replaceable>pid_file</replaceable></arg>
44c5e644cb413a6559bf2d4179cbe48f9a82f366Timo Sirainen <arg choice="opt">--share-[net|ipc|uts] <replaceable>name|pid</replaceable></arg>
6a19e109ee8c5a6f688da83a86a7f6abeb71abddTimo Sirainen </cmdsynopsis>
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen </refsynopsisdiv>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen <command>lxc-start</command> runs the specified
72368bc3058d36912317ffe55e6017205f4fa036Timo Sirainen <replaceable>command</replaceable> inside the container
72368bc3058d36912317ffe55e6017205f4fa036Timo Sirainen specified by <replaceable>name</replaceable>.
72368bc3058d36912317ffe55e6017205f4fa036Timo Sirainen <command>lxc-start</command> は <replaceable>command</replaceable> で指定されたコマンドを、<replaceable>name</replaceable> で指定されたコンテナ内で実行します。
fd2f5fbc1f07aa93e2214a28cdf02437fb7d06c8Timo Sirainen It will setup the container
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen according to the configuration previously defined with the
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen lxc-create command or with the configuration file parameter.
fd2f5fbc1f07aa93e2214a28cdf02437fb7d06c8Timo Sirainen If no configuration is
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen defined, the default isolation is used.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen このコマンドは、lxc-create コマンドもしくは設定ファイルのパラメータであらかじめ定義された設定に従ってコンテナをセットアップします。
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen もし設定が定義されていない場合は、デフォルトの隔離状態を使用します。
287ba82a8da3eaa473b5735d4eeac2fb4c5d8117Timo Sirainen If no command is specified, <command>lxc-start</command> will
785b1ca149341b70bf2cb8cc3049f1c4c1070b52Timo Sirainen use the default
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen <command>"/sbin/init"</command> command to run a system
785b1ca149341b70bf2cb8cc3049f1c4c1070b52Timo Sirainen もし command が指定されない場合は、<command>lxc-start</command> はシステムコンテナを実行するためのコマンドとして、デフォルトで <command>"/sbin/init"</command> を使用します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <variablelist>
56f45b3f3ae20e5c933701f4657dda5ef1916855Timo Sirainen <varlistentry>
56f45b3f3ae20e5c933701f4657dda5ef1916855Timo Sirainen Run the container as a daemon. As the container has no
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen more tty, if an error occurs nothing will be displayed,
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen the log file can be used to check the error.
73a44af966c790560a72a0447f37bb35b1031a83Timo Sirainen コンテナをデーモンとして実行します。
73a44af966c790560a72a0447f37bb35b1031a83Timo Sirainen コンテナはそれ以上の tty を持ちませんので、もしエラーが起きても何も表示されません。
73a44af966c790560a72a0447f37bb35b1031a83Timo Sirainen エラーのチェックにはログファイルを使用することができます。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Run the container in the foreground. In this mode, the container
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen console will be attached to the current tty and signals will be routed
73a44af966c790560a72a0447f37bb35b1031a83Timo Sirainen directly to the container.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen コンテナをフォアグラウンドで実行します。このモードでは、コンテナコンソールは現在使用中の tty に割り当てられ、シグナルはコンテナに直接送られます。(これがデフォルトのモードです)
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <option>-p, --pidfile <replaceable>pid_file</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Create a file with the process id.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen プロセス ID を含むファイルを作製します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <option>-f, --rcfile <replaceable>config_file</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Specify the configuration file to configure the virtualization
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen and isolation functionalities for the container.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen This configuration file if present will be used even if there is
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen already a configuration file present in the previously created
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen container (via lxc-create).
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen (lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプションが指定された場合は、指定した設定ファイルが使用されます。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen --console <replaceable>console_device</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Specify a device to use for the container's console, for example
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen /dev/tty8. If this option is not specified the current terminal
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen will be used unless <option>-d</option> is specified.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen コンテナのコンソールに使用するデバイスを指定します。例えば /dev/tty8 のように指定します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen このオプションが指定されない時は、<option>-d</option> が指定されない限りは、現在のターミナルを使用します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
5e4f94015f5bbc9eefb1f2cb7af81ed50dcd2b39Timo Sirainen --console-log <replaceable>console_logfile</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Specify a file to log the container's console output to.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen コンテナのコンソール出力のログを出力するファイルを指定します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Assign value <replaceable>VAL</replaceable> to configuration
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen variable <replaceable>KEY</replaceable>. This overrides any
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen assignment done in <replaceable>config_file</replaceable>.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen 設定変数 <replaceable>KEY</replaceable> に対する設定値として <replaceable>VAL</replaceable> を設定します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen この設定は、<replaceable>config_file</replaceable> で既に設定されている値も上書きします。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen --close-all-fds</option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen If any file descriptors are inherited, close them. If this option
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen is not specified, then <command>lxc-start</command> will exit with
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen failure instead. Note: <replaceable>--daemon</replaceable> implies
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen <replaceable>--close-all-fds</replaceable>.
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen 継承しているファイルディスクリプタが存在する場合、それをクローズします。
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen このオプションが指定されない場合、<command>lxc-start</command> の実行は失敗して終了します。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen 注意: <replaceable>--daemon</replaceable> オプションは、<replaceable>--close-all-fds</replaceable> オプションを指定しなくても指定している場合と同様の動きをします。
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen </varlistentry>
e015e2f7e7f48874495f9df8b0dd192b7ffcb5ccTimo Sirainen <varlistentry>
e015e2f7e7f48874495f9df8b0dd192b7ffcb5ccTimo Sirainen <option>--share-net <replaceable>name|pid</replaceable></option>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen Inherit a network namespace from
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen a <replaceable>name</replaceable> container or
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen a <replaceable>pid</replaceable>. The network namespace
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen will continue to be managed by the original owner. The
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen network configuration of the starting container is ignored
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen and the up/down scripts won't be executed.
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen 名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナとネットワーク名前空間を共有します。
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen ネットワーク名前空間は引き続き元の所有者が管理します。
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen 開始するコンテナのネットワーク設定は無視され、up/down のスクリプトは実行されません。
1b97a59edb073e9a89ac43a21a9abe5d590d4a56Timo Sirainen </varlistentry>
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen <varlistentry>
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen <option>--share-ipc <replaceable>name|pid</replaceable></option>
6a8a4c9f530668cd8961b73d702856ed94f05f80Timo Sirainen Inherit an IPC namespace from
6a8a4c9f530668cd8961b73d702856ed94f05f80Timo Sirainen a <replaceable>name</replaceable> container or
6a8a4c9f530668cd8961b73d702856ed94f05f80Timo Sirainen a <replaceable>pid</replaceable>.
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen 名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと IPC 名前空間を共有します。
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen </varlistentry>
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen <varlistentry>
e015e2f7e7f48874495f9df8b0dd192b7ffcb5ccTimo Sirainen <option>--share-uts <replaceable>name|pid</replaceable></option>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen Inherit a UTS namespace from
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen a <replaceable>name</replaceable> container or
710deabc6b3c305c3a842e7a2e0d173c526d13a7Timo Sirainen a <replaceable>pid</replaceable>. The starting LXC will
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen not set the hostname, but the container OS may do it
710deabc6b3c305c3a842e7a2e0d173c526d13a7Timo Sirainen 名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと UTS 名前空間を共有します。
992a13add4eea0810e4db0f042a595dddf85536aTimo Sirainen LXC は開始するときににはホスト名を設定しませんが、コンテナ内の OS が何らかの方法でホスト名を設定するかもしれません。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen </variablelist>
dd4b5f14b71b01a84af942e720a2d6e5f15ee1a7Timo Sirainen &commonoptions;
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen <variablelist>
dd4b5f14b71b01a84af942e720a2d6e5f15ee1a7Timo Sirainen <varlistentry>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen The specified container is already running an
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen application. You should stop it before reuse this
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen container or create a new one.
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen 指定したコンテナは既に実行済みです。
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen このコンテナを使用する前に既に起動しているコンテナを停止するか、新しいものを作成する必要があります。
dd4b5f14b71b01a84af942e720a2d6e5f15ee1a7Timo Sirainen </varlistentry>
1171f0abf442638bac1827bb24a0b6b8eb682a82Timo Sirainen </variablelist>
710deabc6b3c305c3a842e7a2e0d173c526d13a7Timo Sirainen <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainen<!-- Keep this comment at the end of the file
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo SirainenLocal variables:
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-omittag:t
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-shorttag:t
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-minimize-attributes:nil
dd4b5f14b71b01a84af942e720a2d6e5f15ee1a7Timo Sirainensgml-always-quote-attributes:t
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-indent-step:2
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-indent-data:t
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-parent-document:nil
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-default-dtd-file:nil
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-exposed-tags:nil
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-local-catalogs:nil
6b85bc4b03e552cfaeeae872d63c2d8ac5fcb7c4Timo Sirainensgml-local-ecat-files:nil