Latest revision as of 01:40, May 30, 2018

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

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

@@ Line 2: / Line 2: @@
 |Summary=Tool to manage Gentoo overlays
 |CatPkg=app-portage/layman
-|Homepage=http://layman.sourceforge.net/
+|Homepage=https://wiki.gentoo.org/wiki/Project:Layman
 }}
 Layman is an "overlay" external repository management tool.
+{{important|In order to use layman, please make sure your /etc/portage/repos.conf is a directory and not a symlink to <code>/var/git/meta-repo/repos.conf</code>.
+}}
+=== Installation ===
 <console>###i## emerge layman</console>
-make.conf must source laymans overlays for emerge to pull in packages from external sources.
+=== Using Layman ===
-<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>
@@ Line 15: / Line 17: @@
 Add an overlay to your system:
 <console>###i## layman -a <overlay name></console>
+{{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:
 <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:
@@ Line 28: / Line 46: @@
 <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>
 {{EbuildFooter}}

Difference between revisions of "Package:Layman"