doc/ja/lxc-unshare.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 Serge Hallyn <serge.hallyn at ubuntu.com>
  10
  11 This library is free software; you can redistribute it and/or
  12 modify it under the terms of the GNU Lesser General Public
  13 License as published by the Free Software Foundation; either
  14 version 2.1 of the License, or (at your option) any later version.
  15
  16 This library is distributed in the hope that it will be useful,
  17 but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19 Lesser General Public License for more details.
  20
  21 You should have received a copy of the GNU Lesser General Public
  22 License along with this library; if not, write to the Free Software
  23 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  24
  25 Translated into Japanese
  26 by KATOH Yasufumi <karma at jazz.email.ne.jp>
  27
  28 -->
  29
  30 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  31
  32 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
  33 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
  34 ]>
  35
  36 <refentry>
  37
  38   <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
  39
  40   <refmeta>
  41     <refentrytitle>lxc-unshare</refentrytitle>
  42     <manvolnum>1</manvolnum>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>lxc-unshare</refname>
  47
  48     <refpurpose>
  49       <!--
  50       Run a task in a new set of namespaces.
  51       -->
  52       タスクを新しい名前空間の組で実行する．
  53     </refpurpose>
  54   </refnamediv>
  55
  56   <refsynopsisdiv>
  57     <cmdsynopsis>
  58       <command>lxc-clone</command>
  59       <arg choice="req">-s <replaceable>namespaces</replaceable></arg>
  60       <arg choice="req">-u <replaceable>user</replaceable></arg>
  61       <arg choice="req">command</arg>
  62     </cmdsynopsis>
  63   </refsynopsisdiv>
  64
  65   <refsect1>
  66     <title><!-- Description -->説明</title>
  67
  68     <para>
  69       <!--
  70       <command>lxc-unshare</command> can be used to run a task in a cloned set
  71       of namespaces.  This command is mainly provided for testing purposes.
  72       Despite its name, it always uses clone rather than unshare to create
  73       the new task with fresh namespaces.  Apart from testing kernel
  74       regressions this should make no difference.
  75       -->
  76       <command>lxc-unshare</command> はクローンされた名前空間の組の中でタスクを実行するのに使います．このコマンドは主にテスト目的で使います．このような名前であるにもかかわらず，このコマンドは常に，新しい名前空間で新しいタスクを作成するために unshare ではなく clone を使います．テスト中のカーネルの退行は別として，これで違いは生じないはずです．
  77     </para>
  78
  79   </refsect1>
  80
  81   <refsect1>
  82
  83     <title><!-- Options -->オプション</title>
  84
  85     <variablelist>
  86
  87       <varlistentry>
  88         <term>
  89           <option>-s <replaceable>namespaces</replaceable></option>
  90         </term>
  91         <listitem>
  92           <para>
  93             <!--
  94             Specify the namespaces to attach to, as a pipe-separated list,
  95             e.g. <replaceable>NETWORK|IPC</replaceable>. Allowed values are
  96             <replaceable>MOUNT</replaceable>, <replaceable>PID</replaceable>,
  97             <replaceable>UTSNAME</replaceable>, <replaceable>IPC</replaceable>,
  98             <replaceable>USER </replaceable> and
  99             <replaceable>NETWORK</replaceable>. This allows one to change
 100             the context of the process to e.g. the network namespace of the
 101             container while retaining the other namespaces as those of the
 102             host.
 103             -->
 104             アタッチする名前空間を，パイプでつなげたリストで指定します．例えば <replaceable>NETWORK|IPC</replaceable> のようにです．指定できる値は <replaceable>MOUNT</replaceable>，<replaceable>PID</replaceable>，<replaceable>UTSNAME</replaceable>，<replaceable>IPC</replaceable>，<replaceable>USER </replaceable>，<replaceable>NETWORK</replaceable> です．これにより，プロセスのコンテキストを変更することができます．例えば，コンテナのネットワーク名前空間だけを変更し，他の名前空間をホストのものと同じものに保ったままにするというようなことです．
 105           </para>
 106         </listitem>
 107       </varlistentry>
 108
 109       <varlistentry>
 110         <term>
 111           <option>-u <replaceable>user</replaceable></option>
 112         </term>
 113         <listitem>
 114           <para>
 115             <!--
 116             Specify a user which the new task should become.  This option is
 117             only valid if a user namespace is unshared.
 118             -->
 119             新しいタスクを実行するユーザを指定します．このオプションはユーザ名前空間を unshare する時のみ有効です．
 120           </para>
 121         </listitem>
 122       </varlistentry>
 123
 124     </variablelist>
 125
 126   </refsect1>
 127
 128   <refsect1>
 129     <title><!-- Examples -->例</title>
 130       <para>
 131         <!--
 132         To spawn a new shell with its own UTS (hostname) namespace,
 133         <programlisting>
 134           lxc-clone -s UTSNAME /bin/bash
 135         </programlisting>
 136         If the hostname is changed in that shell, the change will not be
 137         reflected on the host.
 138         -->
 139         自身の UTS(hostname)名前空間でシェルを起動するには以下のように実行します．
 140         <programlisting>
 141           lxc-clone -s UTSNAME /bin/bash
 142         </programlisting>
 143         もし，そのシェル上でホスト名を変更しても，その変更はホストには反映されません．
 144       </para>
 145       <para>
 146         <!--
 147         To spawn a shell in a new network, pid, and mount namespace,
 148         <programlisting>
 149           lxc-clone -s "NETWORK|PID|MOUNT" /bin/bash
 150         </programlisting>
 151         The resulting shell will have pid 1 and will see no network interfaces.
 152         After re-mounting /proc in that shell,
 153         <programlisting>
 154           mount -t proc proc /proc
 155         </programlisting>
 156         ps output will show there are no other processes in the namespace.
 157         -->
 158         新しいネットワーク，pid，マウント名前空間でシェルを起動するには以下のように実行します．
 159         <programlisting>
 160           lxc-clone -s "NETWORK|PID|MOUNT" /bin/bash
 161         </programlisting>
 162         その結果起動するシェルは pid が 1 となり，ネットワークインターフェースがないでしょう．そのシェル上で /proc を再マウントした後
 163         <programlisting>
 164           mount -t proc proc /proc
 165         </programlisting>
 166         ps の出力は，その名前空間内には他のプロセスが存在しない事を表示するでしょう．
 167       </para>
 168   </refsect1>
 169
 170   &seealso;
 171
 172   <refsect1>
 173     <title><!-- Author -->作者</title>
 174     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 175   </refsect1>
 176
 177 </refentry>
 178
 179 <!-- Keep this comment at the end of the file
 180 Local variables:
 181 mode: sgml
 182 sgml-omittag:t
 183 sgml-shorttag:t
 184 sgml-minimize-attributes:nil
 185 sgml-always-quote-attributes:t
 186 sgml-indent-step:2
 187 sgml-indent-data:t
 188 sgml-parent-document:nil
 189 sgml-default-dtd-file:nil
 190 sgml-exposed-tags:nil
 191 sgml-local-catalogs:nil
 192 sgml-local-ecat-files:nil
 193 End:
 194 -->