lxc-execute.sgml.in revision 6127da6b3f5815028bee187ac98840cd94313841
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen<!--
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainenlxc: linux Container library
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen
5355df8b66da35698449a10c2c83633a64995298Timo Sirainen(C) Copyright IBM Corp. 2007, 2008
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen
a64adf62fa33f2463a86f990217b0c9078531a40Timo SirainenAuthors:
1b04762685272a53643ac2179939537a44c7c044Timo SirainenDaniel Lezcano <daniel.lezcano at free.fr>
c000aa8509e03b4f7b0574f910d38a7e5e7e002aTimo Sirainen
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo SirainenThis library is free software; you can redistribute it and/or
8d3278a82b964217d95c340ec6f82037cdc59d19Timo Sirainenmodify it under the terms of the GNU Lesser General Public
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo SirainenLicense as published by the Free Software Foundation; either
0aac625db5e6e179c8ee7420a12ab300d6b178edTimo Sirainenversion 2.1 of the License, or (at your option) any later version.
0aac625db5e6e179c8ee7420a12ab300d6b178edTimo Sirainen
9e708a17f984ef7690ff2468ec19ad62c95b1ac2Timo SirainenThis library is distributed in the hope that it will be useful,
d3b29d4b61f1549244a7509b798be6f806cf7d4eTimo Sirainenbut WITHOUT ANY WARRANTY; without even the implied warranty of
d3b29d4b61f1549244a7509b798be6f806cf7d4eTimo SirainenMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
9e708a17f984ef7690ff2468ec19ad62c95b1ac2Timo SirainenLesser General Public License for more details.
bd6abf27d1d29a2407f990163e9fe0d0c478a15aTimo Sirainen
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo SirainenYou should have received a copy of the GNU Lesser General Public
9e708a17f984ef7690ff2468ec19ad62c95b1ac2Timo SirainenLicense along with this library; if not, write to the Free Software
87e74a3969c8380e53bebc7805dbec20fffeed49Timo SirainenFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo SirainenTranslated into Japanese
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainenby KATOH Yasufumi <karma at jazz.email.ne.jp>
a64adf62fa33f2463a86f990217b0c9078531a40Timo Sirainen
a64adf62fa33f2463a86f990217b0c9078531a40Timo Sirainen-->
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen<!DOCTYPE refentry PUBLIC @docdtd@ [
e3a317209a903361987b60ccd763de72dfa174b9Timo Sirainen
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
548f87789cf9865572b7b86f7be5a9bbfa132f3fTimo Sirainen<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
a64adf62fa33f2463a86f990217b0c9078531a40Timo Sirainen]>
a64adf62fa33f2463a86f990217b0c9078531a40Timo Sirainen
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen<refentry>
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen <refmeta>
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen <refentrytitle>lxc-execute</refentrytitle>
bbe42963032af89fac1318844da08c742525cc87Timo Sirainen <manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname>lxc-execute</refname>
<refpurpose>
<!--
run an application inside a container.
-->
コンテナ内でのアプリケーションの実行
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>lxc-execute</command>
<arg choice="req">-n <replaceable>name</replaceable></arg>
<arg choice="opt">-f <replaceable>config_file</replaceable></arg>
<arg choice="opt">-s KEY=VAL</arg>
<arg choice="opt">-- <replaceable>command</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title><!-- Description -->説明</title>
<para>
<!--
<command>lxc-execute</command> runs the specified
<replaceable>command</replaceable> inside the container
specified by <replaceable>name</replaceable>.
-->
<command>lxc-execute</command> は特定の <replaceable>command</replaceable> を,<replaceable>name</replaceable> で指定したコンテナ内で実行します.
</para>
<para>
<!--
It will setup the container
according to the configuration previously defined with the
lxc-create command or with the configuration file parameter.
If no configuration is
defined, the default isolation is used.
-->
このコマンドは,lxc-create コマンドであらかじめ定義した設定,もしくはパラメータとして与えた設定ファイルを元にコンテナをセットアップします.もし設定が定義されていない場合,デフォルトの隔離を使用します.
</para>
<para>
<!--
This command is mainly used when you want to quickly launch an
application in an isolated environment.
-->
このコマンドは主に,素早く単一のアプリケーションを隔離された環境で動作させたい時に使います.
</para>
<para>
<!--
<command>lxc-execute</command> command will run the
specified command into the container via an intermediate
process, <command>lxc-init</command>.
This lxc-init after launching the specified command,
will wait for its end and all other reparented processes.
(to support daemons in the container).
In other words, in the
container, <command>lxc-init</command> has the pid 1 and the
first process of the application has the pid 2.
-->
<command>lxc-execute</command> は,<command>lxc-init</command> を間にはさんで,コンテナ内で特定のコマンドを実行します.lxc-init は,指定されたコマンドが実行された後は,そのコマンドの終了と,そのコマンドから生成された全てのプロセスの終了を待ちます (これにより,コンテナ内でデーモンのサポートが可能になります).言いかえると,コンテナ内では <command>lxc-init</command> が pid 1 となり,アプリケーションの最初のプロセスの pid が 2 となります.
</para>
<para>
<!--
The above <command>lxc-init</command> is designed to forward received
signals to the started command.
So <command>lxc-kill</command> (1) sent signal is received
by the user specified command (pid 2 in the container).
-->
前述の <command>lxc-init</command> は,受け取ったシグナルを開始したコマンドに送るように設計されています.なので,<command>lxc-kill</command> (1) が送ったシグナルは,ユーザが指定したコマンド (コンテナ内の pid 2 のプロセス) が受けとります.
</para>
</refsect1>
<refsect1>
<title><!-- Options -->オプション</title>
<variablelist>
<varlistentry>
<term>
<option>-f, --rcfile <replaceable>config_file</replaceable></option>
</term>
<listitem>
<para>
<!--
Specify the configuration file to configure the virtualization
and isolation functionalities for the container.
-->
コンテナに設定したい仮想化および隔離機能の設定を行う設定ファイルを指定します.
</para>
<para>
<!--
This configuration file if present will be used even if there is
already a configuration file present in the previously created
container (via lxc-create).
-->
もしコンテナ作成前に (lxc-create によって) あらかじめ設定ファイルが指定されている場合であっても,指定した設定ファイルが使われます.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-s, --define <replaceable>KEY=VAL</replaceable></option>
</term>
<listitem>
<para>
<!--
Assign value <replaceable>VAL</replaceable> to configuration
variable <replaceable>KEY</replaceable>. This overrides any
assignment done in <replaceable>config_file</replaceable>.
-->
設定変数 <replaceable>KEY</replaceable> の値を <replaceable>VAL</replaceable> に設定します.この設定は <replaceable>config_file</replaceable> で設定された値を上書きします.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--</option></term>
<listitem>
<para>
<!--
Signal the end of options and disables further option
processing. Any arguments after the &#045;&#045; are treated as
arguments to <replaceable>command</replaceable>.
-->
オプション指定の最後の印で,それ以上のオプションの処理を止めます.-- の後の引数は実行する <replaceable>command</replaceable> の引数として扱われます.
</para>
<para>
<!--
This option is useful when you want specify options
to <replaceable>command</replaceable> and don't want
<command>lxc-execute</command> to interpret them.
-->
このオプションは,<replaceable>command</replaceable> にオプションを指定したいときに,<command>lxc-execute</command> がそのオプションを読み取ってほしくないときに役に立ちます.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
&commonoptions;
<refsect1>
<title><!-- Diagnostic -->診断</title>
<variablelist>
<varlistentry>
<term>The container is busy</term>
<listitem>
<para>
<!--
The specified container is already running an
application. You should stop it before reuse this
container or create a new one.
-->
指定したコンテナが既にアプリケーションを実行中の場合.コンテナを再使用したり,新しく作成する前にコンテナを止める必要があります.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
&seealso;
<refsect1>
<title><!-- Author -->作者</title>
<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->