Overlay in Gentoo

Overlay in Gentoo

Emerge required packages

# emerge --ask repoman layman

Creating a local overlay

A local overlay is usefull for (1) Installing an ebuild received from someone else. (2) Making a simple version bump to an ebuild. (3) Developing ebuilds.

A local repository (aka local overlay) can be setup with a few steps

# mkdir -p /usr/local/portage/{metadata,profiles}

# echo 'jongmin-overlay' > /usr/local/portage/profiles/repo_name

# echo 'masters = gentoo' > /usr/local/portage/metadata/layout.conf

# chown -R portage:portage /usr/local/portage

Register an overlay.

# mkdir -p /etc/portage/repos.conf

# /etc/portage/repos.conf

[jongmin-overlay]

location = /usr/local/portage

masters = gentoo

auto-sync = no

Add an ebuild to the overlay

# mkdir -p /usr/local/portage/sys-auth/nss-mdns

# cp /usr/portage/sys-auth/nss-mdns/nss-mdns-0.10-r3.ebuild /usr/local/portage/sys-auth/nss-mdns/nss-mdns-0.10-r3.ebuild

# chown -R portage:portage /usr/local/portage

# pushd /usr/local/portage/sys-auth/nss-mdns

# repoman manifest

# popd

You should now be able to install the package from your overlay with emerge

# emerge --ask --verbose --oneshot nss-mdns

You can see my public overlay git repository like below:

https://github.com/starryjm/gentoo.overlay

References

1. https://wiki.gentoo.org/wiki/Overlay/Local_overlay

2. https://wiki.gentoo.org/wiki/Overlay/ko

3. https://overlays.gentoo.org/

4. https://github.com/starryjm/gentoo.overlay

5. https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/net-misc/mDNSResponder/?hideattic=0