Das XFORWARD Protokoll ist eine Erweiterung des Standard-SMTP-Wortschatzes, die vom Postfix Mailserver eingeführt wurde, um es SMTP Filter Proxies zu erlauben, die ursprünglichen Clientinformationen an einen übergeordneten Mailserver weiterzugeben. Dies wird erreicht indem das XFORWARD Schlüsselwort zusammen mit Parametern gesendet wird.

Download Net-SMTP-XFORWARD-0.02.tar

Perldoc Documentation

perldoc Net::SMTP::XFORWARD

NAME
    Net::SMTP::XFORWARD - XFORWARD protocol support for Net::SMTP

SYNOPSIS
      use Net::SMTP::XFORWARD;
  
      my $smtpx = Net::SMTP::XFORWARD->new( 'some.smtp.host' );
  
      die "Server does not support XFORWARD!" if( ! $smtpx->XFORWARD_ok() );
  
      $smtpx->XFORWARD(
        NAME => "other.client.host",
        HELO => "helo.from.client",
        SOURCE => "local"
      );

DESCRIPTION
    The XFORWARD protocol is an extension to the standard SMTP verbs to
    allow filtering proxies to pass on original client information to an
    upstream MTA. This is done by using the XFORWARD verb together with a
    number of paramters:

      NAME   Overrides the client name from name resolution
      ADDR   Overrides the client IP address from the connection info
      PROTO  Set SMTP/ESMTP protocol independent of prior HELO/EHLO
      HELO   Set the value for the HELO/EHLO verb
      SOURCE Whether the message was submitted locally or via the net

USAGE
  Constructor
    new ($smtphost[, param => value[, ...]])
        The constructor for Net::SMTP::XFORWARD is simply passed through to
        the Net::SMTP class. It takes the SMTP host to connect to as a first
        paramter. Subsequent paramters are key => value pares. See the
        documentation for Net::SMTP for details.

  Methods
    XFORWARD_ok ()
        Takes no paramters. Checks if the server returned the XFORWARD
        keyword in its status after the EHLO was issued. Returns a true
        value on success, false on failure.

    XFORWARD ( param1 => value1, ... )
        Issues an XFORWARD command to the server with the given parameters.
        Parameters can be NAME, ADDR, PROTO, HELO and SOURCE. The passed
        values will be encoded in xtext encoding.

    compat ( )
        Enables compatibility mode for Postfix versions < 2.3 by turning off
        xtext encoding for XCLIENT attribute values.

  XFORWARD Parameters
    NAME
        The alternative client name that is to be supplied via the XFORWARD
        command, or "[UNAVAILABLE]".

    ADDR
        The client address that is to be supplied via the XFORWARD command.
        This address can be a non-IP-address. "[UNAVAILABLE]" is also a
        valid value for this paramter.

    PROTO
        The SMTP client protocol (SMTP or ESMTP) or a non-SMTP-protocol to
        be supplied via the XFORWARD command, this can differ from the
        result of a previous HELO/EHLO command.

    HELO
        The alternative HELO/EHLO string to be passed to the server via the
        XFORWARD command. "[UNAVAILABLE]" is also a valid option for this
        paramter.

        The hostname can also be a non-DNS hostname.

    SOURCE
        The way the message was delivered, either "LOCAL" if the message was
        submitted locally, "REMOTE" if it was submitted via the network, or
        "[UNAVAILABLE]" if this information is unkown.

        This parameter may influence the way the downstream MTA might treat
        headers and addresses in the mail, depending on whether it was
        submitted locally or via a remote mechanism.

        Defaults to "LOCAL".

BUGS
    None known yet.

AUTHOR
        Chr. Winter 
    
        http://www.a-za-z0-9.de/perlmodules/

COPYRIGHT
    (c) 2006 Chr. Winter

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

    The full text of the license can be found in the LICENSE file included
    with this module.

SEE ALSO
    http://www.postfix.org/XFORWARD_README.html, pod documentation for
    Net::SMTP, pod documentation for Convert::XText