Difference between revisions of "Package:Layman"

From Funtoo
Jump to navigation Jump to search
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=http://layman.sourceforge.net/
|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 setup correctly.
{{Important| In order to use layman, please make sure your /etc/portage/repos.conf is setup correctly.
By default <code>/etc/portage/repos.conf</code> is a directory with a link to /var/git/meta-repo/repos.conf inside it.  
By default <code>/etc/portage/repos.conf</code> is a directory with a link to <code>/var/git/meta-repo/repos.conf</code>.  
For layman setup, please correct it using the following commands:
For layman setup, please correct it using the following commands:
<console>###i## rm /etc/portage/repos.conf
<console>###i## rm /etc/portage/repos.conf

Revision as of 04:36, November 8, 2017

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 setup correctly.

By default /etc/portage/repos.conf is a directory with a link to /var/git/meta-repo/repos.conf. For layman setup, please correct it using the following commands:

root # rm /etc/portage/repos.conf
root # mkdir /etc/portage/repos.conf
root # ln -s /var/git/meta-repo/repos.conf /etc/portage/repos.conf/funtoo

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