[lxc-devel] [PATCH] doc: Update Japanese lxc-stop(1), lxc.conf(5), lxc-start-ephemeral(1)
Stéphane Graber
stgraber at ubuntu.com
Tue Jan 7 14:22:31 UTC 2014
On Tue, Jan 07, 2014 at 09:54:15PM +0900, KATOH Yasufumi wrote:
> * nokill option of lxc-stop (commit 84fbfcb434f5a59680b7f017bbc1d0db0b81a39d)
> * lxc.haltsignal in lxc.conf (commit f0f1d8c076ae93d8ecf735c2eeae471e27ca6abd)
> * fix sgml (commit d438f5a0ef0f304917e227405d26aef6e7b30303)
>
> Signed-off-by: KATOH Yasufumi <karma at jazz.email.ne.jp>
Acked-by: Stéphane Graber <stgraber at ubuntu.com>
> ---
> doc/ja/lxc-start-ephemeral.sgml.in | 2 ++
> doc/ja/lxc-stop.sgml.in | 55 ++++++++++++++++++++------------------
> doc/ja/lxc.conf.sgml.in | 51 ++++++++++++++++++++++++++++-------
> 3 files changed, 72 insertions(+), 36 deletions(-)
>
> diff --git a/doc/ja/lxc-start-ephemeral.sgml.in b/doc/ja/lxc-start-ephemeral.sgml.in
> index f3d4c19..c673c16 100644
> --- a/doc/ja/lxc-start-ephemeral.sgml.in
> +++ b/doc/ja/lxc-start-ephemeral.sgml.in
> @@ -228,7 +228,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
> <manvolnum>1</manvolnum>
> </citerefentry>,
> </simpara>
> + </refsect1>
>
> + <refsect1>
> <title><!-- Examples -->例</title>
> <variablelist>
> <varlistentry>
> diff --git a/doc/ja/lxc-stop.sgml.in b/doc/ja/lxc-stop.sgml.in
> index e82e772..d21f6a2 100644
> --- a/doc/ja/lxc-stop.sgml.in
> +++ b/doc/ja/lxc-stop.sgml.in
> @@ -60,7 +60,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
> <arg choice="opt">-r</arg>
> <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
> <arg choice="opt">-k</arg>
> - <arg choice="opt">-s</arg>
> + <arg choice="opt">--nokill</arg>
> + <arg choice="opt">--nolock</arg>
> </cmdsynopsis>
> </refsynopsisdiv>
>
> @@ -71,27 +72,29 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
> <!--
> <command>lxc-stop</command> reboots, cleanly shuts down, or kills
> all the processes inside the container. By default, it will
> - request a clean shutdown of the container (by sending SIGPWR to
> - the container), wait 60 seconds for the container to exit, and
> - returns. If the container fails to cleanly exit, then after 60
> - seconds the container will be sent the
> - <command>lxc.stopsignal</command> to force it to shut down.
> + request a clean shutdown of the container by sending
> + <command>lxc.haltsignal</command> (defaults to SIGPWR) to
> + the container's init process, waiting up to 60 seconds for the container
> + to exit, and then returning. If the container fails to cleanly exit in
> + 60 seconds, it will be sent the <command>lxc.stopsignal</command>
> + (defaults to SIGKILL) to force it to shut down.
> -->
> <command>lxc-stop</command> は，リブート，クリーンシャットダウン，コンテナ内の全てのプロセスの kill のどれかを行います．
> - デフォルトでは，コンテナのクリーンなシャットダウンを (SIGPWR をコンテナに送ることで) 行い，コンテナの終了を 60 秒待ち，return します．
> - コンテナがクリーンに終了するのに失敗した場合，60 秒待った後，コンテナに <command>lxc.stopsignal</command> で指定したシグナルを送り，強制的にシャットダウンします．
> + デフォルトでは，コンテナのクリーンなシャットダウンを <command>lxc.haltsignal</command> (デフォルトでは SIGPWR) をコンテナの init プロセスに送ることでリクエストし，コンテナの終了を 60 秒待ち，return します．
> + コンテナが 60 秒の間にクリーンに終了するのに失敗した場合，<command>lxc.stopsignal</command> (デフォルトでは SIGKILL) を送り，強制的にシャットダウンします．
> </para>
>
> <para>
> <!--
> - The <optional>-W</optional>, <optional>-r</optional>, <optional>-s</optional>
> - and <optional>-k</optional> options specify the action to perform.
> + The <optional>-W</optional>, <optional>-r</optional>,
> + <optional>-k</optional> and <optional>--nokill</optional>
> + options specify the action to perform.
> <optional>-W</optional> indicates that after performing the specified
> action, <command>lxc-stop</command> should immediately exit, while
> <optional>-t TIMEOUT</optional> specifies the maximum amount of time
> to wait for the container to complete the shutdown or reboot.
> -->
> - <optional>-W</optional>, <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> オプションは実行する際のアクションを指定します．
> + <optional>-W</optional>, <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional>, <optional>--nokill</optional> オプションは実行する際のアクションを指定します．
> <optional>-W</optional> は，指定したアクションの後に，<command>lxc-stop</command> は速やかに終了します．
> 一方，<optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンやリブートするのを待つ時間の最大値を設定します．
> </para>
> @@ -118,36 +121,36 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
>
> <varlistentry>
> <term>
> - <option>-s,--shutdown </option>
> + <option>-k,--kill </option>
> </term>
> <listitem>
> <para>
> <!--
> - Only request a clean shutdown, do not kill the container tasks if the
> - clean shutdown fails.
> - -->
> - クリーンシャットダウンだけをリクエストします．
> - クリーンなシャットダウンに失敗した場合でも，コンテナのタスクを kill しません．
> + Rather than requesting a clean shutdown of the container, explicitly
> + kill all tasks in the container. This is the legacy
> + <command>lxc-stop</command> behavior.
> + -->
> + コンテナのクリーンシャットダウンをリクエストするのでなく，明確にコンテナ内の全てのタスクを kill します．
> + これは，以前の <command>lxc-stop</command> の動作です．
> </para>
> </listitem>
> - </varlistentry>
> + </varlistentry>
>
> <varlistentry>
> <term>
> - <option>-k,--kill </option>
> + <option>--nokill</option>
> </term>
> <listitem>
> <para>
> <!--
> - Rather than requesting a clean shutdown of the container, explicitly
> - kill all tasks in the container. This is the legacy
> - <command>lxc-stop</command> behavior.
> - -->
> - コンテナのクリーンシャットダウンをリクエストするのでなく，明確にコンテナ内の全てのタスクを kill します．
> - これは，以前の <command>lxc-stop</command> の動作です．
> + Only request a clean shutdown, do not kill the container tasks if the
> + clean shutdown fails.
> + -->
> + クリーンなシャットダウンのみをリクエストします．
> + クリーンなシャットダウンに失敗した場合でも，コンテナのタスクを kill しません．
> </para>
> </listitem>
> - </varlistentry>
> + </varlistentry>
>
> <varlistentry>
> <term>
> diff --git a/doc/ja/lxc.conf.sgml.in b/doc/ja/lxc.conf.sgml.in
> index 8aeebd2..d99d33c 100644
> --- a/doc/ja/lxc.conf.sgml.in
> +++ b/doc/ja/lxc.conf.sgml.in
> @@ -210,19 +210,50 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
> </refsect2>
>
> <refsect2>
> - <title><!-- Stop signal -->停止時のシグナル</title>
> + <title><!-- Halt signal -->クリーンなシャットダウン時のシグナル</title>
> <para>
> <!--
> - Allows one to specify signal name or number, sent by lxc-stop to
> - shutdown the container. Different init systems could use
> - different signals to perform clean shutdown sequence. Option
> - allows signal to be specified in kill(1) fashion, e.g.
> - SIGKILL, SIGRTMIN+14, SIGRTMAX-10 or plain number.
> + Allows one to specify signal name or number, sent by lxc-stop to the
> + container's init process to cleanly shutdown the container. Different
> + init systems could use different signals to perform clean shutdown
> + sequence. This option allows the signal to be specified in kill(1)
> + fashion, e.g. SIGPWR, SIGRTMIN+14, SIGRTMAX-10 or plain number. The
> + default signal is SIGPWR.
> + -->
> + lxc-stop がコンテナをクリーンにシャットダウンするためにコンテナの init プロセスに送るシグナル名か番号を指定することができます．
> + init システムによって，クリーンなシャットダウンを行うために使うシグナルは異なります．
> + このオプションではシグナルとして kill(1) で使う形式を指定することができます．
> + 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式，もしくは数字を指定します．デフォルトのシグナルは SIGPWR です．
> + </para>
> + <variablelist>
> + <varlistentry>
> + <term>
> + <option>lxc.haltsignal</option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + specify the signal used to halt the container
> + -->
> + コンテナをシャットダウンするのに使うシグナルを指定します
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </refsect2>
> +
> + <refsect2>
> + <title><!-- Stop signal -->強制停止時のシグナル</title>
> + <para>
> + <!--
> + Allows one to specify signal name or number, sent by lxc-stop to forcibly
> + shutdown the container. This option allows signal to be specified in
> + kill(1) fashion, e.g. SIGKILL, SIGRTMIN+14, SIGRTMAX-10 or plain number.
> + The default signal is SIGKILL.
> -->
> - lxc-stop がコンテナをシャットダウンするときに送出するシグナル名か番号を指定可能です．
> - 様々な init システムが，クリーンなシャットダウンシーケンスを実行するために，様々なシグナルを用いる可能性があります．
> - オプションとして，シグナルを kill(1) の形式で指定することが可能です．
> - 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式，もしくは数字を指定します．
> + lxc-stop がコンテナを強制的にシャットダウンするために送るシグナル名か番号を指定することができます．
> + このオプションではシグナルとして kill(1) で使う形式を指定することができます．
> + 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式，もしくは数字を指定します．デフォルトのシグナルは SIGKILL です．
> </para>
> <variablelist>
> <varlistentry>
> --
> 1.8.4.4
>
> _______________________________________________
> lxc-devel mailing list
> lxc-devel at lists.linuxcontainers.org
> http://lists.linuxcontainers.org/listinfo/lxc-devel
--
Stéphane Graber
Ubuntu developer
http://www.ubuntu.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.linuxcontainers.org/pipermail/lxc-devel/attachments/20140107/fc6c9ec5/attachment.pgp>
More information about the lxc-devel
mailing list