Das XCLIENT 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 zur Verifikation weiterzugeben. Dies wird erreicht indem das XCLIENT Schlüsselwort zusammen mit Parametern gesendet wird.

Das XCLIENT Protokoll kann auch verwendet werden, um die korrekte Einrichtung der Filterregeln eines Postfix Servers zu testen. Dazu wird zusammen mit diesem Modul das Script xclienttest.pl installiert. Geben Sie nach der Installation "perldoc xclienttest.pl" ein, um die Dokumentation dazu zu lesen.

Download Net-SMTP-XCLIENT-0.04.tar.gz

Perldoc Documentation

perldoc Net::STMP::XCLIENT

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

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

DESCRIPTION
    The XCLIENT protocol is an extension to the standard SMTP verbs to allow
    filtering proxies to delegate tasks like recipient verification to an
    upstream MTA. This is done by using the XCLIENT 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

USAGE
  Constructor
    new ($smtphost[, param => value[, ...]])
        The constructor for Net::SMTP::XCLIENT 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
    xclient_ok ()
        Takes no paramters. Checks if the server returned the XCLIENT
        keyword in its status after the EHLO was issued. Returns a true
        value on success, false on failure.

    xclient ( param1 => value1, ... )
        Issues an xclient command to the server with the given parameters.
        Parameters can be NAME, ADDR, PROTO and HELO. 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.

  XCLIENT Parameters
    NAME
        The alternative client name that is to be supplied via the XCLIENT
        command. "[UNAVAILABLE]" and "[TEMPUNAVAIL]" are both valid options
        for this paramter.

    ADDR
        The IPV4 or IPV6 client address that is to be supplied via the
        XCLIENT command. If the address is an IPV6 address, is has to be
        prefixed with "IPV6:". Also can be "[UNAVAILABLE]".

        Upper and lower case are both acceptable in the value.

    PROTO
        The SMTP client protocol (SMTP or ESMTP) to be supplied via the
        XCLIENT 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
        XCLIENT command. "[UNAVAILABLE]" is also a valid option for this
        paramter.

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/XCLIENT_README.html, pod documentation for
    Net::SMTP, pod documentation for Convert::XText