From d7cd0dce506bfbcb527c049b4a00f5efd8c72fc6 Mon Sep 17 00:00:00 2001 From: Hideyuki KURASHINA Date: Wed, 15 Jun 2005 20:34:42 +0000 Subject: [PATCH] Merge the following from the English version: 1.146 -> 1.155 books/handbook/boot/chapter.sgml Submitted by: Ryusuke Suzuki Reference: [doc-jp-work 1102] --- ja_JP.eucJP/books/handbook/ports/chapter.sgml | 182 +++++++++++++----- 1 file changed, 136 insertions(+), 46 deletions(-) diff --git a/ja_JP.eucJP/books/handbook/ports/chapter.sgml b/ja_JP.eucJP/books/handbook/ports/chapter.sgml index f3256ec9b1..b3f06fcbc4 100644 --- a/ja_JP.eucJP/books/handbook/ports/chapter.sgml +++ b/ja_JP.eucJP/books/handbook/ports/chapter.sgml @@ -2,7 +2,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: 1.146 + Original revision: 1.155 $FreeBSD$ --> @@ -216,7 +216,7 @@ ports の更新状況を把握するために、 - freebsd-ports@freebsd.org + freebsd-ports@FreeBSD.org メーリングリストを購読するとよいでしょう。 この章では、packages と ports を用いた FreeBSD 上での @@ -236,14 +236,14 @@ - FreeBSD ウェブサイトは、 - 利用可能なすべてのアプリケーションの検索できる最新の一覧を - http://www.FreeBSD.org/ports/ - で公開しています。 - アプリケーションの名前はカテゴリに分類されており、 - (名前を知っているならば) 名前で検索できます。 - また、カテゴリ中の利用可能な - すべてのアプリケーションを表示させることもできます。 + FreeBSD ウェブサイトは、 + 利用可能なすべてのアプリケーションの検索できる最新の一覧を + http://www.FreeBSD.org/ports/ + で公開しています。 + アプリケーションの名前はカテゴリに分類されており、 + (名前を知っているならば) 名前で検索できます。 + また、カテゴリ中の利用可能な + すべてのアプリケーションを表示させることもできます。 FreshPorts @@ -303,9 +303,9 @@ package をダウンロードしてローカルからインストールする - &prompt.root; ftp -a ftp2.freebsd.org -Connected to ftp2.freebsd.org. -220 ftp2.freebsd.org FTP server (Version 6.00LS) ready. + &prompt.root; ftp -a ftp2.FreeBSD.org +Connected to ftp2.FreeBSD.org. +220 ftp2.FreeBSD.org FTP server (Version 6.00LS) ready. 331 Guest login ok, send your email address as password. 230- 230- This machine is in Vienna, VA, USA, hosted by Verio. @@ -596,7 +596,7 @@ docbook = Ports Collection は スケルトン と呼ばれるもので構成されているという事実です。 port スケルトンは簡単に言うと、アプリケーションを FreeBSD - 上でコンパイルしインストールするために必要となる最小限のファイルのセットのことです。 + 上で正しくコンパイルしインストールするために必要となる最小限のファイルのセットのことです。 それぞれの port スケルトンには、次のファイルが含まれています。 @@ -653,6 +653,15 @@ docbook = + これらの他に pkg-message + といったファイルを含む ports もあります。 + ports システムは、 + このようなファイルを用いて特殊な状況にも対応しています。 + これらのファイルについての詳細および + ports の一般的な説明については、port 作成者のためのハンドブック + をご覧下さい。 + さて、Ports Collection が何を目的として使われるものなのか、 それを理解するための基礎的な知識はこれで十分です。 最初の port をインストールする準備ができました。 @@ -663,7 +672,7 @@ docbook = 実際の作業に入る前に、 インストールする port を選ぶ必要があります。 選ぶ方法はいくつかありますが、最も簡単なのは - FreeBSD ウェブサイトの + FreeBSD ウェブサイトの ports リスト を利用することでしょう。 そこにリストされている ports や、 サイトの検索機能を使って閲覧することができます。 @@ -724,7 +733,16 @@ R-deps: インストールしたい port が見つかったら、 - 実際のインストールに移ることができます。 + 実際のインストールに移ることができます。 + port はソースコードからアプリケーションを構築する方法を提供しますが、 + 実際のソースコードを含んでいません。 + ソースコードはソフトウェア作者のお気に入りの形式で配布されます。 + たいてい、tar と gzip で作成された圧縮アーカイブとして配布されますが、 + 他のツールで圧縮されていたり、圧縮されずに配布されることもあります。 + どのような形式で配布されているかに関わらず、 + これらのプログラムのソースコードは distfile + と呼ばれています。 + distfile は CD-ROM もしくはインターネット経由で入手できます。 CD-ROM からの ports のインストール @@ -733,20 +751,23 @@ R-deps: ports CD-ROM からのインストール - タイトルから想像できると思いますが、 - このセクションで説明する内容は、FreeBSD の - CDROM セットを持っていることを前提としています。 - もし CDROM セットを持っていなければ、 - FreeBSD Mall - で注文することができます。 - FreeBSD CDROM がドライブに挿入されていて、 - /cdrom - (マウントポイントは必ず - /cdrom でないといけません) - にマウントされていれば、port をインストールすることができます。 - まず、インストールしたい port - のあるディレクトリに移動してください。 + FreeBSD プロジェクトの公式 CDROM イメージには + もう distfiles は収録されていません。 + あらかじめコンパイルされた、よく使われる packages が CDROM + の大部分を占めています。 + 一方、FreeBSD PowerPak のような CDROM 製品は distfiles + が収録されています。 + FreeBSD Mall + といったベンダからこれらの製品を注文できます。 + このセクションではこのような FreeBSD の CDROM セットを持っていることを前提としています。 + + FreeBSD CDROM をドライブに入れ、 + /cdrom にマウントしてください + (別のマウントポイントを指定すると、 + おそらくインストールに失敗するでしょう)。 + そして、インストールしたい port のあるディレクトリに移動してください。 + &prompt.root; cd /usr/ports/sysutils/lsof @@ -835,7 +856,7 @@ R-deps: インターネット経由で port をインストールする方法は、 CDROM からインストールする場合と完全に同じです。 - 唯一異なる部分はプログラムのソースコードを CDROM からではなく、 + 唯一異なる部分は distfile を CDROM からではなく、 インターネット経由でダウンロードするということです。 次のように、必要な手順は同じです。 @@ -893,14 +914,12 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100% ports のインストール方法について知ればおそらく、 インストールの後になって、それが間違っていたことに気付いた時などに備えて それらを削除する方法はどうすれば良いのか疑問に感じることでしょう。 - ここでは、その削除の方法について扱います。 - - さて、前の例 (例のまま何も変更していない人は + さて、前の例 (例のまま何も変更していない人は lsof) を削除してみましょう。ports のインストールと同じように、 - まず最初にやらなければならないのは port のディレクトリに移動することです。 - port のディレクトリは /usr/ports/sysutils/lsof でしたね。 + まず最初にやらなければならないのは port のディレクトリ + /usr/ports/sysutils/lsof に移動することです。 ディレクトリを移動したら、lsof を削除するのに必要な準備は終わりです。 削除するには、make deinstall コマンド @@ -912,15 +931,86 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100% 極めて簡単な作業です。 これでうまく lsof - をシステムから削除することができました。 + をシステムから削除できました。 もう一度再インストールしたい場合には、 /usr/ports/sysutils/lsof ディレクトリから make reinstall を実行することで行なうことができます。 + + 一度 make clean を実行してしまうと、 + make deinstall および make + reinstall の一連の作業はできません。 + make clean を実行した後で + インストールした port を削除したいのであれば、 + ハンドブックの packages + のセクション で説明されているように + pkg_delete を使ってください。 + + インストール後の作業 + + 新しいアプリケーションのインストールが終わったら、 + 次に付属のドキュメントを読みたいと思うでしょう。 + また、必要な設定ファイルを編集したり、 + (デーモンの場合には) システムの起動時にプログラムが開始することの確認などを行いたくなるでしょう。 + + port のインストール後に追加で行わなければならない作業の詳細は、 + アプリケーションごとに異なります。 + しかしながら、新しいアプリケーションをインストールしたばかりで、 + 次は何 ? と思っているのであれば、 + 以下の tips は役に立つでしょう。 + + + + どのようなファイルがインストールされているか、 + そしてそれらがどこにインストールされているかを知りたいのであれば、 + &man.pkg.info.1; を使ってください。 + たとえば、FooPackage の 1.0.0 バージョンをインストールしたのであれば、 + 以下を実行してください。 + + &prompt.root; pkg_info -L foopackage-1.0.0 | less + + 上のコマンドを実行すると package + としてインストールされているすべてのファイルが表示されます。 + 特に、man/, etc/, + doc/ ディレクトリのファイルに注目してください。 + それぞれ、マニュアルページ、 + 設定ファイル、より包括的なドキュメントが設置されています。 + + もし、アプリケーションのバージョンがわからなければ、 + 次のコマンドを実行してください。 + + &prompt.root; pkg_info | grep foopackage + + インストールされた packages の中から、名前に + foopackage を含む package が表示されます。 + 必要に応じてコマンドラインの foopackage + を置き換えてください。 + + + + アプリケーションのマニュアルページがインストールされているのであれば、 + &man.man.1; を使ってマニュアルを読んでください。 + 同様に、設定ファイルのサンプルや提供されているドキュメントにも目を通してください。 + + + + アプリケーションのウェブサイトがあれば、 + そのサイトにおいてドキュメントや FAQ などを調べてください。 + ウェブサイトのアドレスを知りたい場合には、以下を実行してください。 + + + &prompt.root; pkg_info foopackage-1.0.0 + + 通常、ウェブサイトの URL は + WWW: を含む行に表示されます。 + + + + トラブルシューティング @@ -1062,15 +1152,15 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100% - ports は - /usr/ports/distfiles から tarball - を探します。しかし、これは読み出し専用の CDROM - へのシンボリックリンクなので、 - ここにファイルを置くことはできません。 - 次のようにすれば他の場所を探すよう ports - に指示することができます。 + ports はダウンロードした tarball を + /usr/ports/distfiles + に置こうとしますが、システム管理者の多くはこのディレクトリに + リモートのファイルサーバやローカルの読み出し専用の CDROM + に対するシンボリックリンクを作成しています。 + このような場合には、以下のようにして distfiles + を格納するディレクトリを変更してください。 - &prompt.root; make DISTDIR=/where/you/put/it install + &prompt.root; make DISTDIR=/local/dir/with/write/permission install @@ -1520,8 +1610,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Makefile を直接読み、 保守担当者の電子メールアドレスを調べます。 メールを送る際には、port 名とバージョン番号 - (Makefile の $FreeBSD: - 行)、 + (Makefile の + $FreeBSD: 行)、 そしてエラーが出力されるまでの出力ログを忘れずに添付してください。 保守担当者から返信がなければ、send-pr を使ってバグレポートを提出しても構いません。