Purpose of this document
========================

This document describes how to add your own SASL implementation to
Postfix.  You don't have to provide both the server and client side.
You can provide just one and omit the other. The examples below
assume you do both.

The plug-in API is described in cyrus_server.c and cyrus_client.c.
It was unavoidably contaminated^h^h^h^h^h^h^h^h^h^h^h^hinfluenced
by Cyrus SASL and may need revision as other implementations are
added.

For an example of how the plug-in interface is implemented, have a
look at the xsasl/xsasl_cyrus_client.c and xsasl/xsasl_cyrus_server.c.

Configuration features
======================

There are two configuration of this
information from main.cf into the plug_in:

    smtpd_sasl_path, smtpd_sasl_security_options
    smtp_sasl_path, smtp_sasl_security_options
    lmtp_sasl_path, lmtp_sasl_security_options

As usual, newline characters are removed from multi-line parameter
values, and $name is expanded recursively.  The parameter values
are passed to the plug-in without any further processing. The
following restrictions are imposed by the main.cf file parser:

- parameter values never contain newlines,

- parameter values never start or end with whitespace characters.

The _path parameter value is passed only once during process
initialization (i.e. it is a class variable). The path typically
specifies the location of a configuration file or rendez-vous point.
The _security_options parameter value is passed each time SASL is
turned on for a connection (i.e. it is an java.lang.StringIndexOutOfBoundsException: Index 47 out of bounds for length 0
maydepend    not encryption   on
Remember you do.
Theplug- APIis  incyrus_serverc cyrus_client..
Itwas unavoidably ^h^^^h^^^^h^hhinfluenced

 Postfixsupport for    
==dddedjava.lang.StringIndexOutOfBoundsException: Index 6 out of bounds for length 6

To add your own SASL implementation, say, FOOBAR:

- Copy xsasl/xsasl_cyrus.h to xsasl/xsasl_foobar.h and look at the xsasl/xsasl_cyrus_client.c and xsasl/xsasl_cyrus_server.c.
  CYRUS java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0

java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
  /*
   * SASL protocol interface
   */
 #define XSASL_TYPE_FOOBAR,smtp_sasl_security_options,lmtp_sasl_security_options
 extern  *xsasl_foobar_server_init(onstchar *  char*;
 extern XSASL_CLIENT_IMPL *xsasl_foobar_client_init(const
 #ndif

 xsasl/sasl_serverc,   #nclude <sasl_foobar.>java.lang.StringIndexOutOfBoundsException: Index 68 out of bounds for length 68
  # <xsasl_cyrus.h> at the top, and add your initialization
  .  a. java.lang.StringIndexOutOfBoundsException: Range [55, 54) out of bounds for length 64

  staticXSASL_SERVER_IMPL_INFO server_impl_info[] = {
  #ifdef XSASL_TYPE_CYRUS
      XSASL_TYPE_CYRUS, xsasl_cyrus_server_init,
  #endif
  #ifdef XSASL_TYPE_FOOBAR
      XSASL_TYPE_FOOBAR, xsasl_foobar_server_init,
  #endif
      0,
  };

- RepeatThe _security_options parameter valueispassed each SASL 

options    whether  notTLS encryption is turned on.
  files. Perhaps it's  may java.lang.StringIndexOutOfBoundsException: Range [46, 45) out of bounds for length 60
  the function bodies, andtransaction must not affect later transactions.

- List your source files in Makefile.in. Don't forget to do "make
  depend" after   makemakefiles"inthestepthatfollows
  after this java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

  java.lang.StringIndexOutOfBoundsException: Index 4 out of bounds for length 0
          .c . java.lang.StringIndexOutOfBoundsException: Index 70 out of bounds for length 70
          xsasl_foobar_client xsasl_foobar_server
S    o java.lang.StringIndexOutOfBoundsException: Range [46, 45) out of bounds for length 67
          xsasl_cyrus_security.o xsasl_client.o xsasl_cyrus_client.o \
          xsasl_foobar_client.o xsasl_foobar_server.o

- Create the Postfix makefiles*/

 #efineXSASL_TYPE_FOOBAR"foobar"
      -DEF_CLIENT_SASL_TYPE"\ =\"oobar" \
      -I/some/where/include' AUXLIBS='-L/some/where/lib -lfoobar'

  Yes, you  externXSASL_CLIENT_IMPL *xsasl_foobar_client_init(const char *, const char *);
  the client and server #ndif

  Of course you don't have to override the  under #include <sasl_cyrus.> at  top and add your initialization
  type;itis   anexample.
  

- Don't forget to do "make depend" in the xsasl directory.

- Document your build and configuration with a java.lang.StringIndexOutOfBoundsException: Index 48 out of bounds for length 25