§2023-10-29

Warning! app-portage/layman is pmasked for removal. The eselect repository eselect module supersedes layman and is currently the preferred way for managing ebuild repositories.

• eselect/repository

Note This utility supersedes layman for listing, configuring, and handling synchronization of alternate repositories. There are still some exceptions for which layman can supplement eselect-repository, when using version control systems that Portage does not natively sync (e.g. darcs and g-sorcery).

1. intall

orgpi516G /home/alexlai # emerge --ask app-eselect/eselect-repository
orgpi516G /home/alexlai # qlist eselect-repository
/etc/eselect/repository.conf
/usr/share/man/man5/repository.eselect.5.bz2
/usr/share/eselect/modules/repository.eselect
/usr/lib/eselect-repo/eselect-repo-helper

2. Use the -i option to show currently configured repositories only

orgpi516G /home/alexlai # eselect repository list -i 
Available repositories:
  [126] gentoo # (https://gentoo.org/)
  [287] SarahMiaOverlay * (https://gitlab.com/SarahMia/sarahmiaoverlay)
orgpi516G /home/alexlai # ls -l /etc/portage/repos.conf/
total 8
-rw-r--r-- 1 root root 166 Oct 29 12:50 eselect-repo.conf
-rw-r--r-- 1 root root 641 Oct 29 11:07 gentoo.conf

4. list all

rgpi516G /home/alexlai # eselect repository list
Available repositories:
  [1]   4nykey (https://github.com/4nykey/4nykey)
  [2]   ace (https://github.com/ananace/overlay)
  [3]   activehome (https://cgit.gentoo.org/user/activehome.git/)
  [4]   adasss (https://github.com/AdamGiergun/adasss)
  [5]   ago (https://cgit.gentoo.org/dev/ago.git/)
  [6]   ag-ops (https://gitlab.com/ILMostro/ag-ops)
  [7]   ahyangyi-overlay (https://github.com/ahyangyi/ahyangyi-overlay)
  [8]   akater (https://gitlab.com/akater/ebuilds)
  [9]   alatar-lay (https://github.com/alatarum/alatar-lay)
  [10]  alesharik (https://github.com/alesharik/alesharik-overlay)
  [11]  AlexandreFournier (https://github.com/AlexandreFournier/gentoo-overlay)
...
  [131] gentoo-zh (https://github.com/microcai/gentoo-zh)
....
[388] zugaina (http://gpo.zugaina.org/Overlays/zugaina/)
  [389] zyrenth (https://github.com/kabili207/zyrenth-overlay)

orgpi516G /home/alexlai # eselect repository list|grep gentoo-zh
  [131] gentoo-zh (https://github.com/microcai/gentoo-zh)

5. Add repositories

eselect repository add gentoo-zh git https://github.com/microcai/gentoo-zh

orgpi516G /home/alexlai # eselect repository add gentoo-zh git https://github.com/microcai/gentoo-zh
Adding gentoo-zh to /etc/portage/repos.conf/eselect-repo.conf ...
Repository gentoo-zh added
orgpi516G /home/alexlai # ls -l /etc/portage/repos.conf/
total 8
-rw-r--r-- 1 root root 279 Oct 29 13:47 eselect-repo.conf
-rw-r--r-- 1 root root 641 Oct 29 11:07 gentoo.conf

orgpi516G /home/alexlai # cat /etc/portage/repos.conf/eselect-repo.conf 
# created by eselect-repo

[SarahMiaOverlay]
location = /var/db/repos/SarahMiaOverlay
sync-type = git
sync-uri = https://github.com/gentoo-mirror/SarahMiaOverlay.git

[gentoo-zh]
location = /var/db/repos/gentoo-zh
sync-type = git
sync-uri = https://github.com/microcai/gentoo-zh

6. sync the newly added

orgpi516G /home/alexlai # emerge --sync gentoo-zh
>>> Syncing repository 'gentoo-zh' into '/var/db/repos/gentoo-zh'...
/usr/bin/git clone --depth 1 https://github.com/microcai/gentoo-zh .
Cloning into '.'...
remote: Enumerating objects: 1705, done.
remote: Counting objects: 100% (1705/1705), done.
remote: Compressing objects: 100% (1483/1483), done.
remote: Total 1705 (delta 266), reused 1249 (delta 164), pack-reused 0
Receiving objects: 100% (1705/1705), 1.97 MiB | 5.14 MiB/s, done.
Resolving deltas: 100% (266/266), done.
=== Sync completed for gentoo-zh

Performing Global Updates
(Could take a couple of minutes if you have a lot of binary packages.)
  .='update pass'  *='binary update'  #='/var/db update'  @='/var/db move'
  s='/var/db SLOT move'  %='binary move'  S='binary SLOT move'
  p='update /etc/portage/package.*'
/var/db/repos/gentoo-zh/profiles/updates/1Q-2023.............
/var/db/repos/gentoo-zh/profiles/updates/4Q-2012.
/var/db/repos/gentoo-zh/profiles/updates/4Q-2021.
/var/db/repos/gentoo-zh/profiles/updates/3Q-2022.
/var/db/repos/gentoo-zh/profiles/updates/2Q-2023.
/var/db/repos/gentoo-zh/profiles/updates/1Q-2022..
/var/db/repos/gentoo-zh/profiles/updates/1Q-2013....
/var/db/repos/gentoo-zh/profiles/updates/4Q-2013..
/var/db/repos/gentoo-zh/profiles/updates/2Q-2022...................
/var/db/repos/gentoo-zh/profiles/updates/3Q-2016.
/var/db/repos/gentoo-zh/profiles/updates/2Q-2014...
/var/db/repos/gentoo-zh/profiles/updates/2Q-2011.
/var/db/repos/gentoo-zh/profiles/updates/2Q-2021...
/var/db/repos/gentoo-zh/profiles/updates/3Q-2017.
/var/db/repos/gentoo-zh/profiles/updates/1Q-2015.
/var/db/repos/gentoo-zh/profiles/updates/2Q-2012....
/var/db/repos/gentoo-zh/profiles/updates/4Q-2020.
/var/db/repos/gentoo-zh/profiles/updates/3Q-2014..
/var/db/repos/gentoo-zh/profiles/updates/4Q-2017..



 * IMPORTANT: 11 news items need reading for repository 'gentoo'.
 * Use eselect news read to view new items.


Action: sync for repo: gentoo-zh, returned code = 0