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: @@
-<noinclude>
+{{Ebuild
-Use like so:
+|Summary=Tool to manage Gentoo overlays
+|CatPkg=app-portage/layman
+|Homepage=http://layman.sourceforge.net/
+}}
+Layman is an "overlay" external repository management tool.
+=== 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
+}}
-<pre>
+{{file|name=/etc/portage/package.unmask|lang=|desc=unmask packages to be used|body=
-{{News
+cat-egory/pack-age1
-|Summary=Test News Item
+cat-egory/pack-age2
-|News Category=General
-|Author=Drobbins
-|Publication Status=Draft
-|Publication Date=2014/10/16
-|Icon=File:foobar.jpg
-|News Format=Short (or Extended)
 }}
-</pre>
-</noinclude><includeonly>
+==== Sync ====
-<div class="container" style="margin-top: 20px;"><div class="row"><div class="col-xs-12">
-= {{PAGENAME}} =
+Sync a specific overlays ebuilds:
-{{#if:{{{Deprecated By|}}}|{{Important|This news item is not current. You can find more information on this topic at [[Deprecated By::{{{Deprecated By}}}]].}}}}
+<console>###i## layman -s <overlay name></console>
-{{#ifeq:{{{Publication Status|}}|Draft|{{NotYetPublished}}}}{{#set:Summary={{{Summary|}}}|News Category={{{News Category|}}}|Publication Status={{{Publication Status|}}}|Icon={{{Icon|}}}|Publication Date={{{Publication Date|}}}|News Format={{{News Format}}}}}
-{{#set:Author=User:{{{Author|}}}|Gravatar MD5={{#show: User:{{{Author}}} | ?Gravatar MD5}}}}
+Sync all overlays:
-{{#ifeq:{{{News Format|}}}|Extended|
+<console>###i## layman -S</console>
-{{#widget:NewsInfo|body={{{Summary|}}}|user={{{Author|}}}|icon_url={{#if:{{{Icon|}}}|{{filepath:{{#sub:{{{Icon}}}|5}}|80}}|http://www.gravatar.com/avatar/{{#show: User:{{{Author}}} | ?Gravatar MD5}}/?s=80&d=retro&r=g}}|date={{#time:F j, Y|{{{Publication Date}}}}}
-}}}}
+Sync all overlays via eix:
-</div></div><div class="row"><div class="col-xs-12">
+<console>###i## eix-sync</console>
-</includeonly>
+=== 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 pages "Template:News" and "Package:Layman"