[lxc-devel] [PATCH] doc: Add Japanese lxc-autostart(1) and update lxc.conf(5)
Stéphane Graber
stgraber at ubuntu.com
Fri Dec 20 14:25:22 UTC 2013
On Fri, Dec 20, 2013 at 09:27:45PM +0900, KATOH Yasufumi wrote:
> Signed-off-by: KATOH Yasufumi <karma at jazz.email.ne.jp>
Acked-by: Stéphane Graber <stgraber at ubuntu.com>
> ---
> configure.ac | 1 +
> doc/ja/Makefile.am | 1 +
> doc/ja/lxc-autostart.sgml.in | 202 +++++++++++++++++++++++++++++++++++++++++++
> doc/ja/lxc.conf.sgml.in | 75 ++++++++++++++++
> 4 files changed, 279 insertions(+)
> create mode 100644 doc/ja/lxc-autostart.sgml.in
>
> diff --git a/configure.ac b/configure.ac
> index 052d38c..2818d79 100644
> --- a/configure.ac
> +++ b/configure.ac
> @@ -523,6 +523,7 @@ AC_CONFIG_FILES([
> doc/ja/Makefile
> doc/ja/legacy/lxc-ls.sgml
> doc/ja/lxc-attach.sgml
> + doc/ja/lxc-autostart.sgml
> doc/ja/lxc-cgroup.sgml
> doc/ja/lxc-checkconfig.sgml
> doc/ja/lxc-checkpoint.sgml
> diff --git a/doc/ja/Makefile.am b/doc/ja/Makefile.am
> index 999369c..cfb033b 100644
> --- a/doc/ja/Makefile.am
> +++ b/doc/ja/Makefile.am
> @@ -9,6 +9,7 @@ EXTRA_DIST = \
> if ENABLE_DOCBOOK
> man_MANS = \
> lxc-attach.1 \
> + lxc-autostart.1 \
> lxc-cgroup.1 \
> lxc-checkconfig.1 \
> lxc-checkpoint.1 \
> diff --git a/doc/ja/lxc-autostart.sgml.in b/doc/ja/lxc-autostart.sgml.in
> new file mode 100644
> index 0000000..f43867a
> --- /dev/null
> +++ b/doc/ja/lxc-autostart.sgml.in
> @@ -0,0 +1,202 @@
> +<!--
> +
> +lxc-autostart
> +
> +(C) Copyright 2013 Canonical Ltd.
> +
> +Authors:
> +Stéphane Graber <stgraber at ubuntu.com>
> +
> +This library is free software; you can redistribute it and/or
> +modify it under the terms of the GNU Lesser General Public
> +License as published by the Free Software Foundation; either
> +version 2.1 of the License, or (at your option) any later version.
> +
> +This library is distributed in the hope that it will be useful,
> +but WITHOUT ANY WARRANTY; without even the implied warranty of
> +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
> +Lesser General Public License for more details.
> +
> +You should have received a copy of the GNU Lesser General Public
> +License along with this library; if not, write to the Free Software
> +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
> +
> +-->
> +
> +<!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-autostart</refentrytitle>
> + <manvolnum>1</manvolnum>
> + </refmeta>
> +
> + <refnamediv>
> + <refname>lxc-autostart</refname>
> +
> + <refpurpose>
> + <!--
> + start/stop/kill auto-started containers
> + -->
> + 自動起動の設定がされたコンテナの開始/停止/kill
> + </refpurpose>
> + </refnamediv>
> +
> + <refsynopsisdiv>
> + <cmdsynopsis>
> + <command>lxc-autostart</command>
> + <arg choice="opt">-k</arg>
> + <arg choice="opt">-L</arg>
> + <arg choice="opt">-r</arg>
> + <arg choice="opt">-s</arg>
> + <arg choice="opt">-a</arg>
> + <arg choice="opt">-g <replaceable>groups</replaceable></arg>
> + <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
> + </cmdsynopsis>
> + </refsynopsisdiv>
> +
> + <refsect1>
> + <title><!-- Description -->説明</title>
> +
> + <para>
> + <!--
> + <command>lxc-autostart</command> processes containers
> + with lxc.start.auto set. It lets the user start, shutdown,
> + kill, restart containers in the right order, waiting the
> + right time. Supports filtering by lxc.group or just run
> + against all defined containers. It can also be used by
> + external tools in list mode where no action will be performed
> + and the list of affected containers (and if relevant, delays)
> + will be shown.
> + -->
> + <command>lxc-autostart</command> は lxc.start.auto が設定されたコンテナの処理を行います．
> + ユーザがコンテナの開始，シャットダウン，kill，再起動を，設定した時間待機を行い，正しい順番で行えるようにします．
> + lxc.group でのフィルタリングによって，もしくは定義された全てのコンテナを実行します．
> + 何の動作も行わず，対象のコンテナ (とコンテナに設定された待機時間) のリストを表示するリストモードを外部ツールから使用することも可能です．
> + </para>
> +
> + <para>
> + <!--
> + The <optional>-r</optional>, <optional>-s</optional>
> + and <optional>-k</optional> options specify the action to perform.
> + If none is specified, then the containers will be started.
> + <optional>-a</optional> and <optional>-g</optional> are used to
> + specify which containers will be affected. By default only
> + containers without a lxc.group set will be affected.
> + <optional>-t TIMEOUT</optional> specifies the maximum amount
> + of time to wait for the container to complete the shutdown
> + or reboot.
> + -->
> + <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> オプションは実行する動作を指定します．何も指定しない場合は，コンテナを起動します．
> + <optional>-a</optional>, <optional>-g</optional> は，どのコンテナを対象にするかを指定するのに使います．デフォルトでは，lxc.group が指定されていないコンテナにだけ影響します．
> + <optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンもしくはリブートを待つ最大時間を指定します．
> + </para>
> + </refsect1>
> +
> + <refsect1>
> + <title><!-- Options -->オプション</title>
> + <variablelist>
> + <varlistentry>
> + <term>
> + <option>-r,--reboot </option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Request a reboot of the container.
> + -->
> + コンテナのリブートを要求します．
> + </para>
> + </listitem>
> + </varlistentry>
> +
> + <varlistentry>
> + <term>
> + <option>-s,--shutdown </option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Only request a clean shutdown, do not kill the
> + container tasks if the clean shutdown fails.
> + -->
> + クリーンなシャットダウンのみを要求します．クリーンなシャットダウンに失敗した場合でも，コンテナのタスクを kill しないでください．
> + </para>
> + </listitem>
> + </varlistentry>
> +
> + <varlistentry>
> + <term>
> + <option>-k,--kill </option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Rather than requesting a clean shutdown of the
> + container, explicitly kill all tasks in the container.
> + -->
> + コンテナのクリーンなシャットダウンを要求するのではなく，明確にコンテナの全てのタスクを kill します．
> + </para>
> + </listitem>
> + </varlistentry>
> +
> + <varlistentry>
> + <term>
> + <option>-L,--list </option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Rather than performing the action, just print
> + the container name.
> + -->
> + 実際の動作は行わず，コンテナ名の表示だけを行います．
> + </para>
> + </listitem>
> + </varlistentry>
> +
> + <varlistentry>
> + <term>
> + <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Wait TIMEOUT seconds before hard-stopping the
> + container of (in the reboot case) returning failure.
> + -->
> + コンテナの強制停止まで TIMEOUT 秒待ちます．リブートの場合，失敗が返るのを TIMEOUT 秒待ちます．
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </refsect1>
> +
> + &seealso;
> +
> + <refsect1>
> + <title>Author</title>
> + <para>Stéphane Graber <email>stgraber at ubuntu.com</email></para>
> + </refsect1>
> +</refentry>
> +
> +<!-- Keep this comment at the end of the file
> +Local variables:
> +mode: sgml
> +sgml-omittag:t
> +sgml-shorttag:t
> +sgml-minimize-attributes:nil
> +sgml-always-quote-attributes:t
> +sgml-indent-step:2
> +sgml-indent-data:t
> +sgml-parent-document:nil
> +sgml-default-dtd-file:nil
> +sgml-exposed-tags:nil
> +sgml-local-catalogs:nil
> +sgml-local-ecat-files:nil
> +End:
> +-->
> diff --git a/doc/ja/lxc.conf.sgml.in b/doc/ja/lxc.conf.sgml.in
> index 52b4fc8..71a1571 100644
> --- a/doc/ja/lxc.conf.sgml.in
> +++ b/doc/ja/lxc.conf.sgml.in
> @@ -1672,6 +1672,81 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
> </variablelist>
> </refsect2>
>
> + <refsect2>
> + <title><!-- Autostart -->自動起動</title>
> + <para>
> + <!--
> + The autostart options support marking which containers should be
> + auto-started and in what order. These options may be used by LXC tools
> + directly or by external tooling provided by the distributions.
> + -->
> + 自動起動オプションでは，自動起動させるコンテナと順番の設定が可能です．
> + このオプションは LXC ツールが直接使用するか，ディストリビューションが提供する外部ツールが使用するかもしれません．
> + </para>
> +
> + <variablelist>
> + <varlistentry>
> + <term>
> + <option>lxc.start.auto</option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + Whether the container should be auto-started.
> + Valid values are 0 (off) and 1 (on).
> + -->
> + コンテナを自動起動させるかどうかを設定します．有効な値は 0(オフ) か 1(オン) です．
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term>
> + <option>lxc.start.delay</option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + How long to wait (in seconds) after the container is
> + started before starting the next one.
> + -->
> + コンテナを起動させた後，次のコンテナを起動させるまでにどれくらい (秒) 待つかを設定します．
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term>
> + <option>lxc.start.order</option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + An integer used to sort the containers when auto-starting
> + a series of containers at once.
> + -->
> + 多数の自動起動させるコンテナがある場合のコンテナの起動順を決めるのに使う整数を指定します．
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term>
> + <option>lxc.group</option>
> + </term>
> + <listitem>
> + <para>
> + <!--
> + A multi-value key (can be used multiple times) to put the
> + container in a container group. Those groups can then be
> + used (amongst other things) to start a series of related
> + containers.
> + -->
> + コンテナを追加したいコンテナグループ名を指定します．(複数回使用される可能性のある) 複数の値を設定可能です．
> + 設定されたグループは，関連する一連のコンテナを起動させるために使われます．
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </refsect2>
> +
> </refsect1>
>
> <refsect1>
> --
> 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/20131220/66b91924/attachment.pgp>
More information about the lxc-devel
mailing list