doc/ja/lxc-top.sgml.in

   1 <!--
   2
   3 Copyright © 2012 Oracle.
   4
   5 Authors:
   6 Dwight Engen <dwight.engen@oracle.com>
   7
   8 This library is free software; you can redistribute it and/or
   9 modify it under the terms of the GNU Lesser General Public
  10 License as published by the Free Software Foundation; either
  11 version 2.1 of the License, or (at your option) any later version.
  12
  13 This library is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 Lesser General Public License for more details.
  17
  18 You should have received a copy of the GNU Lesser General Public
  19 License along with this library; if not, write to the Free Software
  20 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  21
  22 -->
  23
  24 <!DOCTYPE refentry PUBLIC @docdtd@ [
  25
  26 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
  27 ]>
  28
  29 <refentry>
  30
  31   <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
  32
  33   <refmeta>
  34     <refentrytitle>lxc-top</refentrytitle>
  35     <manvolnum>1</manvolnum>
  36   </refmeta>
  37
  38   <refnamediv>
  39     <refname>lxc-top</refname>
  40
  41     <refpurpose>
  42       <!--
  43       monitor container statistics
  44       -->
  45       コンテナの統計情報の表示
  46     </refpurpose>
  47   </refnamediv>
  48
  49   <refsynopsisdiv>
  50     <cmdsynopsis>
  51       <command>lxc-top</command>
  52       <arg choice="opt">--help</arg>
  53       <arg choice="opt">--delay <replaceable>delay</replaceable></arg>
  54       <arg choice="opt">--sort <replaceable>sortby</replaceable></arg>
  55       <arg choice="opt">--reverse</arg>
  56     </cmdsynopsis>
  57   </refsynopsisdiv>
  58
  59   <refsect1>
  60     <title><!-- Description -->説明</title>
  61     <para>
  62       <!--
  63       <command>lxc-top</command> displays container statistics. The output
  64       is updated every <replaceable>delay</replaceable> seconds, and is
  65       ordered according to the <replaceable>sortby</replaceable> value
  66       given. <command>lxc-top</command> will display as many containers as
  67       can fit in your terminal. Press 'q' to quit. Press one of the sort
  68       key letters to sort by that statistic. Pressing a sort key letter a
  69       second time reverses the sort order.
  70       -->
  71       <command>lxc-top</command> はコンテナの統計情報を表示します。出力は <replaceable>delay</replaceable> 秒ごとに更新されます。
  72       そして、<replaceable>sortby</replaceable> の指定に従ってソートされます。<command>lxc-top</command> は使用しているターミナルに収まるようにできるだけ多くの数のコンテナを表示します。'q' を入力すると終了します。ソートのキーとなる文字を入力するとその統計値でソートします。ソートのキーとなる文字を 2 度入力するとソート順が逆になります。
  73     </para>
  74   </refsect1>
  75
  76   <refsect1>
  77     <title><!-- Options -->オプション</title>
  78     <variablelist>
  79
  80       <varlistentry>
  81         <term>
  82           <option>-d, --delay <replaceable>delay</replaceable></option>
  83         </term>
  84         <listitem>
  85           <para>
  86             <!--
  87             Amount of time in seconds to delay between screen updates.
  88             The default is 3 seconds.
  89             -->
  90             表示を更新する間隔を秒で指定します。デフォルトは 3 秒です。
  91           </para>
  92         </listitem>
  93       </varlistentry>
  94       <varlistentry>
  95         <term>
  96           <option>-s, --sort <replaceable>sortby</replaceable></option>
  97         </term>
  98         <listitem>
  99           <para>
 100             <!--
 101             Sort the containers by name, cpu use, or memory use. The
 102             <replaceable>sortby</replaceable> argument should be one of
 103             the letters n,c,b,m,k to sort by name, cpu use, block I/O, memory,
 104             or kernel memory use respectively. The default is 'n'.
 105             -->
 106             名前、CPU 使用量、メモリ使用量でコンテナをソートします。<replaceable>sortby</replaceable> で指定する引数は n,c,b,m,k のどれかでなければなりません。
 107             これはそれぞれ名前、CPU 使用量、ブロック I/O、メモリ使用量、カーネルメモリ使用量を表します。デフォルトは 'n' です。
 108           </para>
 109         </listitem>
 110       </varlistentry>
 111       <varlistentry>
 112         <term>
 113           <option>-r, --reverse</option>
 114         </term>
 115         <listitem>
 116           <para>
 117             <!--
 118             Reverse the default sort order. By default, names sort in
 119             ascending alphabetical order and values sort in descending
 120             amounts (ie. largest value first).
 121             -->
 122             デフォルトのソート順を逆転させます。デフォルトでは、名前のソートはアルファベットの昇順、値のソートは量の降順 (最も大きい数が最初) です。
 123           </para>
 124         </listitem>
 125       </varlistentry>
 126     </variablelist>
 127   </refsect1>
 128
 129   <refsect1>
 130     <title><!-- Example -->例</title>
 131     <variablelist>
 132       <varlistentry>
 133         <term>lxc-top --delay 1 --sort m</term>
 134         <listitem>
 135         <para>
 136           <!--
 137           Display containers, updating every second, sorted by memory use.
 138           -->
 139           コンテナを 1 秒ごとに更新し、メモリ使用量でソートして表示します。
 140         </para>
 141         </listitem>
 142       </varlistentry>
 143     </variablelist>
 144   </refsect1>
 145
 146   <refsect1>
 147     <title><!-- Notes -->注意</title>
 148     <para>
 149       <!--
 150       For performance reasons the kernel does not account kernel memory use
 151       unless a kernel memory limit is set. If a limit is not set, <command>
 152       lxc-top</command> will display kernel memory use as 0. If no containers
 153       are being accounted, the KMem column will not be displayed. A limit can
 154       be set by specifying
 155       <programlisting>
 156       lxc.cgroup.memory.kmem.limit_in_bytes = <replaceable>number</replaceable>
 157       </programlisting>
 158       in your container configuration file, see
 159       <citerefentry>
 160         <refentrytitle>lxc.conf</refentrytitle>
 161         <manvolnum>5</manvolnum>
 162       </citerefentry>.
 163       -->
 164       パフォーマンスへの影響を考慮して、カーネルメモリの使用量は、カーネルメモリの制限値が設定されない限りはカウントされません。
 165       もし、制限が設定されていない場合、<command>lxc-top</command> はカーネルメモリの使用量を 0 と表示します。
 166       もし、カウントされているコンテナが存在しない場合、KMem カラムは表示されません。制限は
 167       <programlisting>
 168       lxc.cgroup.memory.kmem.limit_in_bytes = <replaceable>number</replaceable>
 169       </programlisting>
 170       のように、コンテナの設定ファイルで指定することができます。詳しくは、
 171       <citerefentry>
 172         <refentrytitle>lxc.conf</refentrytitle>
 173         <manvolnum>5</manvolnum>
 174       </citerefentry>
 175       を参照してください。
 176     </para>
 177   </refsect1>
 178
 179   &seealso;
 180
 181   <refsect1>
 182     <title><!-- Author -->作者</title>
 183     <para>Dwight Engen <email>dwight.engen@oracle.com</email></para>
 184   </refsect1>
 185
 186 </refentry>
 187
 188 <!-- Keep this comment at the end of the file
 189 Local variables:
 190 mode: sgml
 191 sgml-omittag:t
 192 sgml-shorttag:t
 193 sgml-minimize-attributes:nil
 194 sgml-always-quote-attributes:t
 195 sgml-indent-step:2
 196 sgml-indent-data:t
 197 sgml-parent-document:nil
 198 sgml-default-dtd-file:nil
 199 sgml-exposed-tags:nil
 200 sgml-local-catalogs:nil
 201 sgml-local-ecat-files:nil
 202 End:
 203 -->