
        qmail-masq version 0.4 by Davide Giunchi (davidegiunchi@libero.it)

	   			      http://www.folug.linux.it/qmail-masq.html

1 - Topic and feature of qmail-masq
2 - Various
3 - Bugs
4 - Thanks
5 - License


 1 - TOPIC AND FEATURE OF qmail-masq

This is a perl program that works with qmail, it masquerade the internal mail 
users address with an external one when sending email from local network users 
to the external internet users.
It's useful when you have an internal qmail mail server that is configured with 
a nonexistent internet domain or a domain that you don't own, if you send an 
email from the internal network the adressee wouldn't be able to reply (or send
a new mail to that address) because this address doesn't really exist.
It could be useful even if you own the external domain and coincide to the 
internal one but you don't want your personal address to be show, so all the
reply will arrive to an unique email.
This program parse all mail, if one has field "From:" from an internal users
and "To:" or "CC" or "BCC" to an external one, it: modify the field "From" and 
"Return-Path" (and delete ununseful and dangerous "Sender", "X-Sender" and 
"Notified-to")  to make seems that the sender's email is another (it change 
the email but mantain the name of the sender).
You could also define some "exception": mail users that will not be masquerade
with the default adressee but with another specified one.

All parameters like: internal domain, default email with which masquerade and
exceptions in masquerading are settable from the configuration file 
/etc/qmail-masq.conf .

This from-header-rewrite function is already build-in in sendmail but not in qmail, 
so as i like to use qmail i've written this program to make this function available.

To install this program read the file INSTALL.

 2 - VARIOUS

You are encourage to contribute this program, if you have patch, suggestion or
critics please contact me.

I'm estimating the opportunity to write other perl programs to expand the 
qmail-rewrite-header features, if you know a feature that lack in qmail in this
topic, please contact me and explain your ideas.

Latest qmail-masq version can be found at 
http://www.folug.linux.it/qmail-masq.html

 3 - BUGS

If you find a bug, send me the original mail(s) that give problem and i will 
analize it.

 4 - THANKS

Ivan Fabris for his Perl suggestions and for some bugfixes.
Davide L. Nicol for his advice in the qmail mailing list.
Tobias Habermann, Walter and David Pisa for the "Return-Path"+"Notified-to" suggested-feature.
Jacek Kochan for one bugfix.
Andrea Chiumenti for one bugfix.

 5 - LICENSE

This program is Copyright(C) 2001 Davide Giunchi, and may be copied according to
the GNU GENERAL PUBLIC LICENSE (GPL) Version 2 or a later version.  A copy of 
this license is included with this package.  This package comes with no warranty
of any kind.
