The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Difference between revisions of "Package:Layman"
Threesixes (talk | contribs) (initial commit) |
|||
| (9 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
|Summary=Tool to manage Gentoo overlays | |Summary=Tool to manage Gentoo overlays | ||
|CatPkg=app-portage/layman | |CatPkg=app-portage/layman | ||
|Homepage= | |Homepage=https://wiki.gentoo.org/wiki/Project:Layman | ||
}} | }} | ||
Layman is an "overlay" external repository management tool. | 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> | <console>###i## emerge layman</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> | |||
{{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: | |||
<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}} | {{EbuildFooter}} | ||
Latest revision as of 01:40, May 30, 2018
Layman
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.
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>
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 usedcat-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