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. The releases run in series, with a letter for each release
  90         after the initial release (e.g. 1.1.1, 1.1.1a, 1.1.1b, etc). Because LFS
  91         installs only the shared libraries, there is no need to recompile packages
  92         which link to <filename class="libraryfile">libcrypto.so</filename> or
  93         <filename class="libraryfile">libssl.so</filename>
  94         <emphasis>when upgrading in the same series.</emphasis>
  95 @y
  96         ぜい弱性への対処を行った新バージョンが公開されたら、OpenSSL をアップデートすることになります。
  97         リリースは公開される順に従って、初期リリースバージョンに英字 1 文字をつけて公開されます（たとえば 1.1.1、1.1.1a、1.1.1b、1.1.1c といった具合です）。
  98         本パッケージは <filename class="libraryfile">libcrypto.so</filename> または
  99         <filename class="libraryfile">libssl.so</filename> へのリンクを行っていますが、LFS では共有ライブラリをインストールするだけなので、<emphasis role="bold">同一シリーズ内でのアップグレードである限り</emphasis> は、パッケージを再コンパイルする必要はありません。
 100 @z
 101
 102 @x
 103         However, any running programs linked to those libraries need to be stopped
 104         and restarted. Read the related entries in
 105         <xref linkend='pkgmgmt-upgrade-issues'/> for details.
 106 @y
 107         そうであっても、それらのライブラリにリンクしているプログラムが稼働中であるなら、一度停止してから再起動することが必要です。
 108         詳しくは関連する話が <xref linkend='pkgmgmt-upgrade-issues'/> にあるので参照してください。
 109 @z
 110
 111 @x
 112     <title>Contents of OpenSSL</title>
 113 @y
 114     <title>&ContentsOf1;OpenSSL&ContentsOf2;</title>
 115 @z
 116
 117 @x
 118       <segtitle>Installed programs</segtitle>
 119       <segtitle>Installed libraries</segtitle>
 120       <segtitle>Installed directories</segtitle>
 121 @y
 122       <segtitle>&InstalledProgram;</segtitle>
 123       <segtitle>&InstalledLibrary;</segtitle>
 124       <segtitle>&InstalledDirectory;</segtitle>
 125 @z
 126
 127 @x
 128         <seg>
 129           c_rehash and openssl
 130         </seg>
 131         <seg>
 132           libcrypto.so and libssl.so
 133         </seg>
 134         <seg>
 135           /etc/ssl,
 136           /usr/include/openssl,
 137           /usr/lib/engines and
 138           /usr/share/doc/openssl-&openssl-version;
 139         </seg>
 140 @y
 141         <seg>
 142           c_rehash, openssl
 143         </seg>
 144         <seg>
 145           libcrypto.so, libssl.so
 146         </seg>
 147         <seg>
 148           /etc/ssl,
 149           /usr/include/openssl,
 150           /usr/lib/engines,
 151           /usr/share/doc/openssl-&openssl-version;
 152         </seg>
 153 @z
 154
 155 @x
 156       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 157 @y
 158       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 159 @z
 160
 161 @x c_rehash
 162             is a <application>Perl</application> script that scans all files in
 163             a directory and adds symbolic links to their hash values
 164 @y
 165             ディレクトリ内のすべてのファイルをスキャンする <application>Perl</application> スクリプト。
 166             それらのファイルに対するハッシュ値へのシンボリックリンクを生成します。
 167 @z
 168
 169 @x openssl
 170             is a command-line tool for using the various cryptography functions
 171             of <application>OpenSSL</application>'s crypto library from the
 172             shell. It can be used for various functions which are documented in
 173             <command>man 1 openssl</command>
 174 @y
 175             <application>OpenSSL</application> の暗号化ライブラリが提供するさまざまな関数を、シェルから利用するためのコマンドラインツール。
 176             <command>man 1 openssl</command> に示される数多くの関数を利用することができます。
 177 @z
 178
 179 @x libcrypto.so
 180             implements a wide range of cryptographic algorithms used in various
 181             Internet standards. The services provided by  this library are used
 182             by the <application>OpenSSL</application> implementations of SSL,
 183             TLS and S/MIME, and they have also been used to implement
 184             <application>OpenSSH</application>,
 185             <application>OpenPGP</application>, and other cryptographic
 186             standards
 187 @y
 188             各種のインターネット標準にて採用されている暗号化アルゴリズムを幅広く実装しています。
 189             このライブラリが提供する機能は、SSL、TLS、S/MIME を実装する <application>OpenSSL</application> において利用されており、また
 190             <application>OpenSSH</application>、<application>OpenPGP</application>、あるいはこの他の暗号化標準の実装にも利用されています。
 191 @z
 192
 193 @x libssl.so
 194             implements the Transport Layer Security (TLS v1) protocol.
 195             It provides a rich API, documentation
 196             on which can be found by running <command>man 3 ssl</command>
 197 @y
 198             トランスポート層セキュリティ（Transport Layer Security; TLFS v1）プロトコルを実装しています。
 199             これは豊富な API 関数とそのドキュメントを提供します。
 200             ドキュメントは <command>man 3 ssl</command> の実行により参照できます。
 201 @z