doc: Update man pages to the latest information

* lxc-attach(1): Update to the status of kernel 3.8 or higher
* lxc-create(1), lxc-destroy(1): Now lxc-ls don't have "-l" option, so remove
* lxc(7): update description of lxc-ls and lxc-info to current version
* see-also: fix lxc(1) to lxc(7)

Signed-off-by: KATOH Yasufumi <karma@jazz.email.ne.jp>
Acked-by: Stéphane Graber <stgraber@ubuntu.com>
This commit is contained in:
KATOH Yasufumi 2014-01-06 18:05:39 +09:00 committed by Stéphane Graber
parent 5fd9f759c1
commit a600d021ad
10 changed files with 29 additions and 63 deletions

View File

@ -339,13 +339,14 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<para>
<!--
Attaching completely (including the pid and mount namespaces) to a
container requires a patched kernel, please see the lxc website for
container requires a kernel of version 3.8 or higher, or a
patched kernel, please see the lxc website for
details. <command>lxc-attach</command> will fail in that case if
used with an unpatched kernel.
used with an unpatched kernel of version 3.7 and prior.
-->
(pid とマウント名前空間を含む) コンテナに対する完全なアタッチを行うにはパッチを適用したカーネルが必要となります.
(pid とマウント名前空間を含む) コンテナに対する完全なアタッチを行うには 3.8 以上,もしくはパッチを適用したカーネルが必要となります.
詳しくは lxc のウェブサイトを参照してください.
(訳注: 3.8 カーネルから PID, マウント名前空間に対するアタッチも可能になっている)
パッチが当たっていない 3.8 より小さなバージョンのカーネルを使った場合は,<command>lxc-attach</command> の実行は失敗するでしょう.
</para>
<para>
<!--
@ -359,12 +360,10 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
</para>
<para>
<!--
Attaching to user namespaces is currently completely unsupported
by the kernel. <command>lxc-attach</command> should however be able
to do this once once future kernel versions implement this.
Attaching to user namespaces is supported by kernel 3.8 or higher
with enabling user namespace.
-->
ユーザ名前空間へのアタッチは,現時点ではカーネルで完全にサポートされていません.
しかし,<command>lxc-attach</command> は,将来のカーネルがこの機能を実装した時点ですぐに,アタッチが可能になるはずです.
ユーザ名前空間へのアタッチは,ユーザ名前空間機能を有効にした 3.8 以上のカーネルでサポートされます.
</para>
</refsect1>

View File

@ -233,11 +233,11 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<!--
As the message mention it, you try to create a container
but there is a container with the same name. You can use
the <command>lxc-ls -l</command> command to list the
the <command>lxc-ls</command> command to list the
available containers on the system.
-->
メッセージの通り,コンテナを作成しようとしたけれども,同じ名前のコンテナが存在しています.
<command>lxc-ls -l</command> コマンドを使って,システム上に存在する利用可能なコンテナのリストが表示できます.
<command>lxc-ls</command> コマンドを使って,システム上に存在する利用可能なコンテナのリストが表示できます.
</para>
</listitem>
</varlistentry>

View File

@ -123,12 +123,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<!--
The specified container for destruction was not found. It
is probable it does not exists and was already
destroyed.You can use the <command>lxc-ls -l</command>
destroyed.You can use the <command>lxc-ls</command>
command to list the available containers on the system.
-->
破壊するために指定したコンテナが見つかりません.
おそらくそのコンテナが存在しないのか,既に破壊された後なのでしょう.
<command>lxc-ls -l</command> コマンドを使って,システム上に存在するコンテナのリストを得ることができます.
<command>lxc-ls</command> コマンドを使って,システム上に存在するコンテナのリストを得ることができます.
</para>
</listitem>
</varlistentry>

View File

