Revision as of 08:20, February 13, 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

Using Layman

Fetch, and display a list of overlays:

root # layman -L

Add an overlay to your system:

root # layman -a <overlay name>

After adding first overlay(s) 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

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: @@
-== About LXQt ==
+{{Ebuild
+|Summary=Tool to manage Gentoo overlays
+|CatPkg=app-portage/layman
+|Homepage=http://layman.sourceforge.net/
+}}
+Layman is an "overlay" external repository management tool.
-LXQt is a lightweight Desktop environment. Some LXDE developers decided to create a Qt based version of their Desktop environment, it's name was lxde-qt. Around the same time some other people were working on a different minimal Qt based DE called razor-qt. When some developers of those projects met they decided to join forces and work together on one project. LXQt was born.
+=== Installation ===
+<console>###i## emerge layman</console>
+=== Using Layman ===
+Fetch, and display a list of overlays:
+<console>###i## layman -L</console>
-== Installation ==
+Add an overlay to your system:
+<console>###i## layman -a <overlay name></console>
+After adding first overlay(s) [[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>
+Delete an overlay from your system:
+<console>###i## layman -d <overlay name></console>
-It is recommended to set the LXQt mix-in before emerging it.
+==== 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.
-{{console|body=
+{{file|name=/etc/portage/package.mask|lang=|desc=mask all packages in an overlay|body=
-###i## eselect profile add funtoo/1.0/linux-gnu/mix-ins/lxqt
+*/*::overlay-name
-###i## emerge lxqt-meta
 }}
-== Starting LXQt ==
+{{file|name=/etc/portage/package.unmask|lang=|desc=unmask packages to be used|body=
+cat-egory/pack-age1
-You can either use a display manager to log into your system and start LXQt, or you can log in on a TTY and run {{c|startx}} to start xinit by hand.
+cat-egory/pack-age2
+}}
-=== xinit ===
-You should edit the file  {{c|~/.xinitrc}} if it already exists, and put {{c|"exec startlxqt"}} in there.
+==== Sync ====
-If it doesn't exist you can create it like this:
-{{console|body=$##i## echo "exec startlxqt" > ~/.xinitrc}}
+Sync a specific overlays ebuilds:
+<console>###i## layman -s <overlay name></console>
-You might want to add the commands and options {{c|ck-launch-session dbus-launch --sh-syntax --exit-with-session}} to the {{c|exec]}} to start it with ConsoleKit and DBus.
+Sync all overlays:
-In this case you also need to add ConsoleKit to the default runlevel:
+<console>###i## layman -S</console>
-{{console|body=
-###i## rc-update add consolekit default
-###i## rc
-}}
+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']
-=== Login Manager ===
+Solution:
+<console>###i## layman -L</console>
-Please take a look at http://www.funtoo.org/Package:XDM_%28Display_Manager%29 for this.
+{{EbuildFooter}}

Difference between pages "LXQt" and "Package:Layman"