pfixtools

The pfixtools project is a collection of postfix-related tools. The pfixtools are written in C.

The project currently includes two daemons:

pfix-srsd

pfix-srsd is a tcptable lookup service for postfix which performs SRS encoding and decoding.

postlicyd

postlicyd is a very flexible policy daemon for postfix. It can be used as a replacement for tools like whitelister and postgrey. It is able to access R(H)BL databases by DNS or by directly reading rbldns zone files. It also supports SPF and provides rate control policies.

Download

The sources are availble from the  git repository of the project.

• version 0.8 (October 26th, 2009): pfixtools v0.8
• latest sources:  pfixtools snapshot
• from git: git clone http://git.mymind.fr/git/pfixtools.git

Previous versions (see ChangeLog):

• version 0.7 (September 15th, 2009): pfixtools v0.7
• version 0.6 (February 26th, 2009): pfixtools v0.6
• version 0.5 (November 11th, 2008): pfixtools v0.5
• version 0.4 (October 17th, 2008): pfixtools v0.4

Installation

Supported platforms

The pfixtools have been currently successfully compiled and installed on the following platorms:

• Linux: gentoo, debian etch, debian lenny (stable), arch linux
• MacOS X 10.5 (Leopard), 10.6 (Snow Leopard)

Known bugs:

• dns lookup crashed on debian lenny due to a bug in the version of libunbound shipped in the distribution. A workaround is to manually install a more recent version of the library (known to work with libunbound 1.4).

Other platforms might work with some Makefile tuning if gcc is available.

Requirements

The following libraries are required to build and run the pfixtools 0.6:

•  libev
•  libsrs2 (pfix-srsd only)
•  tokyocabinet (postlicyd only)
•  libunbound (postlicyd only)
•  libpcre (postlicyd only)

The following are build-time dependencies:

• gcc: 4.0 or later
• pkg-config (postlicyd only)
• gperf (postlicyd only)
• libpcre3 (postlicyd only)
• xmlto, docbook-xsl and asciidoc to build the documentation (this is only a stub of documentation)

Compilation

To install the pfixtools, just run make all doc and sudo make install.

If you don't want to compile all the tools, you can run make toolname and sudo make install-toolname. You can also specify the installation prefix and a sandbox path sudo make install prefix=/my/prefix DESTDIR=/my/sandbox.

Legal

These programs are free softwares distributed AS IS. Please refer to the LICENSE file for details.

Authors:

•  Pierre Habouzit © 2006-2009: common library, pfix-srsd
•  Florent Bruneau © 2008-2010: common library, postlicyd

Contributors:

•  Aymeric Augustin © 2008: postgrey to postlicyd tool
• Nicolas Aupetit © 2008: debian packaging
•  Vincent Zanotti © 2009: build fixes
• Michael Scherer © 2009: build fixes