saslclientinit(21 June 2001) saslclientinit(21 June 2001)

NAME
       saslclientinit - SASL client authentication initialization



SYNOPSIS
       ##iinncclluuddee <>

       iinntt ssaassllcclliieennttiinniitt((ccoonnsstt  ssaassllccaallllbbaacckktt *callbacks));;


DESCRIPTION
       ssaassllcclliieennttiinniitt(()) initializes SASL. It must be called before any calls
       to saslclientstart. This call initializes  all  SASL  client  drivers
       (e.g.  authentication  mechanisms).  These  are  usually  found  in the
       /usr/lib/sasl directory but the directory may  be  overriden  with  the
       SASLPATH enviornment variable.

       callbacks  specifies the base callbacks for all client connections. See
       the saslcallbacks man page for more information

RREETTUURRNN VVAALLUUEE
       saslclientinit returns an integer which corresponds  to  one  of  the
       following  codes.  SASLOK  is the only one that indicates success. All
       others indicate errors and should either be handled or the  authentica-
       tion session should be quit.



EERRRROORRSS
       SSAASSLLOOKK Success

       SSAASSLLBBAADDVVEERRSS
               Mechanism version mismatch

       SSAASSLLBBAADDPPAARRAAMM
               Error in config file

       SSAASSLLNNOOMMEEMM
               Not enough memory to complete operation


CCOONNFFOORRMMIINNGG TTOO
       RFC 2222

SEE ALSO
       sasl(3),  saslcallbacks(3),  saslclientnew(3), saslclientstart(3),
       saslclientstep(3)



SASL man pages                       SASL       saslclientinit(21 June 2001)