<!DOCTYPE refentry PUBLIC @docdtd@ [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-start</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-start</refname>

<refpurpose>

<!--

コンテナ内でのアプリケーションの実行

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-start</command>

<arg choice="req">-n <replaceable>name</replaceable></arg>

<arg choice="opt">-f <replaceable>config_file</replaceable></arg>

<arg choice="opt">-c <replaceable>console_device</replaceable></arg>

<arg choice="opt">-L <replaceable>console_logfile</replaceable></arg>

<arg choice="opt">-d</arg>

<arg choice="opt">-F</arg>

<arg choice="opt">-p <replaceable>pid_file</replaceable></arg>

<arg choice="opt">-s KEY=VAL</arg>

<arg choice="opt">-C</arg>

<arg choice="opt">--share-[net|ipc|uts] <replaceable>name|pid</replaceable></arg>

<arg choice="opt">command</arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title><!-- Description -->説明</title>

<para>

<!--

<command>lxc-start</command> は <replaceable>command</replaceable> で指定されたコマンドを、<replaceable>name</replaceable> で指定されたコンテナ内で実行します。

</para>

<para>

<!--

このコマンドは、lxc-create コマンドもしくは設定ファイルのパラメータであらかじめ定義された設定に従ってコンテナをセットアップします。

もし設定が定義されていない場合は、デフォルトの隔離状態を使用します。

</para>

<para>

<!--

もし command が指定されない場合は、<command>lxc-start</command> はシステムコンテナを実行するためのコマンドとして、lxc.init_cmd で設定されたコマンドを使用します。

もし lxc.init_cmd が設定されていない場合は、デフォルトで <command>"/sbin/init"</command> を使用します。

</para>

</refsect1>

<refsect1>

<title><!-- Options -->オプション</title>

<variablelist>

<varlistentry>

<term>

<option>-d, --daemon</option>

</term>

<listitem>

<para>

<!--

コンテナをデーモンとして実行します。

コンテナはそれ以上の tty を持ちませんので、もしエラーが起きても何も表示されません。

エラーのチェックにはログファイルを使用することができます。(これがデフォルトのモードです)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-F, --foreground</option>

</term>

<listitem>

<para>

<!--

コンテナをフォアグラウンドで実行します。このモードでは、コンテナコンソールは現在使用中の tty に割り当てられ、シグナルはコンテナに直接送られます。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-p, --pidfile <replaceable>pid_file</replaceable></option>

</term>

<listitem>

<para>

<!--

プロセス ID を含むファイルを作製します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-f, --rcfile <replaceable>config_file</replaceable></option>

</term>

<listitem>

<para>

<!--

コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。

</para>

<para>

<!--

(lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプションが指定された場合は、指定した設定ファイルが使用されます。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-c,

--console <replaceable>console_device</replaceable></option>

</term>

<listitem>

<para>

<!--

コンテナのコンソールに使用するデバイスを指定します。例えば /dev/tty8 のように指定します。

このオプションが指定されない時は、<option>-d</option> が指定されない限りは、現在のターミナルを使用します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-L,

--console-log <replaceable>console_logfile</replaceable></option>

</term>

<listitem>

<para>

<!--

コンテナのコンソール出力のログを出力するファイルを指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-s, --define <replaceable>KEY=VAL</replaceable></option>

</term>

<listitem>

<para>

<!--

設定変数 <replaceable>KEY</replaceable> に対する設定値として <replaceable>VAL</replaceable> を設定します。

この設定は、<replaceable>config_file</replaceable> で既に設定されている値も上書きします。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-C,

--close-all-fds</option>

</term>

<listitem>

<para>

<!--

継承しているファイルディスクリプタが存在する場合、それをクローズします。

このオプションが指定されない場合、<command>lxc-start</command> の実行は失敗して終了します。

注意: <replaceable>--daemon</replaceable> オプションは、<replaceable>--close-all-fds</replaceable> オプションを指定しなくても指定している場合と同様の動きをします。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>--share-net <replaceable>name|pid</replaceable></option>

</term>

<listitem>

<para>

<!--

名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナとネットワーク名前空間を共有します。

ネットワーク名前空間は引き続き元の所有者が管理します。

開始するコンテナのネットワーク設定は無視され、up/down のスクリプトは実行されません。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>--share-ipc <replaceable>name|pid</replaceable></option>

</term>

<listitem>

<para>

<!--

名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと IPC 名前空間を共有します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>--share-uts <replaceable>name|pid</replaceable></option>

</term>

<listitem>

<para>

<!--

名前が <replaceable>name</replaceable> である、もしくは PID が <replaceable>pid</replaceable> であるコンテナと UTS 名前空間を共有します。

LXC は開始するときににはホスト名を設定しませんが、コンテナ内の OS が何らかの方法でホスト名を設定するかもしれません。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&commonoptions;

<refsect1>

<title><!-- Diagnostic -->診断</title>

<variablelist>

<varlistentry>

<term>The container is busy</term>

<listitem>

<para>

<!--

指定したコンテナは既に実行済みです。

このコンテナを使用する前に既に起動しているコンテナを停止するか、新しいものを作成する必要があります。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title><!-- Author -->作者</title>

<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

</refsect1>

</refentry>