Tool to update the Portage(5) tree, all installed packages, and kernel, under Gentoo Linux.
31 Oct 2020: sadly, due to legal obligations arising from a recent change in my 'real world' job, I must announce I am standing down as maintainer of this project with immediate effect. For the meantime, I will leave the repo up (for historical interest, and it may be of use to others); however, I plan no further updates, nor will I be accepting / actioning further pull requests or bug reports from this point. Email requests for support will also have to be politely declined, so, please treat this as an effective EOL notice.
For further details, please see my post here.
With sincere apologies, sakaki ><
genup is a utility intended to simplify the process of keeping your Gentoo system up to date. When invoked, it automatically performs the following steps, in order:
- updates Portage tree (and active overlays), and syncs eix(1)
(using
emaint sync/eix-sync) - removes any prior emerge(1) resume history
(using
emaint --fix cleanresume) - on
aarch64, attempts to apply any pending fixups (if desired, by running/etc/cron.weekly/fixup; errors non-fatal) - ensures Portage(5) itself is up-to-date
(using
emerge --oneshot --update portage) - ensures genup itself is up-to-date (restarting if not)
(using
emerge --oneshot --update genup) - updates all packages in the @world set
(first using emtee(1), if the matching USE flag is set, and then using
emerge --deep --with-bdeps=y --changed-use --update @world) - removes unreferenced packages
(using
emerge --depclean) - rebuilds any external modules (such as those for VirtualBox)
(using
emerge @module-rebuild --exclude '*-bin') - rebuilds any packages depending on stale libraries
(using
emerge @preserved-rebuild) - updates any old perl(1) modules
(using
perl-cleaner --all) - resolves clashing config file changes (in interactive mode)
(using
dispatch-conf) - upgrades the kernel if possible (to staging, in /boot)
(using
buildkernel --stage-only) - removes unreferenced packages (again)
(using
emerge --depclean) - fixes missing shared library dependencies
(using
revdep-rebuild) - rebuilds any packages depending on stale libraries (again)
(using
emerge @preserved-rebuild) - removes any unused source tarballs (if desired)
(using
eclean --deep distfiles) - deploys new kernel from staging (if desired and available)
(using
buildkernel --copy-from-staging) - updates environment settings (as a precautionary measure)
(using
env-update) - updates
eixpackage metadata (usingeix-sync -0) - runs any custom updaters in /etc/genup/updaters.d
The genup utility can be invoked in non-interative (default) or interactive mode (see the --ask option in the manpage). Non-interactive mode is suitable for use in a scripted invocation, for example as part of a nightly cron(8) job.
genup is best installed (on Gentoo) via its ebuild, available as part of the sakaki-tools overlay. Full instructions are provided as part of the Sakaki's EFI Install Guide tutorial, on the Gentoo wiki.