The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Package:Layman
Layman
We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.
Layman is an "overlay" external repository management tool.
In order to use layman, please make sure your /etc/portage/repos.conf is a directory and not a symlink to /var/git/meta-repo/repos.conf.
Installation
root # emerge layman
Using Layman
Fetch, and display a list of overlays:
root # layman -L
Add an overlay to your system:
root # layman -a <overlay name>
In earlier versions, it was necessary to add source /var/lib/layman/make.conf to make.conf. This is not needed anymore, portage will pickup the overlay automatically.
Delete an overlay from your system:
root # layman -d <overlay name>
Masking Overlay Packages
Overlays have the power to override distro packages. To avoid conflicts, mask everything in the overlay, and unmask the packages that are necessary to your system.
/etc/portage/package.mask - mask all packages in an overlay*/*::overlay-name
/etc/portage/package.unmask - unmask packages to be usedcat-egory/pack-age1 cat-egory/pack-age2
Sync
Sync a specific overlays ebuilds:
root # layman -s <overlay name>
Sync all overlays:
root # layman -S
Sync all overlays via eix:
root # eix-sync
Troubleshooting
Problem: Warning: an installed db file was not found at: ['/var/lib/layman/cache***.xml']
Solution:
root # layman -L