<!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-unshare</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-unshare</refname>

<refpurpose>

<!--

タスクの新しい名前空間の組の中ので実行

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-unshare</command>

<arg choice="req">-s <replaceable>namespaces</replaceable></arg>

<arg choice="opt">-u <replaceable>user</replaceable></arg>

<arg choice="opt">-H <replaceable>hostname</replaceable></arg>

<arg choice="opt">-i <replaceable>ifname</replaceable></arg>

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

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

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

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

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

<para>

<!--

<command>lxc-unshare</command> はクローンされた名前空間の組の中でタスクを実行するのに使います。

このコマンドは主にテスト目的で使います。

このような名前であるにもかかわらず、このコマンドは常に、新しい名前空間で新しいタスクを作成するために unshare ではなく clone を使います。

テスト中のカーネルの退行は別として、これで違いは生じないはずです。

</para>

</refsect1>

<refsect1>

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

<variablelist>

<varlistentry>

<term>

<option>-s <replaceable>namespaces</replaceable></option>

</term>

<listitem>

<para>

<!--

アタッチする名前空間を、パイプでつなげたリストで指定します。

例えば <replaceable>NETWORK|IPC</replaceable> のようにです。

指定できる値は <replaceable>MOUNT</replaceable>、<replaceable>PID</replaceable>、<replaceable>UTSNAME</replaceable>、<replaceable>IPC</replaceable>、<replaceable>USER </replaceable>、<replaceable>NETWORK</replaceable> です。

これにより、プロセスのコンテキストを変更することができます。

例えば、コンテナのネットワーク名前空間だけを変更し、他の名前空間をホストのものと同じものに保ったままにするというようなことです。

(パイプ記号を <replaceable>MOUNT\|PID</replaceable> のようにエスケー

プするか、<replaceable>"MOUNT|PID"</replaceable> のように引用符号を付ける必要が>あります。)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-u <replaceable>user</replaceable></option>

</term>

<listitem>

<para>

<!--

新しいタスクを実行するユーザを指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-H <replaceable>hostname</replaceable></option>

</term>

<listitem>

<para>

<!--

新しいコンテナ内でのホスト名を設定します。UTSNAME 名前空間を指定している時のみ有効です。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-i <replaceable>interfacename</replaceable></option>

</term>

<listitem>

<para>

<!--

指定したインターフェースをコンテナ内に移動させます。ネットワーク (NETWORK) 名前空間を指定している時のみ有効です。複数のインターフェースをコンテナに移動させるために複数回指定することも可能です。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-d</option>

</term>

<listitem>

<para>

<!--

デーモンにします (コマンドはコンテナの終了を待ちません)。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-M</option>

</term>

<listitem>

<para>

<!--

コンテナ内でデフォルトのファイルシステム (/proc, /dev/shm, /dev/mqueue) をマウントします。マウント (MOUNT) 名前空間を指定している時のみ有効です。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title><!-- Examples -->例</title>

<para>

<!--

自身の UTS(hostname)名前空間でシェルを起動するには以下のように実行します。

<programlisting>

lxc-unshare -s UTSNAME /bin/bash

</programlisting>

もし、そのシェル上でホスト名を変更しても、その変更はホストには反映されません。

</para>

<para>

<!--

新しいネットワーク、pid、マウント名前空間でシェルを起動するには以下のように実行します。

<programlisting>

lxc-unshare -s "NETWORK|PID|MOUNT" /bin/bash

</programlisting>

その結果起動するシェルは pid が 1 となり、ネットワークインターフェースがないでしょう。

そのシェル上で /proc を再マウントした後

<programlisting>

mount -t proc proc /proc

</programlisting>

ps の出力は、その名前空間内には他のプロセスが存在しない事を表示するでしょう。

</para>

<para>

<!--

新しいネットワーク、PID、マウント、ホスト名 (UTS) 名前空間でシェルを起動するには、

<programlisting>

lxc-unshare -s "NETWORK|PID|MOUNT|UTSNAME" -M -H slave -i veth1 /bin/bash

</programlisting>

<!--

起動したシェルは PID 1 を持ち、2 つのネットワークインターフェース (lo と veth1) を持ちます。

ホスト名は "slave" となり、/proc は再マウントされます。ps コマンドは、名前空間内には他のプロセスがない状態を表示するでしょう。

</para>

</refsect1>

&seealso;

<refsect1>

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

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

</refsect1>

</refentry>