    LMTP(8)                                                   LMTP(8)

    NAME
           lmtp - Postfix local delivery via LMTP

    SYNOPSIS
           lmtp [generic Postfix daemon options]

    DESCRIPTION
           The  LMTP  client processes message delivery requests from
           the queue manager. Each request specifies a queue file,  a
           sender address, a domain or host to deliver to, and recip-
           ient information.  This program expects to be run from the
           master(8) process manager.

           The  LMTP  client updates the queue file and marks recipi-
           ents as finished, or it informs  the  queue  manager  that
           delivery  should  be tried again at a later time. Delivery
           status reports are sent  to  the  bounce(8),  defer(8)  or
           trace(8) daemon as appropriate.

           The  LMTP  client connects to the destination specified in
           the message delivery  request.  The  destination,  usually
           specified in the Postfix transport(5) table, has the form:

           unix:pathname
                  Connect to the local  UNIX-domain  server  that  is
                  bound  to  the  specified  pathname. If the process
                  runs chrooted, an absolute pathname is  interpreted
                  relative to the changed root directory.

           inet:host, inet:host:port (symbolic host)

           inet:[addr], inet:[addr]:port (numeric host)
                  Connect to the specified IPV4 TCP port on the spec-
                  ified local or remote host. If no  port  is  speci-
                  fied,  connect  to the port defined as lmtp in ser-
                  vices(4).   If  no  such  service  is  found,   the
                  lmtp_tcp_port   configuration   parameter  (default
                  value of 24) will be used.

                  The  LMTP  client  does  not   perform   MX   (mail
                  exchanger) lookups since those are defined only for
                  mail delivery via SMTP.

           If  neither  unix:  nor  inet:  are  specified,  inet:  is
           assumed.

    SECURITY
           The LMTP client is moderately security-sensitive. It talks
           to LMTP servers and to DNS servers  on  the  network.  The
           LMTP client can be run chrooted at fixed low privilege.

    STANDARDS
           RFC 821 (SMTP protocol)
           RFC 1651 (SMTP service extensions)
           RFC 1652 (8bit-MIME transport)
           RFC 1870 (Message Size Declaration)
           RFC 2033 (LMTP protocol)
           RFC 2554 (AUTH command)
           RFC 2821 (SMTP protocol)
           RFC 2920 (SMTP Pipelining)

    DIAGNOSTICS
           Problems  and transactions are logged to syslogd(8).  Cor-
           rupted message files are marked so that the queue  manager
           can move them to the corrupt queue for further inspection.

           Depending on the setting of the notify_classes  parameter,
           the  postmaster is notified of bounces, protocol problems,
           and of other trouble.

    CONFIGURATION PARAMETERS
           Changes to main.cf are picked up automatically, as lmtp(8)
           processes  run  for only a limited amount of time. Use the
           command "postfix reload" to speed up a change.

           The text below provides  only  a  parameter  summary.  See
           postconf(5) for more details including examples.

    COMPATIBILITY CONTROLS
           lmtp_skip_quit_response (no)
                  Wait for the response to the LMTP QUIT command.

    TROUBLE SHOOTING CONTROLS
           debug_peer_level (2)
                  The  increment  in  verbose  logging  level  when a
                  remote client or server matches a  pattern  in  the
                  debug_peer_list parameter.

           debug_peer_list (empty)
                  Optional  list  of remote client or server hostname
                  or network address patterns that cause the  verbose
                  logging  level  to increase by the amount specified
                  in $debug_peer_level.

           error_notice_recipient (postmaster)
                  The recipient  of  postmaster  notifications  about
                  mail  delivery  problems that are caused by policy,
                  resource, software or protocol errors.

           notify_classes (resource, software)
                  The list of error classes that are reported to  the
                  postmaster.

    EXTERNAL CONTENT INSPECTION CONTROLS
           Available in Postfix version 2.1 and later:

           lmtp_send_xforward_command (no)
                  Send  an  XFORWARD  command to the LMTP server when
                  the LMTP LHLO server  response  announces  XFORWARD
                  support.

    SASL AUTHENTICATION CONTROLS
           lmtp_sasl_auth_enable (no)
                  Enable  SASL  authentication  in  the  Postfix LMTP
                  client.

           lmtp_sasl_password_maps (empty)
                  Optional LMTP client lookup tables with  one  user-
                  name:password entry per host or domain.

           lmtp_sasl_security_options (noplaintext, noanonymous)
                  What  authentication  mechanisms  the  Postfix LMTP
                  client is allowed to use.

    RESOURCE AND RATE CONTROLS
           In the text below, transport is the name of the service as
           specified in the master.cf file.

           lmtp_cache_connection (yes)
                  Keep Postfix LMTP client connections open for up to
                  $max_idle seconds.

           transport_destination_concurrency_limit ($default_destina-
           tion_concurrency_limit)
                  Limit the number of parallel deliveries to the same
                  destination via this mail delivery transport.

           transport_destination_recipient_limit   ($default_destina-
           tion_recipient_limit)
                  Limit the number of recipients per message delivery
                  via this mail delivery transport.

                  This parameter  becomes  significant  if  the  LMTP
                  client  is  used  for  local  delivery.   Some LMTP
                  servers can optimize delivery of the  same  message
                  to multiple recipients. The default limit for local
                  mail delivery is 1.

                  Setting  this  parameter  to  0  will  lead  to  an
                  unbounded  number of recipients per delivery.  How-
                  ever, this could be risky since  it  may  make  the
                  machine  vulnerable  to running out of resources if
                  messages are encountered with an inordinate  number
                  of  recipients.   Exercise  care  when setting this
                  parameter.

           lmtp_connect_timeout (0s)
                  The LMTP client time limit  for  completing  a  TCP
                  connection,  or  zero  (use  the  operating  system
                  built-in time limit).

           lmtp_lhlo_timeout (300s)
                  The LMTP client time limit for receiving  the  LMTP
                  greeting banner.

           lmtp_xforward_timeout (300s)
                  The LMTP client time limit for sending the XFORWARD
                  command, and for receiving the server response.

           lmtp_mail_timeout (300s)
                  The LMTP client time limit  for  sending  the  MAIL
                  FROM   command,   and   for  receiving  the  server
                  response.

           lmtp_rcpt_timeout (300s)
                  The LMTP client time limit for sending the RCPT  TO
                  command, and for receiving the server response.

           lmtp_data_init_timeout (120s)
                  The  LMTP  client  time  limit for sending the LMTP
                  DATA  command,  and  for   receiving   the   server
                  response.

           lmtp_data_xfer_timeout (180s)
                  The  LMTP  client  time  limit for sending the LMTP
                  message content.

           lmtp_data_done_timeout (600s)
                  The LMTP client time limit  for  sending  the  LMTP
                  ".", and for receiving the server response.

           lmtp_rset_timeout (120s)
                  The  LMTP  client  time  limit for sending the RSET
                  command, and for receiving the server response.

           lmtp_quit_timeout (300s)
                  The LMTP client time limit  for  sending  the  QUIT
                  command, and for receiving the server response.

    MISCELLANEOUS CONTROLS
           config_directory (see 'postconf -d' output)
                  The  default  location  of  the Postfix main.cf and
                  master.cf configuration files.

           daemon_timeout (18000s)
                  How much time a Postfix daemon process may take  to
                  handle  a  request  before  it  is  terminated by a
                  built-in watchdog timer.

           disable_dns_lookups (no)
                  Disable DNS lookups in the Postfix  SMTP  and  LMTP
                  clients.

           ipc_timeout (3600s)
                  The time limit for sending or receiving information
                  over an internal communication channel.

           lmtp_tcp_port (24)
                  The default TCP port that the Postfix  LMTP  client
                  connects to.

           max_idle (100s)
                  The  maximum  amount  of  time that an idle Postfix
                  daemon process waits for the next  service  request
                  before exiting.

           max_use (100)
                  The  maximal number of connection requests before a
                  Postfix daemon process terminates.

           process_id (read-only)
                  The process ID of a Postfix command or daemon  pro-
                  cess.

           process_name (read-only)
                  The  process  name  of  a Postfix command or daemon
                  process.

           queue_directory (see 'postconf -d' output)
                  The location of the Postfix top-level queue  direc-
                  tory.

           syslog_facility (mail)
                  The syslog facility of Postfix logging.

           syslog_name (postfix)
                  The  mail system name that is prepended to the pro-
                  cess  name  in  syslog  records,  so  that  "smtpd"
                  becomes, for example, "postfix/smtpd".

    SEE ALSO
           bounce(8), delivery status reports
           qmgr(8), queue manager
           postconf(5), configuration parameters
           services(4), Internet services and aliases
           master(8), process manager
           syslogd(8), system logging

    README FILES
           LMTP_README, Postfix LMTP client howto
           VIRTUAL_README, virtual delivery agent howto

    LICENSE
           The Secure Mailer license must be  distributed  with  this
           software.

    AUTHOR(S)
           Wietse Venema
           IBM T.J. Watson Research
           P.O. Box 704
           Yorktown Heights, NY 10598, USA

           Alterations for LMTP by:
           Philip A. Prindeville
           Mirapoint, Inc.
           USA.

           Additional work on LMTP by:
           Amos Gouaux
           University of Texas at Dallas
           P.O. Box 830688, MC34
           Richardson, TX 75083, USA

                                                              LMTP(8)