Provided by: masqmail_0.2.30-1_amd64 bug

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.  postmaster 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)