Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
[PALUDIS] HOWTO get started with Paludis, Extras and hooks
View unanswered posts
View posts from last 24 hours

Reply to topic    Gentoo Forums Forum Index Unsupported Software
View previous topic :: View next topic  
Author Message

Joined: 24 Apr 2003
Posts: 156

PostPosted: Wed Apr 04, 2007 2:47 am    Post subject: [PALUDIS] HOWTO get started with Paludis, Extras and hooks Reply with quote

v1.0 - 20070404
HOWTO use Paludis, Paludis-Extras overlay, hooks and automatically show ebuild warnings at end of compile.

This is a step by step guide to
* installing Paludis
* setting it up to use the Paludis-Extras overlay
* get important ebuild/elog warnings presented at the end of a compilation
* learning how to use eselect to manage hooks in Paludis instead of manual symlinking
* install a hook for eix to automatically update after a Paludis --sync

This HOWTO was written for Paludis 0.22.2. Future Paludis versions might not be 100% compatible with this HOWTO. At least make sure to read the changelog ( if you use a newer version.


This HOWTO is meant for people that have a resonably good understanding of how Linux in general and Gentoo especially works and would like to try out Paludis. That means people that by them self can find the information and know how to do the things presented here but, like me, dont nessecarily want or have time to spend several hours reading manuals and setting up config files just to try out what Paludis can offer them. However, you ARE messing around with a CORE component of Gentoo, with high potential of breaking things badly if you just headlessly start trying out commands. Also remember Paludis is currently going through rapid development and things can (and likely will) break from one version to the next (especially going from a 0.x.y to a 0.(x+2).0 version). So be carefull and think about what you are doing!

Also, if you get yourself into a mess, please DO NOT bug the people behind Paludis. This goes double for any issues you might have with Paludis-Extras. Questions about such issues should be directed towards the Paludis-Extras people, not the main Paludis app devs.

Installing Paludis

If you havn't already, start with installing Paludis. If you are running ARCH this probably means you will need to add something like the following in /etc/portage/package.keywords
sys-apps/paludis ~x86
virtual/c++-tr1-memory ~x86
virtual/c++-tr1-functional ~x86
virtual/c++-tr1-type-traits ~x86

Then just emerge paludis -p

The Paludis migration guide ( has a very handy script that does a resonably good job of porting your current Portage config files, including any local or remote overlays you might have.

Run it and check that the created files looks OK.

Setting up Paludis-Extras overlay
Next we need to install the Paludis-Extras overlay to get access to all the neat extra stuff for Paludis. However again, do note that what is available in the Paludis-Extras overlay is NOT supported by the Paludis devs, but are third party addons.

Create the file /etc/paludis/repositories/paludis-extras.conf

Here is an example paludis-extras.conf
# location = ${ROOT}/usr/local/portage/paludis-extras
master_repository = gentoo
sync = rsync://
format = ebuild
importance = 10
cache = /var/empty
write_cache = /var/cache/paludis/metadata
#Important, before turning on the below cache, read up on how it works!
#To enable names_cache comment /var/empty and uncomment next line
names_cache = /var/empty
#names_cache = ${location}/.cache/names

If you are unsure about what to enter as your location the default PORTDIR_OVERLAY is /usr/local/portage. If you already have overlays there or somewhere else, it might be most convenient to place paludis-extras in the same place. Other good suggestions are eg /var/paludis/repositories/paludis-extras, but you can put it any where you like, even /blueberry/jam/sandwich/paludis-extras if you feel like being very exotic. Just remember to manually create the directories if they don't exsist already since Paludis for security reasons can't create them for you.

Now do a paludis --sync to update the main gentoo ebuild tree and all overlays.

Installing Paludis-Extras
After we finished syncing we need to start installing the extras we will use.

First in /etc/paludis/use.conf add:
* PALUDIS_HOOKS: -* eselect update-eix

Then issue the following command:
paludis --dl-upgrade as-needed --dl-new-slots as-needed -i paludis-hooks -p

The reason we are using the two --dl-x options is becuase right now we want to avoid the risk of updating/installing a large ammount of packages if you dont have a fully updated system. You can do that later if you wish, after we have properly enabled the displaying of elog info at the end of the compile.

If you are not running ~ARCH you might also need to add something like the following in /etc/paludis/keywords.conf
app-paludis/paludis-hooks-update-eix ~x86
app-admin/eselect-paludis-hooks ~x86
app-paludis/paludis-hooks ~x86

Setting up the Hooks
After the installation is completed it's time to set up the hooks. If you are not already familiar with the tool eselect write the following commands one by one and read the output. That should be enough to get you up to speed since it's usage is quite intuitive.

eselect paludis-hook
eselect paludis-hook list

To enable the elog output at the end of compilation

eselect paludis-hook enable demos-elog
eselect paludis-hook enable demos-elog-eerror
eselect paludis-hook enable demos-elog-ewarn

and optionally also
eselect paludis-hook enable demos-elog-einfo

If for some reason Paludis fails to properly finish compilation and thus doesnt display the wanted information you will still be able to manually find and read the logfile in /var/tmp/paludis/elog.*

Other usefull advice

* It's a very good idea to issue the command eselect news list to find out the latest important info about paludis and the installed extras.

* Adding paludis to your useflags in /etc/paludis/use.conf and emerging some of the other tools especially modified to be used with

* If you install Paludis with the ruby useflag you get access to the tool check_linkage which like revdep-rebuild can help you fix various packages broken due to updated dependencies.
# ruby /usr/share/paludis/ruby/demos/check_linkage.rb
Back to top
View user's profile Send private message

Joined: 20 Dec 2005
Posts: 5803
Location: Vienna, Austria; Germany; hello world :)

PostPosted: Wed Apr 04, 2007 9:55 am    Post subject: Reply with quote


thanks, this way I won't forget any necessary when moving to paludis in the future :)

hopefully this will encourage more users to try out paludis
_________________ BFS, CFS,THP,compaction, zcache or TOI
Hardcore Linux user since 2004 :D
Back to top
View user's profile Send private message

Joined: 24 Apr 2003
Posts: 156

PostPosted: Fri Apr 06, 2007 5:24 am    Post subject: Reply with quote

You are most welcome and I hope you will find it usefull :)
Back to top
View user's profile Send private message

