日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
PORTSNAP(8) FreeBSD システム管理者マニュアル PORTSNAP(8)
名称
portsnap -- ports ツリーの圧縮されたスナップショットを取って来て (fetch)
抽出 (extract) する
書式
portsnap [-I] [-d workdir] [-f conffile] [-k KEY] [-l descfile]
[-p portsdir] [-s server] command ... [path]
解説
portsnap ツールは、FreeBSD ports ツリーの圧縮されたスナップショットを取っ
て来て更新するため、そして、圧縮されていない ports ツリーを抽出して更新す
るために使用されます。
通常の更新操作では、portsnap は、定期的に変更されたファイルを変更されてい
ない状態に復元して、認識されないローカルファイルを削除します。
オプション
次のオプションがサポートされています:
-d workdir 作業ファイル (例えば、ダウンロードされた更新) を workdir に
格納します。(デフォルト: /var/db/portsnap または設定ファイル
で与えられる。)
-f conffile conffile から設定を読み込みます。(デフォルト:
/etc/portsnap.conf)
-I update コマンドのために、INDEX ファイルを更新しますが、ports
ツリーの残りではありません。
-k KEY 与えられた SHA256 ハッシュがある公開キーを要求します。(デ
フォルト: 設定ファイルから値を読み込みます。)
-l descfile 指定されたローカル記述ファイルを構築された INDEX ファイルに
マージ (統合) します。descfile は、それぞれのローカル port
ディレクトリで make describe を実行することによって生成され
るべきです。
-p portsdir 圧縮されていないスナップショットを抽出するか、または更新する
とき、ディレクトリ portsdir を作動します。(デフォルト:
/usr/ports/ または設定ファイルで与えられる。)
-s server 指定されたサーバまたはサーバプールからのファイルを取って来ま
す。(デフォルト: portsnap.FreeBSD.org、または設定ファイルで
与えられる。)
path extract コマンドだけのために、path から始まる ports ツリーの
部分だけを作動させます。(例えば、portsnap extract
sysutils/port は、sysutils/portsman, sysutils/portsnap,
sysutils/portupgrade, などを抽出します。)
--interactive
呼び出しているプロセスの自動検出を上書きします。対話型で終了
しないアプリケーションから portsnap を呼び出すときのみ、これ
を使用します。(それらが Portsnap ミラーでロードスパイク
(load spike) を引き起こすので、クーロンのジョブは、特に良く
ありません。)
コマンド
command は、次のいずれかの 1 つを指定できます:
fetch ports ツリーの圧縮されたスナップショットを取って来るか、また
は既存のスナップショットを更新します。このコマンドは、インタ
ラクティブのみに使用されるべきです。非対話的な使用のために、
利用者は、cron コマンドを使用するべきです。
cron 1 と 3600 秒の間のランダムな時間スリープし、fetch コマンドが
指定されたかのように動作します。名前が示すように、このコマン
ドは、cron(8) から実行するように設計されています。ランダムな
遅れは、多くのマシンが、同時に更新を取って来る試みの確率を最
小にすることに役立ちます。
extract 既存のファイルとディレクトリを置き換えて、ports ツリーを抽出
します。注: これは、ファイルまたはディレクトリが抽出されてい
る位置を占領するものは何でも取り除きます。特に、ports ツリー
に局所的に行われた変更 (例えば、新しいパッチを加える) は、静
かに消し去られます。
完全に変更されていないツリーを clean にしてやり直したいな
ら、または (path オプションを使用して) ツリーの特定の部分を
抽出したいなら、このコマンドを単に走らせて、初めて portsnap
によって維持された ports ツリーを初期化します。
update extract コマンドを使用して、抽出された ports ツリーを更新し
ます。利用者は、fetch または cron コマンドを通して更新するダ
ウンロードした後の ports ツリーへの変化を適用するためにこの
コマンドを実行しなければなりません。再び、更新されている
ports ツリーの部分では、どんな局所的な変更や追加も取り除かれ
ることに注意してください。
auto 標準出力 (stdin) が端末であるかどうかに応じて fetch または
cron を実行します。次に、portsdir が存在するかどうかに応じて
update または extract を実行します。
TIPS (秘訣)
• 利用者のクロックがローカル時間に設定されているなら、/etc/crontab に行
0 3 * * * root /usr/sbin/portsnap cron
を追加することは、/usr/ports にすばやく抽出することができる利用可能な
ports ツリーのスナップショットを常に最新の保つ良い方法です。利用者の
クロックが UTC に設定されるなら、スナップショットをホスティングする
サーバで一様でない負荷を過度に強制することを避けるために、午前 3 時以
外のランダムな時間を選んでください。
portsnap cron または portsnap fetch を実行することは、受信された変更
を適用しないことに注意してください: それらは、単にそれらをダウンロー
ドします。変更を適用するために、利用者は、portsnap update で、これら
のコマンドに続かなければなりません。portsnap update コマンドは、ports
ツリーで誰も手動で作業していないと確信された時期に、通常手動で実行さ
れます。
• cron(8) から portsnap update を実行することは、悪い考えです -- 利用者
がかって cron ジョブを実行する時間に port をインストールするか更新す
るなら、利用者は、portsnap が port を構築することによって使用されてい
るファイルを更新するか、または削除するとき、たぶん混乱して終わるで
しょう。しかしながら、portsnap -I update を実行することは、たぶん安全
であり、期限が切れたインストールされたソフトウェアを識別するために
pkg-version(8) と共に使用することができます。
• 利用者が、多くのマシンを最新の状態に保持するために portsnap を使用し
たいなら、キャッシュしている HTTP プロキシをセットアップしたいかもし
れません。portsnap がダウンロードして更新するために fetch(1) を使用す
るので、HTTP_PROXY 環境変数を設定することは、与えられたプロキシから更
新を取って来るようにそれに指示します。ファイルの大部分がすべての特定
のクライアントによっても必要とされないので、これは、portsnap サーバの
ファイルをミラーリングするよりはるかに効率的です。
プライバシの注
操作の避けられない部分として、portsnap を実行するマシンは、公開 IP アドレ
スとそれが取って来るファイルのリストを更新を取って来るサーバで利用可能と
します。これらを使用して、延長された期間を越えてマシンを認識し、更新する
ときを決定して、FreeBSD ports ツリーの部分が、もしあるなら portsnap.conf
の "REFUSE" 指示を使用して無視されることを識別することが可能です。さら
に、FreeBSD のリリースレベルがサーバに転送されます。
このように集められた情報から生成された統計データが公開されるかもしれませ
んが、全体として、個々のシステムが匿名にされた後だけです。
関連ファイル
/etc/portsnap.conf portsnap 設定ファイルのデフォルト位置。
/var/db/portsnap 圧縮されたスナップショットが格納されるデフォルト位
置。
/usr/ports ports ツリーが抽出されるデフォルト位置。
関連項目
fetch(1), sha256(1), fetch(3), portsnap.conf(5), pkg(7), pkg-version(8)
作者
Colin Percival <cperciva@FreeBSD.org>
FreeBSD March 1, 2016 FreeBSD