postfwd2 - chroot setup
=======================
If you care about security and want to run postfwd2 within a chroot environment you have to setup it up before. This document will give you an idea about what has to be prepared.

How to create a minimal chroot environment for postfwd2
=======================================================

Tested with SLES 11 x86_64, customize this to suit your specific system.
For example, on SLES 10 x86_64, use perl version 5.8.8 instead of 5.10.0
and glibc version 2.4 instead of 2.11.1.

cd $CHROOTDIR
for dir in tmp dev var var/tmp etc lib64 usr usr/lib usr/lib/perl5 \
  usr/lib/perl5/site_perl \
  usr/lib/perl5/site_perl/5.10.0 \
  usr/lib/perl5/site_perl/5.10.0/Net \
  usr/lib/perl5/site_perl/5.10.0/Net/Server \
  usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto ; do
    mkdir $dir
    chmod --reference /$dir $dir
    chown --reference /$dir $dir
done
for file in dev/null etc/protocols etc/localtime etc/resolv.conf \
  lib64/libnss_files-2.11.1.so lib64/libnss_files.so.2 \
  usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto/TCP.pm \
  usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto/UNIX.pm ; do
    cp -p /$file $file
done
grep nobody /etc/passwd > etc/passwd
grep nobody /etc/group > etc/group
echo -e 'passwd: files\ngroup: files\nprotocols: files' > etc/nsswitch.conf

=> Configure your syslog daemon to listen to $CHROOTDIR/dev/log:
    echo 'SYSLOGD_ADDITIONAL_SOCKET_POSTFWD="$CHROOTDIR/dev/log"' \
      >> /etc/sysconfig/syslog
    /etc/init.d/syslog restart

=> Place your postfwd configuration in $CHROOTDIR:
    cp $POSTFWDCONF $CHROOTDIR/etc/postfwd.conf

=> Start postfwd2:
    /usr/local/sbin/postfwd2 --file=/etc/postfwd.conf --chroot=$CHROOTDIR


List of directories
===================

tmp
lib64
dev
var
var/tmp
etc
usr
usr/lib
usr/lib/perl5
usr/lib/perl5/site_perl
usr/lib/perl5/site_perl/5.10.0
usr/lib/perl5/site_perl/5.10.0/Net
usr/lib/perl5/site_perl/5.10.0/Net/Server
usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto


List of files
=============

lib64/libnss_files.so.2
lib64/libnss_files-2.11.1.so
dev/null
dev/log
etc/localtime
etc/protocols
etc/postfwd.conf
etc/nsswitch.conf
etc/passwd
etc/resolv.conf
etc/group
usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto/UNIX.pm
usr/lib/perl5/site_perl/5.10.0/Net/Server/Proto/TCP.pm

Thanks to Lukas Wunner for providing this howto and the patch for postfwd2!