@ -697,35 +697,15 @@ rootfs
<para>
<!--
<command>lxc-ls</command> lists the containers of the
system. The command is a script built on top
of <command>ls</command>, so it accepts the options of the ls
commands, eg:
<programlisting>
lxc-ls -C1
</programlisting>
will display the containers list in one column or:
<programlisting>
lxc-ls -l
</programlisting>
will display the containers list and their permissions.
system.
-->
<command>lxc-ls</command> は,システムのコンテナを一覧します.
このコマンドは <command>ls</command> をうまく利用して作られているスクリプトです.
なのでls コマンドのオプションを受け付けます.例えば
<programlisting>
lxc-ls -C1
</programlisting>
はコンテナのリストを 1 列で表示しますし,
<programlisting>
lxc-ls -l
</programlisting>
はコンテナのリストとパーミッションを表示します.
</para>
<para>
<!--
<command>lxc-ps</command> will display the pids for a specific
container. Like <command>lxc-ls</command>, <command>lxc-ps</command>
container. <command>lxc-ps</command>
is built on top of <command>ps</command> and accepts the same
options, eg:
<programlisting>lxc-ps &#045;&#045;name foo &#045;&#045;forest</programlisting>
@ -736,7 +716,7 @@ rootfs
will display all the containers and their processes.
-->
<command>lxc-ps</command> は特定のコンテナに対する pid を表示します.
<command>lxc-ls</command> のように,<command>lxc-ps</command> は <command>ps</command> コマンドをうまく利用して作られており,同じオプションを利用可能です.
<command>lxc-ps</command> は <command>ps</command> コマンドをうまく利用して作られており,同じオプションを利用可能です.
例えば,
<programlisting>lxc-ps --name foo --forest</programlisting>
は 'foo' という名前のコンテナに属するプロセスを階層構造で表示します.
@ -748,11 +728,9 @@ rootfs
<para>
<!--
<command>lxc-info</command> gives information for a specific
container, at present time, only the state of the container is
displayed.
container.
-->
<command>lxc-info</command> は,指定したコンテナに対する情報を与えます.
現時点では,コンテナの状態だけを表示します.
<command>lxc-info</command> は,指定したコンテナに関する情報を取得します.
</para>
<para>

View File

@ -32,7 +32,7 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<simpara>
<citerefentry>
<refentrytitle><command>lxc</command></refentrytitle>
<manvolnum>1</manvolnum>
<manvolnum>7</manvolnum>
</citerefentry>,
<citerefentry>

View File

@ -257,9 +257,10 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
<title>Compatibility</title>
<para>
Attaching completely (including the pid and mount namespaces) to a
container requires a patched kernel, please see the lxc website for
container requires a kernel of version 3.8 or higher, or a
patched kernel, please see the lxc website for
details. <command>lxc-attach</command> will fail in that case if
used with an unpatched kernel.
used with an unpatched kernel of version 3.7 and prior.
</para>
<para>
Nevertheless, it will succeed on an unpatched kernel of version 3.0
@ -269,9 +270,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
and <replaceable>UTSNAME</replaceable>.
</para>
<para>
Attaching to user namespaces is currently completely unsupported
by the kernel. <command>lxc-attach</command> should however be able
to do this once once future kernel versions implement this.
Attaching to user namespaces is supported by kernel 3.8 or higher
with enabling user namespace.
</para>
</refsect1>

View File

@ -184,7 +184,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
<para>
As the message mention it, you try to create a container
but there is a container with the same name. You can use
the <command>lxc-ls -l</command> command to list the
the <command>lxc-ls</command> command to list the
available containers on the system.
</para>
</listitem>

View File

@ -104,7 +104,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
<para>
The specified container for destruction was not found. It
is probable it does not exists and was already
destroyed.You can use the <command>lxc-ls -l</command>
destroyed.You can use the <command>lxc-ls</command>
command to list the available containers on the system.
</para>
</listitem>

View File

@ -463,22 +463,12 @@ rootfs
</para>
<para>
<command>lxc-ls</command> lists the containers of the
system. The command is a script built on top
of <command>ls</command>, so it accepts the options of the ls
commands, eg:
<programlisting>
lxc-ls -C1
</programlisting>
will display the containers list in one column or:
<programlisting>
lxc-ls -l
</programlisting>
will display the containers list and their permissions.
system.
</para>
<para>
<command>lxc-ps</command> will display the pids for a specific
container. Like <command>lxc-ls</command>, <command>lxc-ps</command>
container. <command>lxc-ps</command>
is built on top of <command>ps</command> and accepts the same
options, eg:
<programlisting>lxc-ps --name foo --forest</programlisting>
@ -491,8 +481,7 @@ rootfs
<para>
<command>lxc-info</command> gives information for a specific
container, at present time, only the state of the container is
displayed.
container.
</para>
<para>

View File

@ -29,7 +29,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
<simpara>
<citerefentry>
<refentrytitle><command>lxc</command></refentrytitle>
<manvolnum>1</manvolnum>
<manvolnum>7</manvolnum>
</citerefentry>,
<citerefentry>