[hornetq-commits] JBoss hornetq SVN: r9198 - branches/HnetQ_323_cn/docs/user-manual/zh.

do-not-reply at jboss.org do-not-reply at jboss.org
Tue May 4 23:10:15 EDT 2010


Author: gaohoward
Date: 2010-05-04 23:10:14 -0400 (Tue, 04 May 2010)
New Revision: 9198

Modified:
   branches/HnetQ_323_cn/docs/user-manual/zh/libaio.xml
Log:
done.


Modified: branches/HnetQ_323_cn/docs/user-manual/zh/libaio.xml
===================================================================
--- branches/HnetQ_323_cn/docs/user-manual/zh/libaio.xml	2010-05-04 15:23:51 UTC (rev 9197)
+++ branches/HnetQ_323_cn/docs/user-manual/zh/libaio.xml	2010-05-05 03:10:14 UTC (rev 9198)
@@ -17,87 +17,77 @@
 <!-- permitted by applicable law.                                                  -->
 <!-- ============================================================================= -->
 <chapter id="libaio">
-    <title>Libaio Native Libraries</title>
-    <para>HornetQ distributes a native library, used as a bridge between HornetQ and linux
-        libaio.</para>
-    <para><literal>libaio</literal> is a library, developed as part of the linux kernel project.
-        With <literal>libaio</literal> we submit writes to the operating system where they are
-        processed asynchronously. Some time later the OS will call our code back when they have been
-        processed.</para>
-    <para>We use this in our high performance journal if configured to do so, please see <xref
-            linkend="persistence"/>.</para>
-    <para>These are the native libraries distributed by HornetQ:</para>
+    <title>Libaio平台专有库</title>
+    <para>HornetQ发布包中包括一个平台专有的库,它可以使HornetQ使用Linux操作系统的libaio。</para>
+    <para><literal>libaio</literal>是Linux项目的一个库。它将用户提交的写操作用异步的方式执行。通过
+        回调用户的代码来通知写操作的完成。</para>
+    <para>通过配置,HornetQ可以使用这个库来访问高性能的日志,具体请参见 <xref
+            linkend="persistence"/>。</para>
+    <para>下面列出了HornetQ所带的平台专有库文件:</para>
     <itemizedlist>
         <listitem>
-            <para>libHornetQAIO32.so - x86 32 bits</para>
+            <para>libHornetQAIO32.so - x86 32 位平台</para>
         </listitem>
         <listitem>
-            <para>libHornetQAIO64.so - x86 64 bits</para>
+            <para>libHornetQAIO64.so - x86 64 位平台</para>
         </listitem>
     </itemizedlist>
-    <para>When using libaio, HornetQ will always try loading these files as long as they are on the
-            <link linkend="using-server.library.path">library path</link>.</para>
+    <para>当使用libaio时,HornetQ会在<link linkend="using-server.library.path">库路径</link>中寻找并装
+           载这些文件。</para>
     <section>
-        <title>Compiling the native libraries</title>
-        <para>In the case that you are using Linux on a platform other than x86_32 or x86_64
-            (for example Itanium 64 bits or IBM Power) you may need to compile the native library, since we
-            do not distribute binaries for those platforms with the release.</para>
+        <title>库文件的编译</title>
+        <para>如果你的Linux平台不是x86_32或x86_64(比如Itanium 64或IBM Power),你需要自己编译相应的库文件,
+            因为HornetQ不提供这些平台的库文件。</para>
         <section>
-            <title>Install requirements</title>
+            <title>安装要求</title>
             <note>
-                <para>At the moment the native layer is only available on Linux. If you are in a
-                    platform other than Linux the native compilation will not work</para>
+                <para>目前libaio只在Linux上有。所以它不可能在其它操作系统上编译。</para>
             </note>
-            <para>The native library uses <ulink url="http://en.wikipedia.org/wiki/Autoconf"
-                    >autoconf</ulink> what makes the compilation process easy, however you need to
-                install extra packages as a requirement for compilation:</para>
+            <para>编译需要<ulink url="http://en.wikipedia.org/wiki/Autoconf"
+                    >autoconf</ulink>工具,它用来简化编译过程。除此之外还需要一些安装包:</para>
             <itemizedlist>
                 <listitem>
