Ebuild repository/ja

Gentoo Linuxでは、ユーザには既に、かつて同義語的にPortage ツリーと呼ばれていたメインのリポジトリが与えられています. この用語は、Portage以外のパッケージマネージャがGentooのパッケージリポジトリと相互作用できるようになってからは、段階的に廃止するべきとされています. このメインのリポジトリは、Gentoo 開発者たちによって維持管理されている全てのソフトウェアパッケージ (ebuild と呼ばれているもの)で構成されています. しかしユーザは、この Portage ツリーに対して更に追加のリポジトリを付け加えることもできます. 追加のパッケージツリーは通常、リポジトリによって提供されています. ユーザはこうした追加のリポジトリをメインのツリーに対して覆い被せる("lay over")ことができ、そこからこれをoverlayと呼んでいます.

リポジトリ
Package repositories are nothing more (or less) than a set of files (ebuilds, metadata files, ChangeLog entries ...). These can be pulled in from public repositories (git, CVS, SVN ...) or downloaded as tarballs and extracted manually onto the system. It is advised to use managed repositories by trusted third parties; any installed overlay will cause Portage to look through the overlaid files when deciding which software to install. If compromised code is in the overlay, then compromised packages could be installed on the system.

The now default approach for handling repositories is through which, like many other Portage related locations, can be a directory as well.

Repository definitions inside also inform Portage if and how the repository can be updated. With it, calling will automatically update the repositories as well.

A deprecated, yet still supported method is to use the PORTDIR_OVERLAY variable inside. This variable can point to one or more additional locations on the file system where repositories are available. The use of the directory is highly preferred.

より詳しくは、 /etc/portage/repos.conf 及び Portage/Sync の記事を参照してください

優先順位について
それぞれのオーバーレイは、固有の優先度を保持します. 特定のバージョンが複数のオーバーレイ内に見つかって処理方法が不明確になった場合に備えるための仕様です. 優先度値のより高い（たとえば60）オーバーレイ内の ebuild が、優先度の低い（たとえば50）オーバーレイ内の ebuild に先んじて処理されます.

優先度を含んだオーバーレイのリストは、以下のコマンドの出力で得られます（"Repositories"の欄を探してください）:

Gentoo Portage ツリーには -1000 という優先度が設定されます. すなわち、他のすべてのオーバーレイのほうに高い優先度が割り当てられているので、これらが先んじて処理されます. この挙動は既定の仕様です. なぜなら、オーバーレイとは、portage ツリーの上に覆い被せる (lay over/on top) ように設計されたものなのですから.

Available software
多くのツールがオーバーレイをサポート、または統合的に扱っています.

Layman
アプリケーションは、複数の追加オーバーレイを更新・管理することを容易にします. はコマンドラインアプリケーションで、を通じて公に利用可能なオーバーレイを一覧表示、購読、購読解除、更新することができます.

It supports both the as well as  method.
 * When using the method,  manages a dedicated configuration file which should be sourced in by
 * When using, manages the  file directly

より詳しくは Layman の記事及びProject:Portage/Sync を参照してください.

emaint
See the Sync (Portage project) article and.

eix
is a wrapper starting (which in turn starts ) followed by. For further details see the Eix article and.

Emerging a duplicate package
When working with overlays it is possible to encounter a situation where multiple versions of the same package are available from different overlays. Instruct Portage to install a specific package from a specific overlay with the  notation:

キャッシュの生成について
portage は、オーバーレイが多量にインストールされている場合には、パッケージの前提関係を解決するような処理に長い時間を要するかもしれません. これは、オーバーレイには一般的に、メタデータキャッシュが含まれていないためです.

ローカルのメタデータキャッシュを生成するには、オーバーレイとの同期後に を実行してください:

Be careful, because takes a lot of time and it's not recommended for rsync users as rsync updates the cache using server-side caches (most of users of portage are rsync users). Rsync users should simply run (or ) to regenerate the cache. It's probably only users of very large overlays should try.

Masking when using unsafe overlays
巨大なオーバーレイや、よく知らない・低品質なオーバーレイを利用するなら、そのオーバレイ全体に対してハードマスクをかけるのが最善でしょう.

その後に、インストールするパッケージのマスクを外します.

参考

 * Overlays project - The official Gentoo project for overlays support.
 * Overlays guide (Overlay project) - A user guide written by the Overlay project.
 * Developer's guide to Gentoo overlays - This document is kept only for historical purposes. The current guide is maintained as Project:Overlays/Overlays guide.
 * Defining a custom repository - Section in the Gentoo Handbook

外部の情報

 * https://overlays.gentoo.org
 * https://github.com/gentoo/