Paludis Logo Introduction Hooks general.conf bashrc
Bugs, Requests, Support Syncers keywords.conf / platforms.conf suggestions.conf
Overview Fetchers use.conf / options.conf sets/
FAQ Env Vars licenses.conf / licences.conf repositories/
Clients File Formats mirrors.conf  
Configuration Dep Specs output.conf  
API specpath.conf package_mask.conf  

Fetchers

Overview

Paludis makes use of scripts called 'fetchers' to do most downloading. Fetchers can be added for additional protocols (for example, if you need to use a third party ebuild where upstream distributes its sources via Gopher), and built-in fetchers can be replaced (for example, if you want to use something other than wget to fetch via http).

Standard Fetchers

Paludis ships with the following fetcher protocols:

User Defined Fetchers

To write your own fetcher for protocol proto, create an executable script named doproto (the do prefix is essential). Fetchers may be located in any of the following directories:

Paludis places its own fetchers in LIBEXECDIR/fetchers/doproto. This directory is not for end user use.

A fetcher is called with two parameters, the source URI and the destination filename. It indicates success or failure via its exit status.

For examples, consult the built-in fetchers, which can be found in LIBEXECDIR/paludis/fetchers/.