-                    <para>gcc - C Compiler</para>
+                    <para>gcc - C 编译器</para>
                 </listitem>
                 <listitem>
-                    <para>gcc-c++ or g++ - Extension to gcc with support for C++</para>
+                    <para>gcc-c++ or g++ - gcc的c++编译工具扩展</para>
                 </listitem>
                 <listitem>
-                    <para>autoconf - Tool for automating native build process</para>
+                    <para>autoconf - 自动编译工具</para>
                 </listitem>
                 <listitem>
-                    <para>make - Plain old make</para>
+                    <para>make - make 工具</para>
                 </listitem>
                 <listitem>
-                    <para>automake - Tool for automating make generation</para>
+                    <para>automake - make文件自动生成工具</para>
                 </listitem>
                 <listitem>
-                    <para>libtool - Tool for link editing native libraries</para>
+                    <para>libtool - 库连接工具</para>
                 </listitem>
                 <listitem>
-                    <para>libaio - library to disk asynchronous IO kernel functions</para>
+                    <para>libaio - 磁盘异步IO库</para>
                 </listitem>
                 <listitem>
-                    <para>libaio-dev - Compilation support for libaio</para>
+                    <para>libaio-dev - libaio的编译支持</para>
                 </listitem>
                 <listitem>
-                    <para>A full JDK installed with the environment variable JAVA_HOME set to its
-                        location</para>
+                    <para>完整的JDK,JAVA_HOME要指向正确的位置</para>
                 </listitem>
             </itemizedlist>
-            <para>To perform this installation on RHEL or Fedora, you can simply type this at a
-                command line:</para>
+            <para>如果在RHEL或Fedora上进行安装,输入以下命令:</para>
             <programlisting>sudo yum install automake libtool autoconf gcc-g++ gcc libaio libaio-dev make</programlisting>
-            <para>Or on debian systems:</para>
+            <para>如果是 debian系统,则:</para>
             <programlisting>sudo apt-get install automake libtool autoconf gcc-g++ gcc libaio libaio-dev make</programlisting>
             <note>
-                <para>You could find a slight variation of the package names depending on the
-                    version and linux distribution. (for example gcc-c++ on Fedora versus g++ on
-                    Debian systems)</para>
+                <para>在有些Linux的版本中上述的安装包名可能有一些差别。(例如Fedora中的gcc-c++在Debian系统中
+                    的名称为g++)</para>
             </note>
         </section>
         <section>
-            <title>Invoking the compilation</title>
-            <para>In the distribution, in the <literal>native-src</literal> directory, execute the
-                shell script <literal>bootstrap</literal>. This script will invoke <literal
-                    >automake</literal> and <literal>make</literal> what will create all the make
-                files and the native library.</para>
+            <title>开始编译</title>
+            <para>在HornetQ发布包的<literal>native-src</literal>目录下,执行shell脚本
+                <literal>bootstrap</literal>。这个脚本会调用 <literal
+                    >automake</literal>以及<literal>make</literal>来创建所有的make文件和专有库。</para>
             <programlisting>someUser at someBox:/messaging-distribution/native-src$ ./bootstrap 
 checking for a BSD-compatible install... /usr/bin/install -c
 checking whether build environment is sane... yes
@@ -114,12 +104,11 @@
 config.status: executing libtool commands
 
 ...</programlisting>
-            <para>The produced library will be at <literal
-                    >./native-src/src/.libs/libHornetQAIO.so</literal>. Simply move that file over
-                    <literal>bin</literal> on the distribution or the place you have chosen on the
-                    <link linkend="using-server.library.path">library path</link>.</para>
-            <para>If you want to perform changes on the HornetQ libaio code, you could just call
-                make directly at the <literal>native-src</literal> directory.</para>
+            <para>编译好的库文件在<literal
+                    >./native-src/src/.libs/libHornetQAIO.so</literal>。将该文件移到发布包的
+                    <literal>bin</literal>目录下,或者你的<link linkend="using-server.library.path">库目录</link>
+                    所指向的目录即可。</para>
+            <para>如果你修改了HornetQ的libaio代码,只需要在<literal>native-src</literal>目录下直挂运行make即可完成编译。</para>
         </section>
     </section>
 </chapter>



More information about the hornetq-commits mailing list