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>
-This is the "Ebuild" template.
-It should be called in the following format:
-<pre>
 {{Ebuild
-|Summary=
+|Summary=Tool to manage Gentoo overlays
-|CatPkg=
+|CatPkg=app-portage/layman
-|Maintainer=
+|Homepage=http://layman.sourceforge.net/
-|Homepage=
 }}
-</pre>
+Layman is an "overlay" external repository management tool.
-Edit the page to see the template text.
-</noinclude><includeonly><div class="container"><div class="row">
+=== Installation ===
-<div class="col-md-3 col-md-push-9">
+<console>###i## emerge layman</console>
-<b>[[CatPkg::{{{CatPkg|}}}]]</b>
+[[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.
-<hr>{{#vardefine:cat|{{#explode:{{{CatPkg}}}|/|0}}}}{{#vardefine:pkg|{{#explode:{{{CatPkg}}}|/|1}}}}{{#get_web_data:url=http://ports.funtoo.org/packages.xml|format=xml|use xpath|data=repo_id=/packages/category[@name='{{#var:cat}}']/package[@name='{{#var:pkg}}']/@repository}}{{#vardefine:repoid|{{#if:{{#external_value:repo_id}}|{{#external_value:repo_id}}|gentoo}}}}{{#set:RepoID={{#var:repoid}}}}
+<console>###i## echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf</console>
-<table border="0" width="100%">
-{{#if: {{{Maintainer|}}} |<tr><td><i>Current Maintainer(s):</i></td><td>{{#arraymaptemplate:{{{Maintainer|}}}|MaintainerDisplay|,|<br>}}</td></tr> |}}<tr><td><i>Source Repository:</i></td><td>{{#ask:[[Category:Repositories]] [[Repository ID::{{#var:repoid}}]]}}</td></tr>   {{#if: {{{Homepage|}}} |<tr><td></td><td>[[Homepage::{{{Homepage|}}}|Homepage]]</td></tr> |}}</table><hr>
+=== Using Layman ===
-<b>Summary:</b> [[Summary::{{{Summary|}}}]]
+Fetch, and display a list of overlays:
-{{#get_web_data:url=http://ports.funtoo.org/packages.xml|format=xml|use xpath|data=use=/packages/category[@name='{{#var:cat}}']/package[@name='{{#var:pkg}}']/@use}}{{#set:Use={{#external_value:use}}}}{{#if: {{#external_value:use}}|
+<console>###i## layman -L</console>
-== Use Flags ==
-{{#arraymaptemplate:{{#external_value:use}}|ExternUse|,|}}
+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
 }}
-</div><div class="col-xs-12 col-md-9 col-md-pull-3">
-<div id="ebuild_header"><div id="ebuild_logo" style="padding-bottom: 1em;">[[File:ebuild.png|link=|frameless|class=img-responsive]]</div><div id="ebuild_title">
+{{file|name=/etc/portage/package.unmask|lang=|desc=unmask packages to be used|body=
-= {{PAGENAME}} =
+cat-egory/pack-age1
-</div></div>
+cat-egory/pack-age2
-</includeonly>
+}}
+==== 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>
+{{EbuildFooter}}

Difference between pages "Template:Ebuild" and "Package:Layman"