src/chapter08/openssl.ch

   1 %
   2 % This is part of LFSbookja package.
   3 %
   4 % This is a CTIE change file for the original XML source of the LFSbook.
   5 %
   6 @x
   7 <?xml version="1.0" encoding="ISO-8859-1"?>
   8 @y
   9 <?xml version="1.0" encoding="UTF-8"?>
  10 @z
  11
  12 @x
  13     <para>The OpenSSL package contains  management tools and libraries relating
  14     to cryptography. These are useful for providing cryptographic functions
  15     to other packages, such as OpenSSH, email applications, and web browsers
  16     (for accessing HTTPS sites).  </para>
  17 @y
  18     <para>
  19     OpenSSL パッケージは暗号化に関する管理ツールやライブラリを提供します。
  20     これを利用することにより、他のパッケージにおいて暗号化機能が実現されます。
  21     例えば OpenSSH、Email アプリケーション、（HTTPS サイトアクセスを行う）ウェブブラウザーなどです。
  22     </para>
  23 @z
  24
  25 @x
  26     <title>Installation of OpenSSL</title>
  27 @y
  28     <title>&InstallationOf1;OpenSSL&InstallationOf2;</title>
  29 @z
  30
  31 @x
  32     <para>Prepare OpenSSL for compilation:</para>
  33 @y
  34     <para>&PreparePackage1;OpenSSL&PreparePackage2;</para>
  35 @z
  36
  37 @x
  38     <para>Compile the package:</para>
  39 @y
  40     <para>&CompileThePackage;</para>
  41 @z
  42
  43 @x
  44     <para>To test the results, issue:</para>
  45 @y
  46     <para>
  47     ビルド結果をテストする場合は以下を実行します。
  48     </para>
  49 @z
  50
  51 @x
  52     <para>One test, 30-test_afalg.t, is known to fail on some kernel
  53     configurations (depending on inconsistent values of
  54     CONFIG_CRYPTO_USER_API* settings.) If it fails, it can safely be
  55     ignored.</para>
  56 @y
  57     <para>
  58     カーネル設定によっては (CONFIG_CRYPTO_USER_API* の設定に一貫性がないと)、30-test_afalg.t というテストが 1 つだけ失敗することがわかっています。
  59     失敗しても、無視してかまいません。
  60     </para>
  61 @z
  62
  63 @x
  64     <para>Install the package:</para>
  65 @y
  66     <para>&InstallThePackage;</para>
  67 @z
  68
  69 @x
  70     <para>Add the version to the documentation directory name, to be
  71     consistent with other packages:</para>
  72 @y
  73     <para>
  74     ドキュメントディレクトリにバージョンを含めます。
  75     他のパッケージとの整合をとるためです。
  76     </para>
  77 @z
  78
  79 @x
  80     <para>If desired, install some additional documentation:</para>
  81 @y
  82     <para>
  83     必要であれば、さらにドキュメントをインストールします。
  84     </para>
  85 @z
  86
  87 @x
  88         You should update OpenSSL when a new version which fixes vulnerabilities
  89         is announced.  Since OpenSSL 3.0.0, the OpenSSL versioning scheme
  90         follows the MAJOR.MINOR.PATCH format.  API/ABI compatibility
  91         are guaranteed for the same MAJOR version number.  Because LFS
  92         installs only the shared libraries, there is no need to recompile
  93         packages which link to
  94         <filename class="libraryfile">libcrypto.so</filename> or
  95         <filename class="libraryfile">libssl.so</filename>
  96         <emphasis>when upgrading to a version with MAJOR version number
  97         unchanged</emphasis>.
  98 @y
  99         ぜい弱性への対処を行った新バージョンが公開されたら、OpenSSL をアップデートすることになります。
 100         OpenSSL 3.0.0 以降では、バージョンのつけ方が MAJOR.MINOR.PATCH という形式になりました。
 101         API/API の互換性は、同一の MAJOR バージョン番号では保証されます。
 102         本パッケージは <filename class="libraryfile">libcrypto.so</filename> または
 103         <filename class="libraryfile">libssl.so</filename> へのリンクを行っていますが、LFS では共有ライブラリをインストールするだけなので、<emphasis role="bold">MAJOR バージョン番号が同一のアップグレードである限り</emphasis> は、パッケージを再コンパイルする必要はありません。
 104 @z
 105
 106 @x
 107         However, any running programs linked to those libraries need to be stopped
 108         and restarted. Read the related entries in
 109         <xref linkend='pkgmgmt-upgrade-issues'/> for details.
 110 @y
 111         そうであっても、それらのライブラリにリンクしているプログラムが稼働中であるなら、一度停止してから再起動することが必要です。
 112         詳しくは関連する話が <xref linkend='pkgmgmt-upgrade-issues'/> にあるので参照してください。
 113 @z
 114
 115 @x
 116     <title>Contents of OpenSSL</title>
 117 @y
 118     <title>&ContentsOf1;OpenSSL&ContentsOf2;</title>
 119 @z
 120
 121 @x
 122       <segtitle>Installed programs</segtitle>
 123       <segtitle>Installed libraries</segtitle>
 124       <segtitle>Installed directories</segtitle>
 125 @y
 126       <segtitle>&InstalledProgram;</segtitle>
 127       <segtitle>&InstalledLibrary;</segtitle>
 128       <segtitle>&InstalledDirectory;</segtitle>
 129 @z
 130
 131 @x
 132         <seg>
 133           c_rehash and openssl
 134         </seg>
 135         <seg>
 136           libcrypto.so and libssl.so
 137         </seg>
 138         <seg>
 139           /etc/ssl,
 140           /usr/include/openssl,
 141           /usr/lib/engines and
 142           /usr/share/doc/openssl-&openssl-version;
 143         </seg>
 144 @y
 145         <seg>
 146           c_rehash, openssl
 147         </seg>
 148         <seg>
 149           libcrypto.so, libssl.so
 150         </seg>
 151         <seg>
 152           /etc/ssl,
 153           /usr/include/openssl,
 154           /usr/lib/engines,
 155           /usr/share/doc/openssl-&openssl-version;
 156         </seg>
 157 @z
 158
 159 @x
 160       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 161 @y
 162       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 163 @z
 164
 165 @x c_rehash
 166             is a <application>Perl</application> script that
 167             scans all files in a directory and adds symbolic links to their
 168             hash values.  Use of <command>c_rehash</command> is considered
 169             obsolete and should be replaced by
 170             <command>openssl rehash</command> command
 171 @y
 172             ディレクトリ内のすべてのファイルをスキャンする <application>Perl</application> スクリプト。
 173             それらのファイルに対するハッシュ値へのシンボリックリンクを生成します。
 174             <command>c_rehash</command> の利用は非推奨と考えられており、この代わりに <command>openssl rehash</command> コマンドを使ってください。
 175 @z
 176
 177 @x openssl
 178             is a command-line tool for using the various cryptography functions
 179             of <application>OpenSSL</application>'s crypto library from the
 180             shell. It can be used for various functions which are documented in
 181             <command>man 1 openssl</command>
 182 @y
 183             <application>OpenSSL</application> の暗号化ライブラリが提供するさまざまな関数を、シェルから利用するためのコマンドラインツール。
 184             <command>man 1 openssl</command> に示される数多くの関数を利用することができます。
 185 @z
 186
 187 @x libcrypto.so
 188             implements a wide range of cryptographic algorithms used in various
 189             Internet standards. The services provided by  this library are used
 190             by the <application>OpenSSL</application> implementations of SSL,
 191             TLS and S/MIME, and they have also been used to implement
 192             <application>OpenSSH</application>,
 193             <application>OpenPGP</application>, and other cryptographic
 194             standards
 195 @y
 196             各種のインターネット標準にて採用されている暗号化アルゴリズムを幅広く実装しています。
 197             このライブラリが提供する機能は、SSL、TLS、S/MIME を実装する <application>OpenSSL</application> において利用されており、また
 198             <application>OpenSSH</application>、<application>OpenPGP</application>、あるいはこの他の暗号化標準の実装にも利用されています。
 199 @z
 200
 201 @x libssl.so
 202             implements the Transport Layer Security (TLS v1) protocol.
 203             It provides a rich API, documentation
 204             on which can be found by running <command>man 3 ssl</command>
 205 @y
 206             トランスポート層セキュリティ（Transport Layer Security; TLFS v1）プロトコルを実装しています。
 207             これは豊富な API 関数とそのドキュメントを提供します。
 208             ドキュメントは <command>man 3 ssl</command> の実行により参照できます。
 209 @z