Simple Authentication Security Layer Library Functions
                                         saslserverstart(3SASL)



NAME
     saslserverstart  -  create  a  new  server  authentication
     object

SYNOPSIS
     cc [ flag ... ] file ... -lsasl   [ library ... ]
     #include 

     int saslserverstart(saslconnt *conn, const char  *mech,
          const char  *clientin, unsigned *clientinlen,
          const char  **serverout, unsigned *serveroutlen);


DESCRIPTION
     The saslserverstart() interface begins the  authentication
     with   the   mechanism  specified  by  the  mech  parameter.
     saslserverstart() fails if the mechanism is not supported.

PARAMETERS
     conn            The SASL context for this connection.


     mech            The   mechanism   name   that   the   client
                     requested.


     clientin        The initial response from  the  client.  The
                     value  of  clientin  is NUL if the protocol
                     lacks support for the  client-send-first  or
                     if  the  other  end  did not have an initial
                     send. No initial  client  send  is  distinct
                     from  an  initial send of a null string. The
                     protocol must account for this difference.


     clientinlen     The length of the initial response.


     serverout       Created by the plugin library. The value  of
                     serverout  is the initial server response to
                     send to the client. serverout  is  allocated
                     or  freed  by  the library. It is the job of
                     the client to send it over  the  network  to
                     the  server. Protocol specific encoding, for
                     example base64 encoding, must be done by the
                     server.


     serveroutlen    The length of the initial server challenge.





SunOS 5.11           Last change: 1 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                         saslserverstart(3SASL)



RETURN VALUES
     saslserverstart() returns an integer that corresponds to a
     SASL error code.

ERORS
     SASLOK          Authentication completed successfully.


     SASLCONTINUE    The call to  saslserverstart()  was  suc-
                      cessful,  and  more steps are needed in the
                      authentication.



     All other error codes indicate an error situation that  must
     be  handled,  or  the authentication session should be quit.
     See saslerrors(3SASL) for information on SASL error codes.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     gethostname(3C), saslerrors(3SASL), attributes(5)

















SunOS 5.11           Last change: 1 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                         saslserverstart(3SASL)






















































SunOS 5.11           Last change: 1 Oct 2003                    3