Deltup/Paludis

This is a guide for enabling getdelta/deltup support for Paludis users.

Introduction

NOTE: This is verbatim from Deltup
Deltup is a program that allows you to fetch the changes to a program, instead of the entire tarball. In other words if you already have cool-app-1.0.tar.bz and a new version is released, instead of having to download cool-app-1.1.tar.bz you would only have to download the minor differences between the two ( aka patch ). This howto is an absolute must for dialup users.

Installation

First, emerge the stuff that's in portage

# echo "app-portage/deltup ~x86" >> /etc/portage/package.keywords
# echo "dev-util/bdelta ~x86" >> /etc/portage/package.keywords
# emerge bdelta deltup

If you are on AMD64, change ~x86 to ~amd64 accordingly.

By default you get a getdelta.sh script for portage which doesn't work appropriately with paludis. Therefore the modified getdelta.sh should be obtained from the Paludis Trac ticket #68[1] which is named getdelta-paludis.sh

• You will find different versions of the dohttp and getdelta-paludis.sh scripts. e.g. dohttp.7, get-delta-paludis.2.sh so chose likely the more recent of each one.

• This is done by clicking the corresponding attachment and then the button at the bottom named Download in other formats: Original Format.

• Next, copy the dohttp.# script to your system directory: $SHAREDIR/paludis/fetchers/ which is usally /usr/share/paludis/fetchers, renaming it to dohttp. And copy accordingly the getdelta-paludis.#.sh script to /usr/bin/getdelta-paludis.sh.

Thus you wont override the original fetcher which is removed every time you update paludis. --Gh 19:31, 31 January 2008 (UTC)

Finally, do remember to run as root "chmod +rx /usr/bin/getdelta-paludis.sh" and /usr/share/paludis/fetchers/dohttp. Wrong file permissions are usual cause of silly errors.

Configuration

In order to enable deltup for paludis, you must edit /etc/${PALUDIS_CONFDIR}/bashrc (which usually resolves to /etc/paludis/bashrc):

...
export DELTUP='/usr/bin/getdelta-paludis.sh'
export USE_GETDELTA='yes'
...

Tuning of the script is accomplished by editing /etc/deltup/getdelta.rc, the configuration file it shares with normal deltup.

What if digest verification fails?

NOTE: This is verbatim from Deltup
Due to the on-the-fly-generation of the package-files the digest verification may fail. If you are sure that the package has been downloaded correctly, you can run

ebuild /path/to/ebuild digest to re-digest the file and try to emerge the package.

In any case you should try first by removing the file from /usr/portage/distfiles manually, trying to sync and fetch once again later.