Layman

Tip

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.

Important

In order to use layman, please make sure your /etc/portage/repos.conf is setup correctly.

/etc/portage/repos.conf should be a directory with a link to /var/git/meta-repo/repos.conf inside it. If your /etc/portage/repos.conf is a symlink please correct it using the following commands:

root # rm /etc/portage/repos.conf
root # mkdir /etc/portage/repos.conf
root # ln -s /var/git/meta-repo/repos.conf /etc/portage/repos.conf/funtoo

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>

Note

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 used

cat-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

Package:Layman