Revision as of 12:00, February 3, 2015

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.

Installation

root # emerge layman

make.conf must source laymans overlays for emerge to pull in packages from external sources. This line needs to be below everything else in make.conf.

root # echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf

Using Layman

Fetch, and display a list of overlays:

root # layman -L

Add an overlay to your system:

root # layman -a <overlay name>

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

@@ Line 1: / Line 1: @@
 {{Ebuild
-|Summary=The vanilla sources are the pure, unadulterated kernel sources as release by Linus Torvalds himself. No additional patches are applied.
+|Summary=Tool to manage Gentoo overlays
-|CatPkg=sys-kernel/vanilla-sources
+|CatPkg=app-portage/layman
-|Maintainer=
+|Homepage=http://layman.sourceforge.net/
-|Homepage=https://www.kernel.org/
 }}
-The vanilla sources supply the source code for the Linux kernel in an unadulterated form. Linux was ultimately created by Linux Torvalds, and the vanilla kernel is the result of what has been accepted by him into the kernel. There are no additional patches applied.
+Layman is an "overlay" external repository management tool.
-Often, you'll point /usr/src/linux to the source code of the kernel you are currently using.
+=== Installation ===
+<console>###i## emerge layman</console>
+[[make.conf]] must source laymans overlays for emerge to pull in packages from external sources.  This line needs to be below everything else in make.conf.
+<console>###i## echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf</console>
+=== Using Layman ===
+Fetch, and display a list of overlays:
+<console>###i## layman -L</console>
+Add an overlay to your system:
+<console>###i## layman -a <overlay name></console>
+Delete an overlay from your system:
+<console>###i## layman -d <overlay name></console>
+==== 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.
+{{file|name=/etc/portage/package.mask|lang=|desc=mask all packages in an overlay|body=
+*/*::overlay-name
+}}
+{{file|name=/etc/portage/package.unmask|lang=|desc=unmask packages to be used|body=
+cat-egory/pack-age1
+cat-egory/pack-age2
+}}
+==== Sync ====
+Sync a specific overlays ebuilds:
+<console>###i## layman -s <overlay name></console>
+Sync all overlays:
+<console>###i## layman -S</console>
+Sync all overlays via eix:
+<console>###i## eix-sync</console>
+=== Troubleshooting ===
+Problem:
+Warning: an installed db file was not found at: ['/var/lib/layman/cache***.xml']
+Solution:
+<console>###i## layman -L</console>
-To configure the kernel, you can do so with make menuconfig for a curses-based configuration menu, oldconfig for text only prompts. There is also an availability of building similar configuration menus for X windowing toolkits.
 {{EbuildFooter}}

Difference between pages "Package:Vanilla Sources" and "Package:Layman"