Joined: 17 Apr 2005
Posts: 278
Location: Magdeburg

PostPosted: Tue Sep 25, 2007 9:54 am    Post subject: Reply with quote

only minor change:

* PALUDIS_HOOKS: -* eselect update-eix


*/* PALUDIS_HOOKS: -* eselect update-eix

How can I find out what global keyword are supported in .conf files -> like the PALUDIS_HOOKS keyword is?
Optimism is solely an absence of information. / Optimismus ist nur ein Mangel an Information.
(Arthur Schopenhauer)
Back to top
View user's profile Send private message
Jerry McBride

Joined: 14 Jan 2008
Posts: 2

PostPosted: Mon Jan 14, 2008 1:52 pm    Post subject: Next step? Reply with quote

Ok... Paludis is installed. Paludis-extras is installed. Everything works and boy... IS THIS GOOD. :D Thank you...

Now the next step... How does one go about getting rid of Portage? Is it enough to install the tools from paludis-extras then remove portage via Paludis? Is it that simple?

Thanks, again. :)
Back to top
View user's profile Send private message

Joined: 06 Jan 2006
Posts: 1160
Location: in bed in front of the computer

PostPosted: Tue Jan 15, 2008 1:31 am    Post subject: Reply with quote

No it is not that simple.

Many packages in gentoo tree depend on portage and if you uninstall portage it will be pulled in at the next world update.
Nature does not hurry, yet everything is accomplished.
Lao Tzu
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Unsupported Software All times are GMT
Page 1 of 1

Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum