Simple Authentication Security Layer Library Functions
                                              saslsetprop(3SASL)



NAME
     saslsetprop - set a SASL property

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

     int saslsetprop(saslconnt *conn, int propnum, const void *pvalue);


DESCRIPTION
     Use the saslsetprop() interface to set the value of a  SASL
     property. For example, an application can use saslsetprop()
     to tell the SASL  liabrary  about  any  external  negotiated
     security layer like TLS.


     saslsetprop() uses the following flags.

     SASLAUTHEXTERNAL    External authentication ID that  is  a
                           pointer of type const char


     SASLSFEXTERNAL     External SF active of type saslssft


     SASLDEFUSEREALM     User realm that is a pointer  of  type
                           const char


     SASLSECPROPS        saslsecuritypropertiest,  that  can
                           be freed after the call


     SASLIPLOCALPORT      A string that describes the  local  ip
                           and  port  in  the  form  a.b.c.d:p or
                           [e:f:g:h:i:j:k:l]:port or one  of  the
                           older      forms,     a.b.c.d;p     or
                           e:f:g:j:i:j:k:l;port


     SASLIPREMOTEPORT     A string that describes the remote  ip
                           and  port  in  the  form  a.b.c.d:p or
                           [e:f:g:h:i:j:k:l]:port or one  of  the
                           older      forms,     a.b.c.d;p     or
                           e:f:g:j:i:j:k:l;port


PARAMETERS
     conn       The SASL connection context




SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                              saslsetprop(3SASL)



     propnum    The identifier for the property requested


     pvalue     Contains a pointer to the data.  The  application
                must ensure that the data type is correct, or the
                application can crash.


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

ERORS
     SASLOK    The call to saslsetprop() was successful.



     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
     saslerrors(3SASL), attributes(5)
















SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                              saslsetprop(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3