The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Difference between revisions of "User:Happy/funtoo-overlay"
(added more information) |
|||
| Line 1: | Line 1: | ||
If you're on a version of portage that supports repos.conf, you can add funtoo-overlay for testing purposes | ==Setup== | ||
If you're on a version of portage that supports repos.conf, you can add funtoo-overlay for testing purposes (to use updated ebuilds not yet synced to the funtoo portage tree) or to use ebuilds from the overlay itself (for other reasons). | |||
Here's how. | Here's how. | ||
Assuming /etc/portage/repos.conf is a directory, create a file called /etc/portage/repos.conf/funtoo-overlay with the following contents. | Assuming {{f|/etc/portage/repos.conf}} is a directory, create a file called {{f|/etc/portage/repos.conf/funtoo-overlay}} with the following contents. | ||
{{file|name=/etc/portage/repos.conf/funtoo-overlay|desc=adding funtoo-overlay to repos.conf|body= | {{file|name=/etc/portage/repos.conf/funtoo-overlay|desc=adding funtoo-overlay to repos.conf|body= | ||
| Line 12: | Line 14: | ||
}} | }} | ||
The location of the overlay can be anywhere you'd like, ensure that the top level directory above the overlay directory exists. In this case | The location of the overlay can be anywhere you'd like, ensure that the top level directory above the overlay directory exists. In this case {{f|/var/portage}} must exist when creating this configuration. Again it does '''not''' have to specifically be in {{f|/var/portage}}, location may be edited to a location of your choosing. Just ensure that the top level directory exists. | ||
If {{f|/etc/portage/repos.conf}} is a file instead of a directory on your system, you may add the above as a block to the file. The same statement about location applies. | |||
After the configuration is saved, you may {{c|emerge --sync}}, and it will clone the repository and make the overlay available for you to use. | |||
==Masking/Unmasking packages== | |||
You may want to mask packages from the overlay or temporarily mask all packages from the overlay entirely. You can do so with a {{f|/etc/portage/package.mask}} file. | |||
{{file|name=/etc/portage/package.mask|desc=masking packages from funtoo-overlay|body= | |||
# mask a specific atom and version from funtoo-overlay | |||
=category/package-1.2.3.4::funtoo-overlay | |||
# mask all versions of a specific atom from funtoo-overlay | |||
category/package::funtoo-overlay | |||
# mask an entire category from funtoo-overlay | |||
category/*::funtoo-overlay | |||
# mask all of funtoo-overlay | |||
*/*::funtoo-overlay | |||
}} | |||
You may also use relational operators to mask a range of versions. For more information see {{c|portage(5)}}. | |||
In some cases your profile may be masking newer versions available on funtoo-overlay. In this case you'd need to ''unmask'' whatever you desire to install with {{c|emerge(1)}}. This is possible with a {{f|/etc/portage/package.unmask}} file. The syntax is the same as the file for masking. | |||
{{file|name=/etc/portage/package.unmask|desc=unmasking packages from funtoo-overlay|body= | |||
# unmask a specific atom and version from funtoo-overlay | |||
=category/package-1.2.3.4::funtoo-overlay | |||
# unmask all versions of a specific atom from funtoo-overlay | |||
category/package::funtoo-overlay | |||
# unmask an entire category from funtoo-overlay | |||
category/*::funtoo-overlay | |||
# unmask all of funtoo-overlay | |||
*/*::funtoo-overlay | |||
}} | |||
Relational operators are also supported, again see {{c|portage(5)}} for more information. | |||
Revision as of 15:27, November 1, 2015
Setup
If you're on a version of portage that supports repos.conf, you can add funtoo-overlay for testing purposes (to use updated ebuilds not yet synced to the funtoo portage tree) or to use ebuilds from the overlay itself (for other reasons). Here's how.
Assuming /etc/portage/repos.conf is a directory, create a file called /etc/portage/repos.conf/funtoo-overlay with the following contents.
/etc/portage/repos.conf/funtoo-overlay - adding funtoo-overlay to repos.conf[funtoo-overlay]
location = /var/portage/funtoo-overlay
sync-type = git
sync-uri = https://github.com/funtoo/funtoo-overlay.git
auto-sync = yes
The location of the overlay can be anywhere you'd like, ensure that the top level directory above the overlay directory exists. In this case /var/portage must exist when creating this configuration. Again it does not have to specifically be in /var/portage, location may be edited to a location of your choosing. Just ensure that the top level directory exists.
If /etc/portage/repos.conf is a file instead of a directory on your system, you may add the above as a block to the file. The same statement about location applies.
After the configuration is saved, you may emerge --sync, and it will clone the repository and make the overlay available for you to use.
Masking/Unmasking packages
You may want to mask packages from the overlay or temporarily mask all packages from the overlay entirely. You can do so with a /etc/portage/package.mask file.
/etc/portage/package.mask - masking packages from funtoo-overlay# mask a specific atom and version from funtoo-overlay
=category/package-1.2.3.4::funtoo-overlay
# mask all versions of a specific atom from funtoo-overlay
category/package::funtoo-overlay
# mask an entire category from funtoo-overlay
category/*::funtoo-overlay
# mask all of funtoo-overlay
*/*::funtoo-overlay
You may also use relational operators to mask a range of versions. For more information see portage(5).
In some cases your profile may be masking newer versions available on funtoo-overlay. In this case you'd need to unmask whatever you desire to install with emerge(1). This is possible with a /etc/portage/package.unmask file. The syntax is the same as the file for masking.
/etc/portage/package.unmask - unmasking packages from funtoo-overlay# unmask a specific atom and version from funtoo-overlay
=category/package-1.2.3.4::funtoo-overlay
# unmask all versions of a specific atom from funtoo-overlay
category/package::funtoo-overlay
# unmask an entire category from funtoo-overlay
category/*::funtoo-overlay
# unmask all of funtoo-overlay
*/*::funtoo-overlay
Relational operators are also supported, again see portage(5) for more information.