Merge pull request #2926 from tenforward/japanese

doc: update Japanese lxc-user-nic manpage
lxc · Apr 6, 2019 · 74f628a · 74f628a
2 parents a38fa3d + a1c4b83
commit 74f628a
Showing 1 changed file with 72 additions and 7 deletions.
diff --git a/doc/ja/lxc-user-nic.sgml.in b/doc/ja/lxc-user-nic.sgml.in
@@ -46,19 +46,33 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
 
     <refpurpose>
       <!--
-      Create and attach a nic to another network namespace.
+      Manage nics in another namespace
       -->
-      NIC を作成し、他のネットワーク名前空間に割り当てる
+      現在と異なるネットワーク名前空間の NIC を管理する
     </refpurpose>
   </refnamediv>
 
   <refsynopsisdiv>
     <cmdsynopsis>
       <command>lxc-user-nic</command>
+      <command>create</command>
+      <arg choice="req"><replaceable>lxcpath</replaceable></arg>
+      <arg choice="req"><replaceable>name</replaceable></arg>
       <arg choice="req"><replaceable>pid</replaceable></arg>
       <arg choice="req"><replaceable>type</replaceable></arg>
       <arg choice="req"><replaceable>bridge</replaceable></arg>
-      <arg choice="opt"><replaceable>nicname</replaceable></arg>
+      <arg choice="opt"><replaceable>container nicname</replaceable></arg>
+    </cmdsynopsis>
+
+     <cmdsynopsis>
+      <command>lxc-user-nic</command>
+      <command>delete</command>
+      <arg choice="req"><replaceable>lxcpath</replaceable></arg>
+      <arg choice="req"><replaceable>name</replaceable></arg>
+      <arg choice="req"><replaceable>path to network namespace</replaceable></arg>
+      <arg choice="req"><replaceable>type</replaceable></arg>
+      <arg choice="req"><replaceable>bridge</replaceable></arg>
+      <arg choice="req"><replaceable>container nicname</replaceable></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
 
@@ -68,7 +82,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
     <para>
       <!--
       <command>lxc-user-nic</command> is a setuid-root program with which
-      unprivileged users may create network interfaces for use by a lxc container.
+      unprivileged users may create network interfaces for use by a
+      lxc container.
       -->
       <command>lxc-user-nic</command> は root に setuid されたプログラムで、lxc コンテナが使うネットワークインターフェースを、特権を持たないユーザが作成できます。
     </para>
@@ -81,10 +96,14 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
       <filename>@LXC_USERNIC_DB@</filename>.  It ensures that the calling
       user is privileged over the network namespace to which the interface
       will be attached.
+      <command>lxc-user-nic</command> also allows to delete network devices.
+      Currently only ovs ports can be deleted.
       -->
       このプログラムは、<filename>@LXC_USERNIC_CONF@</filename> という設定ファイルを参照して、呼び出したユーザが作成することができるインターフェースの数と、どのブリッジに接続するかを決定します。
       また、ユーザが作成したインターフェースの数を <filename>@LXC_USERNIC_DB@</filename> を使ってチェックします。
       これにより、呼び出したユーザが、インターフェースを割り当てるネットワーク名前空間上で特権を持つことが保証されます。
+      <command>lxc-user-nic</command> はネットワークデバイスを削除することもできます。
+      現時点では ovs ポートの削除のみ可能です。
     </para>
 
   </refsect1>
@@ -94,6 +113,33 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
     <title><!-- Options -->オプション</title>
 
     <variablelist>
+      <varlistentry>
+	<term>
+	  <option><replaceable>lxcpath</replaceable></option>
+	</term>
+	<listitem>
+	  <para>
+	    <!--
+	  The path of the container. This is currently not used.
+	      -->
+	    すべてのコンテナが保存されるパス。これは現在使われていません。
+	  </para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>
+	  <option><replaceable>name</replaceable></option>
+	</term>
+	<listitem>
+	  <para>
+	    <!--
+	  The name of the container. This is currently not used.
+	      -->
+	    コンテナ名。これは現在使われていません。
+	  </para>
+	</listitem>
+      </varlistentry>
 
       <varlistentry>
 	<term>
@@ -117,7 +163,7 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
 	<listitem>
 	  <para>
             <!--
-	  The network interface type to attach.  Currently only veth is
+	  The network interface type to attach. Currently only veth is
 	  supported.  With this type, two interfaces representing each
 	  tunnel endpoint are created.  One endpoint will be attached
 	  to the specified bridge, while the other will be passed into
@@ -148,12 +194,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
 
       <varlistentry>
 	<term>
-	  <option><replaceable>nicname</replaceable></option>
+	  <option><replaceable>container nicname</replaceable></option>
 	</term>
 	<listitem>
 	  <para>
             <!--
-	  The desired interface name in the container.  This will be
+	  The desired interface name in the container. This will be
 	  <filename>eth0</filename> if unspecified.
           -->
             コンテナ内に作られるインターフェースの名前。
@@ -162,6 +208,23 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
 	</listitem>
       </varlistentry>
 
+      <varlistentry>
+	<term>
+	  <option><replaceable>path to network namespace</replaceable></option>
+	</term>
+	<listitem>
+	  <para>
+	    <!--
+	  A path to open to get a file descriptor for the target
+	  network namespace.
+	  This is only relevant when an veth device is deleted.
+	      -->
+	    対象のネットワーク名前空間のファイルディスクリプタを取得するために open するためのパス。
+	    これは veth デバイスを削除するときのみ関係します。
+	  </para>
+	</listitem>
+      </varlistentry>
+
     </variablelist>
 
   </refsect1>
@@ -189,6 +252,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
 
   <refsect1>
     <title><!-- Author -->作者</title>
+    <para>Christian Brauner <email>christian@brauner.io</email></para>
+    <para>Serge Hallyn <email>serge@hallyn.com</email></para>
     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
   </refsect1>