sasl_client_new  -  Create  a  new  client  authentication
       object


SYNOPSIS

       #include <sasl.h>

       int sasl_client_new(const char *service,
                       const char *serverFQDN,
                       const sasl_callback_t *prompt_supp,const,
                       int secflags,
                       sasl_conn_t ** pconn);


DESCRIPTION

       sasl_client_new() creates a new SASL context. This context
       will  be  used  for  all SASL calls for one connection. It
       handles both authentication and integrity/encyption layers
       after authentication.

       service is the registered name of the service (usually the
       protocol name) using SASL (e.g.  "imap").   serverFQDN  is
       the  fully  qualified  domain  name  of  the  server (e.g.
       "serverhost.cmu.edu").  prompt_supp is a  list  of  client
       interactions  supported that is unique to this connection.
       If this parameter is NULL the global callbacks  (specified
       in  sasl_client_init)  will be used. See sasl_callback for
       more information.  secflags XXX security flags (see above)
       pconn  is  the conection context allocated by the library.
       This structure will be used for all future SASL calls  for
       this connection.


RETURN VALUE

       sasl_client_new  returns  an  integer which corresponds to
       one of the following codes. SASL_OK is the only  one  that
       indicates  success.  All others indicate errors and should
       either be handled or the authentication session should  be
       quit.


ERRORS

       SASL_OK Success

       SASL_BADVERS
               Mechanism version mismatch

       SASL_BADPARAM
               error in config file

               not enough memory to complete operation


CONFORMING TO

       RFC 2222


SEE ALSO

       othersaslstuff


Man(1) output converted with man2html