meillo@56:
meillo@56:

masqmail.get

meillo@56:

masqmail get configuration file

meillo@56: meillo@56: meillo@56:

Description

meillo@56:

This man page describes the options available for the meillo@56: masqmail get configuration.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

Options

meillo@56: meillo@56: meillo@56: meillo@56:

protocol = string

meillo@56: meillo@56:

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

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

server = string

meillo@56: meillo@56:

The server you get your mail from.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

resolve_list = list

meillo@56: meillo@56:

Specify the method how the domain of the server is resolved. Possible values are meillo@56: dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX meillo@56: pointer to a list of host names, these will be tried each in order meillo@56: (lowest preference value first, equal preference values in random meillo@56: order). For 'dns_a', the domain is assumed to be an A pointer. For meillo@56: 'byname', the library function gethostbyname (3) will be used.

meillo@56:

The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

user = string

meillo@56: meillo@56:

Your login name.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

pass = string

meillo@56: meillo@56:

Your password.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

address = address

meillo@56: meillo@56:

The address where the retrieved mail should be sent to. It can be meillo@56: any address, but you probably want to set this to a local address on meillo@56: your LAN.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

return_path = address

meillo@56: meillo@56:

If set, masqmail sets the return path to this address. Bounces meillo@56: generated during further delivery will be sent to this address. If meillo@56: unset, masqmail looks for the Return-Path: header in the mail, if meillo@56: this does not exist it uses the From: address and if this fails, meillo@56: postmaster will be used. meillo@56:

meillo@56: It is in most cases not useful to set this to the same address as meillo@56: the 'address' option as this may generate multiple bounces. meillo@56: postmaster is recommended.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

do_keep = boolean

meillo@56: meillo@56:

If you want to keep your mail on the server after you retrieved it, meillo@56: set this to true. It is recommended that you also set do_uidl, meillo@56: otherwise you will get the mail again each time you connect to the meillo@56: server. Masqmail does not check any headers before it retrieves mail, meillo@56: which may mark it as already fetched. Note that this behaviour is meillo@56: different to that of fetchmail. The default is false.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

do_uidl = boolean

meillo@56: meillo@56:

If set, MasqMail keeps a list of unique IDs of mails already meillo@56: fetched, so that they will not be retrieved again. Default is false.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

do_uidl_dele = boolean

meillo@56: meillo@56:

If set, and do_uidl is also set, MasqMail sends a delete (DELE) meillo@56: command to the server for each message uid in the uid listing at the meillo@56: beginning of the session. This prevents mail to be left on the server if meillo@56: masqmail gets interrupted during a session before it can send the QUIT meillo@56: command to the server. Default is false. meillo@56:

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

max_size = numeric

meillo@56: meillo@56:

If set to a value > 0, only messages smaller than this in bytes will be meillo@56: retrieved. The default is 0.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

max_count = numeric

meillo@56: meillo@56:

If set to a value > 0, only max_count messages will be retrieved. meillo@56: The default is 0.

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

wrapper = command

meillo@56: meillo@56:

If set, instead of opening a connection to a remote server, command will meillo@56: be called and all traffic will be piped to its meillo@56: stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.

meillo@56:

Example for ssl tunneling:

meillo@56:

wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"

meillo@56: meillo@56: meillo@56: meillo@56: meillo@56: meillo@56:

Author

meillo@56: meillo@56:

masqmail was written by Oliver Kurth meillo@56:

You will find the newest version of meillo@56: masqmail at http://masqmail.cx/masqmail/ or search for it meillo@56: in freshmeat (http://www.freshmeat.net). There is also a mailing list, meillo@56: you will find information about it at masqmails main site.

meillo@56: meillo@56: meillo@56: meillo@56:

Bugs

meillo@56: meillo@56:

You should report them to the mailing list.

meillo@56: meillo@56: meillo@56: meillo@56:

See also

meillo@56: meillo@56:

meillo@56: masqmail, masqmail.route, masqmail.conf meillo@56:

meillo@56: meillo@56: meillo@56: meillo@56:

Comments

meillo@56: meillo@56:

This man page was written using xml2man by the same meillo@56: author.

meillo@56: meillo@56: meillo@56: meillo@56:
meillo@56: