Provided by: masqmail_0.2.27-1.2_i386 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)