This is a reference for specifying versions of packages as used when interacting with Portage via emerge or /etc/portage.
These are also known as "DEPEND atoms" in Portage documentation.
For the ebuild development perspective, see the Gentoo Development Guide.
Matches any version of a package.
Matches version and any revision.
does not match: gdb-7.3.1
Matches a version by the version range. Note that there's no "." before the "*".
Please note that
sys-devel/gdb-7.3*, for example, would also match
sys-devel/gdb-7.30 (if that actually existed). Also, you cannot avoid this by trying with
7.3. (with a trailing dot) is not a valid version number.
Matches a version exactly.
does not match: firefox-7.0-r1
does not match: firefox-7.0.1
Matches the specified version or any higher version.
Matches a version strictly later than specified.
does not match: python-2.7
Matches a version strictly older than specified.
does not match: dev-python/beautifulsoup-3.2.0
Matches the specified version or any older version.
does not match: udev-171-r1
Matches package in the specified package SLOT. Note that there is no prefix.
does not match: sqlite-3.7.8
By ebuild repository
Matches a package from a specific ebuild repository. This can be combined with other specifiers. The official Gentoo repository is ::gentoo.
matches: mesa version 9999 from the x11 overlay
does not match: any version from a different overlay.
Portage — the official package manager and distribution system for Gentoo.