masqmail.get(5) 						   File Formats 						   masqmail.get(5)

NAME

       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.

       port = number

	      The port number of server to connect to.

	      Default: 110.

       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
	      is assumed to be an MX pointer to a list of host names, these will be tried each in order  (lowest  preference  value  first,  equal
	      preference  values  in  random  order).	For `dns_a', the domain is assumed to be an A pointer.	For `byname', the library function
	      gethostbyname(3) will be used.

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

       user = string

	      Your login name.

       pass = string

	      Your password.

       address = address

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

       return_path = address

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

	      It is in most cases not useful to set this to the same address as the `address' option as this may generate multiple bounces.  post-
	      master is recommended.

       do_keep = boolean

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

       do_uidl = boolean

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

       do_uidl_dele = boolean

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

       max_size = numeric

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

       max_count = numeric

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

       max_size_delete = boolean

	      If max_size > 0 and do_uidl_dele is set, delete messages that are larger than max_size on the server WITHOUT  retrieving	them.	Be
	      careful with this option.

	      Default: false

       wrapper = command

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

	      Example for ssl tunneling:

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

AUTHOR

       Masqmail was written by Oliver Kurth.  It is now maintained by Markus Schnalke <meillo@marmaro.de>.

       You will find the newest version of masqmail at http://marmaro.de/prog/masqmail/.  There is also a mailing list, you will find  information
       about it at masqmail's main site.

BUGS

       Please report bugs to the mailing list.

SEE ALSO

       masqmail(8), masqmail.route(5), masqmail.conf(5)

masqmail-0.2.30 						    2011-07-27							   masqmail.get(5)