masqmail.get

masqmail get configuration file

Description

This man page describes the options available for the masqmail get configuration.

Options

protocol = string

The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default.

server = string

The server you get your mail from.

resolve_list = list

Specify the method how the domain of the server is resolved. Possible values are dns_mx, dns_a, byname. For 'dns_mx', the domain

If the string begins with a slash '/', it it assumed that it is a filename, and the first line of this file will be used. Usually this will be '/etc/mailname' to make masqmail conform to Debian policies.

It is not used to find whether an address is local. Use local_hosts for that.

remote_port = n

The remote port number to be used. This defaults to port 25.

This option is deprecated. Use host_name in the route configuration instead. See masqmail.route.

local_hosts = list

A semicolon ';' separated list of hostnames which are considered local. Normally you set it to "localhost;foo;foo.bar.com" if your host has the fully qualified domain name 'foo.bar.com'.

local_nets = list

A semicolon ';' separated list of hostnames which are on the 'local' net. Delivery to these hosts is attempted immediately. You can use patterns with '*', eg. "*.bar.com".

local_addresses = list

A semicolon ';' separated list of fully qualified email-addresses which are considered local although their domain name part is not in the list of local_hosts.

For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain. But there are other persons @yourdomain which are NOT local. So you can not put yourdomain to the list of local_hosts. If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put

local_addresses = "person1@yourdomain;person2@yourdomain"

to your masqmail.conf.

not_local_addresses = list

A semicolon ';' separated list of fully qualified email-addresses which are considered not local although their domain name part is in the list of local_hosts.

This ist the opposite of the previous case. The majority of addresses of a specific domain are local. But some users are not. With this option you can easily exclude these users.

Example:

local_hosts = "localhost;myhost;mydomain.net"

not_local_addresses = "eric@mydomain.net"

listen_addresses = list

A semicolon ';' separated list of interfaces on which connections will be accepted. An interface ist defined by a hostname, optionally followed by a colon ':' and a number for the port. If this is left out, port 25 will be used.

You can set this to "localhost:25;foo:25" if your hostname is 'foo'.

Note that the names are resolved to IP addreses. If your host has different names which resolve to the same IP, use only one of them, otherwise you will get an error message.

do_save_envelope_to = boolean

If this is set to true, a possibly existing Envelope-to: header in an incoming mail which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header.

This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail, and the server supports Envelope-to: headers, and you want to make use of those with a mail filtering tool, eg. procmail. It cannot be preserved because masqmail sets such a header by itself.

Default is false.

do_relay = boolean

If this is set to false, mail with a return path that is not local and a destination that is also not local will not be accepted via smtp and a 550 reply will be given. Default is true.

Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients.