masqmail-0.2

annotate examples/example.route @ 92:10d00e3235f2

updated docs (online_file, mserver_iface) - the default location of the online_file is /var/run/masqmail/masqmail-route - the online file can and should (!) end with a newline (this once was different) - marked the online detect method `mserver' as obsolete
author meillo@marmaro.de
date Mon, 21 Jun 2010 10:04:36 +0200
parents
children
rev   line source
meillo@0 1 # Example route file for masqmail
meillo@0 2 # see also: man 5 masqmail.route
meillo@0 3
meillo@0 4 #
meillo@0 5 # mail properties tested for:
meillo@0 6 #
meillo@0 7
meillo@0 8 # users that can send mail over this connection:
meillo@0 9 # this is a list of the local parts of the original return addresses, as they are
meillo@0 10 # configured with your mail client. If not set, anybody may send.
meillo@0 11
meillo@0 12 allowed_mail_locals = "okurth"
meillo@0 13
meillo@0 14 # local_hosts and local_nets will be checked before this.
meillo@0 15 # cpwright.com uses the dialup up list of dul.maps.vix.com,
meillo@0 16 # so I cannot send any mail over this connection to that domain.
meillo@0 17 # There are probably many others... :-( (No, this is okay. Nobody
meillo@0 18 # wants his mailbox stuffed to the ceiling with spam...)
meillo@0 19 #
meillo@0 20 # You will find this necessary only if you send mail directly
meillo@0 21 # (if mail_host is not set below)
meillo@0 22
meillo@0 23 not_allowed_rcpt_domains = "cpwright.com"
meillo@0 24
meillo@0 25 #
meillo@0 26 # settings:
meillo@0 27 #
meillo@0 28
meillo@0 29 # the mail server which relays mail for you:
meillo@0 30 # if this is not set, mail will be sent directly.
meillo@0 31 # If your ISP gives has a mail server, it is wiser to use it:
meillo@0 32
meillo@0 33 mail_host = "mail.isp.com"
meillo@0 34
meillo@0 35 # Make picky servers happy:
meillo@0 36 # If set, we look up our own name as seen from the network
meillo@0 37 # and send this in our HELO/EHLO message. Otherwise we send our host name,
meillo@0 38 # which is probably different for dialup conections and may be unknown outside.
meillo@0 39 # Some servers complain,
meillo@0 40 # which is really crazy, since it is senseless to lie about it...
meillo@0 41 # Unfortunately, some ISPs do not give you a name, just an ip address. In this case,
meillo@0 42 # we have a delay until the DNS lookup fails.
meillo@0 43
meillo@0 44 do_correct_helo = true
meillo@0 45
meillo@0 46 # 'forge' headers:
meillo@0 47
meillo@0 48 # return path and From: address are TWO different things:
meillo@0 49 #
meillo@0 50 # the return path is address where delivery failure messages will go
meillo@0 51 # to, and this address will be checked by many MTAs in the outside
meillo@0 52 # world, so it should be valid. It canNOT contain a real name:
meillo@0 53 # 'miller@foo.com' is a valid return path, but 'Charlie Miller <miller@foo.com>' is NOT.
meillo@0 54 #
meillo@0 55 # The From: address is the address the recipient sees, and where
meillo@0 56 # replies will go to (if you do not set a Reply-to header). In most
meillo@0 57 # cases it corresponds to the return path, but this is not
meillo@0 58 # required. It CAN have a real name, both examples for Charlie above
meillo@0 59 # are correct, and it is more pretty to include a real name.
meillo@0 60 #
meillo@0 61 # The return path:
meillo@0 62 # if we send the mail directly, we can set any valid address here,
meillo@0 63 # use the one you prefer to get error messages to:
meillo@0 64 # Use EITHER set_return_path_domain OR map_return_path_addresses
meillo@0 65 #
meillo@0 66 # this sets the return path kurth@anywhere.org to kurth@innominate.de
meillo@0 67 #set_return_path_domain = "innominate.de"
meillo@0 68 # this sets okurth@somewhere.else.org to kurth@innominate.de, and
meillo@0 69 # leaves all other addresses untouched:
meillo@0 70 map_return_path_addresses = "okurth: kurth@innominate.de"
meillo@0 71
meillo@0 72 # 'From:' header:
meillo@0 73 # Use EITHER set_h_from_domain OR map_h_from_addresses
meillo@0 74 #set_h_from_domain = "uni-sw.gwdg.de"
meillo@0 75 map_h_from_addresses = "okurth: Oliver Kurth <kurth@innominate.de>"
meillo@0 76
meillo@0 77 # if your mail server outside uses the AUTH machanism, set the following.
meillo@0 78 # You need to compile masqmail with AUTH support (--enable-auth option for ./configure):
meillo@0 79 # for auth_name, only 'cram-md5' and 'login' are supported.
meillo@0 80 # see also: man 5 masqmail.route
meillo@0 81
meillo@0 82 #auth_name="cram-md5"
meillo@0 83 #auth_login="yourname"
meillo@0 84 #auth_secret="dontTellAnyBody"
meillo@0 85
meillo@0 86 # if your mail server requires smtp after POP (eg. gmx), set this.
meillo@0 87 # It is not necessary if you fetch from the pop server just before you
meillo@0 88 # send mail (either masqmail, fetchmail or any other pop client).
meillo@0 89 # Set it to a get file.
meillo@0 90 # You need to compile masqmail with pop3 support (default)
meillo@0 91 # pop3_login = "/etc/masqmail/example.get"
meillo@0 92 # see also: man 5 masqmail.route, man 5 masqmail.get