1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/examples/example.route	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,92 @@
     1.4 +# Example route file for masqmail
     1.5 +# see also: man 5 masqmail.route
     1.6 +
     1.7 +#
     1.8 +# mail properties tested for:
     1.9 +#
    1.10 +
    1.11 +# users that can send mail over this connection:
    1.12 +# this is a list of the local parts of the original return addresses, as they are
    1.13 +# configured with your mail client. If not set, anybody may send.
    1.14 +
    1.15 +allowed_mail_locals = "okurth"
    1.16 +
    1.17 +# local_hosts and local_nets will be checked before this.
    1.18 +# cpwright.com uses the dialup up list of dul.maps.vix.com,
    1.19 +# so I cannot send any mail over this connection to that domain.
    1.20 +# There are probably many others... :-( (No, this is okay. Nobody
    1.21 +# wants his mailbox stuffed to the ceiling with spam...)
    1.22 +# 
    1.23 +# You will find this necessary only if you send mail directly
    1.24 +# (if mail_host is not set below)
    1.25 +
    1.26 +not_allowed_rcpt_domains = "cpwright.com"
    1.27 +
    1.28 +#
    1.29 +# settings:
    1.30 +#
    1.31 +
    1.32 +# the mail server which relays mail for you:
    1.33 +# if this is not set, mail will be sent directly.
    1.34 +# If your ISP gives has a mail server, it is wiser to use it:
    1.35 +
    1.36 +mail_host = "mail.isp.com"
    1.37 +
    1.38 +# Make picky servers happy:
    1.39 +# If set, we look up our own name as seen from the network
    1.40 +# and send this in our HELO/EHLO message. Otherwise we send our host name,
    1.41 +# which is probably different for dialup conections and may be unknown outside.
    1.42 +# Some servers complain,
    1.43 +# which is really crazy, since it is senseless to lie about it...
    1.44 +# Unfortunately, some ISPs do not give you a name, just an ip address. In this case,
    1.45 +# we have a delay until the DNS lookup fails.
    1.46 +
    1.47 +do_correct_helo = true
    1.48 +
    1.49 +# 'forge' headers:
    1.50 +
    1.51 +# return path and From: address are TWO different things:
    1.52 +#
    1.53 +# the return path is address where delivery failure messages will go
    1.54 +# to, and this address will be checked by many MTAs in the outside
    1.55 +# world, so it should be valid. It canNOT contain a real name:
    1.56 +# 'miller@foo.com' is a valid return path, but 'Charlie Miller <miller@foo.com>' is NOT.
    1.57 +#
    1.58 +# The From: address is the address the recipient sees, and where
    1.59 +# replies will go to (if you do not set a Reply-to header). In most
    1.60 +# cases it corresponds to the return path, but this is not
    1.61 +# required. It CAN have a real name, both examples for Charlie above
    1.62 +# are correct, and it is more pretty to include a real name.
    1.63 +#
    1.64 +# The return path:
    1.65 +# if we send the mail directly, we can set any valid address here,
    1.66 +# use the one you prefer to get error messages to:
    1.67 +# Use EITHER set_return_path_domain OR map_return_path_addresses
    1.68 +#
    1.69 +# this sets the return path kurth@anywhere.org to kurth@innominate.de
    1.70 +#set_return_path_domain = "innominate.de"
    1.71 +# this sets okurth@somewhere.else.org to kurth@innominate.de, and
    1.72 +# leaves all other addresses untouched:
    1.73 +map_return_path_addresses = "okurth: kurth@innominate.de"
    1.74 +
    1.75 +# 'From:' header:
    1.76 +# Use EITHER set_h_from_domain OR map_h_from_addresses
    1.77 +#set_h_from_domain = "uni-sw.gwdg.de"
    1.78 +map_h_from_addresses = "okurth: Oliver Kurth <kurth@innominate.de>"
    1.79 +
    1.80 +# if your mail server outside uses the AUTH machanism, set the following.
    1.81 +# You need to compile masqmail with AUTH support (--enable-auth option for ./configure):
    1.82 +# for auth_name, only 'cram-md5' and 'login' are supported.
    1.83 +# see also: man 5 masqmail.route
    1.84 +
    1.85 +#auth_name="cram-md5"
    1.86 +#auth_login="yourname"
    1.87 +#auth_secret="dontTellAnyBody"
    1.88 +
    1.89 +# if your mail server requires smtp after POP (eg. gmx), set this.
    1.90 +# It is not necessary if you fetch from the pop server just before you
    1.91 +# send mail (either masqmail, fetchmail or any other pop client).
    1.92 +# Set it to a get file.
    1.93 +# You need to compile masqmail with pop3 support (default)
    1.94 +# pop3_login = "/etc/masqmail/example.get"
    1.95 +# see also: man 5 masqmail.route, man 5 masqmail.get